org.apache.river.api.io

Class AtomicSerial.Factory

java.lang.Object

org.apache.river.api.io.AtomicSerial.Factory

Enclosing class:

AtomicSerial

public static final class AtomicSerial.Factory
extends Object

Factory to test AtomicSerial instantiation compliance.

Method Summary

Modifier and Type	Method and Description
static <T> T	instantiate(Class<T> type, AtomicSerial.GetArg arg) Convenience method for testing implementing class constructor signature compliance.
static AtomicSerial.ReadObject	streamReader(Class<?> streamClass) Convenience method to test retrieval of a new ReadObject instance from a class static method annotated with @ReadInput

Methods inherited from class java.lang.Object

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

Method Detail

instantiate

public static <T> T instantiate(Class<T> type,
                                AtomicSerial.GetArg arg)
                         throws IOException

Convenience method for testing implementing class constructor signature compliance.

De-serializers are free to implement higher performance instantiation that complies with this contract.

Only public and package default constructors can be called by de-serializers. Package default constructors have been provided to prevent implementations from polluting public api, but should be treated as public constructors.

Constructors with private visibility cannot be called.

Constructors with protected visibility can only be called by subclasses, not de-serializers.

Type Parameters:

T - AtomicSerial implementation type.

Parameters:

type - AtomicSerial implementing class.

arg - GetArg caller sensitive arguments used by implementing constructor.

Returns:

new instance of T.

Throws:

InvalidClassException - if constructor is non compliant or doesn't exist.

InvalidObjectException - if invariant check fails

NullPointerException - if arg or type is null.

IOException

streamReader

public static AtomicSerial.ReadObject streamReader(Class<?> streamClass)
                                            throws IOException

Convenience method to test retrieval of a new ReadObject instance from a class static method annotated with @ReadInput

Parameters:

streamClass -

Returns:

Throws:

IOException

See Also:

AtomicSerial.ReadInput