DEV ℧ Developer Diary

[EffectiveJava] item62 - 다른 타입이 적절하다면 문자열 사용을 피하라

10 Jul 2023

문자열(String)은 텍스트를 표현하도록 설계되었고, 그 일을 아주 멋지게 해낸다.

그렇지만 문자열은 워낙 흔하고 자바가 또 잘 지원해주어 원래 의도하지 않은 용도로 쓰이는 경향이 있다.

이러한 사례를 정리해 보도록 하자.

적절하지 않은 문자열의 사용

문자열은 다른 값 타입을 대신하기 적합하지 않다.

많은 사람이 파일, 네트워크, 키보드 입력으로부터 데이터를 받을 때 주로 문자열을 사용한다. 자연스러워 보이지만, 입력받을 데이터가 진짜 문자열일 때만 그렇게 하는게 좋다.

받은 데이터가 수치형이라면 int, float, BigInteger 등 적당한 수치 타입으로 변환해야한다. ‘예/아니오’ 질문의 답이라면 적절한 열거 타입이나 boolean으로 변환해야 한다.

문자열은 열거 타입을 대신하기에 적합하지 않다.

Item34에서 이야기 했듯, 상수를 열거할 때는 문자열보다는 열거 타입이 월등히 낫다.

문자열은 혼합 타입을 대신하기에 적합하지 않다.

여러 요소가 혼합된 데이터를 하나의 문자열로 표현하는 것은 대체로 좋지 않은 생각이다.

String compoundKey = className + "#" + i.next();

이는 단점이 많은 방식이다. 혹여라도 두 요소를 구분해주는 문자 #이 두 요소 중 하나에서 쓰였다면 혼란스러운 결과를 초래한다.

  • 각 요소를 개별로 접근하려면 문자열을 파싱해야 해서 느리다.
  • 귀찮고 오류 가능성도 커진다.
  • equals, toString, compareTo 메서드를 제공할 수 없다.
  • String이 제공하는 기능에만 의존해야 한다.

위와 같은 문제점으로 차라리 전용 클래스를 새로 만드는 것이 낫다. 이러한 경우에는 보통 private 정적 멤버 클래스로 선언한다.

문자열은 권한을 표현하기에 적합하지 않다.

권한(capacity)을 문자열로 표현하는 경우가 종종 있다.

예를 들어 스레드 지역변수 기능을 설계한다고 해보자. 그 이름처럼 각 스레드가 자신만의 변수를 갖게 해주는 기능이다.

자바가 이 기능을 자바 2부터 지원하기 시작했으며, 그전에는 프로그래머가 직접 구현을 하였다.

많은 프로그래머가 고민끝에 문자열 키로 스레드별 지역변수를 식별 하였다.

public class ThreadLocal {
    private ThreadLocal() { } /** 객체 생성 불가 */

    /** 현 스레드의 값을 키로 구분해 저장한다. */
    public static void set(String key, Object value);

    /** (키가 가르키는) 현 스레드의 값을 반환한다. */
    public static Object get(String key);
}

이 방식의 문제는 스레드 구분용 문자열 키가 전역 이름 공간에서 공유된다는 점이다. 만약 두 클라이언트가 같은 키를 쓰게 된다면, 의도치 않게 같은 변수를 공유하게 된다.

악의적인 클라이언트는 의도적으로 같은 키를 사용해 다른 클라이언트의 값을 가져올 수 있다.

이 API는 문자열 대신 위조할 수 없는 키(권한)를 사용하면 된다.

Key 클래스로 권한을 구분한다.

public class ThreadLocal {
    private ThreadLocal() { } /** 객체 생성 불가 */

    public static class Key { /** (권한) */
        Key() { }
    }

    /** 위조 불가능한 고유 키를 생성한다. */
    public static Object getKey() {
        return new Key();
    };

    public static void set(Key key, Object value);
    public static Object get(Key key);
}

이 방법은 앞서의 문자열 기반 API의 문제 두 가지를 모두 해결해주지만 set/get은 이제 정적 메서드일 이유가 없으니 Key의 인스턴스 메서드로 수정해 주도록 하자.
이렇게 하면 Key는 더 이상 스레드 지역변수를 구분하기 위한 키가 아니라 그자체가 스레드 지역변수가 된다. 그러면 쓸모가 없어진 ThreadLocal은 치워버리고 Key의 이름을 ThreadLocal로 바꿔버리자.

리팩토링 하여 Key를 ThreadLocal로 변경

public final class ThreadLocal {
    public ThreadLocal();
    public void set(Object value);
    public Object get();
}

이 API에서는 get으로 얻은 Object를 실제 타입으로 형변환 해야 해서 타입 안전하지 않다.

처음 문자열 기반의 API는 타입 안전하게 만들 수 없으며, Key를 사용한 API도 타입 안전하게 만들기 어렵다.

하지만 ThreadLocal을 매개변수화 타입으로 선한면 간단하게 문제가 해결된다.

public final class ThreadLocal<T> {
    public ThreadLocal();
    public void set(T value);
    public T get();
}

이제 자바의 java.lang.ThreadLocal과 흡사해졌다. 문자열 기반 API의 문제를 해결해주며, 키 기반 API보다 빠르고 우아하다.

Related posts