diff --git a/src/main/java/io/foldright/inspectablewrappers/Wrapper.java b/src/main/java/io/foldright/inspectablewrappers/Wrapper.java index 9945aa0..7e220cf 100644 --- a/src/main/java/io/foldright/inspectablewrappers/Wrapper.java +++ b/src/main/java/io/foldright/inspectablewrappers/Wrapper.java @@ -4,8 +4,14 @@ /** - * This {@code Wrapper} interface is used to be implemented by wrapper classes, + * This {@code Wrapper} interface is used to be implemented by biz wrapper instances, * make an inspectable wrapper chain(linked list). + * + * + * + * + * + * *

* Note about wrapper chain: *

* + *

About wrapper pattern

+ * + * Wrapper pattern(aka. Decorator pattern) is + * well-known and widely-used, is used to attach new behaviors to objects + * (the wrappee/underlying instances/wrapped instances) + * by placing these objects inside the wrapper objects that contain the behaviors. + *

+ * Well-known examples of wrapper pattern in java std lib: + *

+ *

+ * The related design patterns are Adapter + * the wrapper instances and wra + * * @author Jerry Lee (oldratlee at gmail dot com) * @author Zava Xu (zava dot kid at gmail dot com) * @author Yang Fang (snoop dot fy at gmail dot com)