README.md 30.5 KB
Newer Older
I
Ilkka Seppälä 已提交
1

2
# Design pattern samples in Java.
I
Ilkka Seppälä 已提交
3

I
Ilkka Seppälä 已提交
4 5 6 7
## Build status:

![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master)

8 9
## <a name="list-of-design-patterns">List of Design Patterns</a>

10 11 12 13 14 15 16 17 18 19 20 21 22 23
* Creational Patterns
	* [Abstract Factory](#abstract-factory)
	* [Builder](#builder)
	* [Factory Method](#factory-method)
	* [Prototype](#prototype)
	* [Singleton](#singleton)
* Structural Patterns
	* [Adapter](#adapter)
	* [Bridge](#bridge)
	* [Composite](#composite)
	* [Decorator](#decorator)
	* [Facade](#facade)
	* [Flyweight](#flyweight)
	* [Proxy](#proxy)
M
M Saif Asif 已提交
24
	* [Service Locator](#service-locator)
25 26 27 28 29 30 31 32 33 34 35 36
* Behavioral Patterns
	* [Chain of responsibility](#chain-of-responsibility)
	* [Command](#command)
	* [Interpreter](#interpreter)
	* [Iterator](#iterator)
	* [Mediator](#mediator)
	* [Memento](#memento)
	* [Observer](#observer)
	* [State](#state)
	* [Strategy](#strategy)
	* [Template method](#template-method)
	* [Visitor](#visitor)
37 38
* [Model-View-Presenter](#model-view-presenter)
* [Double Checked Locking](#double-checked-locking)
I
Ilkka Seppälä 已提交
39
* [Servant](#servant)
40 41

## <a name="abstract-factory">Abstract Factory</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
42
**Intent:** Provide an interface for creating families of related or dependent objects without specifying their concrete classes.
I
Ilkka Seppälä 已提交
43

I
Ilkka Seppälä 已提交
44
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/abstract-factory/etc/abstract-factory_1.png "Abstract Factory")
I
Ilkka Seppälä 已提交
45

I
Ilkka Seppälä 已提交
46
**Applicability:** Use the Abstract Factory pattern when
I
Ilkka Seppälä 已提交
47 48 49 50
* a system should be independent of how its products are created, composed and represented
* a system should be configured with one of multiple families of products
* a family of related product objects is designed to be used together, and you need to enforce this constraint
* you want to provide a class library of products, and you want to reveal just their interfaces, not their implementations
I
Ilkka Seppälä 已提交
51

52 53 54
**Real world examples:**
* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/6/docs/api/javax/xml/parsers/DocumentBuilderFactory.html)

55
## <a name="builder">Builder</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
56
**Intent:** Separate the construction of a complex object from its representation so that the same construction process can create different representations.
I
Ilkka Seppälä 已提交
57

I
Ilkka Seppälä 已提交
58
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/builder/etc/builder_1.png "Builder")
I
Ilkka Seppälä 已提交
59

I
Ilkka Seppälä 已提交
60 61
**Applicability:** Use the Builder pattern when
* the algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled
I
Ilkka Seppälä 已提交
62
* the construction process must allow different representations for the object that's constructed
I
Ilkka Seppälä 已提交
63

64 65 66
**Real world examples:**
* [java.lang.StringBuilder](http://docs.oracle.com/javase/6/docs/api/java/lang/StringBuilder.html)

67
## <a name="factory-method">Factory Method</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
68
**Intent:** Define an interface for creating an object, but let subclasses decide which class to instantiate. Factory Method lets a class defer instantiation to subclasses.
I
Ilkka Seppälä 已提交
69

I
Ilkka Seppälä 已提交
70
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/factory-method/etc/factory-method_1.png "Factory Method")
I
Ilkka Seppälä 已提交
71 72 73 74 75 76

**Applicability:** Use the Factory Method pattern when
* a class can't anticipate the class of objects it must create
* a class wants its subclasses to specify the objects it creates
* classes delegate responsibility to one of several helper subclasses, and you want to localize the knowledge of which helper subclass is the delegate

77 78 79
**Real world examples:**
* [java.util.Calendar#getInstance()](http://docs.oracle.com/javase/6/docs/api/java/util/Calendar.html#getInstance%28%29)

80
## <a name="prototype">Prototype</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
81
**Intent:** Specify the kinds of objects to create using a prototypical instance, and create new objects by copying this prototype.
I
Ilkka Seppälä 已提交
82

I
Ilkka Seppälä 已提交
83
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/prototype/etc/prototype_1.png "Prototype")
I
Ilkka Seppälä 已提交
84 85 86 87 88 89

**Applicability:** Use the Prototype pattern when a system should be independent of how its products are created, composed and represented; and
* when the classes to instantiate are specified at run-time, for example, by dynamic loading; or
* to avoid building a class hierarchy of factories that parallels the class hierarchy of products; or
* when instances of a class can have one of only a few different combinations of state. It may be more convenient to install a corresponding number of prototypes and clone them rather than instantiating the class manually, each time with the appropriate state

90 91 92
**Real world examples:**
* [java.lang.Object#clone()](http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html#clone%28%29)

93
## <a name="singleton">Singleton</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
94
**Intent:** Ensure a class only has one instance, and provide a global point of access to it.
I
Ilkka Seppälä 已提交
95

I
Ilkka Seppälä 已提交
96
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/singleton/etc/singleton_1.png "Singleton")
I
Ilkka Seppälä 已提交
97 98

**Applicability:** Use the Singleton pattern when
M
Matthew Dean 已提交
99
* there must be exactly one instance of a class, and it must be accessible to clients from a well-known access point
I
Ilkka Seppälä 已提交
100 101
* when the sole instance should be extensible by subclassing, and clients should be able to use an extended instance without modifying their code

L
llitfkitfk 已提交
102 103 104 105 106
**Typical Use Case:**
* the logging class
* managing a connection to a database
* file manager

107 108 109
**Real world examples:**
* [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/6/docs/api/java/lang/Runtime.html#getRuntime%28%29)

110
## <a name="adapter">Adapter</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
111
**Intent:** Convert the interface of a class into another interface the clients expect. Adapter lets classes work together that couldn't otherwise because of incompatible interfaces.
I
Ilkka Seppälä 已提交
112

I
Ilkka Seppälä 已提交
113
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/adapter/etc/adapter_1.png "Adapter")
I
Ilkka Seppälä 已提交
114 115 116 117 118 119

**Applicability:** Use the Adapter pattern when
* you want to use an existing class, and its interface does not match the one you need
* you want to create a reusable class that cooperates with unrelated or unforeseen classes, that is, classes that don't necessarily have compatible interfaces
* you need to use several existing subclasses, but it's impractical to adapt their interface by subclassing every one. An object adapter can adapt the interface of its parent class.

120 121 122
**Real world examples:**
* [java.util.Arrays#asList()](http://docs.oracle.com/javase/6/docs/api/java/util/Arrays.html#asList%28T...%29)

123
## <a name="bridge">Bridge</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
124
**Intent:** Decouple an abstraction from its implementation so that the two can vary independently.
I
Ilkka Seppälä 已提交
125

I
Ilkka Seppälä 已提交
126

I
Ilkka Seppälä 已提交
127
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/bridge/etc/bridge_1.png "Bridge")
I
Ilkka Seppälä 已提交
128 129 130 131 132 133 134 135

**Applicability:** Use the Bridge pattern when
* you want to avoid a permanent binding between an abstraction and its implementation. This might be the case, for example, when the implementation must be selected or switched at run-time.
* both the abstractions and their implementations should be extensible by subclassing. In this case, the Bridge pattern lets you combine the different abstractions and implementations and extend them independently
* changes in the implementation of an abstraction should have no impact on clients; that is, their code should not have to be recompiled.
* you have a proliferation of classes. Such a class hierarchy indicates the need for splitting an object into two parts. Rumbaugh uses the term "nested generalizations" to refer to such class hierarchies
* you want to share an implementation among multiple objects (perhaps using reference counting), and this fact should be hidden from the client. A simple example is Coplien's String class, in which multiple objects can share the same string representation.

136
## <a name="composite">Composite</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
137
**Intent:** Compose objects into tree structures to represent part-whole hierarchies. Composite lets clients treat individual objects and compositions of objects uniformly.
I
Ilkka Seppälä 已提交
138

I
Ilkka Seppälä 已提交
139
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/composite/etc/composite_1.png "Composite")
I
Ilkka Seppälä 已提交
140 141 142 143 144

**Applicability:** Use the Composite pattern when
* you want to represent part-whole hierarchies of objects
* you want clients to be able to ignore the difference between compositions of objects and individual objects. Clients will treat all objects in the composite structure uniformly

145
**Real world examples:**
146
* [java.awt.Container](http://docs.oracle.com/javase/6/docs/api/java/awt/Container.html) and [java.awt.Component](http://docs.oracle.com/javase/6/docs/api/java/awt/Component.html)
147 148
* [Apache Wicket](https://github.com/apache/wicket) component tree, see [Component](https://github.com/apache/wicket/blob/91e154702ab1ff3481ef6cbb04c6044814b7e130/wicket-core/src/main/java/org/apache/wicket/Component.java) and [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java)

149
## <a name="decorator">Decorator</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
150
**Intent:** Attach additional responsibilities to an object dynamically. Decorators provide a flexible alternative to subclassing for extending functionality.
I
Ilkka Seppälä 已提交
151

I
Ilkka Seppälä 已提交
152
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/decorator/etc/decorator_1.png "Decorator")
I
Ilkka Seppälä 已提交
153 154 155 156 157 158

**Applicability:** Use Decorator
* to add responsibilities to individual objects dynamically and transparently, that is, without affecting other objects
* for responsibilities that can be withdrawn
* when extension by subclassing is impractical. Sometimes a large number of independent extensions are possible and would produce an explosion of sublasses to support every combination. Or a class definition may be hidden or otherwise unavailable for subclassing

159
## <a name="facade">Facade</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
160 161
**Intent:** Provide a unified interface to a set of interfaces in a subsystem. Facade defines a higher-level interface that makes the subsystem easier to use.

I
Ilkka Seppälä 已提交
162
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/facade/etc/facade_1.png "Facade")
I
Ilkka Seppälä 已提交
163 164 165 166 167 168

**Applicability:** Use the Facade pattern when
* you want to provide a simple interface to a complex subsystem. Subsystems often get more complex  as they evolve. Most patterns, when applied, result in more and smaller classes. This makes the subsystem more reusable and easier to customize, but is also becomes harder to use for clients that don't need to customize it. A facade can provide a simple default view of the subsystem that is good enough for most clients. Only clients needing more customizability will need to look beyond the facade.
* there are many dependencies between clients and the implementation classes of an abstraction. Introduce a facade to decouple the subsystem from clients and other subsystems, thereby promoting subsystem independence and portability.
* you want to layer your subsystems. Use a facade to define an entry point to each subsystem level. If subsystems are dependent, the you can simplify the dependencies between them by making them communicate with each other solely through their facades

169
## <a name="flyweight">Flyweight</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
170
**Intent:** Use sharing to support large numbers of fine-grained objects efficiently.
I
Ilkka Seppälä 已提交
171

I
Ilkka Seppälä 已提交
172
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/flyweight/etc/flyweight_1.png "Flyweight")
I
Ilkka Seppälä 已提交
173 174 175 176 177 178 179 180

**Applicability:** The Flyweight pattern's effectiveness depends heavily on how and where it's used. Apply the Flyweight pattern when all of the following are true
* an application uses a large number of objects
* storage costs are high because of the sheer quantity of objects
* most object state can be made extrinsic
* many groups of objects may be replaced by relatively few shared objects once extrinsic state is removed
* the application doesn't depend on object identity. Since flyweight objects may be shared, identity tests will return true for conceptually distinct objects.

181 182 183
**Real world examples:**
* [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/6/docs/api/java/lang/Integer.html#valueOf%28int%29)

184
## <a name="proxy">Proxy</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
185 186
**Intent:** Provide a surrogate or placeholder for another object to control access to it.

I
Ilkka Seppälä 已提交
187
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/proxy/etc/proxy_1.png "Proxy")
I
Ilkka Seppälä 已提交
188 189

**Applicability:** Proxy is applicable whenever there is a need for a more versatile or sophisticated reference to an object than a simple pointer. here are several common situations in which the Proxy pattern is applicable
L
llitfkitfk 已提交
190

I
Ilkka Seppälä 已提交
191 192 193 194
* a remote proxy provides a local representative for an object in a different address space.
* a virtual proxy creates expensive objects on demand.
* a protection proxy controls access to the original object. Protection proxies are useful when objects should have different access rights.

L
llitfkitfk 已提交
195 196 197 198 199 200 201 202
**Typical Use Case:**

* Control access to another object
* Lazy initialization
* implement logging
* facilitate network connection
* to count references to an object

203 204 205
**Real world examples:**
* [java.lang.reflect.Proxy](http://docs.oracle.com/javase/6/docs/api/java/lang/reflect/Proxy.html)

M
M Saif Asif 已提交
206 207 208
## <a name="service-locator">Service Locator</a> [&#8593;](#list-of-design-patterns)
**Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer.

M
M Saif Asif 已提交
209
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy")
M
M Saif Asif 已提交
210

M
M Saif Asif 已提交
211
**Applicability:** The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensive lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relavant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent.
M
M Saif Asif 已提交
212 213 214

**Typical Use Case:**

M
M Saif Asif 已提交
215
* When network hits are expensive and time consuming
M
M Saif Asif 已提交
216 217
* lookups of services are done quite frequently
* large number of services are being used
L
llitfkitfk 已提交
218

219
## <a name="chain-of-responsibility">Chain of responsibility</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
220
**Intent:** Avoid coupling the sender of a request to its receiver by giving more than one object a chance to handle the request. Chain the receiving objects and pass the request along the chain until an object handles it.
I
Ilkka Seppälä 已提交
221

I
Ilkka Seppälä 已提交
222
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/chain/etc/chain_1.png "Chain of Responsibility")
I
Ilkka Seppälä 已提交
223 224 225 226 227 228

**Applicability:** Use Chain of Responsibility when
* more than one object may handle a request, and the handler isn't known a priori. The handler should be ascertained automatically
* you want to issue a request to one of several objects without specifying the receiver explicitly
* the set of objects that can handle a request should be specified dynamically

229 230 231
**Real world examples:**
* [java.util.logging.Logger#log()](http://docs.oracle.com/javase/6/docs/api/java/util/logging/Logger.html#log%28java.util.logging.Level,%20java.lang.String%29)

232
## <a name="command">Command</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
233
**Intent:** Encapsulate a request as an object, thereby letting you parameterize clients with different requests, queue or log requests, and support undoable operations.
I
Ilkka Seppälä 已提交
234

I
Ilkka Seppälä 已提交
235
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/command/etc/command_1.png "Command")
I
Ilkka Seppälä 已提交
236 237

**Applicability:** Use the Command pattern when you want to
L
llitfkitfk 已提交
238

I
Ilkka Seppälä 已提交
239 240 241 242 243 244
* parameterize objects by an action to perform. You can express such parameterization in a procedural language with a callback function, that is, a function that's registered somewhere to be called at a later point. Commands are an object-oriented replacement for callbacks.
* specify, queue, and execute requests at different times. A Command object can have a lifetime independent of the original request. If the receiver of a request can be represented in an address space-independent way, then you can transfer a command object for the request to a different process and fulfill the request there
* support undo. The Command's execute operation can store state for reversing its effects in the command itself. The Command interface must have an added Unexecute operation that reverses the effects of a previous call to execute. Executed commands are stored in a history list. Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling unexecute and execute, respectively
* support logging changes so that they can be reapplied in case of a system crash. By augmenting the Command interface with load and store operations, you can keep a persistent log of changes. Recovering from a crash involves reloading logged commands from disk and re-executing them with the execute operation
* structure a system around high-level operations build on primitive operations. Such a structure is common in information systems that support transactions. A transaction encapsulates a set of changes to data. The Command pattern offers a way to model transactions. Commands have a common interface, letting you invoke all transactions the same way. The pattern also makes it easy to extend the system with new transactions

L
llitfkitfk 已提交
245 246 247 248 249 250
**Typical Use Case:**

* to keep a history of requests
* implement callback functionality
* implement the undo functionality

251 252 253
**Real world examples:**
* [java.lang.Runnable](http://docs.oracle.com/javase/6/docs/api/java/lang/Runnable.html)

254
## <a name="interpreter">Interpreter</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
255
**Intent:** Given a language, define a representation for its grammar along with an interpreter that uses the representation to interpret sentences in the language.
I
Ilkka Seppälä 已提交
256

I
Ilkka Seppälä 已提交
257
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/interpreter/etc/interpreter_1.png "Interpreter")
I
Ilkka Seppälä 已提交
258 259 260 261 262

**Applicability:** Use the Interpreter pattern when there is a language to interpret, and you can represent statements in the language as abstract syntax trees. The Interpreter pattern works best when
* the grammar is simple. For complex grammars, the class hierarchy for the grammar becomes large and unmanageable. Tools such as parser generators are a better alternative in such cases. They can interpret expressions without building abstract syntax trees, which can save space and possibly time
* efficiency is not a critical concern. The most efficient interpreters are usually not implemented by interpreting parse trees directly but by first translating them into another form. For example, regular expressions are often transformed into state machines. But even then, the translator can be implemented by the Interpreter pattern, so the pattern is still applicable

263
## <a name="iterator">Iterator</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
264
**Intent:** Provide a way to access the elements of an aggregate object sequentially without exposing its underlying representation.
I
Ilkka Seppälä 已提交
265

I
Ilkka Seppälä 已提交
266
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/iterator/etc/iterator_1.png "Iterator")
I
Ilkka Seppälä 已提交
267 268 269 270 271 272

**Applicability:** Use the Iterator pattern
* to access an aggregate object's contents without exposing its internal representation
* to support multiple traversals of aggregate objects
* to provide a uniform interface for traversing different aggregate structures

273
## <a name="mediator">Mediator</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
274
**Intent:** Define an object that encapsulates how a set of objects interact. Mediator promotes loose coupling by keeping objects from referring to each other explicitly, and it lets you vary their interaction independently.
I
Ilkka Seppälä 已提交
275

I
Ilkka Seppälä 已提交
276
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/mediator/etc/mediator_1.png "Mediator")
I
Ilkka Seppälä 已提交
277 278 279 280 281 282

**Applicability:** Use the Mediator pattern when
* a set of objects communicate in well-defined but complex ways. The resulting interdependencies are unstructured and difficult to understand
* reusing an object is difficult because it refers to and communicates with many other objects
* a behavior that's distributed between several classes should be customizable without a lot of subclassing

283
## <a name="memento">Memento</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
284 285
**Intent:** Without violating encapsulation, capture and externalize an object's internal state so that the object can be restored to this state later.

I
Ilkka Seppälä 已提交
286
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/memento/etc/memento_1.png "Memento")
I
Ilkka Seppälä 已提交
287 288 289 290 291

**Applicability:** Use the Memento pattern when
* a snapshot of an object's state must be saved so that it can be restored to that state later, and
* a direct interface to obtaining the state would expose implementation details and break the object's encapsulation

S
Stamatis Pitsios 已提交
292

293
## <a name="observer">Observer</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
294
**Intent:** Define a one-to-many dependency between objects so that when one object changes state, all its dependents are notified and updated automatically.
I
Ilkka Seppälä 已提交
295

I
Ilkka Seppälä 已提交
296
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/observer/etc/observer_1.png "Observer")
I
Ilkka Seppälä 已提交
297 298

**Applicability:** Use the Observer pattern in any of the following situations
L
llitfkitfk 已提交
299

I
Ilkka Seppälä 已提交
300 301 302 303
* when an abstraction has two aspects, one dependent on the other. Encapsulating these aspects in separate objects lets you vary and reuse them independently
* when a change to one object requires changing others, and you don't know how many objects need to be changed
* when an object should be able to notify other objects without making assumptions about who these objects are. In other words, you don't want these objects tightly coupled

L
llitfkitfk 已提交
304 305 306 307 308
**Typical Use Case:**

* changing in one object leads to a change in other objects


309
## <a name="state">State</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
310
**Intent:** Allow an object to alter its behavior when its internal state changes. The object will appear to change its class.
I
Ilkka Seppälä 已提交
311

I
Ilkka Seppälä 已提交
312
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/state/etc/state_1.png "State")
I
Ilkka Seppälä 已提交
313 314 315 316 317

**Applicability:** Use the State pattern in either of the following cases
* an object's behavior depends on its state, and it must change its behavior at run-time depending on that state
* operations have large, multipart conditional statements that depend on the object's state. This state is usually represented by one or more enumerated constants. Often, several operations will contain this same conditional structure. The State pattern puts each branch of the conditional in a separate class. This lets you treat the object's state as an object in its own right that can vary independently from other objects.

318
## <a name="strategy">Strategy</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
319 320
**Intent:** Define a family of algorithms, encapsulate each one, and make them interchangeable. Strategy lets the algorithm vary independently from clients that use it.

I
Ilkka Seppälä 已提交
321
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/strategy/etc/strategy_1.png "Strategy")
I
Ilkka Seppälä 已提交
322 323 324 325 326 327 328

**Applicability:** Use the Strategy pattern when
* many related classes differ only in their behavior. Stratefies provide a way to configure a class eith one of many behaviors
* you need different variants of an algorithm. for example, you migh define algorithms reflecting different space/time trade-offs. Strategies can be used when these variants are implemented as a class hierarchy of algorithms
* an algorithm uses data that clients shouldn't know about. Use the Strategy pattern to avoid exposing complex, algorithm-specific data structures
* a class defines many behaviors, and these appear as multiple conditional statements in its operations. Instead of many conditionals, move related conditional branches into their own Strategy class

329
## <a name="template-method">Template method</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
330 331
**Intent:** Define the skeleton of an algorithm in an operation, deferring some steps to subclasses. Template method lets subclasses redefine certain steps of an algorithm without changing the algorithm's structure.

I
Ilkka Seppälä 已提交
332
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/template-method/etc/template-method_1.png "Template Method")
I
Ilkka Seppälä 已提交
333 334 335 336 337 338

**Applicability:** The Template Method pattern should be used
* to implement the invariant parts of an algorithm once and leave it up to subclasses to implement the behavior that can vary
* when common behavior among subclasses should be factored and localized in a common class to avoid code duplication. This is good example of "refactoring to generalize" as described by Opdyke and Johnson. You first identify the differences in the existing code and then separate the differences into new operations. Finally, you replace the differing code with a template method that calls one of these new operations
* to control subclasses extensions. You can define a template method that calls "hook" operations at specific points, thereby permitting extensions only at those points

339
## <a name="visitor">Visitor</a> [&#8593;](#list-of-design-patterns)
I
Ilkka Seppälä 已提交
340
**Intent:** Represent an operation to be performed on the elements of an object structure. Visitor lets you define a new operation without changing the classes of the elements on which it operates.
I
Ilkka Seppälä 已提交
341

I
Ilkka Seppälä 已提交
342
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/visitor/etc/visitor_1.png "Visitor")
I
Ilkka Seppälä 已提交
343 344 345 346 347

**Applicability:** Use the Visitor pattern when
* an object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes
* many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
* the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
348

349 350 351
**Real world examples:**
* [Apache Wicket](https://github.com/apache/wicket) component tree, see [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java)

352 353 354 355 356 357 358 359 360
## <a name="model-view-presenter">Model-View-Presenter</a> [&#8593;](#list-of-design-patterns)
**Intent:** Apply a "Separation of Concerns" principle in a way that allows developers to build and test user interfaces.

![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/model-view-presenter/etc/model-view-presenter_1.png "Model-View-Presenter")

**Applicability:** Use the Model-View-Presenter in any of the following situations
* when you want to improve the "Separation of Concerns" principle in presentation logic
* when a user interface development and testing is necessary.

361
## <a name="double-checked-locking">Double Checked Locking</a> [&#8593;](#list-of-design-patterns)
362
**Intent:** Reduce the overhead of acquiring a lock by first testing the locking criterion (the "lock hint") without actually acquiring the lock. Only if the locking criterion check indicates that locking is required does the actual locking logic proceed.
363

I
Ilkka Seppälä 已提交
364
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking_1.png "Double Checked Locking")
365

366 367 368
**Applicability:** Use the Double Checked Locking pattern when
* there is a concurrent access in object creation, e.g. singleton, where you want to create single instance of the same class and checking if it's null or not maybe not be enough when there are two or more threads that checks if instance is null or not.
* there is a concurrent access on a method where method's behaviour changes according to the some constraints and these constraint change within this method.
369

I
Ilkka Seppälä 已提交
370
## <a name="servant">Servant</a> [&#8593;](#list-of-design-patterns)
P
Petros G. Sideris 已提交
371 372
**Intent:** Servant is used for providing some behavior to a group of classes. Instead of defining that behavior in each class - or when we cannot factor out this behavior in the common parent class - it is defined once in the Servant.

373
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/servant/etc/servant-pattern.png "Servant")
P
Petros G. Sideris 已提交
374 375 376 377 378

**Applicability:** Use the Servant pattern when
* When we want some objects to perform a common action and don't want to define this action as a method in every class.


379 380 381
# Frequently asked questions

**Q: What is the difference between State and Strategy patterns?**
I
Ilkka Seppälä 已提交
382 383

While the implementation is similar they solve different problems. The State pattern deals with what state an object is in - it encapsulates state-dependent behavior. The Strategy pattern deals with how an object performs a certain task - it encapsulates an algorithm.
384 385

**Q: What is the difference between Strategy and Template Method patterns?**
I
Ilkka Seppälä 已提交
386 387

In Template Method the algorithm is chosen at compile time via inheritance. With Strategy pattern the algorithm is chosen at runtime via composition.
I
Ilkka Seppälä 已提交
388 389 390 391

**Q: What is the difference between Proxy and Decorator patterns?**

The difference is the intent of the patterns. While Proxy controls access to the object Decorator is used to add responsibilities to the object.
392 393 394 395 396



# How to contribute

I
Ilkka Seppälä 已提交
397
**To add a new pattern** you need to do the following steps:
I
Ilkka Seppälä 已提交
398

399 400
1. Fork the repository.
2. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation.
I
Ilkka Seppälä 已提交
401
3. Create a simple class diagram from your example code.
402 403
4. Add description of the pattern in README.md and link to the class diagram.
5. Create a pull request.
I
Ilkka Seppälä 已提交
404

I
Ilkka Seppälä 已提交
405 406 407
**To edit the existing UML diagrams** you need one of the following:
- [GenMyModel](http://genmymodel.com/)
- [ObjectAid UML Explorer for Eclipse](http://www.objectaid.com/home)
I
Ilkka Seppälä 已提交
408

I
Ilkka Seppälä 已提交
409
**For inspiration** there is a good list of design patterns at [Wikipedia](http://en.wikipedia.org/wiki/Software_design_pattern).
I
Ilkka Seppälä 已提交
410

I
Ilkka Seppälä 已提交
411
**Links to patterns applied in real world applications** are welcome. The links should be added to the corresponding section of the `README.md`.
I
Ilkka Seppälä 已提交
412

I
Ilkka Seppälä 已提交
413 414


I
Ilkka Seppälä 已提交
415 416
# Credits

I
Ilkka Seppälä 已提交
417 418
* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
* [Effective Java (2nd Edition)](http://www.amazon.com/Effective-Java-Edition-Joshua-Bloch/dp/0321356683)
419
* [Java Generics and Collections](http://www.amazon.com/Java-Generics-Collections-Maurice-Naftalin/dp/0596527756/)
420
* [Let’s Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf)
I
Ilkka Seppälä 已提交
421 422 423



I
Ilkka Seppälä 已提交
424 425
# License

I
Ilkka Seppälä 已提交
426
This project is licensed under the terms of the MIT license.