Feat: 댓글 생성 API 구현

Author: joyewon0705

src/main/java/com/back/domain/board/controller/CommentController.java

@@ -0,0 +1,36 @@
+package com.back.domain.board.controller;
+
+import com.back.domain.board.dto.CommentRequest;
+import com.back.domain.board.dto.CommentResponse;
+import com.back.domain.board.service.CommentService;
+import com.back.global.common.dto.RsData;
+import com.back.global.security.user.CustomUserDetails;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/posts/{postId}/comments")
+@RequiredArgsConstructor
+public class CommentController implements CommentControllerDocs {
+    private final CommentService commentService;
+
+    // 댓글 생성
+    @PostMapping
+    public ResponseEntity<RsData<CommentResponse>> createComment(
+            @PathVariable Long postId,
+            @RequestBody @Valid CommentRequest request,
+            @AuthenticationPrincipal CustomUserDetails user
+    ) {
+        CommentResponse response = commentService.createComment(postId, request, user.getUserId());
+        return ResponseEntity
+                .status(HttpStatus.CREATED)
+                .body(RsData.success(
+                        "댓글이 생성되었습니다.",
+                        response
+                ));
+    }
+}

src/main/java/com/back/domain/board/controller/CommentControllerDocs.java

@@ -0,0 +1,7 @@
+package com.back.domain.board.controller;
+
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = "Comment API", description = "댓글 관련 API")
+public interface CommentControllerDocs {
+}

src/main/java/com/back/domain/board/dto/CommentRequest.java

@@ -0,0 +1,13 @@
+package com.back.domain.board.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+/**
+ * 댓글 작성 및 수정을 위한 요청 DTO
+ *
+ * @param content   댓글 내용
+ */
+public record CommentRequest(
+        @NotBlank String content
+) {
+}

src/main/java/com/back/domain/board/dto/CommentResponse.java

@@ -0,0 +1,35 @@
+package com.back.domain.board.dto;
+
+import com.back.domain.board.entity.Comment;
+
+import java.time.LocalDateTime;
+
+/**
+ * 댓글 응답 DTO
+ *
+ * @param commentId 댓글 Id
+ * @param postId    게시글 Id
+ * @param author    작성자 정보
+ * @param content   댓글 내용
+ * @param createdAt 댓글 생성 일시
+ * @param updatedAt 댓글 수정 일시
+ */
+public record CommentResponse(
+        Long commentId,
+        Long postId,
+        AuthorResponse author,
+        String content,
+        LocalDateTime createdAt,
+        LocalDateTime updatedAt
+) {
+    public static CommentResponse from(Comment comment) {
+        return new CommentResponse(
+                comment.getId(),
+                comment.getPost().getId(),
+                AuthorResponse.from(comment.getUser()),
+                comment.getContent(),
+                comment.getCreatedAt(),
+                comment.getUpdatedAt()
+        );
+    }
+}

src/main/java/com/back/domain/board/entity/Comment.java

@@ -34,4 +34,11 @@ public class Comment extends BaseEntity {
 
     @OneToMany(mappedBy = "comment", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<CommentLike> commentLikes = new ArrayList<>();
+
+    // -------------------- 생성자 --------------------
+    public Comment(Post post, User user, String content) {
+        this.post = post;
+        this.user = user;
+        this.content = content;
+    }
 }

src/main/java/com/back/domain/board/repository/CommentRepository.java

@@ -0,0 +1,9 @@
+package com.back.domain.board.repository;
+
+import com.back.domain.board.entity.Comment;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface CommentRepository extends JpaRepository<Comment, Long> {
+}

src/main/java/com/back/domain/board/service/CommentService.java

@@ -0,0 +1,48 @@
+package com.back.domain.board.service;
+
+import com.back.domain.board.dto.CommentRequest;
+import com.back.domain.board.dto.CommentResponse;
+import com.back.domain.board.entity.Comment;
+import com.back.domain.board.entity.Post;
+import com.back.domain.board.repository.CommentRepository;
+import com.back.domain.board.repository.PostRepository;
+import com.back.domain.user.entity.User;
+import com.back.domain.user.repository.UserRepository;
+import com.back.global.exception.CustomException;
+import com.back.global.exception.ErrorCode;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Transactional
+public class CommentService {
+    private final CommentRepository commentRepository;
+    private final UserRepository userRepository;
+    private final PostRepository postRepository;
+
+    /**
+     * 댓글 생성 서비스
+     * 1. User 조회
+     * 2. Post 조회
+     * 3. Comment 생성
+     * 4. Comment 저장 및 CommentResponse 반환
+     */
+    public CommentResponse createComment(Long postId, CommentRequest request, Long userId) {
+        // User 조회
+        User user = userRepository.findById(userId)
+                .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
+
+        // Post 조회
+        Post post = postRepository.findById(postId)
+                .orElseThrow(() -> new CustomException(ErrorCode.POST_NOT_FOUND));
+
+        // Comment 생성
+        Comment comment = new Comment(post, user, request.content());
+
+        // Comment 저장 및 응답 반환
+        commentRepository.save(comment);
+        return CommentResponse.from(comment);
+    }
+}