블로그4 - 서비스, 컨트롤러 만들기

작업 1 - DTO(Data Transfer Object)클래스 만들기 (게시글 저장)

DTO는 데이터 전송을 위한 객체로, 주로 계층 간 데이터 교환을 목적으로 사용된다. 예를 들어, 클라이언트에서 서버로, 혹은 서비스 계층에서 프레젠테이션 계층으로 데이터를 전달할 때 사용된다.

package com.tenco.demo._domain.blog.dto;

import com.tenco.demo._domain.blog.entity.Article;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;

@NoArgsConstructor
@AllArgsConstructor
@Getter
// 즉, 주로 계층 간 데이터 전송을 목적으로 설계
public class ArticleDTO {

	private String title;
	private String content;
	
	// 여기서 ArticleDTO -> Article의 데이터 타입을 변환시키는 메서드를 만들었음
	public Article toEntity() {
		return Article.builder()
						.title(this.title)
						.content(this.content)
						.build();
	}
	
}

 

작업 2 - 서비스 클래스 만들기 (게시글 저장)

서비스 계층은 애플리케이션에서 비즈니스 로직을 처리하는 중요하는 역할을 한다. 서비스 계층은 주로 컨트롤러와 데이터베이스 간의 중간 계층으로, 데이터를 조작하거나 처리하는 모든 비즈니스 규칙을 담당한다. 

package com.tenco.demo._domain.blog.service;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.tenco.demo._domain.blog.dto.ArticleDTO;
import com.tenco.demo._domain.blog.entity.Article;
import com.tenco.demo._domain.blog.repository.PostRepository;

import jakarta.transaction.Transactional;
import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor
@Service // IoC (빈으로 등록)
public class BlogService {
	
	@Autowired // DI
	private final PostRepository postRepository;
	
	@Transactional // 쓰기 지연 처리 까지
	public Article save(ArticleDTO dto) {
		// 비즈니스 로직이 필요하다면 작성
		return postRepository.save(dto.toEntity());
	}
}

@Service 어노테이션은 해당 클래스를 스프링 컨테이너에 빈(Bean)으로 등록해주는 역할 즉, 스프링 컨테이너 또는 애플리케이션 컨텍스트에 빈으로 등록된다.

애플리케이션 컨텍스트(ApplicationContext)가 스프링 컨테이너의 구체적인 구현체 중 하나이다.

스프링 컨테이너(Spring Container)는 스프링 프레임워크가 애플리케이션을 관리하고 실행하는 핵심 부분이다. 스프링 컨테이너는 애플리케이션에서 사용할 객체들(Bean)을 생성하고, 이 객체들 간의 의존성을 관리하며, 생명주기를 관리하는 역할을 한다.

 

작업 3 - 컨트롤러 클래스 만들기(게시글 저장)

컨트롤러 클래스는 사용자의 요청을 처리하고 (URL 매핑), 그 요청을 서비스 계층으로 전달하며, 결과를 다시 사용자에게 반환하는 역할을 한다.

package com.tenco.demo._domain.blog.controller;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

import com.tenco.demo._domain.blog.dto.ArticleDTO;
import com.tenco.demo._domain.blog.entity.Article;
import com.tenco.demo._domain.blog.service.BlogService;

import lombok.RequiredArgsConstructor;


@RequiredArgsConstructor
@RestController // @Controller + @ResponseBody
public class BlogApiController {
	
	private final BlogService blogService;
	
	// URL 매핑 : 주소설계 - http://localhost:8080/api/articles
	@PostMapping("/api/articles")
	public ResponseEntity<Article> addArticle(@RequestBody ArticleDTO dto) {
		// 1. 인증 검사
		// 2. 유효성 검사
		Article savedArticle = blogService.save(dto);
		return ResponseEntity.status(HttpStatus.CREATED).body(savedArticle);
	}
	
}

---

꼭 알아두어야 할 응답 코드

200 OK: 요청이 성공적으로 처리되었습니다.
201 Created: 요청이 성공적으로 처리되었고, 새로운 리소스가 생성되었습니다.
302 Found: 요청한 리소스가 임시적으로 다른 URL로 리다이렉트됩니다.
400 Bad Request: 클라이언트의 요청이 잘못되었거나 서버가 요청을 이해할 수 없습니다.
401 Unauthorized: 인증이 필요하지만 클라이언트가 인증되지 않았습니다.
403 Forbidden: 클라이언트가 요청한 리소스에 접근할 권한이 없습니다.
404 Not Found: 요청한 리소스를 찾을 수 없습니다.
500 Internal Server Error: 서버에서 오류가 발생하여 요청을 처리할 수 없습니다.