item 1 leekyunghee - JAVA-JIKIMI/EFFECTIVE-JAVA3 GitHub Wiki

• 클래스의 인스턴스를 얻는 수단은 두가지

1. public 생성자를 사용
2. 정적 팩토리 메소드를 사용

• 클래스는 생성자와 별도로 정적 팩터리 메서드를 제공할 수 있다.

public static Boolean valueOf(boolean b) {
    return b? Boolean.TRUE : Boolean.False;
}

참고로 정적 팩토리 메서드는 디자인 패턴에서의 팩토리 메서드와는 무관하다.

1. 생성자에 넘기는 매개변수와 생성자 자체만으로는 반환될 객체의 특성을 제대로 설명하지 못한다. 반면 정적 팩토리는 반환된 객체의 특성을 쉽게 묘사할 수 있다.

BigInteger(int, int, Random)

BigInteger.probablePrime (자바 4+)

• 둘중 어느쪽이 값이 소수인 BigInteger를 반환한다 는 의미를 더 잘 설명할 것 같은지 생각해보자.

• 아래와 같이 생성자가 동일하게 여러가지 썼을 때 의도가 드러나지 않는다.

BigInt()  -> 기본 생성자 
BigInt(int t)
BigInt(float f) 

• 생성자는 이름을 가질 없으나 메소드는 이름을 가질 수 있음
• 생성자는 정적이 아니므로 메소드는 정적이어야 함
• static factory method를 쓸 경우에 보통 생성자를 private로 바꾸고 객체 생성을 막는다. -> 객체를 직접 생성할 수 없게 만든다.

2. 하나의 시그니처로는 생성자 하나만 만들 수 있다. 입력 매개변수들의 순서를 다르게 한 생성자를 새로 추가하는 식으로 이 제한을 피해볼 수도 있지만 좋지 않다.

그런 API를 사용하는 개발자는 각 생성자가 어떤 역할을 하는지 정확히 기억하기 어려워 엉뚱한 것을 호출하는 실수를 할 수 있다.

생성자를 정적 팩토리 메서드로 바꾸고 각각의 차이를 잘 들어내는 이름을 지어주자.

• 변수 어딘가에 저장하고 있으며 캐싱하고 있다.

1. 불변클래스(item 17)는 인스턴스를 미리 만들어 놓거나 새로 생성한 인스턴스를 캐싱하여 재활용 하는 식으로 불필요한 객체 생성을 피할 수 있다.

Boolean.valueOf(boolean) 메서드는 객체를 아예 생성하지 않는다. 생성 비용이 크고 같은 객체가 자주 요청되는 상황이라면 성능을 상당히 끌어올려준다.(플라이 웨이트 패턴 비슷한 내용 참고)

2. 반복되는 요청에 같은 객체를 반환하는 식 : 정적 팩터리 방식의 클래스는 언제 어느 인스턴스를 살아 있게 할지를 철저히 통제할 수 있다

인스턴스 통제(instance-controlled)를 하는 이유는 무엇일까?

• 인스턴스를 통제하면 클래스를 싱글턴으로 만들 수도, 인스턴스화 불가로 만들 수도 있다.
• 불변값 클래스(item17)에서 동치인 인스턴스가 단 하나뿐임을 보장할 수 있다. a == b일때만 a.equals(b)가 성립
• 인스턴스 통제는 플라이웨이트 패턴의 근간이 되며 열거 타입(item34)은 인스턴스가 하나만 만들어짐을 보장한다.

1. 반환할 객체의 클래스를 자유롭게 선택할 수 있게 하는 엄청난 유연성을 제공

API를 만들 때 이러한 유연성을 응용하면 구현 클레스를 공개하지 않고도 그 객체를 반환할 수 있어 API를 작게 유지할 수 있다. 이는 인터페이스를 정적 팩토리 메서드의 반환 타입으로 사용하는 인터페이스 기반 프레임워크(아이템20)을 만드는 핵심 기술이기도 하다.

2. 자바 8부터는 인터페이스가 정적 메서드를 가질 수 없다는 제한이 풀렸기 때문에 인스턴스화 불가 동반 클래스를 둘 이유가 없다.

동반 클래스에 두었던 public 정적 멤버들 상당수를 그냥 인터페이스 자체에 두면 되는 것이다.

자바 8 - 인터페이스에는 public 정적 멤버만 허용

자바 9 - private 정적 메서드, 정적 필드와 정적 멤버 클래스는 public

• 인자에 따라서 (팩토리패턴) A 타입일 경우 A 클래스 B 타입일 경우 B클래스 반환
• 매개변수에 따라서 다른 클래스를 반환한다. (다형성)

1. 반환 타입의 하위 타입(상속받은 - 다형성) 이기만 하면 어떤 클래스의 객체를 반환 하던지 상관없다. (인터페이스를 상속을 받던)

EnumSet 클래스(아이템 36) - (상위 클래스를 말함) 는 public 생성자 없이 오직 정적 팩터리만 제공하는데 원소의 수에 따라 두가지 하위 클래스 중 하나의 인스턴스를 반환한다.

원소가 64개 이하면 원소들을 long 변수 하나로 관리하는 RegularEnumSet의 인스턴스를, 65개 이상이면 long 배열로 관리하는 JumboEnumSet의 인스턴스를 반환한다.

  /**
     * @description public 생성자 없이 정적 팩토리만 제공
     *              입력 매개 변수에 따라 매번 다른 클래스의 객체를 반환
     * @param num
     * @return
     */
    public static EnumSet getInstance(int num)  {
        if (num < 64) {
            return new RegularEnumSet();
        } else if (num > 65) {
            return new JumboEnumSet();    // 미리 new 한 객체가 없고 반환 시점에 new 
        }

        throw new IllegalArgumentException();

    }

• 미리 만들어 놓지 않고 필요한 시점에 객체를 만든다.

서비스 제공자 프레임워크(service provider framework) 를 만드는 근간

서비스 제공자는 반환되는 클래스가 존재하는 애가 아님 - 반환할 클래스가 이미 존재하지 않아도 됨.

provider - 서비스의 기능을 제공

반환하는 객체(RegularEnumSet, JumboEnumSet) 가 구현체이다.

서비스 제공자가 실제 구현체이다.

• 서비스 제공자 프레임워크는 3개의 핵심 컴포넌트로 이뤄진다.
• 서비스 인터페이스 (service interface)
• 제공자가 구현체를 등록할 때 사용하는 제공자 등록 API (provider registration API)
• 클라이언트가 서비스의 인스턴스를 인스턴스를 얻을 때 사용하는 서비스 접근 API (service access API)

종종 서비스 제공자 인터페이스 (service provider interface)

• JDBC 에서는 Connection이 서비스 인터페이스 역할
• DriverManager.registerDriver가 제공자 등록 API 역할
• DriverManager.getConnection이 서비스 접근 API 역할
• Driver가 서비스 제공자 인터페이스 역할을 수행

• 기본 생성자가 private 일 경우 상속 불가 이므로

• 팩토리 패턴이나 싱글톤을 쓸 경우 관례처럼 사용되는 메서드 명명 규칙을 따르자.

from
   매개변수를 하나 받아서 해당 타입의 인스턴스를 반환하는 형변환 메서드 
   Date d = Date.from(instant);   

of
   여러 매개변수를 받아 적합한 타입의 인스턴스를 반환하는 집계 메서드
   Set<Rank> faceCards = EnumSet.of(JACK, QUEEN, KING);    

valueOf
   from과 of의 더 자세한 버전 
   BigInteger prime = BigInteger.valueOf(Integer.MAX_VALUE); 

instance / getInstance 
   (매개변수를 받는다면) 매개변수로 명시한 인스턴스를 반환하지만 같은 인스턴스 임을 보장하지 않는다. 
   StackWalker luke = StackWalker.getInstance(options);    

create / newInstance 
   instance 혹은 getInstance와 같지만 매번 사로운 인스턴스를 생성해 반환함을 보장한다. 
   Object newArray = Array.newInstance(classObject, arrayLen);  

getType 
   getInstance와 같으나, 생성할 클래스가 아닌 다른 클래스에 팩터리 메서드를 정의할 때 쓴다. "Type"은 팩터리 메서드가 반환할 객체의 타입이다. 
   FileStore fs = Files.getFileStore(path);   

newType
   newInstance와 같으나, 생성할 클래스가 아닌 다른 클래스에 팩터리 메서드를 정의할 때 쓴다. "Type"은 팩터리 메서드가 반환할 객체의 타입이다.    
   BufferedReader br = Files.newBufferedReader(path);    

type
   getType과 newType의 간결한 버전
   List<Complaint> litany = Collections.list(legacyLitany);

핵심 정리

정적 팩토리 메서드가 유리한점이 많으므로 무작정 public 생성자를 제공하던 습관이 있다면 고치자.