org.ujorm.tools.thread

Class Jobs<P>

java.lang.Object

org.ujorm.tools.thread.Jobs<P>

Direct Known Subclasses:

MultiJob, ParallelJob

public class Jobs<P>
extends Object

API for a multithreading 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.

Since:

1.94

See Also:

https://dzone.com/articles/think-twice-using-java-8, https://www.baeldung.com/java-completablefuture

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Jobs.JobException An envelope for checked exceptions
static interface	Jobs.UserFunction<T,R>

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	REQUIRED_INPUT_TEMPLATE_MSG Template message for an invalid input
protected Duration	timeout A timeout of a job where a default duration is the one hour

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Jobs(Stream<P> params, Duration timeout)

Method Summary

Modifier and Type	Method and Description
protected Stream<P>	getParallel() Get a parameter Stream like a parallel type
<R> Stream<R>	run(Jobs.UserFunction<P,R> job) Get of single values where all nulls are excluded
<R> Stream<R>	runOfStream(Jobs.UserFunction<P,Stream<R>> job) Get result of a Streams
<R> long	runOfSum(Jobs.UserFunction<P,Integer> job) Get a sum of job results type of long
Jobs<P>	setTimeout(Duration timeout) Set a timeout where a default duration is the one hour

Methods inherited from class java.lang.Object

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

Field Detail

REQUIRED_INPUT_TEMPLATE_MSG

protected static final String REQUIRED_INPUT_TEMPLATE_MSG

Template message for an invalid input

See Also:

Constant Field Values

timeout

@Nonnull
protected Duration timeout

A timeout of a job where a default duration is the one hour

Constructor Detail

Jobs

protected Jobs(@Nonnull
               Stream<P> params,
               @Nonnull
               Duration timeout)

Method Detail

getParallel

@Nonnull
protected final Stream<P> getParallel()

Get a parameter Stream like a parallel type

setTimeout

public final Jobs<P> setTimeout(@Nonnull
                                Duration timeout)

Set a timeout where a default duration is the one hour

Parameters:

timeout - The maximum time to wait.

Returns:

The same object

run

public <R> Stream<R> run(@Nonnull
                         Jobs.UserFunction<P,R> job)

Get of single values where all nulls are excluded

Parameters:

job - Job with a simple value result

Returns:

The result stream

runOfStream

public <R> Stream<R> runOfStream(@Nonnull
                                 Jobs.UserFunction<P,Stream<R>> job)

Get result of a Streams

Parameters:

job - Job with a stream result

Returns:

The result stream

runOfSum

public <R> long runOfSum(@Nonnull
                         Jobs.UserFunction<P,Integer> job)
                  throws Jobs.JobException

Get a sum of job results type of long

Parameters:

job - Job with a simple value result

Returns:

The sum of job results

Throws:

Jobs.JobException