Improve Builder Javadoc
This commit is contained in:
parent
cdd586ec7c
commit
9a08e35101
@ -4,7 +4,20 @@ import com.iluwatar. builder.Hero.HeroBuilder;
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
*
|
*
|
||||||
* This is the Builder pattern variation as described by Joshua Bloch in
|
* The intention of the Builder pattern is to find a solution to the telescoping
|
||||||
|
* constructor anti-pattern. The telescoping constructor anti-pattern occurs when the
|
||||||
|
* increase of object constructor parameter combination leads to an exponential list
|
||||||
|
* of constructors. Instead of using numerous constructors, the builder pattern uses
|
||||||
|
* another object, a builder, that receives each initialization parameter step by step
|
||||||
|
* and then returns the resulting constructed object at once.
|
||||||
|
* <p>
|
||||||
|
* The Builder pattern has another benefit. It can be used for objects that contain
|
||||||
|
* flat data (html code, SQL query, X.509 certificate...), that is to say, data that
|
||||||
|
* can't be easily edited. This type of data cannot be edited step by step and must
|
||||||
|
* be edited at once. The best way to construct such an object is to use a builder
|
||||||
|
* class.
|
||||||
|
* <p>
|
||||||
|
* In this example we have the Builder pattern variation as described by Joshua Bloch in
|
||||||
* Effective Java 2nd Edition.
|
* Effective Java 2nd Edition.
|
||||||
* <p>
|
* <p>
|
||||||
* We want to build {@link Hero} objects, but its construction is complex because of the
|
* We want to build {@link Hero} objects, but its construction is complex because of the
|
||||||
|
Loading…
x
Reference in New Issue
Block a user