이번 편의 목표: Spring Boot 3 프로젝트를 만들어 내장 웹 서버를 실행합니다.

스프링 부트 애플리케이션은 별도의 톰캣을 먼저 설치하지 않습니다. 의존성에 웹 스타터가 있으면 프로그램 안에 서버가 포함되고, main을 실행하면 그 서버가 같이 뜹니다.

프로젝트 만들기

브라우저에서 다음 주소를 엽니다.

외부 출처start.spring.iohttps://start.spring.io/링크 열기

프로젝트는 Maven, 언어는 Java, Spring Boot는 3의 안정 버전을 고릅니다. Group은 com.thinktree, Artifact는 library로 둡니다. 패키지 이름도 com.thinktree.library가 됩니다. 의존성은 Spring Web 하나만 추가합니다. Generate로 받은 압축을 풀고, 그 폴더를 작업 폴더로 사용합니다.

JDK 17 이상이 필요합니다. 자바 기초 01편에서 java와 javac 버전을 확인했다면 그 환경을 그대로 씁니다.

실행

프로젝트 폴더에서 Maven 래퍼로 실행합니다. 래퍼는 프로젝트에 포함된 mvnw 스크립트라서, Maven을 따로 설치하지 않아도 됩니다.

macOS와 Linux에서는 다음 명령을 사용합니다.

./mvnw spring-boot:run

Windows에서는 mvnw.cmd spring-boot:run 입니다.

처음 실행은 필요한 라이브러리를 받으므로 시간이 걸립니다. 로그에 Tomcat started와 Started LibraryApplication이 보이면 서버가 8080 포트에서 기다립니다. 다른 프로그램이 8080을 이미 쓰면 시작에 실패합니다. 끝낼 때는 그 터미널에서 Ctrl+C를 누릅니다.

아직 만든 주소가 없으므로 브라우저에서 http://localhost:8080 을 열면 404가 나올 수 있습니다. 서버가 떠서 응답한 404라면 실패가 아니라, 연결할 컨트롤러가 없다는 뜻입니다. 컨트롤러는 05편에서 추가합니다.

직접 해 보기

서버를 두 번 실행하고 두 번 정상적으로 종료하세요. 두 번째 실행에서는 라이브러리 다운로드가 거의 없어야 합니다.

해설

같은 명령으로 다시 실행하면 됩니다. 이전 서버를 끄지 않고 또 실행하면 포트가 사용 중이라는 오류가 납니다. 항상 하나면 종료한 뒤 다음 실행으로 넘어갑니다.