Spring Initializr를 이용하여 Spring Boot 서버 생성하기

1. Spring Initializr 페이지 이동 및 프로젝트 설정

• 첫 단계는 Spring Initializr 페이지로 이동하는 것입니다. 이 페이지에서 필요한 프로젝트 설정을 할 수 있습니다.

 

 

 

 

1. 프로젝트 설정 세부 사항

• 빌드 툴 선택: Maven이나 Gradle 중 하나를 선택합니다. 최근에는 Gradle을 많이 사용하는 추세입니다.
• 언어 선택: Java, Kotlin, Groovy 등 원하는 언어를 선택합니다.
• Spring Boot 버전: 최신의 안정적인 버전을 선택합니다. 괄호가 있는 버전은 개발 중이거나 불완전한 버전이므로避하기 바랍니다.
• Group 및 Artifact: 일반적으로 기업의 도메인 및 기업명을 Group에, 빌드 결과물의 이름을 Artifact에 입력합니다.
• Description: 프로젝트에 대한 간단한 설명을 입력합니다.
• Package name: 자동으로 생성되며, 소문자로 작성해야 합니다.
• Packaging: jar 또는 war 중 하나를 선택합니다. 일반적으로 jar을 사용하며, Java 버전도 설정할 수 있습니다 (예: Java 17)
• Dependencies: 필요한 라이브러리를 선택합니다. 예를 들어, Spring Web, H2 Database, Lombok 등을 추가할 수 있습니다.

현 추세는 Gradle 이지만 실습을 위해 Maven을 선택하였습니다.

 

 

2. 프로젝트 다운로드 및 압축 해제

• 모든 설정을 완료한 후, 하단의 GENERATE 버튼을 클릭하여 프로젝트를 다운로드합니다. 다운로드된 zip 파일을 압축 해제합니다.

 

 

 

3. IDE에서 프로젝트 임포트

인텔리제이 사용 시

• 인텔리제이를 실행하고 File → Open → 생성된 프로젝트의 build.gradle 파일을 선택합니다. 이후 Open as Project 버튼을 클릭하여 프로젝트를 임포트합니다.

 

 

 

이클립스 사용 시

• 이클립스를 실행하고 File → Import를 선택합니다. 프로젝트를 Gradle로 만들었다면 Existing Gradle Project를 선택하고, 압축을 풀었던 프로젝트 폴더를 선택합니다. 이후 필요한 옵션을 선택하고 프로젝트를 임포트합니다

 

 

4. 서버 실행

인텔리제이에서 실행

• 프로젝트를 임포트한 후, 프로젝트 이름으로 설정된 Application 클래스를 찾습니다. 이 클래스를 실행하면 내장된 Tomcat 서버가 시작됩니다. 브라우저에서 http://localhost:8080/을 입력하여 서버가 정상적으로 실행되었는지 확인합니다. 초기에는 404 에러 페이지가 표시될 수 있지만, 이는 정상적인 현상입니다.

 

명령줄에서 실행

• 프로젝트 디렉터리로 이동하여 gradlew bootRun 명령을 실행합니다. 이 명령으로 Spring Boot 애플리케이션이 시작됩니다.

 

 

 

5. 추가 설정 및 테스트

application.properties 또는 application.yml 파일 작성

• 프로젝트의 설정을 관리하기 위해 application.properties 또는 application.yml 파일을 작성합니다. 여기서 데이터베이스 설정, JPA 설정, 서버 포트 등 다양한 설정을 할 수 있습니다.

 

테스트

• 간단한 테스트를 위해 index.html 파일을 생성하거나, 컨트롤러를 통해 시작 페이지를 지정할 수 있습니다. 이후 IDE를 통해 실행하거나 터미널에서 직접 빌드 및 실행하여 정상 동작을 확인합니다.

 

실행 창 맨 밑에 종료 프로그램 코드 1이 뜨지 않으면 서버가 실행되는 중입니다.

 

 

6. 추가 기능 구현

• 기본적인 서버 설정이 완료되면, CRUD 기능을 추가하거나 REST API를 구축할 수 있습니다. 필요한 라이브러리를 추가하고, Entity, Repository, Service, Controller 등을 구현하여 완전한 REST API 서버를 구축할 수 있습니다.

 

이와 같은 단계를 통해 Spring Initializr를 이용하여 Spring Boot 서버를 쉽고 빠르게 생성할 수 있습니다.