Package io.foldright.inspectablewrappers

Interface WrapperAdapter<T>

Type Parameters:

T - the type of instances that be wrapped

All Superinterfaces:

Wrapper<T>

public interface WrapperAdapter<T>
extends Wrapper<T>

This WrapperAdapter interface is used to adapt an existed wrapper instance to type Wrapper without modifying it.

The existed wrapper may not be able to be modified to integrate with inspectable wrappers; Integration with inspectable wrappers means implementation the Wrapper interface.

The wrapper chain contained WrapperAdapter looks like:

Provided WrapperAdapterUtils to create WrapperAdapter instances of the given biz interface type by the underlying and adaptee instances without writing boilerplate codes of creating new adapter classes.

Author:

Jerry Lee (oldratlee at gmail dot com), Zava Xu (zava dot kid at gmail dot com)

See Also:

• Wrapper
• WrapperAdapterUtils

Method Summary

Modifier and Type	Method	Description
T	adaptee_()	Returns the adapted/existed wrapper.

Methods inherited from interface io.foldright.inspectablewrappers.Wrapper

unwrap_

Method Details

adaptee_

@NonNull
T adaptee_()

Returns the adapted/existed wrapper.

Specification contracts:

• Do NOT return null which makes no sense.
  If returns null, the inspection operations of Inspector will throw NullPointerException when touch adaptee.
• The adaptee MUST NOT an instance of Wrapper, since adapting a Wrapper to a Wrapper is UNNECESSARY.
  If adapting a Wrapper, the inspection operations of Inspector will throw IllegalStateException when touch the Wrapper type adaptee.

Returns:

the adapted wrapper

See Also:

• Inspector