org.ujorm.tools.thread

Class JobContext

java.lang.Object

org.ujorm.tools.thread.JobContext

public class JobContext
extends Object

A context for a Jobs class. The instance affects to a job performace, three implementations are available.

• A solution based on a parallel Stream object has less memory footprint but worse performance of remote call operations.
• A solution based on CompletableFuture objects has great performance of remote call operations, but higher memory footprint.
• The last implementation call required job on the current single thread.

Save an instance of the JobContent to your application context per a group of tasks. Usage:

   JobContext jobContext = JobContext.forMultiJob(10);
   Stream<Integer> result = jobContext.forEach(1, 2, 3)
         .run(p -> p * 10);
 

For more samples see a MultiJobTest class.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JobContext(ExecutorService threadPool, Duration timeout)

Method Summary

Modifier and Type	Method and Description
static JobContext	forAny(ExecutorService threadPool, Duration timeout)
<P> Jobs<P>	forEach(Collection<P> params) A factory method
<P> Jobs<P>	forEach(P... params) A factory method for a multithreading instance
<P> Jobs<P>	forEach(Stream<P> params) A factory method
static JobContext	forMultiJob(int nThreads)
static JobContext	forMultiJob(int nThreads, Duration timeout)
static JobContext	forParallelJob(Duration timeout)
static JobContext	forParallelJob(int parallelism)
static JobContext	forParallelJob(int parallelism, Duration timeout)
static JobContext	forSingleThread()
<T extends ExecutorService> T	getThreadPool()
Duration	getTimeout()
protected boolean	hasForkJoinPool()
protected boolean	noThreadPool()
void	shutdown()
void	shutdownNow()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JobContext

protected JobContext(@Nullable
                     ExecutorService threadPool,
                     @Nonnull
                     Duration timeout)

Method Detail

getTimeout

@Nonnull
public Duration getTimeout()

noThreadPool

protected final boolean noThreadPool()

hasForkJoinPool

protected final boolean hasForkJoinPool()

getThreadPool

@Nullable
public <T extends ExecutorService> T getThreadPool()

shutdown

public void shutdown()

shutdownNow

public void shutdownNow()

forEach

public <P> Jobs<P> forEach(@Nonnull
                           P... params)

A factory method for a multithreading instance

Parameters:

params - All aguments

Returns:

An instance of MultiJob

forEach

public <P> Jobs<P> forEach(@Nonnull
                           Collection<P> params)

A factory method

Parameters:

params - All aguments

Returns:

An instance of multiJob

forEach

public <P> Jobs<P> forEach(@Nonnull
                           Stream<P> params)

A factory method

Parameters:

params - All aguments

Returns:

An instance of multiJob

forSingleThread

public static JobContext forSingleThread()

forMultiJob

public static JobContext forMultiJob(int nThreads)

forMultiJob

public static JobContext forMultiJob(int nThreads,
                                     Duration timeout)

forParallelJob

public static JobContext forParallelJob(int parallelism)

forParallelJob

public static JobContext forParallelJob(Duration timeout)

forParallelJob

public static JobContext forParallelJob(int parallelism,
                                        Duration timeout)

forAny

public static JobContext forAny(@Nullable
                                ExecutorService threadPool,
                                @Nonnull
                                Duration timeout)