[Spring] Static Method VS Bean 주입

1. 개요

DTO 매핑 방식에는 다양한 방법이 있다. 예를 들어, MapStruct 인터페이스를 활용한 매핑, 별도의 매퍼 클래스를 사용한 매핑, from/toXXX와 같은 static 메서드를 이용한 매핑 등이 있다. 이 중 어떤 방식이 가장 우수하다고 단정 짓기는 어렵다.

 

여러 가지 이유를 고려한 끝에, 별도의 매퍼 클래스를 활용하는 방식을 선택하기로 했다. 하지만 여기서 또 하나의 고민이 생겼다. 이 매퍼 클래스를 Bean으로 등록하여 주입받아 사용할 것인가, 아니면 static 메서드로 정의하여 사용할 것인가?

 

 

 

Spring bean과 Static 함수의 생성 시점은 아래와 같다.

 

1. Spring bean : JVM 로드 → Tomcat 실행 → Component Scan 시점

2. StaticClass Method : JVM에서 클래스가 메모리에 올라가는 시점

 

Spring Bean 생성 시점보다 StaticClass 내부의 Method 생성 시점이 앞선다. 뿐만 아니라, Spring bean과 StaticClass의 Method 모두 싱글톤을 보장한다는 점에서 공통점을 가진다.

 

그렇다면 'Spring Bean을 대체해서 StaticClass를 정의해서 사용해도 될까'하는 생각이 들었고 이 글을 작성하게 되었다.

 

 

 

 

 

 

 

 

2. Spring Bean, Static

공식 문서에 따르면, Spring bean은 Spring IoC 컨테이너에 의해 관리되는 자바 객체이다.

 

IoC 컨테이너에 의해 관리되는 Bean은 싱글톤을 유지하며 생성과 사용, 소멸까지의 생명 주기 관리에 대한 사용자의 부담을 덜어주고, 의존성 주입을 통해 필요한 Bean을 사용하면 된다.

 

 

비슷한 맥락에서 StaticClass는 자신의 ClassName 자체로 객체에 접근할 수 있게 한다.

 

System.out 으로만 코드를 작성할 수 있는 이유가 static 이기 때문이다. 따라서 New() 키워드를 통해 객체를 생성할 필요도 없고, 사용자는 StaticClass의 내부 메서드나 필드에 곧바로 접근할 수 있다.

 

 

 

 

 

 

2. 언제 우리는 이들을 사용하는가?

Spring Bean은 결국 다른 Bean과의 의존성을 가지고 사용되는 경우에 적합하다. 

물론 의존성 없이 독립적으로 사용되는 Bean도 있을 수 있지만, 현재는 의존성이 없더라도 미래에 의존성을 가질 가능성이 있다면 Bean으로 등록하는 것이 바람직하다. 

 

반면, Static 클래스를 활용한 메서드는 의존성이 필요 없는 단순한 변환 로직을 수행할 때 더 적합할 수 있다. 

 

결국, 의존성 주입이 필요한가? 아닌가? 가 Spring Bean과 Static 메서드 사용을 구분 짓는 핵심 기준이 된다.

 

 

Spring Bean을 사용해야 하는 경우

@Component
public class S3Handler {
    private final AmazonS3 amazonS3;
    private final String bucketName;

    public S3Handler(AmazonS3 amazonS3, @Value("${aws.s3.bucket}") String bucketName) {
        this.amazonS3 = amazonS3;
        this.bucketName = bucketName;
    }

    public String uploadFile(String key, File file) {
        amazonS3.putObject(new PutObjectRequest(bucketName, key, file));
        return amazonS3.getUrl(bucketName, key).toString();
    }

    public S3Object downloadFile(String key) {
        return amazonS3.getObject(bucketName, key);
    }
}

 

이런 코드는 다음과 같은 이유들로 @Component 등록하는게 옳다. 

 

 

• AmazonS3와 같은 AWS SDK 객체를 의존성 주입(DI)을 통해 관리할 수 있다.
• @Value("${aws.s3.bucket}")와 같은 환경 변수 값을 주입할 수 있다.

 

 

 

 

Static 을 사용해야 하는 경우

public class Util {
    private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd");

    // 날짜 변환
    public static String formatLocalDate(LocalDate date) {
        return date.format(DATE_FORMATTER);
    }

    public static LocalDate parseDate(String dateStr) {
        return LocalDate.parse(dateStr, DATE_FORMATTER);
    }

    // 수 변환
    public static double roundToTwoDecimalPlaces(double value) {
        return new BigDecimal(value).setScale(2, RoundingMode.HALF_UP).doubleValue();
    }

    public static String formatCurrency(double value) {
        return String.format("$%.2f", value);
    }
}

 

이런 코드는 외부 서비스(AWS, DB 등)나 다른 Bean을 주입받지 않는다. 또한 단순한 변환 기능만 제공하므로 static 을 사용하는 것이 적절하다.