Java 모듈 시스템 — JPMS로 강한 캡슐화를 달성하는 방법

// src/module-info.java
module com.myapp.core {
    // 다른 모듈에 공개할 패키지
    exports com.myapp.core.api;
    exports com.myapp.core.model;

    // 특정 모듈에만 공개
    exports com.myapp.core.internal to com.myapp.web;

    // 리플렉션 접근 허용 (프레임워크용)
    opens com.myapp.core.model to com.google.gson;

    // 의존하는 모듈
    requires java.sql;
    requires transitive java.logging; // 전이적 의존성

    // ServiceLoader 사용/제공
    uses com.myapp.core.spi.PluginService;
    provides com.myapp.core.spi.PluginService
        with com.myapp.core.internal.DefaultPlugin;
}

module com.myapp.core {
    exports com.myapp.core.model;    // public 접근만 허용
    opens com.myapp.core.model;      // 리플렉션까지 허용
}

// 모듈 전체를 리플렉션에 개방 (프레임워크 호환용)
open module com.myapp.core {
    exports com.myapp.core.api;
    requires java.sql;
}

# JAR 파일명에서 모듈 이름 추론
guava-31.1-jre.jar → guava
jackson-databind-2.15.jar → jackson.databind

명시적 모듈 → requires로 자동 모듈 참조 가능
자동 모듈 → 이름 없는 모듈의 클래스도 접근 가능
명시적 모듈 → 이름 없는 모듈 직접 참조 불가

// API 모듈
module com.myapp.api {
    exports com.myapp.api;
}

// 인터페이스 정의
package com.myapp.api;
public interface PaymentGateway {
    void process(Payment payment);
}

// 구현 모듈
module com.myapp.payment.stripe {
    requires com.myapp.api;
    provides com.myapp.api.PaymentGateway
        with com.myapp.payment.stripe.StripeGateway;
}

// 소비 모듈
module com.myapp.web {
    requires com.myapp.api;
    uses com.myapp.api.PaymentGateway;
}

// 사용 코드
ServiceLoader<PaymentGateway> loader = ServiceLoader.load(PaymentGateway.class);
for (PaymentGateway gateway : loader) {
    gateway.process(payment);
}

1. 의존성이 가장 적은 라이브러리부터 module-info.java 추가
2. 외부 라이브러리는 자동 모듈로 사용
3. 점진적으로 상위 모듈에 module-info.java 추가

# 캡슐화 경고 확인
java --illegal-access=warn -jar myapp.jar

# 특정 패키지 강제 개방 (임시 조치)
java --add-opens java.base/java.lang=ALL-UNNAMED -jar myapp.jar

# 모듈 추가
java --add-modules java.sql -jar myapp.jar

# 모듈 의존성 분석
jdeps --module-path libs -s myapp.jar

# module-info.java 자동 생성
jdeps --generate-module-info out/ myapp.jar

# 실무에서 흔히 보이는 --add-opens 목록
java --add-opens java.base/java.lang=ALL-UNNAMED \
     --add-opens java.base/java.lang.reflect=ALL-UNNAMED \
     --add-opens java.base/java.util=ALL-UNNAMED \
     -jar myapp.jar

jlink --module-path $JAVA_HOME/jmods:mods \
      --add-modules com.myapp.core \
      --output custom-runtime \
      --strip-debug --compress=2