Merge pull request #321 from hwanghe159/item55

[#55][2기] 옵셔널 반환은 신중히 하라

Author: ksy90101

8장/55_옵셔널_반환은_신중히_하라_황준호.md

@@ -0,0 +1,134 @@
+## 아이템55. 옵셔널 반환은 신중히 하라
+
+### 어느 메서드가 값을 반환할 수 없을 때?
+
+- 자바8 이전엔..
+
+  1. 예외를 던진다
+
+     But..
+
+     - 예외는 진짜 예외적인 상황에서만 사용해야 한다
+     - 예외를 생성할 때 스택 추적 전체를 캡쳐하므로 비용이 크다
+
+  2. null을 반환한다
+
+     But..
+
+     - `null`을 반환하는 메서드를 호출할 때는 별도의 `null`처리 코드를 추가해야 한다 -> 전혀 상관없는 코드에 NPE가 발생할 수 있다
+
+- 자바8 이후엔 `Optional`
+
+### `Optional<T>`란?
+
+- 원소를 최대 1개 가질 수 있는 불변 컬렉션
+- `null`이 아닌 T타입 참조를 하나 담거나("비지 않았다") 아무것도 담지 않을 수 있다("비었다")
+- 보통은 T를 반환해야 하지만 특정 조건에서는 아무것도 반환하지 않아야 할 때 T대신 `Optional<T>`를 반환하도록 선언하면 된다
+- 장점
+  - 옵셔널을 반환하면 예외를 던지는 것보다 유연하고 사용하기 쉽다. 
+  - `null`을 반환하는 것보다 오류가능성이 적다
+
+### `Optional`을 생성하는 법
+
+- `Optional.empty()` : 빈 옵셔널
+- `Optional.of(value)` : 값이 든 옵셔널 (value에 `null`을 넣으면 NPE를 던진다)
+- `Optional.ofNullable(value)` : value가 `null`이면 빈 옵셔널
+- 옵셔널을 반환하는 메서드에서는 절대로 `null`을 반환하지 말자.
+
+### 언제 null을 반환하거나 예외를 던지는 것보단 `Optional`을 반환하는 게 더 좋을까?
+
+- 반환값이 없을수도 있음을 API 사용자에게 명확히 알려주고 싶을때
+- 클라이언트에게 빈 옵셔널일때의 행동을 정의하도록 강제하고 싶을때
+
+### 옵셔널을 반환하는 메서드를 사용하는 클라이언트에서는..
+
+```java
+public class Person {
+  private final String name;
+  private final int age;
+  // 생성자, getter 생략
+}
+```
+
+```java
+//인자에 아무것도 주어지지 않으면 빈 옵셔널 반환, 주어지면 age가 가장 큰 Person을 담은 옵셔널 반환
+public Optional<Person> pickOldest(Person... people) {
+  return Arrays.stream(people)
+      .max(Comparator.comparingInt(Person::getAge));
+}
+```
+
+1. 기본값을 정해둘 수 있다
+
+   ```java
+   Person oldest = pickOldest(person1, person2, person3)
+       .orElse(new Person("기본이름", 0));
+   ```
+
+   ```java
+   //기본값을 생성하는 비용이 큰 경우 orElseGet을 사용할 수도 있다
+   Person oldest = pickOldest(person1, person2, person3)
+       .orElseGet(() -> new Person("기본이름", 0));
+   ```
+
+2. 원하는 예외를 던질 수 있다
+
+   ```java
+   Person oldest = pickOldest(person1, person2, person3)
+       .orElseThrow(() -> new RuntimeException());
+   ```
+
+   실제 예외가 아니라 팩터리를 건넸으므로 예외가 실제로 발생하지 않는다면 예외 생성 비용은 들지 않는다
+
+3. 값이 채워있다고 가정하고 그냥 값을 꺼낸다
+
+   ```java
+   Person oldest = pickOldest(person1, person2, person3).get();
+   ```
+
+   빈 옵셔널이라면 `NoSuchElementException`이 발생한다
+
+4. 그 외에도 `filter`, `map`, `flatMap`, `ifPresent` 등 여러 메서드도 있다
+
+### `isPresent()`는 대부분의 경우 다른 메서드로 대체 가능하다
+
+가장 나이많은 사람의 이름을 출력하고 싶을때..
+
+```java
+Optional<Person> oldest = pickOldest(person1, person2, person3);
+
+//not good
+System.out.println("가장 나이많은 사람은? " + (oldest.isPresent() ? oldest.get().getName() : "결과없음"));
+//good
+System.out.println("가장 나이많은 사람은? " + (oldest.map(p -> p.getName()).orElse("결과없음")));
+```
+
+`isPresent()` 후 `get()` 하는것보단 `map()`을 사용하는게 더 짧고 명확하고 용법에 맞다.
+
+### 옵셔널의 스트림
+
+`Stream<Optional<T>>`에서 채워진 옵셔널만을 뽑아서 `Stream<T>`로 만들고 싶을때..
+
+```java
+//not good (자바8)
+Stream<Person> personStream = streamOfOptionals
+  .filter(Optional::isPresent)
+  .map(Optional::get);
+
+//good (자바9 이상)
+Stream<Person> personStream = streamOfOptionals
+  .flatMap(Optional::stream);
+```
+
+### 주의사항
+
+- 컬렉션, 스트림, 배열, 옵셔널같은 컨테이너 타입은 옵셔널로 감싸면 안된다.
+  - `Optional<List<T>>` 보단 빈 `List<T>`을 반환하는 게 좋다
+  - 그러면 클라이언트에서 옵셔널 처리 코드를 넣지 않아도 된다
+- 박싱된 기본타입(`Integer`, `Long`, `Double`)을 담은 옵셔널을 반환하면 안된다.
+  - 박싱된 기본타입을 담는 옵셔널은 기본 타입 자체보다 무겁기 때문에 자바 API 설계자는 기본타입 전용 옵셔널을 이미 만들어놨다.
+  - `OptionalInt`, `OptionalLong`, `OptionalDouble`을 사용하자
+  - 덜 중요한 기본타입용(`Boolean`, `Byte`, `Character`, `Short`, `Float`)은 제외
+- 옵셔널을 컬렉션의 키, 값, 원소나 배열의 원소로 사용하는 게 적절한 상황은 거의 없다
+  - 예를 들어 옵셔널을 맵의 값으로 사용한다면 쓸데없이 복잡성만 높아진다
+- 옵셔널을 인스턴스 필드에 저장하는 건 대부분 안좋지만 필수가 아닌 필드에 경우엔 적절한 상황도 있다