Package io.foldright.inspectablewrappers.utils

Class WrapperAdapterUtils

java.lang.Object

io.foldright.inspectablewrappers.utils.WrapperAdapterUtils

@DefaultAnnotationForParameters(edu.umd.cs.findbugs.annotations.NonNull.class)
public final class WrapperAdapterUtils
extends Object

Utility class for creating WrapperAdapter instances without writing boilerplate codes of creating new adapter classes.

Author:

Jerry Lee (oldratlee at gmail dot com)

Method Summary

Modifier and Type	Method	Description
static <T> T	createWrapperAdapter(Class<? super T> bizInterface, T underlying, T adaptee)	Creates a WrapperAdapter instance of the given biz interface type by the underlying(Wrapper.unwrap_()) and adaptee(WrapperAdapter.adaptee_()) instances.
static <T> T	createWrapperAdapter(Class<? super T> bizInterface, T underlying, T adaptee, Attachable<?,?> attachable)	Creates a WrapperAdapter instance of the given biz interface type and Attachable type by the underlying(Wrapper.unwrap_()), adaptee(WrapperAdapter.adaptee_()) and attachable instances.
static <T> T	createWrapperAdapter(Class<? super T> bizInterface, T underlying, T adaptee, Attachable<?,?> attachable, Class<?>... tagInterfaces)	Same as createWrapperAdapter(Class, Object, Object, Attachable), but the returned WrapperAdapter instance also implements the given tag interfaces.
static <T> T	createWrapperAdapter(Class<? super T> bizInterface, T underlying, T adaptee, Class<?>... tagInterfaces)	Same as createWrapperAdapter(Class, Object, Object), but the returned WrapperAdapter instance also implements the given tag interfaces.

Methods inherited from class java.lang.Object

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

Method Details

createWrapperAdapter

@NonNull
public static <T> T createWrapperAdapter(Class<? super T> bizInterface,
 T underlying,
 T adaptee)

Creates a WrapperAdapter instance of the given biz interface type by the underlying(Wrapper.unwrap_()) and adaptee(WrapperAdapter.adaptee_()) instances.

Type Parameters:

T - the type of instances that be wrapped

Parameters:

bizInterface - the class of instances that be wrapped

underlying - the underlying instance that be wrapped, more info see Wrapper.unwrap_()

adaptee - the adapted/existed wrapper instance, more info see WrapperAdapter.adaptee_()

Returns:

the new WrapperAdapter instance

Throws:

IllegalArgumentException - if bizInterface is not an interface, or bizInterface is Wrapper/WrapperAdapter/Attachable, or underlying is not an instance of bizInterface, or adaptee is not an instance of bizInterface, or adaptee is an instance of Wrapper

NullPointerException - if any argument is null

See Also:

• Wrapper.unwrap_()
• WrapperAdapter.adaptee_()

createWrapperAdapter

@NonNull
public static <T> T createWrapperAdapter(Class<? super T> bizInterface,
 T underlying,
 T adaptee,
 Attachable<?,?> attachable)

Creates a WrapperAdapter instance of the given biz interface type and Attachable type by the underlying(Wrapper.unwrap_()), adaptee(WrapperAdapter.adaptee_()) and attachable instances.

Type Parameters:

T - the type of instances that be wrapped

Parameters:

bizInterface - the class of instances that be wrapped

underlying - the underlying instance that be wrapped, more info see Wrapper.unwrap_()

adaptee - the adapted/existed wrapper instance, more info see WrapperAdapter.adaptee_()

attachable - the attachable instance, more info see Attachable

Returns:

the new WrapperAdapter instance

Throws:

IllegalArgumentException - if bizInterface is not an interface, or bizInterface is Wrapper/WrapperAdapter/Attachable, or underlying is not an instance of bizInterface, or adaptee is not an instance of bizInterface, or adaptee is an instance of Wrapper

NullPointerException - if any argument is null

See Also:

• Wrapper.unwrap_()
• WrapperAdapter.adaptee_()
• Attachable.getAttachment_(Object)
• Attachable.setAttachment_(Object, Object)

createWrapperAdapter

@NonNull
public static <T> T createWrapperAdapter(Class<? super T> bizInterface,
 T underlying,
 T adaptee,
 Class<?>... tagInterfaces)

Same as createWrapperAdapter(Class, Object, Object), but the returned WrapperAdapter instance also implements the given tag interfaces.

See Also:

• createWrapperAdapter(Class, Object, Object)

createWrapperAdapter

@NonNull
public static <T> T createWrapperAdapter(Class<? super T> bizInterface,
 T underlying,
 T adaptee,
 Attachable<?,?> attachable,
 Class<?>... tagInterfaces)

Same as createWrapperAdapter(Class, Object, Object, Attachable), but the returned WrapperAdapter instance also implements the given tag interfaces.

See Also:

• createWrapperAdapter(Class, Object, Object, Attachable)