java-design-patterns/builder/README.md

---
layout: pattern
title: Builder
folder: builder
permalink: /patterns/builder/
categories: Creational
tags:
 - Java
 - Gang Of Four
 - Difficulty-Intermediate
---

## Intent
Separate the construction of a complex object from its
representation so that the same construction process can create different
representations.

![alt text](./etc/builder_1.png "Builder")

## 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
* the construction process must allow different representations for the object that's constructed

## Real world examples

* [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html)
* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder)

## Credits

* [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)
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`---`
			`layout: pattern`
			`title: Builder`
			`folder: builder`
Work towards #56: Add permalink to every pattern This makes cleaner URLs thanks to jekyll 2015-08-15 18:03:05 +02:00			`permalink: /patterns/builder/`
Work on #213 - properly categorize all patterns - remove pattern list from readme - minor fixes to readme - removed "introduction" because its not a pattern and an error i committed some time ago 2015-08-20 21:40:07 +02:00			`categories: Creational`
Work on #226, #213, added references of Gang Of Four to all GoF patterns, added tag for Gang Of Four, added difficulty tags to some of them 2015-09-22 18:25:56 +05:30			`tags:`
			`- Java`
			`- Gang Of Four`
Categorize and tag all patterns #213 2015-12-28 15:52:44 +02:00			`- Difficulty-Intermediate`
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`---`

Use headings instead of bold text in index.md #238 2016-01-03 21:14:30 +01:00			`## Intent`
			`Separate the construction of a complex object from its`
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`representation so that the same construction process can create different`
			`representations.`

			`![alt text](./etc/builder_1.png "Builder")`

Use headings instead of bold text in index.md #238 2016-01-03 21:14:30 +01:00			`## Applicability`
			`Use the Builder pattern when`
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00
			`* the algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled`
			`* the construction process must allow different representations for the object that's constructed`

Use headings instead of bold text in index.md #238 2016-01-03 21:14:30 +01:00			`## Real world examples`
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00
			`* [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html)`
Work towards #56: Add permalink to every pattern This makes cleaner URLs thanks to jekyll 2015-08-15 18:03:05 +02:00			`* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder)`
Work on #226, #213, added references of Gang Of Four to all GoF patterns, added tag for Gang Of Four, added difficulty tags to some of them 2015-09-22 18:25:56 +05:30
Use headings instead of bold text in index.md #238 2016-01-03 21:14:30 +01:00			`## Credits`
Work on #226, #213, added references of Gang Of Four to all GoF patterns, added tag for Gang Of Four, added difficulty tags to some of them 2015-09-22 18:25:56 +05:30
			`* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)`
Work on #226, moved pattern specific references to respective patterns. And removed credits section from Home page. 2016-01-27 12:55:59 +05:30			`* [Effective Java (2nd Edition)](http://www.amazon.com/Effective-Java-Edition-Joshua-Bloch/dp/0321356683)`