개요

스프링 프레임워크로 개발을 시작하기 위해서는 적절한 개발 환경을 구축하는 것이 중요합니다. 이번 강의에서는 스프링 애플리케이션을 개발하기 위한 환경 설정 방법을 살펴보겠습니다. 자바 개발 환경부터 시작하여 IDE 선택, 빌드 도구 설정, 그리고 첫 번째 스프링 프로젝트를 생성하는 방법까지 다룹니다.

JDK(Java Development Kit) 설정

스프링은 자바 기반 프레임워크이므로 JDK를 설치해야 합니다. 현재 스프링 프레임워크 6.x 버전은 Java 17 이상을 요구하며, 스프링 부트 3.x는 Java 17 이상을 요구합니다. 이전 버전의 스프링을 사용할 경우에는 Java 8 이상을 사용할 수 있습니다.

JDK 설치 단계

JAVA_HOME = C:\Program Files\Java\jdk-17
PATH = %PATH%;%JAVA_HOME%\bin

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
export PATH=$PATH:$JAVA_HOME/bin

java -version

IDE(통합 개발 환경) 설정

스프링 애플리케이션 개발을 위한 IDE는 주로 Eclipse와 IntelliJ IDEA가 사용됩니다. 두 IDE 모두 스프링 개발을 위한 강력한 도구를 제공합니다.

빌드 도구

스프링 애플리케이션 개발에는 Maven이나 Gradle 같은 빌드 도구가 필수적입니다. 이러한 도구는 의존성 관리, 프로젝트 빌드, 테스트 실행 등의 작업을 자동화합니다.

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.example</groupId>
    <artifactId>spring-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    
    <properties>
        <java.version>17</java.version>
        <spring.version>6.0.0</spring.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>${spring.version}</version>
        </dependency>
    </dependencies>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

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

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

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

test {
    useJUnitPlatform()
}

첫 번째 스프링 프로젝트 생성

스프링 프로젝트를 생성하는 가장 쉬운 방법은 Spring Initializr를 사용하는 것입니다. 이 도구는 프로젝트 구조와 기본 설정을 자동으로 생성해줍니다.

Spring Initializr 사용하기

프로젝트 구조 이해하기

Spring Boot 프로젝트는 다음과 같은 구조를 가집니다:

my-spring-project/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       └── DemoApplication.java
│   │   └── resources/
│   │       ├── application.properties
│   │       ├── static/
│   │       └── templates/
│   └── test/
│       └── java/
│           └── com/example/demo/
│               └── DemoApplicationTests.java
├── pom.xml (또는 build.gradle)
└── README.md

• src/main/java: 자바 소스 코드 위치
• src/main/resources: 설정 파일, 정적 리소스, 템플릿 파일 위치
• src/test: 테스트 코드 위치
• pom.xml/build.gradle: 프로젝트 설정 및 의존성 파일

첫 번째 애플리케이션 실행하기

Spring Boot 애플리케이션을 실행하는 여러 방법이 있습니다:

실습 예제: Hello World 애플리케이션

첫 번째 Spring Boot 애플리케이션을 만들고 실행해 보겠습니다. 이 예제는 웹 브라우저에 간단한 인사말을 표시합니다.

1. Spring Boot 애플리케이션 클래스

먼저, Spring Boot 애플리케이션의 메인 클래스를 확인합니다. 이 클래스는 Spring Initializr에서 자동 생성됩니다:

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

2. 컨트롤러 생성

웹 요청을 처리할 컨트롤러 클래스를 생성합니다:

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {
    
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Framework!";
    }
    
    @GetMapping("/hello/{name}")
    public String helloWithName(@PathVariable String name) {
        return "Hello, " + name + "! Welcome to Spring Framework!";
    }
}

3. 애플리케이션 설정

src/main/resources/application.properties 파일에서 애플리케이션 설정을 구성할 수 있습니다:

# 서버 포트 설정
server.port=8080

# 애플리케이션 이름
spring.application.name=hello-spring

# 로깅 레벨 설정
logging.level.org.springframework=INFO
logging.level.com.example.demo=DEBUG

4. 애플리케이션 실행 및 테스트

1. IDE 또는 빌드 도구를 사용하여 애플리케이션을 실행합니다.
2. 웹 브라우저에서 http://localhost:8080/hello에 접속합니다.
3. “Hello, Spring Framework!”라는 메시지가 표시됩니다.
4. 또는 http://localhost:8080/hello/YourName과 같이 접속하여 개인화된 메시지를 확인합니다.

다음 단계

이제 스프링 프레임워크 개발 환경을 설정하고 첫 번째 애플리케이션을 실행해 보았습니다. 다음 강의에서는 스프링의 핵심 개념인 의존성 주입(Dependency Injection)과 제어의 역전(Inversion of Control)에 대해 자세히 살펴보겠습니다.