reference by Decorator Design Pattern

兄Die，寫程式碼太累了？孤獨寂寞冷？還沒有女朋友吧？
關注微信公眾號(瓠悠笑軟體部落)，送知識！送知識！送溫暖！送工作！送女朋友！插科打諢喲！

##Intent

1. Attach additional responsibilities to an object dynamically. Decorators provide a flexible alternative to subclassing for extending functionality.
2. Client-specified embellishment of a core object by recursively wrapping it.
3. Wrapping a gift, putting it in a box, and wrapping the box.

##Problem

You want to add behavior or state to individual objects at run-time. Inheritance is not feasible because it is static and applies to an entire class.
Discussion

Suppose you are working on a user interface toolkit and you wish to support adding borders and scroll bars to windows. You could define an inheritance hierarchy like …

##Decorator scheme

But the Decorator pattern suggests giving the client the ability to specify whatever combination of “features” is desired.

Widget* aWidget = new BorderDecorator(
  new HorizontalScrollBarDecorator(
    new VerticalScrollBarDecorator(
      new Window( 80, 24 ))));
aWidget->draw();
 

This flexibility can be achieved with the following design

##Decorator scheme

Another example of cascading (or chaining) features together to produce a custom object might look like …

Stream* aStream = new CompressingStream(
  new ASCII7Stream(
    new FileStream("fileName.dat")));
aStream->putString( "Hello world" );

The solution to this class of problems involves encapsulating the original object inside an abstract wrapper interface. Both the decorator objects and the core object inherit from this abstract interface. The interface uses recursive composition to allow an unlimited number of decorator “layers” to be added to each core object.

Note that this pattern allows responsibilities to be added to an object, not methods to an object’s interface. The interface presented to the client must remain constant as successive layers are specified.

Also note that the core object’s identity has now been “hidden” inside of a decorator object. Trying to access the core object directly is now a problem.

##Structure

The client is always interested in CoreFunctionality.doThis(). The client may, or may not, be interested in OptionalOne.doThis() and OptionalTwo.doThis(). Each of these classes always delegate to the Decorator base class, and that class always delegates to the contained “wrappee” object.

##Example

The Decorator attaches additional responsibilities to an object dynamically. The ornaments that are added to pine or fir trees are examples of Decorators. Lights, garland, candy canes, glass ornaments, etc., can be added to a tree to give it a festive look. The ornaments do not change the tree itself which is recognizable as a Christmas tree regardless of particular ornaments used. As an example of additional functionality, the addition of lights allows one to “light up” a Christmas tree.

Another example: assault gun is a deadly weapon on it’s own. But you can apply certain “decorations” to make it more accurate, silent and devastating.

##Check list

1. Ensure the context is: a single core (or non-optional) component, several optional embellishments or wrappers, and an interface that is common to all.
2. Create a “Lowest Common Denominator” interface that makes all classes interchangeable.
3. Create a second level base class (Decorator) to support the optional wrapper classes.
4. The Core class and Decorator class inherit from the LCD interface.
5. The Decorator class declares a composition relationship to the LCD interface, and this data member is initialized in its constructor.
6. The Decorator class delegates to the LCD object.
7. Define a Decorator derived class for each optional embellishment.
8. Decorator derived classes implement their wrapper functionality - and - delegate to the Decorator base class.
9. The client configures the type and ordering of Core and Decorator objects.

##Rules of thumb

1. Adapter provides a different interface to its subject. Proxy provides the same interface. Decorator provides an enhanced interface.
2. Adapter changes an object’s interface, Decorator enhances an object’s responsibilities. Decorator is thus more transparent to the client. As a consequence, Decorator supports recursive composition, which isn’t possible with pure Adapters.
3. Composite and Decorator have similar structure diagrams, reflecting the fact that both rely on recursive composition to organize an open-ended number of objects.
4. A Decorator can be viewed as a degenerate Composite with only one component. However, a Decorator adds additional responsibilities - it isn’t intended for object aggregation.
5. Decorator is designed to let you add responsibilities to objects without subclassing. Composite’s focus is not on embellishment but on representation. These intents are distinct but complementary. Consequently, Composite and Decorator are often used in concert.
6. Composite could use Chain of Responsibility to let components access global properties through their parent. It could also use Decorator to override these properties on parts of the composition.
7. Decorator and Proxy have different purposes but similar structures. Both describe how to provide a level of indirection to another object, and the implementations keep a reference to the object to which they forward requests.

##Sample Code
Need an interface to read and write console message. now I need:

1. support authentication before main work flow, if input password is incorrect, exit system. others do following work flow.
2. if it is read, should encrypt its message with one simple algorithm(just cast char to int and minus 5, then cast to char and return). if it is write, should decrypt its message with one simle algorithm(just cast char to int and add 5, then cast to char and return).

The LowestCommonDenominator interface define the basic common methods: read() and write().

package com.kado.pattern.structural.decorator.a;

public interface LowestCommonDenominator {
    public void write(String[] s);
    public void read(String[] s);
}

Then define a Class named Core to implements read and write operation.

package com.kado.pattern.structural.decorator.a;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

public class Core implements LowestCommonDenominator {
    public static BufferedReader in = new BufferedReader(new InputStreamReader(System.in));
    @Override
    public void write(String[] s) {
        System.out.print("INPUT:   ");
        try{
            s[0] = in.readLine();
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

    @Override
    public void read(String[] s) {
        System.out.print("OUTPUT:    "+s[0]);
    }
}

Define a Decorator class to implements the LowestCommonDenominator interface, it contains an LowestCommonDenominator attribute named inner inside. all its read and write operation is doing by inner’s related method.

package com.kado.pattern.structural.decorator.a;

public class Decorator implements LowestCommonDenominator{
    private  LowestCommonDenominator inner;

    public Decorator(LowestCommonDenominator inner) {
        this.inner = inner;
    }
    public void write(String[] s) {
        inner.write(s);
    }

    @Override
    public void read(String[] s) {
        inner.read(s);
    }
}

Define the Authenticate operation

package com.kado.pattern.structural.decorator.a;

import  com.kado.pattern.structural.decorator.a.Core;

import java.io.IOException;

public class Authenticate extends Decorator {
    public static final String password = "123456";
    public Authenticate(LowestCommonDenominator inner) {
        super(inner);
    }

    @Override
    public void write(String[] s) {
        checkPassword();
        super.write(s);
    }

    @Override
    public void read(String[] s) {
        checkPassword();
        super.read(s);
    }

    private void checkPassword() {
        System.out.print( "PASSWORD: " );
        try {
            String checkPassword = Core.in.readLine();
            if(!password.equals(checkPassword)) {
                System.out.println("input password is not incorrect, exit.");
                System.exit(-1);
            } else {
                System.out.println("password is correct, continue...");
            }
        } catch (IOException ex) { ex.printStackTrace(); }
    }
}

Define the Scramble operation

package com.kado.pattern.structural.decorator.a;

public class Scramble extends Decorator {

    public Scramble(LowestCommonDenominator lowestCommonDenominator) {
        super(lowestCommonDenominator);
    }

    public void write(String[] s) {
        super.write(s);
        System.out.println("encrypt:");
        StringBuffer sb = new StringBuffer(s[0]);
        for(int i=0; i< sb.length(); i++) {
            sb.setCharAt(i, (char) (sb.charAt(i) - 5));
            s[0] = sb.toString();
        }
    }

    public void read(String[] s) {
        StringBuffer sb = new StringBuffer(s[0]);
        for(int i=0; i<sb.length(); i++) {
            sb.setCharAt(i, (char)(sb.charAt(i) + 5) );
        }
        s[0] = sb.toString();
        System.out.println("decrypt:");
        super.read(s);
    }

}

The test code:

package com.kado.pattern.structural.decorator.a;

public class DecoratorDemo {
    public static void main( String[] args ) {
        LowestCommonDenominator stream = new Authenticate( new Scramble( new Core() ) );
        String[] str = { new String() };
        stream.write( str );
        System.out.println( "main:     " + str[0] );
        stream.read( str );
    }
}

output as below:

PASSWORD: 123456
password is correct, continue...
INPUT:   kado is my name
encrypt:
main:     f\_jdnhti\h`
PASSWORD: 123456
password is correct, continue...
decrypt:
OUTPUT:    kado is my name