org.cojen.dirmi.util

Class Wrapper<B,D>

java.lang.Object

org.cojen.dirmi.util.Wrapper<B,D>

public class Wrapper<B,D>
extends Object

Automatically generates objects which delegate method invocations to another object. This simplifies the process of implementing remote objects which are primarily adapters.

Author:

Brian S O'Neill

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Wrapper(Class<? extends B> adapterClass, Constructor<B> ctor)

Method Summary

Modifier and Type	Method and Description
static <B,D> Wrapper<B,D>	from(Class<B> baseType, Class<D> delegateType) Generates a wrapper from a base type and delegate type.
Constructor<? extends B>	getConstructor(Class<?>... arguments) Returns a constructor for the generated wrapper.
B	wrap(D delegate) Returns a wrapper instance around the given delegate.

Methods inherited from class java.lang.Object

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

Constructor Detail

Wrapper

protected Wrapper(Class<? extends B> adapterClass,
                  Constructor<B> ctor)

Method Detail

from

public static <B,D> Wrapper<B,D> from(Class<B> baseType,
                                      Class<D> delegateType)

Generates a wrapper from a base type and delegate type. The base type can be an interface or abstract class, but the delegate can be any type. If the base type is an abstract class, it must have at least one public or protected constructor of the form:

• no arguments
• one argument, capable of accepting the delegate type
• multiple arguments, but the first must be capable of accepting the delegate type

For each public or protected abstract method in the base type, an attempt is made to match the invocation to a method in the delegate type. The method signature must exactly match, and any declared checked exceptions in the delegate type must also be declared by the base type. If any abstract methods cannot be implemented, an IllegalArgumentException is thrown.

Parameters:

baseType - must be a public interface or abstract class

delegateType - any type

Throws:

IllegalArgumentException - if type parameters are unsupported

wrap

public B wrap(D delegate)

Returns a wrapper instance around the given delegate.

Parameters:

delegate - delegate to wrap

Throws:

IllegalArgumentException - if delegate is null or arguments are required

UndeclaredThrowableException - if constructor throws a checked exception

getConstructor

public Constructor<? extends B> getConstructor(Class<?>... arguments)
                                        throws NoSuchMethodException

Returns a constructor for the generated wrapper. The first argument must match the delegate type.

Throws:

NoSuchMethodException