Decorator pattern
Encyclopedia
In object-oriented programming
Object-oriented programming
Object-oriented programming is a programming paradigm using "objects" – data structures consisting of data fields and methods together with their interactions – to design applications and computer programs. Programming techniques may include features such as data abstraction,...

, the decorator pattern is a design pattern
Design pattern (computer science)
In software engineering, a design pattern is a general reusable solution to a commonly occurring problem within a given context in software design. A design pattern is not a finished design that can be transformed directly into code. It is a description or template for how to solve a problem that...

 that allows behaviour to be added to an existing object
Object (computer science)
In computer science, an object is any entity that can be manipulated by the commands of a programming language, such as a value, variable, function, or data structure...

 dynamically.

Introduction

The decorator pattern can be used to extend (decorate) the functionality of a certain object at run-time, independently of other instances of the same class
Class (computer science)
In object-oriented programming, a class is a construct that is used as a blueprint to create instances of itself – referred to as class instances, class objects, instance objects or simply objects. A class defines constituent members which enable these class instances to have state and behavior...

, provided some groundwork is done at design time. This is achieved by designing a new decorator class that wraps the original class. This wrapping could be achieved by the following sequence of steps:
  1. Subclass the original "Decorator" class into a "Component" class (see UML diagram);
  2. In the Decorator class, add a Component pointer as a field;
  3. Pass a Component to the Decorator constructor to initialize the Component pointer;
  4. In the Decorator class, redirect all "Component" methods to the "Component" pointer; and
  5. In the ConcreteDecorator class, override any Component method(s) whose behavior needs to be modified.


This pattern is designed so that multiple decorators can be stacked on top of each other, each time adding a new functionality to the overridden method(s).

The decorator pattern is an alternative to subclassing. Subclassing adds behavior at compile time
Compile time
In computer science, compile time refers to either the operations performed by a compiler , programming language requirements that must be met by source code for it to be successfully compiled , or properties of the program that can be reasoned about at compile time.The operations performed at...

, and the change affects all instances of the original class; decorating can provide new behavior at run-time for individual objects.

This difference becomes most important when there are several independent ways of extending functionality. In some object-oriented programming language
Object-oriented programming language
This is a list of object-oriented programming programming languages.-Languages with object-oriented features:*ABAP*Ada 95*AmigaE*BETA*Blue*Boo*C++*C#*COBOL*Cobra*ColdFusion*Common Lisp*COOL*CorbaScript*Clarion*CLU*Curl*D*Dylan*E*Eiffel...

s, classes cannot be created at runtime, and it is typically not possible to predict, at design time, what combinations of extensions will be needed. This would mean that a new class would have to be made for every possible combination. By contrast, decorators are objects, created at runtime, and can be combined on a per-use basis. The I/O Streams implementations of both Java and the .NET Framework
.NET Framework
The .NET Framework is a software framework that runs primarily on Microsoft Windows. It includes a large library and supports several programming languages which allows language interoperability...

 incorporate the decorator pattern.

Motivation

As an example, consider a window in a windowing system
Windowing system
A windowing system is a component of a graphical user interface , and more specifically of a desktop environment, which supports the implementation of window managers, and provides basic support for graphics hardware, pointing devices such as mice, and keyboards...

. To allow scrolling
Scrolling
In computer graphics, filmmaking, television production, and other kinetic displays, scrolling is sliding text, images or video across a monitor or display. "Scrolling", as such, does not change the layout of the text or pictures, or but incrementally moves the user's view across what is...

 of the window's contents, we may wish to add horizontal or vertical scrollbar
Scrollbar
A scrollbar is an object in a graphical user interface with which continuous text, pictures or anything else can be scrolled including time in video applications, i.e., viewed even if it does not fit into the space in a computer display, window, or viewport...

s to it, as appropriate. Assume windows are represented by instances of the Window class, and assume this class has no functionality for adding scrollbars. We could create a subclass ScrollingWindow that provides them, or we could create a ScrollingWindowDecorator that adds this functionality to existing Window objects. At this point, either solution would be fine.

Now let's assume we also desire the ability to add borders to our windows. Again, our original Window class has no support. The ScrollingWindow subclass now poses a problem, because it has effectively created a new kind of window. If we wish to add border support to all windows, we must create subclasses WindowWithBorder and ScrollingWindowWithBorder. Obviously, this problem gets worse with every new feature to be added. For the decorator solution, we simply create a new BorderedWindowDecorator—at runtime, we can decorate existing windows with the ScrollingWindowDecorator or the BorderedWindowDecorator or both, as we see fit.

Another good example of where a decorator can be desired is when there is a need to restrict access to an object's properties or methods according to some set of rules or perhaps several parallel sets of rules (different user credentials, etc.) In this case instead of implementing the access control in the original object it is left unchanged and unaware of any restrictions on its use, and it is wrapped in an access control decorator object, which can then serve only the permitted subset of the original object's interface.

Examples

First Example (window/scrolling scenario)

The following Java example illustrates the use of decorators using the window/scrolling scenario.


// the Window interface
interface Window {
public void draw; // draws the Window
public String getDescription; // returns a description of the Window
}

// implementation of a simple Window without any scrollbars
class SimpleWindow implements Window {
public void draw {
// draw window
}

public String getDescription {
return "simple window";
}
}


The following classes contain the decorators for all Window classes, including the decorator classes themselves.


// abstract decorator class - note that it implements Window
abstract class WindowDecorator implements Window {
protected Window decoratedWindow; // the Window being decorated

public WindowDecorator (Window decoratedWindow) {
this.decoratedWindow = decoratedWindow;
}
public void draw {
decoratedWindow.draw;
}
}

// the first concrete decorator which adds vertical scrollbar functionality
class VerticalScrollBarDecorator extends WindowDecorator {
public VerticalScrollBarDecorator (Window decoratedWindow) {
super(decoratedWindow);
}

public void draw {
decoratedWindow.draw;
drawVerticalScrollBar;
}

private void drawVerticalScrollBar {
// draw the vertical scrollbar
}

public String getDescription {
return decoratedWindow.getDescription + ", including vertical scrollbars";
}
}

// the second concrete decorator which adds horizontal scrollbar functionality
class HorizontalScrollBarDecorator extends WindowDecorator {
public HorizontalScrollBarDecorator (Window decoratedWindow) {
super(decoratedWindow);
}

public void draw {
decoratedWindow.draw;
drawHorizontalScrollBar;
}

private void drawHorizontalScrollBar {
// draw the horizontal scrollbar
}

public String getDescription {
return decoratedWindow.getDescription + ", including horizontal scrollbars";
}
}


Here's a test program that creates a Window instance which is fully decorated (i.e., with vertical and horizontal scrollbars), and prints its description:


public class DecoratedWindowTest {
public static void main(String[] args) {
// create a decorated Window with horizontal and vertical scrollbars
Window decoratedWindow = new HorizontalScrollBarDecorator (
new VerticalScrollBarDecorator(new SimpleWindow));

// print the Window's description
System.out.println(decoratedWindow.getDescription);
}
}


The output of this program is "simple window, including vertical scrollbars, including horizontal scrollbars". Notice how the getDescription method of the two decorators first retrieve the decorated Window's description and decorates it with a suffix.

Second Example (coffee making scenario)

The next Java example illustrates the use of decorators using coffee making scenario.
In this example, the scenario only includes cost and ingredients.


// The Coffee Interface defines the functionality of Coffee implemented by decorator
public interface Coffee {
public double getCost; // returns the cost of the coffee
public String getIngredients; // returns the ingredients of the coffee
}

// implementation of a simple coffee without any extra ingredients
public class SimpleCoffee implements Coffee {
public double getCost {
return 1;
}

public String getIngredients {
return "Coffee";
}
}


The following classes contain the decorators for all Coffee classes, including the decorator classes themselves..


// abstract decorator class - note that it implements Coffee interface
abstract public class CoffeeDecorator implements Coffee {
protected final Coffee decoratedCoffee;
protected String ingredientSeparator = ", ";

public CoffeeDecorator(Coffee decoratedCoffee) {
this.decoratedCoffee = decoratedCoffee;
}

public double getCost { // implementing methods of the interface
return decoratedCoffee.getCost;
}

public String getIngredients {
return decoratedCoffee.getIngredients;
}
}

// Decorator Milk that mixes milk with coffee
// note it extends CoffeeDecorator
public class Milk extends CoffeeDecorator {
public Milk(Coffee decoratedCoffee) {
super(decoratedCoffee);
}

public double getCost { // overriding methods defined in the abstract superclass
return super.getCost + 0.5;
}

public String getIngredients {
return super.getIngredients + ingredientSeparator + "Milk";
}
}

// Decorator Whip that mixes whip with coffee
// note it extends CoffeeDecorator
public class Whip extends CoffeeDecorator {
public Whip(Coffee decoratedCoffee) {
super(decoratedCoffee);
}

public double getCost {
return super.getCost + 0.7;
}

public String getIngredients {
return super.getIngredients + ingredientSeparator + "Whip";
}
}

// Decorator Sprinkles that mixes sprinkles with coffee
// note it extends CoffeeDecorator
public class Sprinkles extends CoffeeDecorator {
public Sprinkles(Coffee decoratedCoffee) {
super(decoratedCoffee);
}

public double getCost {
return super.getCost + 0.2;
}

public String getIngredients {
return super.getIngredients + ingredientSeparator + "Sprinkles";
}
}


Here's a test program that creates a Coffee instance which is fully decorated (i.e., with milk, whip, sprinkles), and calculate cost of coffee and prints its ingredients:


public class Main
{
public static void main(String[] args)
{
Coffee c = new SimpleCoffee;
System.out.println("Cost: " + c.getCost + "; Ingredients: " + c.getIngredients);

c = new Milk(c);
System.out.println("Cost: " + c.getCost + "; Ingredients: " + c.getIngredients);

c = new Sprinkles(c);
System.out.println("Cost: " + c.getCost + "; Ingredients: " + c.getIngredients);

c = new Whip(c);
System.out.println("Cost: " + c.getCost + "; Ingredients: " + c.getIngredients);

// Note that you can also stack more than one decorator of the same type
c = new Sprinkles(c);
System.out.println("Cost: " + c.getCost + "; Ingredients: " + c.getIngredients);
}
}


The output of this program is given below:


Cost: 1.0; Ingredients: Coffee

Cost: 1.5; Ingredients: Coffee, Milk

Cost: 1.7; Ingredients: Coffee, Milk, Sprinkles

Cost: 2.4; Ingredients: Coffee, Milk, Sprinkles, Whip

Cost: 2.6; Ingredients: Coffee, Milk, Sprinkles, Whip, Sprinkles


Dynamic languages

The decorator pattern can also be implemented in dynamic languages with neither interfaces nor traditional OOP inheritance.

JavaScript (coffee making scenario)



// Class to be decorated
function Coffee {
this.cost = function {
return 1;
};
}

// Decorator A
function Milk(coffee) {
this.cost = function {
return coffee.cost + 0.5;
};
}

// Decorator B
function Whip(coffee) {
this.cost = function {
return coffee.cost + 0.7;
};
}

// Decorator C
function Sprinkles(coffee) {
this.cost = function {
return coffee.cost + 0.2;
};
}

// Here's one way of using it
var coffee = new Milk(new Whip(new Sprinkles(new Coffee)));
alert( coffee.cost );

// Here's another
var coffee = new Coffee;
coffee = new Sprinkles(coffee);
coffee = new Whip(coffee);
coffee = new Milk(coffee);
alert(coffee.cost);

See also

  • Composite pattern
    Composite pattern
    In software engineering, the composite pattern is a partitioning design pattern. The composite pattern describes that a group of objects are to be treated in the same way as a single instance of an object. The intent of a composite is to "compose" objects into tree structures to represent...

  • Adapter pattern
    Adapter pattern
    In computer programming, the adapter pattern is a design pattern that translates one interface for a class into a compatible interface...

  • Abstract class
  • Abstract factory
  • Aspect-oriented programming
    Aspect-oriented programming
    In computing, aspect-oriented programming is a programming paradigm which aims to increase modularity by allowing the separation of cross-cutting concerns...

  • Immutable object
    Immutable object
    In object-oriented and functional programming, an immutable object is an object whose state cannot be modified after it is created. This is in contrast to a mutable object, which can be modified after it is created...


External links

The source of this article is wikipedia, the free encyclopedia.  The text of this article is licensed under the GFDL.
 
x
OK