스프링 부트 백엔드 개발 강좌, 블로그 화면 구성 예제, 생성 기능 작성하기

도입부

최근 몇 년 사이에 웹 애플리케이션의 개발은 매우 활성화되었습니다. 특히 블로그 시스템은 개인이나 기업이 정보를 공유하고 브랜드를 알릴 수 있는 훌륭한 플랫폼을 제공합니다. 본 강좌에서는 스프링 부트를 사용하여 블로그의 백엔드를 개발하는 과정과 함께 블로그 화면을 구성하는 방법에 대해 알아보겠습니다. 또한, 게시물 생성 기능을 작성하는 방법도 다뤄보겠습니다.

1. 스프링 부트란?

스프링 부트(Spring Boot)는 스프링 프레임워크를 기반으로 한 애플리케이션 개발 프레임워크입니다. 스프링 부트는 복잡한 설정 없이 쉽게 애플리케이션을 만들 수 있도록 도와주고 있으며, REST API 개발 및 마이크로서비스 구조의 구축에 특히 적합합니다. 스프링 부트의 주요 특징은 다음과 같습니다:

자동 구성: 스프링 부트는 필요한 라이브러리를 자동으로 설정하여 개발 시간을 단축시킵니다.
내장 서버: 톰캣(Tomcat), 제티(Jetty)와 같은 웹 서버를 내장하여 별도의 설정 없이 쉽게 배포할 수 있습니다.
스타터 의존성: 특정 기능을 쉽게 설정할 수 있도록 하는 스타터 의존성을 제공합니다.

2. 개발 환경 설정

스프링 부트를 사용하여 블로그를 개발하기 위해서는 먼저 개발 환경을 설정해야 합니다. 아래는 필요한 도구 및 설정 방법입니다:

Java Development Kit (JDK): JDK 11 이상이 필요합니다. Oracle 또는 OpenJDK를 설치합니다.
IDE: IntelliJ IDEA, Eclipse 등의 통합 개발 환경(IDE)을 사용할 수 있습니다.
빌드 도구: Maven 또는 Gradle을 사용할 수 있으며, 본 강좌에서는 Maven을 기준으로 설명합니다.

3. 프로젝트 생성

스프링 부트 프로젝트를 생성하기 위해서는 Spring Initializr를 사용할 수 있습니다. 아래는 프로젝트를 생성하는 단계입니다.

웹 브라우저를 열고 Spring Initializr에 접속합니다.
프로젝트 메타데이터를 입력합니다. 프로젝트 메타데이터는 아래와 같이 설정합니다.

Group: com.example
Artifact: blog
Name: blog
Package Name: com.example.blog
Packaging: Jar
Java: 11

Dependencies에서 Next를 눌러 다음과 같은 의존성을 추가합니다:

Spring Web
Spring Data JPA
H2 Database (테스트용 인메모리 데이터베이스)
Thymeleaf (템플릿 엔진)

Generate 버튼을 눌러 프로젝트를 생성합니다.
생성된 ZIP 파일을 다운로드 후, 압축을 해제하여 IDE에서 열어줍니다.

4. 패키지 구조 설계

좋은 소프트웨어는 명확한 패키지 구조를 가지고 있어야 합니다. 아래는 이번 블로그 애플리케이션의 추천 패키지 구조입니다.


com.example.blog
├── controller
├── model
├── repository
├── service
└── BlogApplication.java

4.1 Controller

Controller는 클라이언트의 요청을 처리하는 역할을 합니다. 다음 단계에서 작성할 REST API와 화면의 핸들러 메서드가 위치합니다.

4.2 Model

Model은 애플리케이션의 데이터 구조를 정의합니다. 데이터베이스의 엔티티와 DTO(Data Transfer Object)를 포함합니다.

4.3 Repository

Repository는 데이터베이스와 상호 작용을 담당합니다. JPA를 사용하여 CRUD 작업을 수행하는 인터페이스가 위치합니다.

4.4 Service

Service는 비즈니스 로직을 처리하는 계층입니다. Controller와 Repository 사이에서 데이터를 처리합니다.

5. 블로그 게시글 모델 만들기

블로그 게시글을 표현하기 위해 먼저 모델 클래스를 작성합니다. 다음 코드를 model/Post.java 파일에 작성합니다.


package com.example.blog.model;

import javax.persistence.*;
import java.time.LocalDateTime;

@Entity
public class Post {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String content;

    @Column(name = "created_at")
    private LocalDateTime createdAt;

    // getters and setters
}

이 모델 클래스는 JPA의 @Entity 어노테이션으로 데이터베이스 테이블과 연결됩니다. 각 필드는 테이블의 컬럼을 나타냅니다.

6. 데이터베이스 설정

이번 프로젝트에서는 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
spring.jpa.hibernate.ddl-auto=create

7. 게시글 리포지토리 만들기

리포지토리 인터페이스는 데이터베이스와의 CRUD 작업을 수행합니다. 다음 코드를 repository/PostRepository.java 파일에 작성합니다.


package com.example.blog.repository;

import com.example.blog.model.Post;
import org.springframework.data.jpa.repository.JpaRepository;

public interface PostRepository extends JpaRepository {
}

8. 서비스 클래스 작성하기

서비스 클래스는 비즈니스 로직을 처리합니다. 다음 코드를 service/PostService.java 파일에 작성합니다.


package com.example.blog.service;

import com.example.blog.model.Post;
import com.example.blog.repository.PostRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.time.LocalDateTime;
import java.util.List;

@Service
public class PostService {
    @Autowired
    private PostRepository postRepository;

    public List getAllPosts() {
        return postRepository.findAll();
    }

    public Post createPost(Post post) {
        post.setCreatedAt(LocalDateTime.now());
        return postRepository.save(post);
    }
}

9. 컨트롤러 작성하기

컨트롤러는 클라이언트의 요청을 처리하고 응답을 반환합니다. 다음 코드를 controller/PostController.java 파일에 작성합니다.


package com.example.blog.controller;

import com.example.blog.model.Post;
import com.example.blog.service.PostService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/posts")
public class PostController {
    @Autowired
    private PostService postService;

    @GetMapping
    public List getAllPosts() {
        return postService.getAllPosts();
    }

    @PostMapping
    public Post createPost(@RequestBody Post post) {
        return postService.createPost(post);
    }
}

10. HTML 화면 구성

블로그의 화면 구성은 Thymeleaf templating engine을 사용하여 작성할 수 있습니다. HTML 파일을 src/main/resources/templates 디렉토리에 추가합니다. 다음은 간단한 블로그 게시글 목록과 생성 화면을 구성하는 HTML입니다:






    블로그
    


블로그 게시글
게시글 목록

    게시글 제목
    게시글 내용

새 게시글 생성

11. 웹 애플리케이션 실행하기

이제 모든 구성 요소를 작성했으니 애플리케이션을 실행해 보겠습니다. IDE에서 BlogApplication.java 파일을 실행하여 애플리케이션을 시작합니다. 실행이 완료되면 브라우저에서 http://localhost:8080로 접속하여 블로그 페이지를 확인할 수 있습니다.

12. 결론

이번 강좌에서는 스프링 부트를 사용하여 블로그 애플리케이션의 백엔드를 구성하는 방법과 블로그 화면을 설계하는 방법을 배웠습니다. 블로그 게시글을 생성하는 기능도 구현하여 실제로 API와 모델이 연동되는 과정을 경험했습니다. 이 강좌를 통해 스프링 부트의 기본 사용법과 MVC 구조를 이해하는 데 도움이 되었길 바랍니다.

더 나아가 추가적인 기능(예: 댓글, 사용자 인증 등)을 구현하여 여러분의 블로그를 발전시키는 데 도전해 보시기 바랍니다. 감사합니다!

도입부