Asc.Utils.Needle 1.0.1

Asc.Utils.Needle

Utility to simplify multithreading background operations

Installation

Install-Package Asc.Utils.Needle

Usage

With using statement

  IResult someResult = null;
  using INeddleWorker neddleWorker = Pincushion.Instance.GetNeedle();
  
  neddleWorker.AddJob(SomeVoidMethod);
  neddleWorker.AddJob(SomeAsyncTaskMethod);
  neddleWorker.AddJob(async () => await DoSomethingAsync());
  
  if (someCondition)
      neddleWorker.AddJob(() => { someResult = GetResult(); });
  
  await neddleWorker.RunAsync();

Without using statement

  IResult someResult = null;
  INeddleWorker neddleWorker = Pincushion.Instance.GetNeedle(maxThreads: 2);
  
  neddleWorker.AddJob(SomeVoidMethod);
  neddleWorker.AddJob(SomeAsyncTaskMethod);
  neddleWorker.AddJob(async () => await DoSomethingAsync());
  
  if (someCondition)
      neddleWorker.AddJob(() => { someResult = GetResult(); });

  needleWorker.Completed += (object sender, EventArgs e) => needleWorker.Dispose();
  neddleWorker.BeginRun();

If some job fails

  using INeddleWorker neddleWorker = Pincushion.Instance.GetNeedle(
    maxThreads: 2,
    cancelPendingJobsIfAnyOtherFails: false
  );

  foreach(Action job in jobs)
    neddleWorker.AddJob(job);

  try
  {
    await neddleWorker.RunAsync();
  }
  catch (AggregateException aggregateEx)
  {
    foreach (Exception exception in aggregateEx.InnerExceptions)
      logger.LogException(exception);
  }
  catch (Exception ex)
  {
    logger.LogException(ex, "Unexpected error while INeddleWorker.RunAsync");
  }

More info

See INeddleWorker interface to get more info about how to use this utility

Icon from Flaticon:

<a href="https://www.flaticon.com/free-icons/sew" title="sew icons">Sew icons created by Pixel perfect - Flaticon</a>