Java 9에서 모듈(Module) 만드는 방법, 단계별 완벽 가이드

Java 9 모듈이란?

모듈(module)은 코드와 데이터를 하나로 묶은 단위입니다. 모듈의 코드는 여러 개의 패키지로 구성되며, 각 패키지에는 자바 클래스와 인터페이스가 포함됩니다. 모듈의 데이터에는 리소스 파일과 기타 정적 정보가 포함됩니다.

모듈의 중요한 특징 중 하나는 아티팩트(artifact)의 루트 디렉터리에 모듈을 설명하는 module-info.class 파일이 반드시 포함된다는 점입니다. 아티팩트 형식은 기존의 JAR 파일 또는 JMOD 파일일 수 있으며, 이 파일은 루트 디렉터리에 위치한 소스 파일 module-info.java를 컴파일하여 생성됩니다.

모듈 선언하기

module-info.java 파일에서 새로 도입된 키워드인 module을 사용하여 모듈을 선언할 수 있습니다. 예를 들어 com.company.mymodule이라는 모듈의 기본적인 선언 형태는 다음과 같습니다.

module com.tutorialspoint.mymodule {
}

모듈 생성 단계

1단계: 폴더 구조 만들기

C:\JAVA\src 폴더를 생성한 후, 모듈 이름과 동일한 이름으로 com.tutorialspoint.greetings 폴더를 만듭니다.

2단계: module-info.java 작성하기

C:\JAVA\src\com.tutorialspoint.greetings 디렉터리에 다음 코드를 담은 module-info.java 파일을 생성합니다.

module com.tutorialspoint.greetings {
}

3단계: 소스 코드 추가하기

모듈에 소스 코드 파일을 추가합니다. C:\JAVA\src\com.tutorialspoint.greetings\com\tutorialspoint\greetings 디렉터리에 JavaTest.java 파일을 만들고 아래와 같이 작성합니다.

package com.tutorialspoint.greetings;

public class JavaTest {
   public static void main(String args[]) {
      System.out.println("Hello Tutorialspoint!");
   }
}

4단계: 모듈 컴파일하기

C:\JAVA\mods 폴더를 생성하고, 그 안에 com.tutorialspoint.greetings 폴더를 만든 뒤 해당 디렉터리로 모듈을 컴파일합니다.

C:\JAVA>javac -d mods/com.tutorialspoint.greetings src/com.tutorialspoint.greetings/module-info.java
C:\JAVA>javac -d mods/com.tutorialspoint.greetings src/com.tutorialspoint.greetings/com/tutorialspoint/greetings/JavaTest.java

5단계: 모듈 실행하기

모듈을 실행하고 출력 결과를 확인합니다.

C:\JAVA>java --module-path mods -m com.tutorialspoint.greetings/com.tutorialspoint.greetings.JavaTest
Hello Tutorialspoint!

주요 실행 옵션 정리

위 실행 명령어에서 --module-path는 모듈이 위치한 경로를 지정하는 옵션이며, -m 옵션은 실행할 메인 모듈과 메인 클래스를 지정합니다. 이처럼 Java 9의 모듈 시스템을 활용하면 코드의 캡슐화 수준을 높이고, 의존성을 명확하게 관리할 수 있습니다.