Java 모듈 시스템 완벽 가이드, exports와 opens 차이와 활용법

🔍 exports란? 모듈 API 공개 방식

Java 9에서 도입된 모듈 시스템(JPMS)에서 exports 키워드는 특정 패키지를 다른 모듈에서 사용할 수 있도록 공개하는 역할을 합니다.
즉, 모듈 외부에서 해당 패키지의 public 클래스나 public 메서드에 접근할 수 있게 허용합니다.
하지만 중요한 점은, exports는 컴파일과 런타임 시의 직접 호출에만 영향을 미치며, 리플렉션(reflection)을 통한 접근은 자동으로 허용하지 않는다는 것입니다.

예를 들어, 다음과 같이 module-info.java에 exports를 선언하면, 해당 패키지의 API는 외부 모듈에서 사용할 수 있습니다.

module com.example.myapp {
    exports com.example.myapp.api;
}

위 설정을 통해 com.example.myapp.api 패키지는 외부 모듈에서 import하여 사용할 수 있습니다.
하지만, JSON 직렬화 라이브러리(Jackson)나 ORM 프레임워크(Hibernate)처럼 리플렉션 기반으로 필드와 메서드에 접근하는 경우에는 exports만으로는 충분하지 않습니다.
이 경우 opens 키워드를 사용해야 합니다.

🔓 opens란? 리플렉션 허용 방식

Java 모듈 시스템에서 opens 키워드는 특정 패키지를 리플렉션(reflection)으로 접근할 수 있도록 허용합니다.
이는 런타임 시점에 클래스의 비공개 필드나 메서드까지 접근해야 하는 프레임워크나 라이브러리에서 필수적으로 사용됩니다.
대표적으로 Jackson, Gson, Hibernate 같은 라이브러리들은 객체 직렬화·역직렬화를 위해 리플렉션을 활용하므로 opens 선언이 필요합니다.

다음 예시는 module-info.java에서 opens를 선언하는 방법을 보여줍니다.

module com.example.myapp {
    opens com.example.myapp.model to com.fasterxml.jackson.databind;
}

위 설정은 com.example.myapp.model 패키지를 com.fasterxml.jackson.databind 모듈에서 리플렉션을 통해 접근할 수 있도록 허용합니다.
특히 opens는 exports와 달리 런타임 전용으로 적용되며, 컴파일 시점에는 영향을 주지 않습니다.
따라서, 외부 모듈에서 해당 패키지의 클래스를 import해서 사용하는 것은 여전히 불가능하고, 오직 리플렉션을 통한 접근만 허용됩니다.

⚖️ exports와 opens의 차이 비교

Java 모듈 시스템에서 exports와 opens는 모두 모듈 외부 접근을 제어하는 키워드이지만, 그 목적과 작동 시점에서 큰 차이가 있습니다.
exports는 컴파일 시와 런타임 직접 호출을 허용하는 반면, opens는 런타임 리플렉션 접근만 허용합니다.

다음 표는 두 키워드의 차이를 한눈에 정리한 것입니다.

즉, exports는 “내 코드를 외부에서 쓸 수 있도록 열어주는” 것이고, opens는 “내 코드를 리플렉션으로 조작할 수 있도록 허용하는” 개념입니다.
따라서 두 키워드는 함께 사용될 수 있지만, 상황에 따라 하나만 선택하는 것이 보안과 성능 모두에 이롭습니다.

🛠️ 실제 사용 예시와 코드 샘플

실무에서는 exports와 opens를 상황에 맞게 조합하여 사용합니다.
예를 들어, 비즈니스 로직을 외부 모듈에 API로 제공하면서도, JSON 직렬화를 위해 리플렉션 접근이 필요한 경우가 있습니다.
이 경우 하나의 모듈에서 두 키워드를 함께 선언할 수 있습니다.

module com.example.myapp {
    exports com.example.myapp.api; // API 제공
    opens com.example.myapp.model to com.fasterxml.jackson.databind; // 리플렉션 허용
}

위 설정에서는 com.example.myapp.api 패키지를 통해 외부에서 직접 호출 가능한 API를 제공하면서,
com.example.myapp.model 패키지는 Jackson 라이브러리에서만 리플렉션을 통해 접근할 수 있도록 제한합니다.
이 방식은 모듈의 보안을 강화하면서도 필요한 기능은 그대로 유지할 수 있는 좋은 설계입니다.

📌 open module 선언 예시

open module 키워드를 사용하면 모듈 전체의 모든 패키지를 리플렉션에 개방할 수 있습니다.
다만 이는 보안상 매우 위험할 수 있으므로 테스트나 프로토타이핑 환경에서만 사용하는 것이 좋습니다.

open module com.example.test {
    requires java.sql;
}

💡 exports와 opens 선택 가이드

프로젝트에서 exports와 opens 중 어느 것을 선택해야 할지는 모듈의 목적과 사용 방식에 따라 달라집니다.
기본적으로 외부 모듈에서 API를 직접 호출하게 하려면 exports를, 리플렉션 기반 접근이 필요하다면 opens를 사용합니다.
다만, 무분별하게 opens를 사용하는 것은 보안과 유지보수성에 모두 악영향을 줄 수 있으므로 신중하게 결정해야 합니다.

📌 선택 기준 체크리스트

• 🛠️외부 모듈에서 직접 API 호출이 필요한가? → exports
• 🔍런타임에 리플렉션 접근이 필요한가? → opens
• 🔒보안상 꼭 필요한 경우에만 opens 사용
• ⚡성능 민감한 환경에서는 불필요한 리플렉션 허용 지양

📌 모듈 설계 시 팁

모듈 설계 단계에서 패키지별 접근 수준을 미리 계획해 두면, 나중에 exports와 opens를 혼동 없이 적용할 수 있습니다.
예를 들어, 서비스 계층 패키지는 exports로, 데이터 모델 패키지는 opens로 구분하면 깔끔한 구조를 유지할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)