스프링 부트 백엔드 개발 강좌, 데이터베이스, 그림으로 이해하는 프로젝트

안녕하세요! 오늘은 스프링 부트를 활용한 백엔드 개발 강좌를 진행하겠습니다. 이 강좌에서는 스프링 부트의 기본 개념부터 시작하여 데이터베이스 연동, REST API 개발, 그리고 마지막으로 그림을 통해 프로젝트 구조를 이해하는 방법까지 자세히 살펴보겠습니다.

1. 스프링 부트란?

스프링 부트(Spring Boot)는 자바 기반의 스프링 프레임워크를 더욱 간편하게 사용할 수 있도록 돕는 프레임워크입니다. 개발자가 애플리케이션을 신속하게 구축할 수 있도록 지원하며, 복잡한 설정 없이도 실행 가능한 Spring 어플리케이션을 만들 수 있게 해줍니다.

스프링 부트의 주요 특징은 다음과 같습니다:

  • 자동 설정: Spring 설정을 자동으로 구성합니다.
  • 독립 실행형 애플리케이션: JAR 파일로 패키징하여 쉽게 배포하고 실행할 수 있습니다.
  • 생산 준비 완료: 외부 설정 기능과 모니터링 메트릭스를 제공합니다.
  • 스타터 의존성: 필요한 의존성을 간편하게 추가할 수 있도록 도와줍니다.

2. 개발 환경 설정

스프링 부트를 사용하기 위해서는 Java Development Kit (JDK)를 설치하고, IDE(통합 개발 환경)를 선택해야 합니다. 본 강좌에서는 IntelliJ IDEA를 사용하겠습니다.

2.1 JDK 설치

JDK는 Oracle 공식 웹사이트나 OpenJDK를 통해 다운로드할 수 있습니다. 설치 후에는 PATH 환경 변수를 설정하여 JDK를 사용할 수 있도록 해야 합니다.

2.2 IntelliJ IDEA 설치

IntelliJ IDEA는 JetBrains에서 제공하는 IDE입니다. Community Edition은 무료로 제공되며, 스프링 부트 개발에 적합합니다. 공식 웹사이트에서 다운로드 후 설치합니다.

3. 스프링 부트 프로젝트 생성

이제 새로운 스프링 부트 프로젝트를 생성해봅시다. IntelliJ IDEA에서 “New Project”를 클릭하고, “Spring Initializr”를 선택합니다.

3.1 프로젝트 설정

다음과 같은 정보를 입력합니다:

  • Group: com.example
  • Artifact: demo
  • Name: demo
  • Description: Demo project for Spring Boot
  • Package name: com.example.demo
  • Packaging: Jar
  • Java: 11

그 다음, “Dependencies”에서 “Spring Web”, “Spring Data JPA”, “H2 Database”를 추가합니다.

4. 데이터베이스와의 연동

스프링 부트는 다양한 데이터베이스와 쉽게 연동할 수 있도록 지원합니다. 본 강좌에서는 H2 데이터베이스를 사용하여 간단한 CRUD 애플리케이션을 만들어보겠습니다.

4.1 H2 데이터베이스 설정

H2 데이터베이스는 인메모리 데이터베이스로, 프로젝트의 src/main/resources/application.properties 파일에 다음을 추가하여 설정합니다:

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.h2.console.enabled=true

4.2 Entity 클래스 생성

이제 데이터베이스와 매핑할 Entity 클래스를 생성합니다. “model” 패키지를 만들고, 예를 들어 User 클래스를 아래와 같이 작성합니다:

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

4.3 Repository 인터페이스 생성

스프링 데이터 JPA를 사용하여 데이터베이스와 상호작용하기 위해 Repository 인터페이스를 생성합니다. ‘repository’ 패키지를 만들고 다음과 같이 인터페이스를 작성합니다:

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository {
}

4.4 Service 클래스 생성

비즈니스 로직을 처리하기 위해 Service 클래스를 생성합니다. ‘service’ 패키지를 만들고 UserService 클래스를 아래와 같이 작성합니다:

package com.example.demo.service;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public List findAll() {
        return userRepository.findAll();
    }

    public User save(User user) {
        return userRepository.save(user);
    }
}

4.5 Controller 클래스 생성

HTTP 요청을 처리하기 위해 Controller 클래스를 만듭니다. ‘controller’ 패키지를 만들고 UserController 클래스를 작성합니다:

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping
    public List getAllUsers() {
        return userService.findAll();
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.save(user);
    }
}

5. RESTful API의 이해

이제 스프링 부트를 이용한 RESTful API를 이해해보겠습니다. REST는 Representational State Transfer의 약자로, 웹 기반의 아키텍처 스타일입니다. RESTful API는 HTTP 요청을 통해 자원을 생성, 읽기, 수정 및 삭제하는 방식으로 작동합니다.

5.1 HTTP 메소드

RESTful API는 다음과 같은 HTTP 메소드를 사용합니다:

  • GET: 자원의 조회
  • POST: 자원의 생성
  • PUT: 자원의 수정
  • DELETE: 자원의 삭제

5.2 JSON 데이터

RESTful API에서 데이터를 전송하기 위해 일반적으로 JSON(JavaScript Object Notation) 형식을 사용합니다. JSON은 가볍고 사람이 읽기 쉬운 데이터 포맷으로, 웹 애플리케이션에서 널리 사용됩니다.

6. 그림으로 이해하는 프로젝트 구조

이제까지의 내용을 바탕으로 프로젝트 구조를 그려보도록 하겠습니다. 다음은 전반적인 프로젝트 구조입니다:

demo
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.example.demo
│   │   │       ├── controller
│   │   │       │   └── UserController.java
│   │   │       ├── model
│   │   │       │   └── User.java
│   │   │       ├── repository
│   │   │       │   └── UserRepository.java
│   │   │       └── service
│   │   │           └── UserService.java
│   │   └── resources
│   │       └── application.properties
└── pom.xml

7. 결론

이번 강좌에서는 스프링 부트를 사용한 백엔드 개발의 기초를 배우고, 데이터베이스와 연동하여 간단한 RESTful API를 구현하는 방법을 알아보았습니다. 스프링 부트는 강력한 기능을 가진 프레임워크이므로, 추가적인 학습을 통해 더 다양한 기능을 활용해 보시길 권장합니다.

여기서 멈추지 말고, 다양한 프로젝트에 도전해보세요! 여러분의 개발 여정을 응원합니다!

스프링 부트 백엔드 개발 강좌, 깃허브 리포지터리 생성하고 코드 푸시하기

스프링 부트(Spring Boot)는 자바 기반의 웹 애플리케이션을 쉽게 개발할 수 있도록 도와주는 프레임 워크입니다. 이번 강좌에서는 스프링 부트를 활용하여 간단한 백엔드 애플리케이션을 구축하고, 이를 깃허브(GitHub)에 저장하는 방법에 대해 자세히 설명하겠습니다. 우리는 애플리케이션을 개발한 후, 깃허브 리포지터리를 생성하고, 코드를 푸시하는 과정까지 안내할 것입니다.

목차

  • 1. 스프링 부트 소개
  • 2. 개발 환경 설정
  • 3. 간단한 스프링 부트 애플리케이션 만들기
  • 4. 깃허브 리포지터리 생성하기
  • 5. 코드 푸시하기
  • 6. 마무리 및 추가 자료

1. 스프링 부트 소개

스프링 부트는 스프링 프레임워크를 기반으로 하여 빠르고 안정적으로 애플리케이션을 구축할 수 있도록 제공되는 도구입니다. 스프링 부트는 설정을 간소화하고, 자동 구성을 통해 개발자가 최소한의 작업으로 애플리케이션을 실행할 수 있도록 돕습니다.

스프링 부트의 주요 특징은 다음과 같습니다.

  • 자동 설정 : 스프링 부트는 프로젝트에 필요한 기본 설정을 자동으로 처리합니다.
  • 스타터 의존성 : 다양한 기능을 쉽게 추가할 수 있는 스타터 의존성이 제공됩니다.
  • 내장 웹 서버 : 톰캣(Tomcat), 제티(Jetty)와 같은 서버를 내장하여 별도의 설치 없이 애플리케이션을 실행할 수 있습니다.
  • 운영 환경에서의 모니터링 및 관리 : 스프링 부트는 운영 환경에서 애플리케이션을 모니터링하고 관리할 수 있는 다양한 기능을 제공합니다.

2. 개발 환경 설정

필수 도구 설치

안정적인 개발 환경을 구성하기 위해서는 다음 도구들이 필요합니다.

  • Java Development Kit (JDK): 스프링 부트를 실행하기 위해서는 JDK가 필요합니다. JDK 8 이상 버전을 설치해야 합니다.
  • IntelliJ IDEA 또는 Eclipse: 스프링 부트 애플리케이션을 개발하기 위한 IDE입니다. IntelliJ IDEA는 무료와 유료 모두 제공되며, Eclipse는 모든 플랫폼에서 사용할 수 있는 무료 IDE입니다.
  • Git: 버전 관리를 위한 도구입니다. Git을 사용하여 코드 변경 사항을 추적하고, 변경 사항을 리모트 저장소에 푸시할 수 있습니다.
  • 깃허브 계정: 코드 저장을 위한 깃허브 리포지터리를 만들기 위해 깃허브 계정이 필요합니다. 여기에서 가입할 수 있습니다.

개발 환경 설치 절차

각 도구를 설치하는 방법은 다음과 같습니다.

1. JDK 설치

JDK는 오라클 웹사이트에서 다운로드할 수 있습니다. 운영 체제에 맞는 버전을 선택하여 설치합니다.

2. IDE 설치

IntelliJ IDEA는 JetBrains의 공식 웹사이트에서 다운로드할 수 있으며, Eclipse는 오르그의 웹사이트에서 다운로드 가능합니다. IDE를 설치한 후, JDK 경로를 IDE에 설정합니다.

3. Git 설치

Git은 공식 웹사이트에서 다운로드하여 설치할 수 있습니다. 설치 후, Command Line 또는 Terminal에서 git --version 명령어를 실행하여 설치가 완료되었는지 확인합니다.

3. 간단한 스프링 부트 애플리케이션 만들기

이제 실제로 스프링 부트 애플리케이션을 만들어 보겠습니다. 다음 단계를 통해 애플리케이션을 생성할 수 있습니다.

Step 1: 스프링 초기화

스프링 부트 프로젝트를 초기화하기 위해 Spring Initializr를 사용합니다.

  • Project: 선택합니다. (‘Maven Project’ 또는 ‘Gradle Project’)
  • Language: ‘Java’를 선택합니다.
  • Spring Boot: 최신 스프링 부트 버전을 선택합니다.
  • Group: 예를 들어, com.example로 입력합니다.
  • Artifact: 원하는 프로젝트 이름을 입력합니다. 예를 들어, my-spring-boot-app로 설정합니다.
  • Dependencies: Spring Web를 선택합니다. 필요에 따라 다른 종속성을 추가할 수 있습니다.

설정을 마친 후, Generate 버튼을 클릭하여 ZIP 파일로 프로젝트를 다운로드합니다.

Step 2: IDE에서 프로젝트 불러오기

다운로드한 ZIP 파일을 IDE에서 불러옵니다. 이를 위해 IDE를 열고, File -> Open을 선택하여 ZIP 파일을 열거나, 압축을 푼 후 해당 폴더를 열 수 있습니다.

Step 3: 기본 코드 작성하기

프로젝트 구조가 설정되면 src/main/java/com/example/myspringbootapp/MySpringBootApp.java 파일을 열어 다음과 같은 코드로 업데이트합니다:

package com.example.myspringbootapp;

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

@SpringBootApplication
public class MySpringBootApp {

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

간단한 스프링 부트 애플리케이션의 시작점입니다. 이제 간단한 REST API를 만들어 보겠습니다.

Step 4: REST 컨트롤러 작성하기

먼저, 새로운 클래스 파일 GreetingController.java를 생성합니다. 다음과 같이 작성합니다:

package com.example.myspringbootapp;

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

@RestController
public class GreetingController {
    
    @GetMapping("/greeting")
    public String greeting(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello, %s!", name);
    }
}

위 코드는 /greeting API 엔드포인트를 생성하며, 쿼리 매개변수로 이름을 전달받아 인사 메시지를 반환합니다.

Step 5: 애플리케이션 실행하기

IDE에서 메인 클래스(MySpringBootApp)를 실행하거나, 터미널에서 다음 명령어를 실행하여 애플리케이션을 시작할 수 있습니다:

./mvnw spring-boot:run

브라우저에 http://localhost:8080/greeting를 입력하여 API를 호출할 수 있습니다. 만약 http://localhost:8080/greeting?name=Alice를 입력하면 “Hello, Alice!”라는 메시지를 받게 됩니다.

4. 깃허브 리포지터리 생성하기

이제 스프링 부트 애플리케이션을 깃허브에 저장할 차례입니다. 그동안 만든 코드를 깃허브에 올리기 위해서는 먼저 깃허브 리포지터리를 생성해야 합니다.

Step 1: 깃허브에 로그인하기

먼저, 깃허브에 로그인합니다. 계정이 없다면 회원가입을 해야 합니다.

Step 2: 새로운 리포지터리 생성하기

로그인 후 오른쪽 상단의 “+” 버튼을 클릭하여 “New repository”를 선택합니다. 리포지터리 이름과 설명을 입력하고, Public이나 Private 옵션을 선택한 후 Create repository 버튼을 클릭합니다.

5. 코드 푸시하기

이제 로컬에서 작성한 코드를 깃허브 리포지터리에 푸시하는 과정에 대해 알아보겠습니다.

Step 1: Git 초기화

프로젝트 폴더로 이동하여 Git을 초기화합니다. 터미널에서 다음 명령어를 실행합니다:

git init

Step 2: 깃허브 리모트 리포지터리 추가하기

계속해서 깃허브에서 생성한 리포지터리의 주소를 추가합니다. 리포지터리의 주소는 깃허브 상단의 URL 표시줄에서 복사할 수 있습니다:

git remote add origin https://github.com/USERNAME/REPOSITORY_NAME.git

여기서 USERNAME은 깃허브 사용자 이름이고, REPOSITORY_NAME은 생성한 리포지터리 이름입니다.

Step 3: 변경 사항 추가 및 커밋하기

변경 사항을 커밋하기 위해 다음 명령어를 실행합니다:

git add .
git commit -m "Initial commit"

Step 4: 코드 푸시하기

마지막으로, 로컬 변경 사항을 깃허브에 푸시합니다:

git push -u origin master

6. 마무리 및 추가 자료

축하합니다! 이제 간단한 스프링 부트 애플리케이션을 만들고, 깃허브 리포지터리에 코드를 푸시하는 방법까지 익혔습니다. 이 과정은 백엔드 개발의 기초를 다지는 중요한 단계입니다.

추가적인 자료와 참고문헌은 다음 링크를 통해 확인할 수 있습니다:

이 강좌가 도움이 되었길 바랍니다. 더 나아가고 싶은 분들은 스프링 부트와 Git을 활용하여 다양한 프로젝트에 도전해 보세요!

스프링 부트 백엔드 개발 강좌, 그림으로 이해하는 프로젝트

안녕하세요! 이번 강좌에서는 스프링 부트를 이용한 백엔드 개발의 기초부터 고급 주제까지 다룰 것입니다. 이 강좌는 시각적으로 이해하기 쉽도록 그림과 함께 설명하므로, 초보자도 쉽게 따라할 수 있습니다. 단계적으로 진행되는 이 프로젝트는 실제 웹 애플리케이션을 개발하는 데 필요한 모든 요소를 다룹니다.

1. 스프링 부트란?

스프링 부트는 스프링 프레임워크를 바탕으로 한 최신의 경량화된 프레임워크입니다. 이는 개발자가 설정 및 구성 작업에 소요되는 시간을 최소화하고, 근본적으로 스프링 애플리케이션의 부트스트랩 과정을 간소화합니다.

Spring Boot Architecture

그림 1: 스프링 부트 아키텍처

스프링 부트의 주요 장점은 다음과 같습니다:

  • 빠른 개발: 내장 톰캣 서버와 자동 설정 기능을 제공합니다.
  • 배포 용이: 다양한 플랫폼에서 손쉽게 배포할 수 있습니다.
  • 생산적 개발: 간단한 설정만으로도 강력한 기능을 이용할 수 있습니다.

2. 개발환경 설정

스프링 부트 애플리케이션을 개발하기 위해서는 JDK, Maven 및 IDE를 설치해야 합니다. 다음은 각 도구에 대한 설정 방법입니다.

2.1 JDK 설치

스프링 부트를 사용하기 위해 Java Development Kit(JDK)를 설치해야 합니다. JDK의 최신 버전을 다운로드하여 설치하십시오. 설치 후, 환경 변수에서 JAVA_HOME을 설정합니다.

2.2 Maven 설치

Maven은 의존성 관리를 위한 도구입니다. Maven을 설치 후, PATH 환경 변수에 Maven bin 경로를 추가합니다.

2.3 IDE 설치

IntelliJ IDEA 또는 Eclipse와 같은 IDE를 사용하여 스프링 부트 프로젝트를 편리하게 관리할 수 있습니다. 특히 IntelliJ IDEA는 스프링 부트와의 통합 지원이 뛰어나 추천합니다.

3. 첫 번째 스프링 부트 프로젝트 생성하기

이제 실제로 스프링 부트 프로젝트를 생성해 보겠습니다. Spring Initializr를 사용하여 프로젝트를 생성할 수 있습니다. 아래의 단계를 따르세요:

  1. Spring Initializr 웹사이트에 접속합니다.
  2. 프로젝트 메타데이터를 입력합니다.
  3. 의존성을 추가합니다. (Spring Web, Spring Data JPA, H2 Database 등)
  4. 프로젝트를 다운로드하고 IDE에서 엽니다.

3.1 프로젝트 구조 이해하기

생성된 프로젝트는 다음과 같은 구조로 되어 있습니다:

my-spring-boot-project/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── demo/
│   │   │               ├── DemoApplication.java
│   │   │               └── controller/
│   │   │               └── service/
│   │   │               └── repository/
│   │   └── resources/
│   │       ├── application.properties
│   └── test/
│       └── java/
└── pom.xml

이 구조에서 DemoApplication.java는 애플리케이션의 진입점 역할을 합니다.

4. RESTful API 개발

이제 기본적인 RESTful API를 만들어 보겠습니다. 스프링 부트는 RESTful 서비스를 매우 간단하게 구축할 수 있도록 지원합니다.

4.1 모델 클래스 만들기

먼저, 데이터 모델 클래스를 만들어보겠습니다. 예를 들어, 사용자 정보를 저장하는 User 클래스를 만들어 보겠습니다.

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // getters and setters
}

4.2 레포지토리 인터페이스 만들기

데이터를 조회하거나 수정하기 위해 JPA를 활용한 레포지토리 인터페이스를 생성합니다.

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository {
}

4.3 서비스 클래스 만들기

비즈니스 로직을 처리하기 위해 서비스 클래스를 생성합니다.

package com.example.demo.service;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public List getAllUsers() {
        return userRepository.findAll();
    }

    public User createUser(User user) {
        return userRepository.save(user);
    }

    // 다른 메서드들
}

4.4 컨트롤러 클래스 만들기

HTTP 요청을 처리하는 컨트롤러 클래스를 생성합니다.

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping
    public List getAllUsers() {
        return userService.getAllUsers();
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }
}

5. 데이터베이스 설정

이제 H2 데이터베이스를 설정하겠습니다. application.properties 파일을 수정하여 데이터베이스 설정을 추가합니다.

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.h2.console.enabled=true
spring.jpa.hibernate.ddl-auto=update

6. 테스트하기

이제 모든 준비가 끝났습니다. 스프링 부트 애플리케이션을 실행하면 내장된 H2 데이터베이스에서 RESTful API를 통해 사용자 데이터를 생성하고 조회할 수 있습니다. Postman과 같은 도구를 사용하여 API 테스트를 수행할 수 있습니다.

Postman 사용 예시

그림 2: Postman에서 API 테스트

7. 마무리

이번 강좌를 통해 스프링 부트를 사용하여 간단한 백엔드 애플리케이션을 만드는 방법을 배웠습니다. 스프링 부트는 복잡한 설정 없이 신속하게 프로젝트를 진행할 수 있도록 도와주며, RESTful API 개발에 매우 적합합니다. 이 강좌를 통해 여러분이 스프링 부트로 더 깊이 있는 백엔드 개발을 할 수 있는 기반이 되었기를 바랍니다.

8. 추가 자료

더 배우고 싶다면 아래의 자료를 참고하세요:

스프링 부트 백엔드 개발 강좌, 깃과 깃허브

안녕하세요! 이번 강좌에서는 스프링 부트 개발을 시작하면서 깃(Git)과 깃허브(GitHub)를 어떻게 활용할 수 있는지에 대해 살펴보겠습니다. 소스 코드 관리와 버전 관리의 중요성을 이해하고, 실제로 프로젝트에 적용하는 방법을 배워봅시다.

1. 스프링 부트란?

스프링 부트(Spring Boot)는 자바 기반의 웹 애플리케이션 개발 프레임워크인 스프링(Sprig)의 하위 프로젝트로, 웹 애플리케이션을 더 빠르고 쉽게 개발할 수 있도록 도와줍니다. 주요 특징으로는 다음과 같은 것들이 있습니다.

  • 자동 설정: 스프링 부트는 개발자가 설정 파일을 정의하지 않아도 필요한 설정을 자동으로 해줍니다.
  • 스프링 생태계 통합: 스프링 부트는 스프링의 다양한 프로젝트(스프링 MVC, 스프링 데이터 등)와 쉽게 통합되어 사용할 수 있습니다.
  • 독립 실행형: 서버에 배포할 때 별도의 웹 서버 없이 독립 실행 가능한 JAR 파일 형식으로 배포할 수 있습니다.

2. 깃(Git)과 깃허브(GitHub)란?

2.1 깃(Git)

깃(Git)은 분산 버전 관리 시스템으로, 코드의 변경 이력을 기록하고 여러 개발자가 동시에 작업할 수 있도록 도와줍니다. 깃은 특히 다음과 같은 장점이 있습니다:

  • 빠른 성능: 로컬에서 모든 연산을 수행하기 때문에 소프트웨어의 성능이 매끄럽습니다.
  • 작은 크기: 저장소의 크기가 작아져 여러 버전의 코드를 효과적으로 관리할 수 있습니다.
  • 분산: 각 개발자의 로컬 저장소가 독립적으로 관리되므로 중앙 서버에 의존하지 않습니다.

2.2 깃허브(GitHub)

깃허브(GitHub)는 깃을 사용하여 소스 코드를 관리하고 공개하거나 협업할 수 있게 도와주는 플랫폼입니다. 주요 기능으로는:

  • 코드 호스팅: 프로젝트 코드를 클라우드에 저장하고 관리할 수 있습니다.
  • 이슈 추적: 버그나 개선 사항을 추적하고 관리하는 데 유용한 도구를 제공합니다.
  • 협업: 여러 개발자가 동시에 같은 프로젝트에서 작업할 수 있는 기능을 제공합니다.

3. 환경 설정

3.1 자바 설치

스프링 부트를 사용하려면 자바 개발 키트(JDK)를 설치해야 합니다. Oracle의 공식 웹사이트나 OpenJDK를 통해 설치할 수 있습니다.

sudo apt update
sudo apt install openjdk-11-jdk
java -version

3.2 스프링 부트 CLI 설치

스프링 부트 CLI(Command Line Interface)를 사용하면 손쉽게 스프링 부트 애플리케이션을 생성할 수 있습니다. 설치 방법은 다음과 같습니다.

brew tap spring-io/tap
brew install springboot

3.3 깃 설치

깃이 아직 설치되어 있지 않다면 다음 명령어로 설치할 수 있습니다.

sudo apt install git

3.4 깃허브 계정 만들기

깃허브에 가입하여 계정을 생성하세요. GitHub 공식 웹사이트로 이동하여 가입하면 됩니다.

4. 간단한 스프링 부트 애플리케이션 만들기

이제 스프링 부트 애플리케이션을 만들어보겠습니다. 다음 명령어를 사용하여 새로운 프로젝트를 생성합니다.

spring init --dependencies=web my-spring-boot-app

프로젝트가 생성된 후에 해당 디렉토리로 이동합니다.

cd my-spring-boot-app

4.1 간단한 REST API 만들기

스프링 부트 애플리케이션에서 REST API를 사용하여 데이터를 제공하는 간단한 예제를 작성해봅시다. `src/main/java/com/example/myapp/MyController.java` 파일을 생성하고 다음과 같은 코드를 작성합니다.

package com.example.myapp;

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

@RestController
public class MyController {
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

이제 애플리케이션을 실행해 보겠습니다. 다음 명령어로 애플리케이션을 실행할 수 있습니다.

./mvnw spring-boot:run

실행한 후 웹 브라우저에서 http://localhost:8080/hello에 접속하여 결과를 확인하면 “Hello, Spring Boot!”라는 메시지를 볼 수 있습니다.

5. 깃과 깃허브를 활용한 버전 관리

5.1 깃 초기화

이제 프로젝트에 깃을 초기화해보겠습니다. 프로젝트 폴더로 이동한 후 다음 명령어를 입력합니다.

git init

이 명령어를 실행하면 해당 디렉토리에 .git 디렉토리가 생성되어 깃 리포지토리가 초기화됩니다.

5.2 파일 추가 및 커밋

파일을 추가하고 커밋해봅시다. 모든 파일을 스테이징 영역에 추가하려면 다음 명령어를 사용합니다.

git add .

그 다음 커밋을 진행합니다.

git commit -m "초기 커밋: 스프링 부트 애플리케이션 생성"

5.3 깃허브에 리포지토리 생성

깃허브로 가서 새로운 리포지토리를 생성합니다. 새 리포지토리를 생성한 후, 리모트 리포지토리를 추가합니다.

git remote add origin https://github.com/username/my-spring-boot-app.git

5.4 리모트 리포지토리에 푸시

이제 프로젝트를 깃허브에 푸시해보겠습니다. 다음 명령어로 푸시합니다.

git push -u origin master

이제 깃허브에서 프로젝트 코드를 확인할 수 있습니다.

6. 팀 협업을 위한 깃 허브 활용

프로젝트가 커지면 여러 팀원과 협업을 하게 되는데, 이때 깃허브의 다양한 협업 기능을 활용할 수 있습니다. 머지 요청(Pull Request), 코드 리뷰, 이슈 관리 등 다양한 기능이 있습니다.

6.1 이슈 관리

버그나 요청 사항을 관리하기 위해 이슈를 생성합니다. 이슈를 통해 팀원 간에 의견을 공유하고 작업을 할당할 수 있습니다.

6.2 코드 리뷰

코드를 푸시한 후, 팀원에게 리뷰를 요청할 수 있습니다. 리뷰를 통해 코드 품질을 높이고, 다양한 피드백을 받을 수 있습니다.

6.3 머지 요청(Pull Request)

새로운 기능을 개발한 후, 해당 기능을 메인 브랜치에 통합하기 위해 풀 리퀘스트를 사용합니다. 이 옵션은 다른 팀원들이 변경 사항을 검토하고 승인할 수 있도록 합니다.

7. 마무리

이번 강좌에서는 스프링 부트를 사용하여 간단한 백엔드 애플리케이션을 만들고, 깃과 깃허브를 활용하여 소스 코드 관리 및 협업 방법을 살펴보았습니다. 이 과정을 통해 여러분은 스프링 부트와 깃에 대한 기본 이해를 가질 수 있기를 바랍니다.

더 발전하기 위해 추가적인 자료를 찾아보고 다양한 프로젝트에 적용해보세요. 다음 강좌에서는 스프링 부트의 JSON 처리, 설정 관리 등을 더욱 심화해서 다루도록 하겠습니다.

참고 자료

스프링 부트 백엔드 개발 강좌, 개발환경, 프로젝트 생성하기

안녕하세요! 이번 강좌에서는 스프링 부트를 사용하여 백엔드 애플리케이션을 개발하는 방법에 대해 알아보겠습니다. 스프링 부트는 스프링 프레임워크를 기반으로 한 경량화된 프레임워크로, 신속하게 프로덕션급 애플리케이션을 개발할 수 있도록 도와줍니다. 이 글에서는 개발 환경 세팅과 프로젝트 생성 방법에 대해 자세히 설명하겠습니다.

1. 개발 환경 설정

스프링 부트 프로젝트를 시작하기 전에, 다음과 같은 개발 환경을 설정해야 합니다.

1.1. JDK 설치

스프링 부트는 자바를 기반으로 하기 때문에 JDK(Java Development Kit)를 설치해야 합니다. JDK는 Java 소스 코드를 컴파일하고 실행할 수 있는 도구입니다.

  • JDK 다운로드: [Oracle JDK 다운로드 페이지](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) 또는 [OpenJDK 다운로드 페이지](https://openjdk.java.net/install/)
  • 설치 후, 터미널에서 java -version 명령어로 설치가 잘 되었는지 확인하세요.

1.2. IDE 설치

코드를 작성하기 위해 IDE(통합 개발환경)를 사용해야 합니다. IntelliJ IDEA, Eclipse, VSCode 등 다양한 IDE가 있지만, 이 강좌에서는 IntelliJ IDEA를 추천합니다.

  • IntelliJ IDEA 다운로드: [JetBrains 공식 웹사이트](https://www.jetbrains.com/idea/download/)
  • 설치 후, ‘Create New Project’ 메뉴를 통해 새로운 스프링 부트 프로젝트를 생성할 수 있습니다.

1.3. Maven 설치

스프링 부트는 Maven을 사용하여 종속성을 관리합니다. Maven을 설치하여 필요한 라이브러리를 쉽게 추가할 수 있습니다.

  • Maven 다운로드: [Maven 공식 웹사이트](https://maven.apache.org/download.cgi)
  • 설치 후, mvn -v 명령어로 설치가 완료되었는지 확인하세요.

2. 프로젝트 생성하기

이제 개발 환경이 모두 준비되었습니다. 다음 단계는 스프링 부트 프로젝트를 생성하는 것입니다.

2.1. 스프링 Initializr 사용하기

스프링 Initializr는 스프링 부트 프로젝트를 간편하게 생성할 수 있는 웹 기반 도구입니다. 다음과 같은 절차를 따라 프로젝트를 생성합니다.

  • 브라우저에서 [Spring Initializr](https://start.spring.io/)를 엽니다.
  • Project 선택: Maven Project 또는 Gradle Project 중 하나를 선택합니다.
  • Language 선택: Java를 선택합니다.
  • Spring Boot 버전 선택: 최신 안정화 버전을 선택합니다 (ex. 2.6.6).
  • Project Metadata 입력: 다음 필드를 입력해야 합니다.
    • Group: com.example
    • Artifact: demo
    • Name: demo
    • Description: Demo project for Spring Boot
    • Package name: com.example.demo
    • Packaging: Jar를 선택합니다.
    • Java: JDK 버전에 맞는 버전을 선택합니다 (ex. 11).
  • Dependencies 추가: 프로젝트에 필요한 라이브러리를 선택합니다. 예를 들어, Spring Web, Spring Data JPA, H2 Database 등을 추가할 수 있습니다.
  • Generate 버튼을 클릭하여 프로젝트를 생성하고, ZIP 파일을 다운로드합니다.

2.2. IntelliJ에서 프로젝트 열기

다운로드한 ZIP 파일을 압축 해제한 후, IntelliJ IDEA를 열고 다음 단계를 따릅니다.

  • ‘File’ -> ‘Open’ 선택 후, 압축을 푼 프로젝트 폴더를 선택합니다.
  • IntelliJ가 Maven을 인식하고 필요한 라이브러리를 다운로드합니다. 이 과정이 끝나면 프로젝트 구조가 준비됩니다.

2.3. 애플리케이션 코드 작성하기

이제 간단한 스프링 부트 애플리케이션을 만들어보겠습니다. src/main/java/com/example/demo/DemoApplication.java 파일을 열고 다음 코드를 입력합니다.