com.github.dm.jrt.invocation

Class Invocations

java.lang.Object

com.github.dm.jrt.invocation.Invocations

public class Invocations
extends Object

Utility class for creating invocation factory objects.

Created by davide-maestroni on 02/12/2015.

Method Summary

Methods

Modifier and Type	Method and Description
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(Class<? extends Invocation<IN,OUT>> invocationClass) Builds and returns a new invocation factory creating instances of the specified class.
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(Class<? extends Invocation<IN,OUT>> invocationClass, Object... args) Builds and returns a new invocation factory creating instances of the specified class by passing the specified arguments to the class constructor.
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(ClassToken<? extends Invocation<IN,OUT>> invocationToken) Builds and returns a new invocation factory creating instances of the specified class token.
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(ClassToken<? extends Invocation<IN,OUT>> invocationToken, Object... args) Builds and returns a new invocation factory creating instances of the specified class token by passing the specified arguments to the class constructor.
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(Invocation<IN,OUT> invocation) Builds and returns a new invocation factory creating instances of the specified object.
static <IN,OUT> InvocationFactory<IN,OUT>	factoryOf(Invocation<IN,OUT> invocation, Object... args) Builds and returns a new invocation factory creating instances of the specified object by passing the specified arguments to the class constructor.

Methods inherited from class java.lang.Object

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

Method Detail

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   Class<? extends Invocation<IN,OUT>> invocationClass)

Builds and returns a new invocation factory creating instances of the specified class.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocationClass - the invocation class.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no default constructor was found.

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   Class<? extends Invocation<IN,OUT>> invocationClass,
                                                   @Nullable
                                                   Object... args)

Builds and returns a new invocation factory creating instances of the specified class by passing the specified arguments to the class constructor.

Note that inner and anonymous classes can be passed as well. Remember however that Java creates synthetic constructors for such classes, so be sure to specify the correct arguments to guarantee proper instantiation. In fact, inner classes always have the outer instance as first constructor parameter, and anonymous classes have both the outer instance and all the variables captured in the closure.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocationClass - the invocation class.

args - the invocation constructor arguments.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no constructor taking the specified objects as parameters was found.

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   ClassToken<? extends Invocation<IN,OUT>> invocationToken)

Builds and returns a new invocation factory creating instances of the specified class token.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocationToken - the invocation class token.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no default constructor was found.

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   ClassToken<? extends Invocation<IN,OUT>> invocationToken,
                                                   @Nullable
                                                   Object... args)

Builds and returns a new invocation factory creating instances of the specified class token by passing the specified arguments to the class constructor.

Note that class tokens of inner and anonymous classes can be passed as well. Remember however that Java creates synthetic constructors for such classes, so be sure to specify the correct arguments to guarantee proper instantiation. In fact, inner classes always have the outer instance as first constructor parameter, and anonymous classes have both the outer instance and all the variables captured in the closure.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocationToken - the invocation class token.

args - the invocation constructor arguments.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no constructor taking the specified objects as parameters was found.

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   Invocation<IN,OUT> invocation)

Builds and returns a new invocation factory creating instances of the specified object.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocation - the invocation instance.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no default constructor was found.

factoryOf

@NotNull
public static <IN,OUT> InvocationFactory<IN,OUT> factoryOf(@NotNull
                                                   Invocation<IN,OUT> invocation,
                                                   @Nullable
                                                   Object... args)

Builds and returns a new invocation factory creating instances of the specified object by passing the specified arguments to the class constructor.

Note that inner and anonymous objects can be passed as well. Remember however that Java creates synthetic constructors for such classes, so be sure to specify the correct arguments to guarantee proper instantiation. In fact, inner classes always have the outer instance as first constructor parameter, and anonymous classes have both the outer instance and all the variables captured in the closure.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

invocation - the invocation instance.

args - the invocation constructor arguments.

Returns:

the invocation factory.

Throws:

IllegalArgumentException - if no constructor taking the specified objects as parameters was found.