item-2 생성자에 매개변수가 많다면 빌더를 고려하라

src/README.md

@@ -1,5 +1,4 @@
 #### item-1 생성자 대신 정적 팩터리 메서드를 고려하라
-###### 문제점
 ###### 정리
     일반 생성자 대신 정적 팩터리 메서드를 사용 했을 때의 장단점
 
@@ -38,7 +37,39 @@
         없으면 만들고, 만들어져있다면 해당 객체를 공유하는 식으로 객체를 구성하는 방법
         https://know-one-by-one.tistory.com/44
         
+#### item-2 생성자에 매개변수가 많다면 빌더를 고려하라
+###### 정리
+    정적 팩터리와 생성자 둘 다 가지고 있는 제약은 매개변수가 많을 때에 대응하기 어렵다는 것이다.
+    점층적 생성자 패턴도 쓸 수는 있지만, 매개변수 개수가 많아지면 클라이언트 코드를 작성하거나 읽기 어렵다.
+
+    자바빈즈 패턴은 매개변수가 없는 생성자로 객체를 만든 후, 세터 메서드를 통해 원하는 매개변수의 값을 결정하는 방식이다.
+    자바빈즈 패턴의 단점은 객체하나를 만들려면 메서드를 여러번 호출해야 하고,
+    객체가 완전히 생성되기 전까지는 일관성 ( 매개변수의 유효성 ) 이 무너진 상태에 놓이게 된다.
+    이 단점을 보완하고자 생성이 끝난 객체를 얼리는 ( freezing ) 방법을 사용했는데 실제로 프로그래머가 이 메서드를 호출했는지
+    컴파일러는 알 수 있는 방법이 없다.
+
+    그래서 나온 것이 빌더 패턴이다.
+    빏더 패턴은 필수 매개변수 만으로 생성자를 호출하여 빌더 객체를 얻는다.
+    그 이후 빌더 객체가 제공하는 메서드들로 원하는 선택 매개 변수를 설정한다.
+    마지막으로 빌드 메서드를 호출해 객체를 생성한다.
+
+```java
+class Main{
+    NutritionFacts cocaCola = new NutritionFacts.Builder(240, 8)
+            .calories(100).sodium(35).carbohydrate(27).build();
+}
+```
+    빌더 패턴은 계층적으로 설계된 클래스와 함께 쓰기에 좋다.
+    하위 클래스의 메서드가 상위 클래스의 메서드가 정의한 반환 타입이 아닌,
+    그 하위 타입을 반환하는 기능을 *공변 반환 타이핑 이라 한다.
+
+    빌더를 사용하면 가변인수 매개변수를 여러개 사용할 수 있다.
+    빌더 패턴은 빌더 하나로 여러 객체를 순회하면서 만들 수 있고, 빌더에 넘기는 매개변수에 따라 다른 객체를 만들 수도 있다.
+
+###### 내용 추가
+    *공변 반환 타입 :
+        리턴 타입은 서브클래스라는 범위 안에서 다양할 수 있다.
+
 #### item-1
-###### 문제점
 ###### 정리
 ###### 내용 추가

src/item2/Calzone.java

@@ -0,0 +1,33 @@
+package item2;
+
+/**
+ * @author lokie on 2020/06/29
+ */
+public class Calzone extends Pizza {
+    private final boolean sauceInside;
+
+    public static class Builder extends Pizza.Builder<Builder> {
+
+        private boolean sauceInside = false;
+
+        public Builder sauceInside() {
+            sauceInside = true;
+            return this;
+        }
+
+        @Override
+        Calzone build() {
+            return new Calzone(this);
+        }
+
+        @Override
+        protected Builder self() {
+            return this;
+        }
+    }
+
+    private Calzone(Builder builder) {
+        super(builder);
+        sauceInside = builder.sauceInside;
+    }
+}

src/item2/Main.java

@@ -0,0 +1,13 @@
+package item2;
+
+/**
+ * @author lokie on 2020/06/29
+ */
+public class Main {
+    NutritionFacts cocaCola = new NutritionFacts.Builder(240, 8)
+            .calories(100).sodium(35).carbohydrate(27).build();
+
+    NyPizza nyPizza = new NyPizza.Builder(NyPizza.Size.SMALL)
+            .addTopping(Pizza.Topping.SAUSAGE).addTopping(Pizza.Topping.ONION).build();
+    Calzone calzone = new Calzone.Builder().addTopping(Pizza.Topping.HAM).sauceInside().build();
+}

src/item2/NutritionFacts.java

@@ -0,0 +1,63 @@
+package item2;
+
+/**
+ * @author lokie on 2020/06/29
+ */
+public class NutritionFacts {
+    private final int servingSize;
+    private final int servings;
+    private final int calories;
+    private final int fat;
+    private final int sodium;
+    private final int carbohydrate;
+
+    public static class Builder {
+        // 필수
+        private final int servingSize;
+        private final int servings;
+
+        // 필수 아닌 것은 초기화
+        private int calories = 0;
+        private int fat = 0;
+        private int sodium = 0;
+        private int carbohydrate = 0;
+
+        public Builder(int servingSize, int servings) {
+            this.servingSize = servingSize;
+            this.servings = servings;
+        }
+
+        public Builder calories(int val) {
+            this.calories = val;
+            return this;
+        }
+
+        public Builder fat(int val) {
+            this.fat = val;
+            return this;
+        }
+
+        public Builder sodium(int val) {
+            this.sodium = val;
+            return this;
+        }
+
+        public Builder carbohydrate(int val) {
+            this.carbohydrate = val;
+            return this;
+        }
+
+        public NutritionFacts build(){
+            return new NutritionFacts(this);
+        }
+    }
+
+    private NutritionFacts(Builder builder){
+        this.servingSize = builder.servingSize;
+        this.servings = builder.servings;
+        this.calories = builder.calories;
+        this.fat = builder.fat;
+        this.sodium = builder.sodium;
+        this.carbohydrate = builder.carbohydrate;
+    }
+}

src/item2/NyPizza.java

@@ -0,0 +1,42 @@
+package item2;
+
+import java.util.Objects;
+
+/**
+ * @author lokie on 2020/06/29
+ */
+public class NyPizza extends Pizza {
+    public enum Size {
+        SMALL,
+        MEDIUM,
+        LARGE,
+        ;
+    }
+
+    private final Size size;
+
+    public static class Builder extends Pizza.Builder<Builder> {
+
+        private final Size size;
+
+        public Builder(Size size) {
+            this.size = Objects.requireNonNull(size);
+        }
+
+        @Override
+        NyPizza build() {
+            return new NyPizza(this);
+        }
+
+        @Override
+        protected Builder self() {
+            return this;
+        }
+    }
+
+    private NyPizza(Builder builder) {
+        super(builder);
+        size = builder.size;
+    }
+
+}

src/item2/Pizza.java

@@ -0,0 +1,38 @@
+package item2;
+
+import java.util.EnumSet;
+import java.util.Objects;
+import java.util.Set;
+
+/**
+ * @author lokie on 2020/06/29
+ */
+public abstract class Pizza {
+    public enum Topping {
+        HAM,
+        MUSHROOM,
+        ONION,
+        PEPPER,
+        SAUSAGE,
+        ;
+    }
+
+    final Set<Topping> toppings;
+
+    abstract static class Builder<T extends Builder<T>> {
+        EnumSet<Topping> toppings = EnumSet.noneOf(Topping.class);
+
+        public T addTopping(Topping topping) {
+            toppings.add(Objects.requireNonNull(topping));
+            return self();
+        }
+
+        abstract Pizza build();
+
+        protected abstract T self();
+    }
+
+    Pizza(Builder<?> builder) {
+        toppings = builder.toppings.clone();
+    }
+}