Spring Start Project, Initializr, 새롭게 시작해보기

일반적으로 Spring Boot를 처음 접하거나, 혹은 테스트를 위해서  새로운 프로젝트를 시작하는 경우 자주 하지 않아서 방황하는 경우가 있는데 시기에 따라서 IDE 환경에 따라서 여러 가지 방법이 존재하는데 이번에는 맥북에 설치된 STS4에서의 경험을 공유해보고자 한다.

 

다른 글들을 보면 일반적으로 메뉴에서

File > New > Spring Start Project 혹은

File > New > Orther > Spring Start

이런식으로 쉽게 생성해서 바로 시작하는 경우가 많은데, Spring Tool에서 Spring project가 없다니 참으로 이상하지만, 

저의 경우는 메뉴가 없었다.

그래서 이런 경우 다른 정보에 의하면 Help > Install New Software에서 Spring Boot 3, 4를 추가 설치하거나 해보았지만 메뉴는 여전히 나오지 않았다.

 

이런 경우 또다른 방법으로 spring.io 사이트에서 제공하는 생성기능(이니셜라이저(Spring Initializr)) 을 이용해 보았다.

start.spring.io

다른건 그대로 두고 Group, Artifact, Name 정도를 수정하려 [GENERATE]하면 프로젝트 파일이 압축되어 다운로드된다.
 프로젝트 폴더 위치로 압축을 해제하고 해당폴더를 STS에서
File > Import > Projects from File System or Archive 혹은 
File > open project from file system 해서 폴더를 지정하면 현재의 워크스페이스에 추가된다.

파일 구조는 일반적인 백앤드만 있는 스프링프레임워크 형식이다. 

여기서 build.gradle 

plugins {
	id 'java'
	id 'org.springframework.boot' version '3.5.3'
	id 'io.spring.dependency-management' version '1.1.7'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(17)
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

tasks.named('test') {
	useJUnitPlatform()
}

열어서 브라우저에서 열리도록 

implementation 'org.springframework.boot:spring-boot-starter-web' 추가한다.

추가로 기본적으로 로그인창이 뜨도록 되어있는데 일단은 테스트를 위해 로그인 없이 원하는 URL로 서비스가 바로 나오도록 DemoApplication을 다음과 같이 수정하여 보자. 

@SpringBootApplication(exclude = { SecurityAutoConfiguration.class })

 

실행해 보자

DemoApplication.java 에 진입점이 main() 있다

오른쪽 버튼을 누르거나 혹은 툴바에서 실행버튼을 눌러 Run as > Java Application 

(Run Configurations 설정유무에 따라 메뉴가 다를 수 있다)

마지막줄에 표시된 대로 8080 포트로 tomcat이 가동된다고 콘솔에 나와야 합니다.

이게 한 번에 된다면 당신은 아주 운이 좋은 것입니다. 축하합니다.

왜냐하면 설치된 자바버전에 따라서 Gradle이 정상적으로 모듈을 설치하는 것이 항상 문제를 일으키기 때문입니다. 우리가 앞에 Spring Initializr를 생성할 때 지정한 대로 java 17 이 설치되어 있다면 오류가 안 날 가능성이 높습니다.

 

오류가 있다면 Problems 탭에서 확인해 보고 원인을 해결해야 합니다. 오류가 있는 라인을 복사해서 chatGpt에서 넣어주면 대답을 잘해줍니다. Description 란에 나오는 메시지가 원래는 여러 행인데 한 행만 보여서 구체적인 오류 확인이 잘 안 됩니다. 줄을 통째로 복사해서 chatGpt에 붙여 넣으면 전체 메시지를 확인하기 편해서 일단 넣어 봅니다.

 

설치된 java버전이 다른 경우 project > properties > Java Compiler에서 조정을 해주어야 할 수도 있습니다.

 

브라우저에서 localhost:8080 입력하면 아직은 아래와 같이 뜨는 게 정상입니다.

수고하셨습니다.