<div id="readability-page-1" class="page"><div>
<article>
<header>


</header>

<p>스프링 부트(Spring Boot)는 자바 기반의 오픈소스 웹 프레임워크로, 스프링 애플리케이션을 쉽고 빠르게 개발할 수 있도록 도와줍니다. 이 글에서는 VS Code를 사용해 Spring Boot 프로젝트를 생성하고 내장 톰캣 서버를 실행해서 접속해보겠습니다.</p>
<nav>
<ul>
<li><a href="#%EC%A4%80%EB%B9%84-%EB%8B%A8%EA%B3%84-openjdk-%EB%B0%8F-vs-code-%EC%84%A4%EC%B9%98">준비 단계: OpenJDK 및 VS Code 설치</a></li>
<li><a href="#spring-boot%EB%A5%BC-%EC%9C%84%ED%95%9C-extensions-%EC%84%A4%EC%B9%98">Spring Boot를 위한 Extensions 설치</a></li>
<li><a href="#vs-code%EC%97%90%EC%84%9C-spring-boot-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%EC%B4%88%EA%B8%B0%ED%99%94">VS Code에서 Spring Boot 프로젝트 초기화</a></li>
<li><a href="#spring-boot-%EC%84%9C%EB%B2%84-%EC%8B%A4%ED%96%89%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">Spring Boot 서버 실행하는 방법</a></li>
<li><a href="#hello-spring-boot">Hello, Spring Boot</a></li>
</ul>
</nav>
<h2 id="준비-단계-openjdk-및-vs-code-설치">준비 단계: OpenJDK 및 VS Code 설치</h2>
<p>먼저 Spring Boot 프로젝트 셋업에 앞서서 OpenJDK를 설치해야합니다. 맥OS에서는 Homebrew를 사용해 설치할 수 있습니다. temurin 빌드를 사용하는 걸 추천합니다. 이 글에서는 temurin17 빌드를 설치해서 진행하겠습니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/how-to-install-openjdk-in-macos/">맥에서 자바(OpenJDK) 설치하는 방법</a></li>
</ul>
<pre><code>$ brew tap homebrew/cask-versions
$ brew install homebrew/cask-versions/temurin17</code></pre>
<p>설치가 완료되었다면 <code>java_home</code> 명령어로 <code>JAVA_HOME</code> 환경변수를 설정하고, <code>java</code> 버전을 확인해봅니다.</p>
<pre><code>$ export JAVA_HOME=$(/usr/libexec/java_home -v 17)
$ java -version
openjdk version "17.0.10" 2024-01-16
OpenJDK Runtime Environment Temurin-17.0.10+7 (build 17.0.10+7)
OpenJDK 64-Bit Server VM Temurin-17.0.10+7 (build 17.0.10+7, mixed mode)</code></pre>
<p>필요하다면 셸 설정에 <code>JAVA_HOME</code> 환경변수를 추가하는 내용을 추가해주세요.</p>
<p>다음은 VS Code입니다. VS Code가 아직 설치되어있지 않다면, 다음 글을 참고해 설치해주세요.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/how-to-install-visual-studio-code-on-macos/">맥에서 VS Code 설치하는 방법</a></li>
</ul>
<h2 id="spring-boot를-위한-extensions-설치">Spring Boot를 위한 Extensions 설치</h2>
<p>다음으로 스프링 부트 개발을 위한 확장을 설치해줍니다. 먼저 VS Code 왼쪽의 Extensions 탭을 열어 java를 검색하면 나오는 Extension Pack for Java를 설치합니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image.png" alt="Extension Pack for Java를 설치합니다" width="1048" height="662" loading="lazy">
</figure>
<p>다음으로 spring boot를 검색하면 검색 결과에 나오는 Spring Boot Extension Pack을 설치합니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image%202.png" alt="Spring Boot Extension Pack" width="1080" height="744" loading="lazy">
</figure>
<p>여기까지 필수 확장 설치를 마쳤습니다.</p>
<h2 id="vs-code에서-spring-boot-프로젝트-초기화">VS Code에서 Spring Boot 프로젝트 초기화</h2>
<p>이제 VS Code에서 바로 Spring Boot 프로젝트를 초기화해보겠습니다. Command + Shift + P를 입력해 커맨드 팔레트를 열고 spring init을 입력하면 Spring Initializr 3가지가 나옵니다. 여기서는 Maven 프로젝트로 생성을 진행하겠습니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image%203.png" alt="커맨드 팔레트에서 spring init을 입력합니다" width="1500" height="499" loading="lazy">
</figure>
<p>이후에는 스프링 부트 프로젝트와 관련된 옵션을 선택합니다. 괄호 안은 예제에서 입력한 값입니다.</p>
<ul>
<li>
<strong>Spring Boot Version</strong>: 스프링 부트 버전을 선택합니다. (3.2.4)</li>
<li>
<strong>Project language</strong>: 프로젝트의 언어를 선택합니다. (Java)</li>
<li>
<strong>Group Id</strong>: 그룹 아이디를 지정합니다.(com.lainyzine)</li>
<li>
<strong>Artifact Id</strong>: 아티팩트 아이디를 지정합니다. (awesome-service)</li>
<li>
<strong>Packaging type</strong>: 패키징 타입을 선택합니다. (Jar)</li>
<li>
<strong>Java Version</strong>: 자바 버전을 선택합니다. (17)</li>
<li>
<strong>Dependancies</strong>: 설치한 의존성들을 선택합니다. (선택하지 않았습니다)</li>
</ul>
<p>여기까지 선택하고 나면 마지막으로 프로젝트를 저장할 위치를 선택합니다. 디렉터리를 선택하고, Generate into this folder 버튼을 클릭합니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image%2011.png" alt="저장할 디렉터를 선택합니다" width="1500" height="840" loading="lazy">
</figure>
<p>프로젝트가 만들어지면 오른쪽 하단에 알람이 나타납니다. 여기서 Open 버튼을 클릭해주세요.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image%2012.png" alt="프로젝트가 생성되면 팝업으로 알려줍니다" width="1500" height="581" loading="lazy">
</figure>
<p>프로젝트가 생성된 것을 확인할 수 있습니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/image%2013.png" alt="스프링부트 프로젝트 메인 파일" width="1500" height="704" loading="lazy">
</figure>
<h2 id="spring-boot-서버-실행하는-방법">Spring Boot 서버 실행하는 방법</h2>


<p>Ctrl + `(백틱)을 입력해 터미널 창을 엽니다. 혹은 View -&gt; Terminal을 선택해도 터미널 창이 열립니다. 먼저 현재 사용가능한 Java 버전을 확인해봅니다.</p>
<pre><code>$ java -version
openjdk version "17.0.10" 2024-01-16
OpenJDK Runtime Environment Temurin-17.0.10+7 (build 17.0.10+7)
OpenJDK 64-Bit Server VM Temurin-17.0.10+7 (build 17.0.10+7, mixed mode)</code></pre>
<p>프로젝트 생성에 사용한 버전이 맞다면, 바로 프로젝트를 실행해보겠습니다.</p>
<pre><code>$ ./mvnw spring-boot:run
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.561 s
[INFO] Finished at: 2024-03-31T18:20:59+09:00
[INFO] ------------------------------------------------------------------------</code></pre>
<p>처음에는 조금 시간이 걸립니다만, 서버가 실행되지 않고 BUILD SUCCESS 메시지만 나오고 프로그램이 종료됩니다. 서버를 실행하기 위해서는 spring-boot-starter-web 의존성을 추가해야합니다. 프로젝트 루트의 pom.xml 파일을 열고 <code>&lt;dependencies&gt;</code> 태그 안에 다음 내용을 추가하고 저장합니다.</p>
<pre><code>  &lt;dependencies&gt;
    ...
    &lt;dependency&gt;
      &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
      &lt;artifactId&gt;spring-boot-starter-web&lt;/artifactId&gt;
    &lt;/dependency&gt;
  &lt;/dependencies&gt;</code></pre>
<p>다시 터미널에서 서버를 실행해봅니다.</p>
<pre><code>$ ./mvnw spring-boot:run
...
2024-03-31T18:24:00.706+09:00  INFO 21774 --- [awesome-service] [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port 8080 (http) with context path ''
2024-03-31T18:24:00.711+09:00  INFO 21774 --- [awesome-service] [           main] c.l.a.AwesomeServiceApplication          : Started AwesomeServiceApplication in 0.763 seconds (process running for 1.221)</code></pre>
<p>이번에는 서버가 실행되고, 대기 상태가 되었습니다. 출력을 통해서 톰캣 서버가 8080 포트에 실행된 것을 알 수 있습니다.</p>
<p>웹 브라우저를 열고, <code>localhost:8080</code>을 열어봅니다. 이 주소는 현재 컴퓨터의 8080포트에 접속하는 주소입니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/SCR-20240331-qctu-2.png" alt="localhost:8080으로 접속하니 에러가 납니다" width="1495" height="1000" loading="lazy">
</figure>
<p>에러 페이지가 나타납니다만, 무언가 서버가 동작중인 것을 알 수 있습니다. 여기까지 Spring Boot 프로젝트를 초기화하고 서버를 실행해보았습니다.</p>
<h2 id="hello-spring-boot">Hello, Spring Boot</h2>
<p>에러 페이지 대신 루트(<code>/</code>) 페이지를 처리하는 컨트롤러를 만들어보겠습니다. 아래 경로에 다음 내용을 추가하고 저장해주세요.</p>
<pre><code>// /src/main/java/com/lainyzine/awesomeservice/HelloController.java

package com.lainyzine.awesomeservice;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/")
    public String hello() {
        return "&lt;h1 style=\"text-align: center; margin-top: 5rem\"&gt;Hello, Spring Boot!&lt;/h1&gt;";
    }
}</code></pre>
<p>터미널 창에서 Ctrl + C 를 입력해 서버를 종료하고 서버를 다시 실행합니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/SCR-20240331-qelq-2.png" alt="새로 추가한 컨트롤러 파일" width="1500" height="975" loading="lazy">
</figure>
<p>다시 <code>localhost:8080</code>에 접속해봅니다. Hello 함수의 반환 값이, 정상적으로 출력됩니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/creating-a-spring-boot-project-in-vs-code/assets/SCR-20240331-qfir-2.png" alt="localhost:8080에서 새로 추가한 페이지를 보여줍니다" width="1500" height="979" loading="lazy">
</figure>
<p>여기까지 자바 스프링 부트 프로젝트를 초기화하고, 예제 컨트롤러를 만들어보았습니다.</p>


</article>
</div></div>

LZ: 프로그래머 가이드

LainyZine

이 글에서는 VS Code에서 스프링 부트 프로젝트를 생성하고 간단한 컨트롤러를 만들어봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

VS Code에서 Spring Boot 프로젝트 만들기

댓글