[실습] Board Microservice 만들기

JSCODE 박재성

2026. 03. 18.

✅ Board Microservice 만들기

✅ Spring Boot 프로젝트 셋팅 & DB 연결

1. Spring Boot 프로젝트 셋팅
start.spring.io
https://start.spring.io/



• Artifact와 Name을 board-service라고 지어주자.
• Package name을 Java 컨벤션에 맞게 boardservice라고 지어주자.
• Java 21 버전을 선택하자. 아래 과정을 Java 21 버전을 기준으로 진행할 예정이다.
• Dependencies는 Spring Boot DevTools, Spring Web, MySQL Driver, Spring Data JPA를 선택하자.
 

2. application.yml 작성하기

이 프로젝트에서는 application.properties를 지우고 application.yml을 생성했다.

server:
	port: 8081

spring:
	datasource:
		url: jdbc:mysql://localhost:3307/board-db # DB 주소
		username: root # DB 계정
		password: password # DB 비밀번호
		driver-class-name: com.mysql.cj.jdbc.Driver
	jpa:
		hibernate:
			ddl-auto: update
		show-sql: true

 

3. Spring Boot 서버 실행시켜서 DB 연결 제대로 되는 지 확인하기
Spring Boot 실행시켰을 때 아래와 같은 에러 안 뜨고 서버가 실행되면, 정상적으로 DB가 잘 연결된 것이다.



 

✅ 게시글 생성 API 만들기

1. Board 엔티티 생성하기
domain/Board

@Entity
@Table(name = "boards")
public class Board {
  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long boardId;
  
  private String title;
  
  private String content; 
  
  private Long userId; // FK 설정 안하고 그냥 컬럼으로 선언
  
  public Board() {
  }

  public Board(String title, String content, Long userId) {
    this.title = title;
    this.content = content;
    this.userId = userId;
  }

  public Long getBoardId() {
    return boardId;
  }

  public String getTitle() {
    return title;
  }

  public String getContent() {
    return content;
  }

  public Long getUserId() {
    return userId;
  }
}

 

2. Repository 만들기
domain/BoardRepository

public interface BoardRepository extends JpaRepository<Board, Long> {
}

 

3. Controller 만들기
controller/BoardController

@RestController
@RequestMapping("/boards")
public class BoardController {
  private final BoardService boardService;

  public BoardController(BoardService boardService) {
    this.boardService = boardService;
  }

  @PostMapping
  public ResponseEntity<Void> create(
      @RequestBody CreateBoardRequestDto createBoardRequestDto
  ) {
    boardService.create(createBoardRequestDto);
    return ResponseEntity.noContent().build();
  }
}

 

4. DTO 만들기
dto/CreateBoardRequestDto

public class CreateBoardRequestDto {
  private String title;

  private String content;

  private Long userId;

  public String getTitle() {
    return title;
  }

  public String getContent() {
    return content;
  }

  public Long getUserId() {
    return userId;
  }
}

 

5. Service 만들기
service/BoardService

@Service
public class BoardService {
  private final BoardRepository boardRepository;

  public BoardService(BoardRepository boardRepository) {
    this.boardRepository = boardRepository;
  }

	@Transactional
  public void create(CreateBoardRequestDto createBoardRequestDto) {
    Board board = new Board(
      createBoardRequestDto.getTitle(),
      createBoardRequestDto.getContent(), 
      createBoardRequestDto.getUserId()  
    );

    this.boardRepository.save(board);
  }
}

 

6. 서버 다시 실행시키기



 

7. API 잘 작동하는 지 테스트해보기



주의) 8081번 포트로 요청을 보내야 한다.

7. DB에 데이터 잘 들어갔는 지 확인하기