☕ 자바 프로젝트 생성부터 'Hello World' 콘솔에 출력하기

 

이클립스 개발 환경 구축을 완료했다면, 자바 개발을 위한 자바 프로젝트 생성이 필요합니다. 생성된 프로젝트 파일을 이용해서 원하는 클래스를 만들고 만든 프로그램을 실행하기 위해 main() 메서드를 통해 프로그램을 실행합니다.

 

 

 

 

 

자바 프로젝트 생성하기

 

1.  이클립스 메뉴의 File > New > Java Project 메뉴를 선택합니다.

 

 

 

 

 

 

2.  자바 프로젝트를 생성하기 위해서 프로젝트 명, 사용 JRE, 프로젝트 layout 등 설정 후, Finish 버튼을 눌러 생성을 진행합니다.

 

New Java Project / 자바 프로젝트 생성

 

'New Java Project' 창이 나타나면 'Project name' 입력란에 생성할 프로젝트명을 입력합니다. 그리고 JRE 항목에서 사용하고자 하는 JRE 버전을 설정하고 'Finish' 버튼을 눌러 생성을 진행합니다.

 

Create a Java Project (자바 프로젝트 생성)
해당 화면은 Eclipse IDE에서 자바 프로젝트를 새로 생성할 때 보이는 'Create a Java Project'창입니다.


1️⃣ Project name
- 생성할 자바 프로젝트의 이름을 입력하는 칸입니다.

2️⃣ Use default location
- 프로젝트를 Eclipse의 기본 워크스페이스 경로에 생성할지 여부를 결정합니다.
- ☑ 체크시엔 IDE에서 미리 설정해 둔 기본 위치에 저장됩니다.
- ◻ 체크 해제시엔 사용자가 원하는 특정 폴더를 지정할 수 있습니다.

3️⃣ JRE
- 프로젝트가 어떤 Java 실행 환경(Java Runtime Environment)을 사용할지 선택하는 항목입니다.
- '🔘 Use an execution environment JRE' 는 특정 자바 실행 환경 그룹(예: JavaSE)내에서 가장 적합한 JRE를 자동으로 선택하여 사용합니다. 드롭다운 메뉴에서 원하는 실행 환경을 선택할 수 있습니다.
- '🔘 Use a project specific JRE'는 특정 JRE 버전을 명시적으로 지정하여 해당 프로젝트에서만 사용하도록 설정합니다. 드롭다운 메뉴에서 설치된 JRE 목록을 확인하고 선택할 수 있습니다. 그리고 'Configure JREs...' 버튼을 클릭하여 설치된 JRE 목록을 확인하고 관리할 수 있습니다.
- '🔘 Use default JRE 'jre' and workspace compiler preferences' 는 워크스페이스 전체에 설정된 기본 JRE를 사용합니다. 일반적으로 최신 버전의 JDK를 선택하는 것이 좋으며, Eclipse에 설치된 JDK 목록은 'Configure JREs...'에서 관리할 수 있습니다.

4️⃣ Project layout
- 자바 소스 파일(.java)과 컴파일된 클래스 파일(.class)의 디렉토리 구조를 어떻게 구성할지 결정하는 항목입니다.
- '🔘 Use project folder as root for sources and class files'는 자바 소스 코드와 컴파일된 클래스 파일 모두 프로젝트의 최상위 폴더에 위치하게 됩니다. (예: HelloWorld/src 안에서 소스와 클래스가 함께 존재)
-  '🔘 Create separate folders for sources and class files (기본 선택)는 소스 코드는 src 폴더에, 컴파일된 클래스 파일은 bin 또는 target/classes 폴더와 같이 별도의 폴더에 저장됩니다. 일반적으로 더 체계적인 프로젝트 관리를 위해 이 옵션을 선택합니다. 'Configure default...' 버튼을 클릭하면 기본 소스 폴더 및 출력 폴더 이름을 설정할 수 있습니다.

5️⃣ Working sets
- 관련된 프로젝트들을 논리적으로 그룹화하여 IDE 내에서 관리하기 위한 기능입니다. 큰 프로젝트나 여러개의 작은 프로젝트를 동시에 작업할 때 유용합니다. (일반적으로 생략해도 됩니다.)

6️⃣ Module (Java 9 이상에서 추가된 기능)
- ☑ Create module-info.java (module-info.java 파일 생성)는 module-info.java 파일을 생성합니다. 해당 파일은 모듈의 이름, 의존성, 공개할 패키지 등을 정의하는데 사용합니다. 모듈 시스템을 사용하면 코드의 결합도를 낮추고 가시성을 제어하며, 런타임 환경을 최적화할 수 있습니다.
- Module name (모듈 이름)은 모듈 이름을 지정할 수 있습니다. 관례적으로 소문자로 시작합니다. 해당 항목을 비워두면 프로젝트 이름(HelloWorld)이 모듈 이름으로 사용됩니다.
- Generate comments (주석 생성)는 module-info.java 파일에 기본적인 주석을 자동으로 생성합니다. 

 

 

 

 

 

3.  module-info.java 파일 내, 모듈을 설정합니다. (선택사항, Java9 부터 도입된 모듈 시스템의 일부로 없이도 충분히 개발 가능)

 

 

Java 9부터 도입된 모듈 시스템의 일부이며, 기존의 classpath 기반 자바 프로젝트는 module-info.java 없이도 충분히 개발 및 실행이 가능합니다. 그렇기 때문에 module-info.java 는 반드시 필요한 건 아닙니다.

 

module-info.java를 꼭 설정해야 할까?

결론적으로는 필수는 아닙니다. 자바 프로젝트를 생성할 때 module-info.java 파일을 생성하도록 선택하지 않거나, 아예 모듈 시스템을 사용하지 않도록 설정할 수도 있습니다. 이전 버전의 자바(Java 8 이하)에서 개발하던 방식처럼, 클래스들을 단순히 패키지 단위로 묶어서 개발하는 것도 여전히 가능합니다.

하지만, 자바 9 이후부터는 모듈 시스템이 도입되었고, 이를 활용하면 여러 가지 이점을 얻을 수 있습니다. 따라서 새로운 프로젝트를 시작하거나, 기존 프로젝트를 현대화하는 과정에서 모듈 시스템을 고려해 보는 것도 좋습니다.

모듈(Module)이란 정확하게 무엇이고 왜 써야 할까?

모듈이란 관련된 클래스들의 논리적 묶음이며, 명시적으로 의존성과 접근 범위를 선언할 수 있도록 해줍니다. 모듈은 레고 블록처럼, 독립적이고 재사용 가능한 컴포넌트로서 애플리케이션을 구성하는데 사용됩니다.

모듈 시스템을 사용하는 주요 이유는 다음과 같습니다.

💢 기존(classpath 방식)의 문제점
- 클래스 충돌 발생 가능 (예: 동일 클래스가 여러 jar에 있을 때)
- 불필요한 클래스에도 접근 가능
- 의존 관계가 명확하지 않음

💥 모듈 시스템의 핵심 목적
1. 강한 캡슐화(Strong Encapsulation)
- 모듈은 기본적으로 자신의 내부 패키지에 있는 public 타입만을 외부로 공개하고, 명시적으로 허용하지 않은 내부 구현은 숨깁니다. 이를 통해 잘못된 의존성 형성을 방지하고,  API를 명확하게 정의하며, 내부 구현 변경에 대한 영향을 최소화 할 수 있습니다. 마치 잘 설계된 라이브러리처럼, 사용자는 공개된 인터페이스만 신경 쓰면 되고 내부 동작 방식은 알 필요가 없게 됩니다.

2. 명확한 의존성 관리(Explicit Dependencies)
- 각 모듈은 자신이 의존하는 다른 모듈을 명시적으로 선언합니다(requires 키워드 사용). 이를 통해 의존성 관리가 훨씬 명확해지고, 불필요한 의존성을 줄이며, 런타임 시 누락된 의존성으로 인한 오류를 사전에 방지할 수 있습니다.

3. 향상된 보완성(Enhanced Security)
- 필요한 모듈만 포함하여 애플리케이션을 배포할 수 있으므로, 공격 표면을 줄여 보안성을 향상시킬 수 있습니다. 또한, 강한 캡슐화는 내부 구현에 대한 무단 접근을 막아 보안 취약점을 줄이는 데 도움이 됩니다.

4. 작고 효율적인 배포(Smaller and More Effcient Deployment)
- 애플리케이션 실행에 필요한 모듈만 포함하여 배포할 수 있으므로, 배포 크기를 줄이고 런타임 성능을 향상시킬 수 있습니다. 특히 임베디드 시스템이나 클라우드 환경에서 리소스 사용을 최적화하는데 유용합니다.

5. 더 나은 유지보수(Improved Maintainability)
- 모듈 단위로 코드가 분리되어 있고 의존성이 명확하기 때문에, 코드를 이해하고 수정하고 테스트하기가 더 쉬워집니다.

module-info.java 작성 방법

module com.example.hello {
    requires java.base;          // 다른 모듈 의존 (java.base는 기본적으로 포함)
    requires java.sql;           // SQL 기능이 필요할 때

    exports com.example.hello;   // 외부에 공개할 패키지
}​

module : 모듈 이름 정의 (소문자로 시작하는 것이 관례)
requires : 다른 모듈에 대한 의존성 명시 (예: java.sql, java.se, java.desktop 등)
exports : 외부에 공개할 패키지 지정 (이것만 다른 모듈이 import 가능)
opens : 리플렉션 등을 위해 접근 허용 (예: javaFX, jackson 등에서 사용)

언제 module-info.java를 써야 할까요?

⭕ 사용하는 것이 좋은 경우
- Java 9 이상의 기능을 제대로 활용하고 싶을 때
- Jigsaw 기반 모듈 설계를 도입한 프로젝트
- 대규모 시스템 개발 시 명확한 의존성 및 캡슐화가 필요한 경우
- 자체 라이브러리를 만들어 배포할 때

❌ 사용하지 않아도 되는 경우
- 소규모 학습 / 테스트 프로젝트
- 기존 라이브러리들과 호환이 필요할 때
- SpringFrameworkd 기반 프로젝트 (대부분 classpath 방식)

 

 

 

 

 

4.  클래스를 생성하기 위해서 패키지를 생성합니다. 패키지명은 kr.or.junesker로 진행하겠습니다.

 

 

 

Source Package인 'src' 폴더에 'kr.or.junesker' 패키지를 만들거나 본인이 작성하고자 하는 패키지를 구성합니다.

 

 

 

 

 

5.  해당 패키지에 클래스를 생성합니다.

 

 

 

생성할 클래스명을 Name 입력란에 입력합니다. 그리고 'public static void main(String[] args)' 체크박스를 체크 후 'Finish' 버튼을 눌러 클래스 생성을 진행합니다. 'public static void main(String[] args)' 체크박스에 체크 후 클래스를 생성하면 main() 메서드가 클래스 내 자동으로 생성됩니다.

 

New Java Class (새로운 자바 클래스 생성)
해당 화면은 새로운 Java 클래스를 생성하기 위한 다이얼로그 창입니다. 

Basic Settings
1️⃣ Source folder
- 새로운 클래스가 생성될 소스 폴더를 지정합니다.

2️⃣ Package
- 클래스가 속할 패키지 이름을 입력합니다. 패키지는 클래스를 논리적으로 그룹화하고 클래스 중복 방지하는데 중요합니다.

3️⃣ Enclosing type (체크박스)
- 만약 내부 클래스를 생성하고 싶다면, 이 체크박스를 선택하고 외부 클래스를 지정할 수 있습니다. 

4️⃣ Name
- 생성할 클래스의 이름을 입력하는 곳입니다. 클래스의 이름은 UpperCamelCase 규칙을 따르는 것이 일반적입니다.

5️⃣ Modifiers
- 클래스의 접근 제어자 및 속성을 설정합니다.
　> Access Modifiers : public, private, protected, none 중 하나를 선택하여 클래스의 접근 범위를 설정할 수 있습니다.
　> Properties : abstract, final, static, sealed, non-sealed 중 필요한 속성을 선택할 수 있습니다. 

6️⃣ Superclass
- 생성할 클래스가 상속받을 부모 클래스를 지정합니다. 기본적으로 java.lang.Obect가 설정되어 있으며, 'Browse...' 버튼을 눌러 다른 클래스를 선택할 수도 있습니다.

7️⃣ Interfaces
- 생성할 클래스가 구현할 인터페이스들을 추가할 수 있습니다. 'Add...' 버튼을 클릭하여 인터페이스를 선택하고, 'Remove' 버튼으로 제거할 수 있습니다.

Methid Stubs
Which method stubs would you like to create?
1️⃣ public static void main(String[] args)
- 프로그램 실행의 시작점이 되는 main 메소드를 자동으로 생성할지 여부를 선택합니다.

2️⃣ Constructors from superclass
- 부모 클래스의 생성자를 자동으로 생성할지 여부를 선택합니다.

3️⃣ Inherited abstract methods 
- 상속받은 추상 메소드를 자동으로 구현할지 여부를 선택합니다.

Add Comments
Do you want to add comments? (Configure templates and default value [here]
1️⃣ Generate comments
- 클래스 및 메소드에 대한 기본적인 주석을 자동으로 생성할지 여부를 선택합니다. 

 

 

 

 

 

자바 파일 실행하기

 

6.  HelloWorldClass.java 소스 파일이 생성됩니다.

 

 

HelloWorldClass.java 소스 파일이 생성되고, 녹색 'TODO' 영역에 원하는 로직을 작성합니다.

 

 

 

 

 

7.  'Hello, World!'를 출력하기 위해서 print문을 작성합니다.

 

 

'Hello, World!'를 출력하기 위해서는 직접 'System.out.println' 구문을 작성하거나 자동완성 단축키 'syso'를 입력 후 Ctrl + Space를 이용해 자동완성할 수 있습니다.

 

 

 

 

 

8.  Run > Run As > Java Application 메뉴를 통해 'HelloWorldClass.java'를 실행하거나 Run 아이콘을 클릭 > Run As > Java Application 메뉴를 통해 실행하는 방법이 있습니다. 두가지 방법 중 한가지를 선택해 해당 java 파일을 Run 합니다.

 

HelloWorldClass.java 실행 방법 - 1

HelloWorldClass.java 실행 방법 - 2

 

두 가지 방법 중 한가지를 선택해 'HelloWorldClass.java'를 실행합니다.

 

 

 

 

 

9.  실행 결과를 'Console'에서 확인합니다.

 

 

'System.out.println'을 이용해 출력하고자 하는 'Hello, World!' 가 콘솔에 출력되었다면 정상적인 실행에 의한 출력입니다. 

 

 

 

 

 

@Junesker

---