(Spring Boot) 자바로 간단한 블로그 API 만들기 - 초보자를 위한 완벽 가이드

안녕하세요, 코딩하는곰입니다! 오늘은 Spring Boot를 이용해 간단한 블로그 API를 만들어보는 시간을 가져보려고 합니다. 자바 백엔드 개발을 시작하시는 분들께 특히 유용한 내용이 될 거예요. 20년 넘게 자바 개발을 해오면서 느낀 점은, 실습을 통해 배우는 것이 가장 효과적이라는 것입니다. 이 포스팅에서는 REST API의 기본 개념부터 실제 구현까지 단계별로 상세히 설명드리겠습니다. 함께 따라오시면 여러분도 블로그 API를 만드실 수 있을 거예요!

1. Spring Boot 프로젝트 설정하기

Spring Initializr(https://start.spring.io/)를 이용해 프로젝트를 생성합니다. 필수 의존성은 다음과 같습니다:

• Spring Web (REST API 개발용)
• Spring Data JPA (데이터베이스 연동)
• Lombok (보일러플레이트 코드 감소)
• MySQL Driver (데이터베이스 연결)

// build.gradle 예시
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    compileOnly 'org.projectlombok:lombok'
    runtimeOnly 'com.mysql:mysql-connector-j'
    annotationProcessor 'org.projectlombok:lombok'
}

application.properties 파일에 데이터베이스 설정을 추가합니다:

spring.datasource.url=jdbc:mysql://localhost:3306/blog_db
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

2. 엔티티(Entity)와 DTO 설계

블로그 포스트를 위한 기본 엔티티를 설계합니다. JPA를 사용하면 객체와 데이터베이스 테이블을 쉽게 매핑할 수 있습니다.

@Entity
@Getter @Setter
@NoArgsConstructor
public class Post {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String title;
    private String content;
    
    @CreationTimestamp
    private LocalDateTime createdAt;
    
    @UpdateTimestamp
    private LocalDateTime updatedAt;
}

DTO(Data Transfer Object)는 클라이언트와 서버 간 데이터 전송을 위한 객체입니다:

@Getter @Setter
public class PostDto {
    private String title;
    private String content;
}

웹디자인을 하다 보면 원하는 색상의 HEX 또는 RGB 값을 빠르게 확인해야 할 때가 있습니다. 이럴 땐 컬러피커 도구를 활용해보세요.

3. CRUD API 구현하기

이제 본격적으로 API를 구현해보겠습니다. Spring의 계층 구조(Controller-Service-Repository)를 따라 개발합니다.

1. Repository 계층:

public interface PostRepository extends JpaRepository<Post, Long> {
}

2. Service 계층:

@Service
@RequiredArgsConstructor
public class PostService {
    private final PostRepository postRepository;
    
    public Post createPost(PostDto postDto) {
        Post post = new Post();
        post.setTitle(postDto.getTitle());
        post.setContent(postDto.getContent());
        return postRepository.save(post);
    }
    
    // 다른 CRUD 메서드들...
}

3. Controller 계층:

@RestController
@RequestMapping("/api/posts")
@RequiredArgsConstructor
public class PostController {
    private final PostService postService;
    
    @PostMapping
    public ResponseEntity<Post> createPost(@RequestBody PostDto postDto) {
        Post createdPost = postService.createPost(postDto);
        return ResponseEntity.ok(createdPost);
    }
    
    // 다른 엔드포인트들...
}

정확한 시간 기록이 필요한 실험이나 트레이닝에는 실시간 스톱워치 기능을 활용하는 것이 좋습니다.

지금까지 Spring Boot를 이용해 간단한 블로그 API를 만드는 방법을 알아보았습니다. 이제 Postman이나 curl을 이용해 API를 테스트해보실 수 있을 거예요. 실제 프로젝트에서는 더 많은 기능(페이징, 검색, 인증 등)을 추가해야 하지만, 이 튜토리얼이 자바 백엔드 개발의 첫 걸음을 내딛는 데 도움이 되었으면 합니다. 궁금한 점이 있으시면 댓글로 남겨주세요! 다음 시간에는 더 고급진 Spring Boot 기능을 다뤄보겠습니다. 코딩하는곰이었습니다. 감사합니다! 🐾

기억력 감퇴를 막고 인지 능력을 향상시키고 싶다면, AI 힌트 기능이 있는 스도쿠 저니를 활용해보세요.