[Java] Effective Java, 객체 생성과 삭제

Cover image

객체 생성과 삭제

Item 1. 생성자 대신 정적 팩토리 메서드 고려

정적 팩토리 메서드의 장점

다음과 같이 정적 팩토리 메서드를 통해 생성할 수 있습니다.

Set<Rank> faceCards = EnumSet.of(JACK, QUEEN, KING);
BigInteger prime = BigInteger.valueOf(Integer.MAX_VALUE);
StackWalker luke = StackWalker.getInstance(options);

1. 정적 팩토리 메서드의 한 가지 장점은 생성자와 달리 이름이 존재합니다.

  • 정적 팩토리가 사용하기 쉽고, 읽기 쉬운 클라이언트 코드를 제공합니다.
  • 여러 생성자가 필요하다고 판단되면, 정적 팩토리 메서드를 사용하는 것이 좋습니다.

2. 생성자와 달리 호출될 때마다 새 개체를 만들 필요가 없습니다.

  • 생성된 인스턴스를 캐시하고 불필요한 중복 객체 생성을 방지하고 반복적으로 분배 가능합니다.
  • 반복 된 호출에서 동일한 객체를 반환하는 정적 팩토리 메서드의 기능을 통해 클래스는 언제든지 존재하는 인스턴스를 엄격하게 제어 할 수 있습니다.

3. 생성자와 달리 반환 유형의 모든 하위 유형의 객체를 반환할 수 있습니다.

  • 이러한 유연함을 이용해 특정 응용 프로그램은 API가 클래스를 공개하지 않고도 객체를 반환 할 수 있습니다.
  • Java 8에서는 인터페이스에 정적 메서드를 포함 할 수 없다는 제한이 제거되었으므로 편하게 사용할 수 있습니다.

4. 반환 된 개체의 클래스가 입력 매개 변수의 함수로 호출마다 다를 수 있다.

  • 구현 클래스의 존재는 클라이언트에 보이지 않기 때문에 RegularEnumSet과 같은 작은 열거 유형에 대한 성능적 이점이 있습니다.

5. 메서드를 포함하는 클래스가 작성될 때 반환 된 객체의 클래스가 존재할 필요가 없다.

  • 유연한 정적 팩토리 메소드는 JDBC (Java Database Connectivity API)와 같은 Service provider framework 기반을 형성합니다.
  • 서비스 공급자 프레임워크는 세가지 필수 구성 요소가 존재합니다.

    • 구현을 나타내는 서비스 인터페이스 (a service interface)
    • 공급자가 구현을 등록하느데 사용하는 공급자 등록 API (a provider registration APi)
    • 클라이언트가가 서비스의 인스턴스를 얻기 위해 사용하느 서비스 액세스 API (a service access API)
    • (선택적 네 번째 구성 요소) 서비스 제공 업체 인터페이스 (service provider interface)

서비스 제공 업체 프레임 워크 패턴에는 다양한 변형이 존재합니다.

  • 서비스 액세스 API는 공급자가 제공하는 것보다 더 풍부한 서비스 인터페이스를 클라이언트에 반환 가능 (Bridge 패턴)

정적 팩토리 메서드의 단점

1. public 또는 protected 생성자가 없는 클래스는 하위 클래스화 할 수 없습니다.

  • Collections Framework에서 편의 구현 클래스를 하위 클래스로 만드는 것은 불가능합니다.
  • 프로그래머가 상속(inheritance)보다 합성(composition) 를 사용하는 것을 장려하며, immutable types에 필요합니다.

2. 프로그래머가 찾기 어렵습니다.

  • API 문서에서 눈에 띄지 않습니다.
  • 생성자가 수행하므로 생상자 대신 정적 팩토리 메서드를 제공하는 클래스를 인스턴스화 하는 방법을 파악하기 어렵습니다.

대표적 팩토리 메서드

다음은 대표적인 일반적인 이름입니다.

  • 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 or getInstance

    • 매개 변수 (있는 경우)로 설명되지만 같은 값을 가질 수없는 인스턴스를 반환
    • StackWalker luke = StackWalker.getInstance (옵션);
  • create or newInstance

    • instance또는 getInstance. 단, 메서드가 각 호출이 새 인스턴스를 반환하도록 보장한다는 점은 예외
    • Object newArray = Array.newInstance (classObject, arrayLen);
  • getType

    • getInstance비슷하지만 팩토리 메서드가 다른 클래스에있는 경우 사용
    • FileStore fs = Files.getFileStore (경로);
  • newType

    • newInstance비슷하지만 팩토리 메서드가 다른 클래스에있는 경우 사용
    • BufferedReader br = Files.newBufferedReader (경로);
  • type

    • get유형 과 new유형의 간결한 대안
    • List <Complaint> litany = Collections.list (legacyLitany);

Item 2. 생성자 매개 변수가 많은 경우, 빌더를 고려

Static factories 와 생성자는 제한을 고유하므로, 잘 확장되지 않습니다.

telescoping constructor 패턴

  • 생성자에 필수 매개 변수만 제공하고, 다른 하나에는 단일 선택적 매개 변수, 다른 하나는 두 개의 선택적 맥개 변수가 있는 등의 방식으로 생성자를 제공하는 패턴입니다.
public NutritionFacts (int servingSize, int servings) { ... }
public NutritionFacts (int servingSize, int servings, int calories) { ... }
public NutritionFacts (int servingSize, int servings, int calories, int fat) { ... }
public NutritionFacts (int servingSize, int servings, int calories, int fat, int sodium) { ... }
  • 텔레 스코핑 생성자 패턴은 작동하지만 매개 변수가 많으면 클라이언트 코드를 작성하기 어렵고 여전히 읽기가 어렵습니다.

JavaBeans 패턴

이를 해결하는 방법은 setter 메소드 호출(JavaBeans 패턴)입니다. (이 경우는 텔레 스코핑 생성자 패턴을 해결하기에는 유리하나 불일치를 허용하고 가변성을 요구한다는 단점이 존재합니다.)

@Setter
@Getter
public class NutritionFacts {
  private int servingSize = -1; // 필수; 기본값 없음
  private int servings = -1; // 필수; 기본값 없음
  private int calories = 0;
  private int fat = 0;
  private int sodium = 0;
}
  • JavaBeans 패턴은 구성이 여러 호출로 분할되기 때문에 JavaBean은 구성 과정에서 일관성없는 상태에 있을 수 있습니다.

    • 유효성을 확인하는 것으로 일관성을 유지할 수 있는 옵션이 따로 없습니다.
    • 클래스를 불변으로 만들 가능성을 배제하고 스레드 안전성을 보장하기 위해 노력이 필요합니다.

Builder 패턴

텔레 스코핑 생성자 패턴의 안전성 + JavaBeans 패턴의 가독성을 결합

  • 클라이언트는 필요한 모든 매개 변수를 사용하여 생성자 (또는 정적 팩토리)를 호출하고 빌더 객체를 가져옵니다.
  • 그런 다음 클라이언트는 빌더 개체에서 setter와 유사한 메서드를 호출하여 관심있는 각 선택적 매개 변수를 설정합니다.
  • 클라이언트는 매개 변수가없는 build메서드를 호출하여 일반적으로 변경할 수없는 개체를 생성합니다.
public class NutritionFacts {
  private final int servingSize;
  ...

  public static class Builder {
    // 필수 매개 변수
    private final int servingSize;

    // 선택적 매개 변수-기본값으로 초기화
    private int calories = 0;
    private int fat = 0;
    private int sodium = 0;

    public Builder (int servingSize, int servings) {
      this.servingSize = servingSize;
      this.servings = 서빙;
    }
    ...
  }
}

NutritionFacts cocaCola = new NutritionFacts.Builder (240, 8)
        .calories (100) .sodium (35) .carbohydrate (27) .build ();
  • 해당 코드는 작성하기 쉽고 읽기 쉽습니다.

    • 스프링은 @Builder 어노테이션이 있습니다.
// 클래스 계층 구조를위한 빌더 패턴

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 ();

    // Subclasses must override this method to return "this"
    protected abstract T self ();
  }

  Pizza(Builder<?> builder) {
    toppings = builder.toppings.clone(); // See Item  50
  }
}

다음과 같이 추상 self메서드 와 함께 메서드 체이닝이 캐스트 없이도 하위 클래스에서 제대로 작동합니다. 따라서 아래의 장점을 가집니다.

  • 빌더 패턴은 매우 유연합니다. (반복 사용을 통해 여러 개체를 빌드할 수 있음)

다만, 이러한 단점이 있습니다.

  • 개체를 만들기 위해서는 작성기를 만들어야 하기 때문에, 만드는 비용 및 성능이 중요한 상황에서 문제가 될 수 있습니다. (처음부터 시작하는 경우에 빌더를 선택하면 좋습니다.)

따라서 빌더 패턴은 생성자 또는 정적 팩토리에 소수 이상의 매개 변수가 있는 클래스를 디자인할 때 장점을 가집니다.


Item 3. private 생성자 또는 열거형을 통해 싱글 톤 속성을 적용

singleton은 정확하게 한번만 인스턴스화 되고, stateless 또는 unique한 시스템 컴포넌트입니다. 클래스를 싱글톤으로 만들면, 클라이언트 테스트가 어려울 수 있습니다. 왜냐하면 해당 유형으로 사용되는 인터페이스를 구현하지 않는 이상에 싱글톤을 mock으로 구현할 수 없기 때문입니다.

일반적으로 싱글톤을 구현하는 방법에 따라 구분할 수 있습니다.

1. public final field를 통한 singleton 구현

// public final field가 있는 singleton
public class Elvis {
  public static final Elvis INSTANCE = new Elvis();
  private Elvis() {...}

  public void leaveTheBuilding() { ... }
}
  • private 생성자는 public static final 필드를 초기화하기 위해 한번만 호출되며, Elvis.INSTANCE는 public, protected 생성자가 없기 때문에 monoelvistic(단일성)이 보장됩니다.
  • public final field는 해당 장점을 가집니다.

    • API가 클래스가 싱글톤임을 명확하게 합니다.
    • 퍼블릭 정적 필드는 최종이므로 항상 동일한 객체 참조를 포함합니다.
    • 매우 간단합니다.

2. 정적 팩토리를 통한 싱글톤

// Singleton with static factory
public class Elvis {
  private static final Elvis INSTANCE = new Elvis();
  private Elvis() { ... }
	public static Elvis getInstance() { return INSTANCE; }

  public void leaveTheBuilding() { ... }
}
  • Elvis.getInstance 을 사용하는 모든 호출은 동일한 객체 참조를 반환하고, 다른 Elvis 인스턴스는 생성되지 않습니다.
  • 정잭 팩토리의 장점은 아래와 같습니다.

    • API를 변경하지 않고도 클래스가 싱글톤인지 여부에 대해 바꿀 수 있는 유연성을 제공합니다.
    • 애플리케이션에서 필요한 경우, genericwe singleton factory 를 작성할 수 있습니다.
    • method reference(메소드 참조) 를 supllier(공급자)로 사용할 수 있습니다.

그러나 1번이나 2번의 접근 방식은 싱글톤은 serializabe(직렬화) 하는 경우에는 implements Serializable 만으로는 충분하지 않기 때문에 모든 인스턴스 필드(transient)를 선언하고 readResolve 메소드를 제공해야합니다.

// 싱글톤 속성을 보존하는 readResolve 메서드
private Object readResolve () {
  // true Elvis를 반환하고 가바지 커렉터가 Elvis의 복사품을 처리합니다.
  return INSTANCE;
}

3. 단일 요소 열거 형 선언

// Enum sigleton - the preferred approach
public enum Elvis {
  INSTANCE;

  public void leaveTheBuilding() { ... }
}
  • public field 접근 방식과 유사하지만 더 간결하고 직렬화를 제공합니다.
  • 종종 singleton을 구현하는 가장 좋은 방법입니다.

Item 4. private 생성자를 통해 noninstantiability(비인스턴스성)을 적용합니다.

  • java.lang.Mathjava.util.Arrays, java.util.Colletions 와 같은 유틸리티 클래스는 인스턴스화되도록 설계되어 있지 않습니다.
  • 추상 클래스를 만들어서 noninstantiability를 적용하려는 것은 동작하지 않습니다.
  • 다만 기본 생성자는 클래스에 명시적 생성자가 없는 경우에 생성되므로, private constructor을 포함함으로서 class를 noninstantiable 상태로 만들 수 있습니다.
// Noninstantiable utility class
public class UtilityClass {
  // Suppress default constructor for noninstantiability
  private UtilityClass () { throw new AssertionError(); }
  ...
}
  • explict constructor(명시적 생성자)는 private 이므로, 외부에서 접근할 수 없습니다.
  • AssertionError() 는 생성자가 실수로 클래스 내에서 호출되는 경우에 보험을 제공합니다. 즉, 어떤 상황에서도 클래스가 인스턴스화 되지않음을 보장합니다.
  • 다만, 이러한 방법은 클래스가 하위 클래스로 분류되는 것을 방지합니다. 즉, 서브 클래스에는 호출할 액세스 가능한 super class 생성자가 없습니다.

Item 5. Hardwiring 자원에 의존성 주입(Dependency Injection)을 선호합니다.

많은 클래스가 하나 이상의 기본 리소스에 의존합니다.

부정적인 케이스는 다음과 같습니다.

// 유연하지 않고, 테스트할 수 없는 잘못 사용된 유틸리티
public class SpellChecker {
  private static final Lexicon dictionary = ...;
  private SpellChecker () {} // Noninstantiable
  public static boolean isValid (String word) { ... }
  public static List<String> suggests(String typo) {...}
}
  • 즉, Static utility classes 와 싱글톤은 기본 리스스에 의해 동작이 매개변수화 된 클래스에 적합하지 않습니다.
  • 따라서 이를 해결하는 패턴은 새 인스턴스를 만들때, 생성자에 리소스를 전달하는 방법입니다. (DI, Dependency Injection)
// Dependency injection provides flexibility and testability
public class SpellCheker {
  private final Lexicon dictionary;
  public SpellChecker(Lexicon dictionary) {
    this.dictionary = Objects.requireNonNull(dictionary);
  }
  public boolean isValid(String word) { ... }
  public List<String> suggestions(String typo) { ... }
}

Dependency Injection Pattern(의존성 주입 패턴)은 다음의 장점을 가집니다.

  • immutabiliy(불변성)을 보존합니다.
  • resource factory를 전달함으로서 패턴을 변경할 수 있습니다. (Factory Method Pattern)

    • 자바8에 도입된 Supplier<T> 인터페이스는 Factories를 표현하는데 효과적입니다.
    • Supplier<T> 메소드는 bounded wildcard type(제한된 와일드카드 유형) 을 사용해서 팩토리의 매개변수를 제한하여, 클라이언트가 지정된 유형의 하위 유형의 생성하는 팩토리를 전달해야합니다.
Mosaic create(Supplier<? extends Tile> tileFactory)

결론적으로는 singleton 이나 static utility class를 사용하여 하나 이상의 기본 리소스에 의존하는 클래스를 구현하지 않고, 클래스가 이러한 리소스를 직접 생성하지 않도록 설정해야합니다. 대신에, Resource 또는 Factory를 통해서 생성자에 전달해야합니다. (또는 static factory 나 builder) DI를 통해서 클래스의 유연성과 재사용성, 테스트 기능을 향상 시킬 수 있습니다.


Item 6. 불필요한 객체를 생성하는 것을 줄입니다.

필요할때마다 기능적으로 동등한 새 객체를 만드는 것보다 단일 객체를 재사용하는 것이 적절합니다.

  • 나쁜 케이스 : String s = new String("clothes")

좀 더 개선하면 다음과 같습니다.

  • String s = "clothes"

static factory method 를 사용하면, 불필요한 객체 생성을 피할 수 있습니다. 따라서 다음과 같이 작성하여 성능이 향상 가능합니다.

// 성능 향상 가능.
static boolean isRomanNumeral (String s) {
  return s.matches("^(?=.)M*(C[MD]|D?C{0,3})" + "(X[CL]|L?X{0,3})(I[XV]|V?I{0,3})$");
}
  • 다만 문자열이 정규식과 일치하는지 확인하는 가장 쉬운 방법이지만 String.matches` 성능이 중요한 상황에서 반복적으로 사용하기에는 적합하지 않습니다. 이를 개선하면 아래처럼 바뀝니다.
// 성능 향상을 위해 값 비싼 객체 재사용합니다.
public class RomanNumerals {
  private static final Pattern ROMAN = Pattern.compile (
    "^ (? =.) M * (C [MD] | D? C {0,3})" + "( X [CL] | L? X {0,3}) (I [XV] | V? I {0,3}) $ "
  );

  static boolean isRomanNumeral (String s) {
    return ROMAN.matcher (s) .matches ();
	}
}
  • 이러한 버전은 isRomanNumeral을 자주 호출할 경우 높은 성능을 얻으며, 명확성도 향상되었고 사용자가 보기 쉽습니다.

Autoboxing는 애매하지만, primitive 와 boxed primitive types간의 구분을 없애버리지는 않습니다. 이러한 잘못된 사용은 속도를 느리게 만듭니다. 따라서, boxed primitives 보다, primitive를 선호하고 의도하지 않은 오토 박싱을 조심해야합니다.

private static long sum() {
  Long sum = 0;
  for(long i=0; i <= Integer.MAX_VALUE; i++)	// 느리게 만들어버림.
    sum += i;
  return sum;
}

Item 7. 사용하지 않는 개체의 참조를 제거합니다.

흔히. 가비지컬렉터를 사용하는 언어의 경우에는 메모리 관리에 대해 생각할 필요가 없다고 생각을 하지만 그렇지 않습니다.

메모리 낭비의 원인 1 - 미 참조

다음은 간단하게 스택을 구성한 코드입니다.

public class Stack {
  private Object[] elements;
  private int size = 0;
  private static final int DEFAULT_INITIAL_CAPACITY = 16;

  public Stack() {
    elements = new Object[DEFAULT_INITIAL_CAPACITY];
  }

  public void push(Object e) {
    ensureCapacity();
    elements[size++] = e;
  }

  public Object pop() {
    if(size == 0) throw new EmptyStackException();
    return elements[--size];
  }

  private void ensureCapacity() {
    if(elements.length == size)
      elements = Arrays.copyOf(elements, 2 * size + 1);
  }
}

다음 코드에서 스택이 커졌다가 줄어든 경우, 프로그램에 더 이상 참조가 없더라고 스택에서 참조된 객체는 가비지 수집이 되지 않습니다.

이를 수정하는 방법은 참조가 쓸모 없게 되면 null out 참조를 하면 됩니다.

public Object pop () {
  if(size == 0) throw new EmptyStackException();
  Object result = elements[--size];
  elements[size] = null;	// 사용하지 않는 참조
  return results;
}
  • 객체 참조를 무효화하는 것은 표준이 아니라 예외로 처리해야합니다.
  • 클래스가 자체 메모리를 관리할 때마다 프로그래머는 메모리 누수에 대해 경고해야합니다. 해제시 개체 참조를 null로 처리해야합니다.

메모리 낭비의 원인 2 - 캐시

캐시에 넣어놓으면 참조가 있다는 사실을 이후에 잊고, 관련성이 없어진 이후에도 남아있을 확률이 높습니다. 대부분의 캐시에서 사용하는 데이터의 가치는 시간과 반비례하기 때문에 항목을 정리할 필요가 있습니다. LinkedHashMapremoveEldestEntry 방법을 통해서 이러한 낭비를 피하기 위해 노력합니다.

메모리 낭비의 원인 3. 리스너 및 기타 콜백

클라이언트가 콜백을 등록하지만, 명시적으로 취소하지 않으면 누적됩니다.

이러한 부분을 삭제하는 방법은 .NET FrameworkWeakHashMap 과 같습니다.

이렇듯이 메모리 낭비는 명백한 오류로 나타나지 않기 때문에, 미리 예상하고 예방하는 방법을 배우는 것이 매우 바람직합니다.


Item 8. Finalizers(종료자)와 Cleaners(클리너)를 피합니다.

Finalizers 는 얘측할 수 없고 종종 위험하고 일반적으로 불필요합니다.

  • 비정상적인 동작, 성능 저하, 이식성의 문제가 발생할 수 있습니다.

Java 9부터는 Finalizers를 더이상 사용하지는 않지만, Cleaners를 사용합니다. 그러나, CleanerFinalizers 보다 덜 위험하지만 그래도 예측할 수 없고, 느리고, 일반적으로 불필요합니다.

Finalizers와 Cleaner의 단점 1 - 즉시 실행될 것이라는 보장이 없음

종료자나 클리너가 실행되는 시간 사이에 임의의 시간이 걸릴 수 있습니다. 즉, 종료자 또는 클리너에서 시간이 중요한 작업을 수행하면 안됩니다.

Finalizers와 Cleaner의 단점 2 - 종료 중에 발생한 예외는 무시됩니다.

이러한 예외가 손상된 상태로 종료된 경우, 다른 스레드가 이를 사용할려고 하면 비 결정적인 동작이 발생할 수 있습니다.

Finalizers와 Cleaner의 단점 3 - 심각한 성능 저하

Try-with-resource와 가비지 컬렉터를 쓰는 경우 12ns가 걸리는데 종료자를 사용하면 시간이 550ns가 발생합니다. Cleaner는 조금 더 빠르지만 66ns가 걸립니다.

Finalizers와 Cleaner의 단점 4 - 심각한 보안 문제 존재

finalizer attacks(종료자 공격)을 사용하는 경우, 문제가 발생합니다.

이를 막기 위해서는 생성자에서 예외를 던지는 경우, 객체가 존재하지 않도록 방지할 수 있으나 종료자가 이를 불가능하게 만듭니다. 이를 해결하기 위해서는 finalize 와 같은 최종 메서드를 사용해야합니다.

Finalizers나 Cleaner를 쓰지 않기 위해서.

  • AutoCloseable 을 통해서 클래스를 구현합니다.
  • try-with-resource 를 통해서 종료를 보장합니다.

Finalizers나 Cleaner의 합법적인 용도

  • 리소스 소유자가 close method 호출을 무시할 경우, 안전막 역할을 하는 것입니다.

    • FileInputStream, FileOutputStream, ThreadPoolExecutor 등이 finalizers를 통해서 안전망 역할을 수행합니다.
  • native peer가 있는 객체와 관련된 경우에 사용합니다.

    • 이러한 객체는 일반 객체가 아니므로 가비지 컬렉터가 이에 대해 모르기 때문에, 회수할 수 엇습니다.
    • 다만, 이렇게 사용을 하더라도 close method를 사용해야합니다.
// 클리너를 안전망을 사용하는 경우.
public class Room implements AutoCloseable {
  private static final Cleaner cleaner = Cleaner.create();

  // cleaning이 필요합니다. Room을 참조하면 안됩니다.
  private static class State implements Runnable {
    int numJunkPiles; // 이 방의 쓰레기 더미 수
    State(int numJunkPiles) {
      this.numJunkPiles = numJunkPiles;
    }

    // close 메소드 또는 클리너에 의해 호출
		@Override public void run() {
      System.out.println("Cleaning room");
      numJunkPiles = 0;
    }
  }

	// room의 상태, cleanable과 공유됨
	private final State state;

	// cleanable, gc에 의해 가능할때 room이 청소됩니다.
	private final Cleaner.Cleanable cleanable;

	public Room(int numJunkPiles) {
		state = new State(numJunkPiles);
		cleanable = cleaner.register(this, state);
	}

	@Override public void close() {
		cleanable.clean();
	}
}

추가적인 참고자료

다음과 같이 State 인스턴스가 Room을 참조하지 않도록 사용합니다.


Item 9. TRY-WITH-RESOURCE 를 TRY-FINALLY 보다 선호합니다.

Java 라이브러리에서는 close 메소드를 호출하는 경우, 많은 자원이 소모되기 때문에 다른 방법을 사용해야합니다.

Try-finally 는 2개 이상의 경우에서는 사용하기 어렵기 때문에, try-with-resource 를 사용하는 것이 좋습니다.

static String firstLineOfFile (String path) throws IOException {
  try (BufferedReader br = new BufferedReader (new FileReader(path)) {
    return br.readLine ();
  }
}
static String firstLineOfFile (String path, String defaultVal) {
  try (BufferedReader br = new BufferedReader (new FileReader (path))) {
		return br.readLine ();
  } catch (IOException e) {
		return defaultVal;
  }
}