웹 개발

SpringBoot 개발환경 설정하기.

Blue_bull 2025. 2. 17. 20:10

Ⅰ. Spring Boot 프로젝트 생성하기.

1. Spring Boot 프로젝트를 쉽게 생성할 수 있도록 도와주는 공식 사이트 접속.

(1) https://start.spring.io/

- 기본적인 틀을 제공해주어 의존성(Dependencies) 추가, 패키징 선택, Java 버전 설정 등을 한 번에 할 수 있다.

img.png

(2) 빌드는 Maven, 프로그래밍 언어는 Java, Spring Boot 버젼은 3.3.8, 패키징은 Jar, Java버젼은 17로 한다.

(3) Project Metadata

  • Group: 프로젝트의 조직명이나 도메인 네임, 패키지 네임의 기본이 됨.
  • Artifact: 빌드 결과물(JAR/WAR)의 이름, 프로젝트의 고유 식별자.
  • Name: 프로젝트의 기본 이름(보통 Artifact와 동일).
  • Description: 프로젝트의 목적이나 기능을 설명하는 짧은 문장.
  • Package name: 기본 패키지 경로 (Group + Artifact 조합).
  • Packaging: 최종 실행 파일 형식 (jar: 단독 실행, war: 웹 서버 배포용).
  • Java: 사용할 Java 버전 (Spring Boot 호환 버전 확인 필요).

    (4). JSP에서 lib 폴더에 jar 파일을 넣듯이, Spring Boot에서는 Dependencies에 라이브러리를 추가하면 자동으로 관리됨. (pom.xml의 또는 build.gradle의 dependencies { })

Ⅱ. 인텔리제이 IDEA에서 SpringBoot 프로젝트 환경설정 하기.

1.프로젝트를 열어준다.

img_1.png

2. 프로젝트 생성시 설정한 내용 확인.

  • pom.xml 프로젝트 전반에 설정된 메타데이터 정보를 가지고 있다.
  • 의존관계를 갖는 파일들을 나타낸다.
    img_2.png

3. JDK 버젼 맞춰주기.

1. File - Project Structure.

2. SpringBoot 프로젝트 생성시의 자바 버젼과 같게 하기.

  • 다운로드 되지 않았다면 Download JDK로 다운로드 해준다.
  • JDK가 설정되지 않으면 프로젝트가 실행되지 않는다.

img_4.png

4. 인코딩 문제를 방지하고 정상적으로 출력하기 위해 UTF-8로 바꿔주기.

1. File - Project Structure - File Encodings

2. Global Encoding, Project Encoding, Default encoding for properties files를 "UTF-8"로 바꾸기.

  • 인코딩이 맞지 않으면 한글 깨짐이 발생할 수 있다.

img_5.png

5. Spring Boot 서버 설정하기

1. application.properties 파일 열기.

2. server.port=9000 입력.

  • 기본 포트 설정은 개발할 때 서버 충돌을 방지하는 데 중요하다.
    img_6.png

6. import 자동 추가 정리 기능 설정하기.

1. File - Project Structure - Editor-General - Auto import

2. Java - "Add unambiguous imports on the fly"와 "optimize imports on the fly" 항목 체크

  • 자동으로 필요한 import를 추가하고, 불필요한 import를 정리해주는 기능이 활성화되어 개발 속도가 빨라진다.
    img_7.png

7. spring-boot-devtools 라이브러리 추가 됐는지 확인하기.

img_8.png

1. pom.xml 파일에서 spring-boot-devtools 찾아 라이브러리가 추가 됐는지 확인하기.

2. spring-boot-devtools는 Spring Boot 개발을 편리하게 해주는 개발 도구 모음이다.

- 핫 리로드(코드 수정 후 자동 반영), Live Reload, 캐시 비활성화 등의 기능 포함

8-1. Spring Boot 서버 설정하기

1. application.properties 파일 열기.

2. server.port=9000 입력.

- Spring Boot의 기본 포트는 **8080이지만, server.port=9000으로 설정하여 9000번 포트에서 서버가 실행되게 함.**

img_9.png

8-2. Spring Boot 서버 설정하기

1. application.properties 파일 열기

2. spring.devtools.restart.enabled=true 입력

- Spring Boot DevTools의 "자동 재시작(Hot Restart)" 기능을 활성화하여, 코드 변경 시 서버가 자동으로 재시작되도록 설정함.

img_10.png

9. import 자동 추가 정리 기능 설정하기.

1. File - Settings - Advanced Settings - compiler

2. "Allow auto-make to start even if developed application is currently running" 항목 체크

- 애플리케이션이 실행 중이어도 코드 변경 시 자동으로 빌드가 수행됨.

img_11.png

10.파일 저장 시 변경된 코드 자동 컴파일 기능 설정하기.

1. File - Settings - Build, Execution, Deployment - compiler

2. "Bild project automatically" 항목 체크

- 파일 저장 시 변경된 코드가 자동으로 컴파일되어 반영됨.

img_12.png

11. F5 없이 브라우저 새로고침하기

1. application.properties 파일 열기

2. spring.devtools.livereload.enabled=true 입력

- 코드 변경 시 F5 없이 자동으로 브라우저가 새로고침되도록 Live Reload 기능 활성화.

img_13.png

12. F5 없이 브라우저 새로고침하기

1. 크롬 웹 브라우저 열기

2. live reload chrome 검색하여 추가하기

- 코드 변경 시 브라우저를 자동으로 새로고침해주는 기능.

img_14.png

13. Thymeleaf 변경 사항을 서버 재시작 없이 즉시 반영하도록 캐싱 비활성화.

1. application.properties 파일 열기

2. spring.thymeleaf.cache=false 입력

- 캐쉬메모리가 남아 갱신이 안되는 경우가 있기에 캐싱 비활성화.

img_15.png

14. Lombok 라이브러리를 설정하여 자동으로 Getter, Setter 등을 생성하도록 하고, 어노테이션 처리가 정상적으로 작동하도록 설정

pom.xml 파일을 열어서 아래와 같이 코드를 수정하고 추가해준다.

(1) 코드 수정

원래 코드

   <dependency>
   <groupId>org.projectlombok</groupId>
   <artifactId>lombok</artifactId>
   <optional>true</optional>
   </dependency>

수정된 코드

  <!-- for Lombok Library-->
  <dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
  <version>1.18.36</version>
  <scope>provided</scope>
  </dependency>

img_16.png

(2) 코드 수정

원래 코드

<configuration>
    <annotationProcessorPaths>
        <path>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </path>
    </annotationProcessorPaths>
</configuration>

수정된 코드

<configuration>
   <source>17</source>
   <target>17</target>
   <annotationProcessorPaths>
      <path>
         <groupId>org.projectlombok</groupId>
         <artifactId>lombok</artifactId>
         <version>1.18.36</version>
      </path>
   </annotationProcessorPaths>
</configuration>

(3) 코드 추가

<!-- Lombok Annotation Processor --> //어노테이션 처리자이다.
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok-mapstruct-binding</artifactId>
<version>0.2.0</version>
</dependency>

img_17.png

15. 컴파일 시 Lombok 등 어노테이션 기반 코드를 자동 생성하도록 활성화.

1. File - Settings - Compiler - Annotation Processors

2. "Enable annotation processing" 항목 체크

img_20.png

16. "Lombok"을 검색하여 install해준다.

1. File - Settings - Plugins

2. "Lombok"을 검색하여 install해준다.

img_19.png

'웹 개발' 카테고리의 다른 글

React - Router의 동작 흐름  (0) 2025.02.24
Java - 특정 폴더의 이미지 파일 목록 가져오기  (0) 2025.02.24
배열 정렬 하기 - toSorted(), Sort()  (1) 2025.02.15
JavaScript 객체 및 데이터 변환 정리  (0) 2025.02.15
JavaScript 키-밸류 출력하는 다양한 방법  (0) 2025.02.15

'웹 개발'의 다른글

  • 현재글SpringBoot 개발환경 설정하기.

관련글

티스토리툴바