[feat] 캡슐 CRUD 구현 by jucheonsu · Pull Request #22 · KES-DASOM/MemoReal_Backend

jucheonsu · 2025-07-20T11:33:14Z

[feat] 캡슐 CRUD 구현

😺 Issue

[feat] 캡슐 CRUD 구현 #16

✅ 작업 리스트

Capsule, Media 엔티티 및 1:N 매핑
CapsuleType enum과 DTO 작성
Repository, Service CRUD 구현
REST API 컨트롤러 작성 (파일 업로드 포함)
커스텀 예외 및 글로벌 예외 처리
단위 테스트 및 API 테스트 수행

⚙️ 작업 내용

캡슐과 미디어 데이터를 계층 구조로 관리하고,
REST API로 CRUD 기능 제공
파일 업로드 및 예외 처리를 포함한 안정적 서비스 구현
테스트로 기능 정상 동작 확인

📷 테스트 / 구현 내용

🔧 수정 내용

Controller에서 ResponseEntity return inline
변경 및 코드 간소화
Service에서 user 조회 분리
Entity에서 Setter 제거 및 생성자 정리
DTO를 요청/응답으로 분리하고 builder 패턴 적용
Repository 주석 제거
테스트 코드 리팩토링, 출력문 제거
SecurityUtil 활용해 유저 조회 로직 분리 및 print문 삭제

ysw789 · 2025-07-20T12:53:50Z

src/main/java/com/dasom/MemoReal/domain/capsule/controller/CapsuleController.java

+        CapsuleResponseDto responseDto = capsuleService.createCapsule(requestDto);
+        return ResponseEntity.status(HttpStatus.CREATED).body(responseDto);


비즈니스 레이어 메소드가 리턴 값이 있는 경우 ResponseEntity 리턴에 인라인으로 합쳐도 될 듯 합니다

return ResponseEntity.status(HttpStatus.CREATED).body(capsuleService.createCapsule(requestDto));

네 수정하겠습니다

ysw789 · 2025-07-20T13:02:59Z

src/main/java/com/dasom/MemoReal/domain/capsule/dto/CapsuleDto.java

+import java.util.List;
+import java.util.stream.Collectors;
+
+public class CapsuleDto {


Request와 Response처럼 역할이 완전히 다른 DTO를 함께 이너 클래스로 두는 것은 단일 책임 원칙에 위배된다는 생각이 들긴 합니다만
지금처럼 작은 프로젝트에서는 큰 문제 없을 듯 하므로 그대로 유지해도 무방해보입니다
다만 프로젝트 규모가 더 커지고, 한 도메인에서 사용되는 DTO 및 VO 클래스가 많아진다면 그 때는 역할 별로 DTO도 클래스를 분리하는 것을 추천합니다~

네 코드 리뷰 감사합니다

ysw789 · 2025-07-20T13:05:56Z

src/main/java/com/dasom/MemoReal/domain/capsule/dto/MediaDto.java

+    private String originalFileName;
+
+    public static MediaDto toDto(Media media) {
+        String cid = media.getCid();


빌더에서 바로 초기화해도 될 것 같은데 따로 초기화 된 이유가 있을까요?

ysw789 · 2025-07-20T13:08:10Z

src/main/java/com/dasom/MemoReal/domain/capsule/service/CapsuleService.java

+    private User getCurrentUser() {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        if (authentication == null || !authentication.isAuthenticated()) {
+            throw new CustomException(ErrorCode.UNAUTHORIZED);
+        }
+        String userEmail = authentication.getName();
+
+        return userRepository.findByEmail(userEmail)
+                .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
+    }


사용자 정보를 불러오는 로직은 Capsule 과는 전혀 연관되지 않는데 별도의 서비스로 분리하는 게 어떨까요? 예를들어 UserService

캡슐 CRUD에 사용자의 로그인 정보를 불러오는 로직이 필요해서 추가했습니다. 만약 수정이 필요하다면 바로 수정하도록 하겠습니다.

ysw789 · 2025-07-20T13:24:28Z

src/main/java/com/dasom/MemoReal/domain/capsule/service/CapsuleService.java

+        capsule.setUser(currentUser);
+
+        Capsule savedCapsule = capsuleRepository.save(capsule);
+        System.out.println("Capsule 저장 완료, ID: " + savedCapsule.getId());


print문은 개발 때에만 잠깐 사용하고 실제 로깅은 Slf4j를 통해 하는 걸 추천합니다

네 감사합니다

ysw789 · 2025-07-20T13:26:06Z

src/main/java/com/dasom/MemoReal/domain/capsule/service/CapsuleService.java

+        Capsule capsule = requestDto.toEntity();
+        capsule.setUser(currentUser);


Entity 변환 시 User를 인자로 전달해 객체 인스턴스 생성과 동시에 초기화 하는 것이 좋아보입니다
객체 인스턴스 생성 후 상태 변경은 객체 내부적으로만 수행하는 것이 적절하므로 setter 사용은 지양하는 것이 좋습니다

ysw789 · 2025-07-20T13:29:28Z

src/main/java/com/dasom/MemoReal/domain/capsule/entity/Capsule.java

+    private User user;
+
+    @Builder
+    public Capsule(String title, CapsuleType type, String content, LocalDate openDate, User user) {


사용되지 않는 생성자는 제거해주세요

ysw789 · 2025-07-20T13:50:28Z

전체적으로 잘 설계하신 것 같습니다!
Media 관련 구현 사항은 아직 없는 것 같아 이 부분은 제외하고 참고 사항 알려드리겠습니다

Builder 패턴 적용
CapsuleDto.CapsuleRequestDto 에서 Capsule.builder()를 직접 호출하고 있는데, 객체 생성의 책임을 해당 도메인 엔티티에 위임하고 외부에서는 이를 호출하기만 하도록 하는 것이 적절합니다.

// 현재: DTO에서 직접 빌더 호출
public Capsule toEntity() {
    return Capsule.builder()
            .title(title)
            .type(type)
            .content(content)
            .openDate(openDate)
            .build();
}

// 개선: Capsule에 정적 팩토리 메소드 추가
public class Capsule {
    public static Capsule from(CapsuleRequestDto dto, User user) {
        return Capsule.builder()
                .title(dto.getTitle())
                .type(dto.getType())
                .content(dto.getContent())
                .openDate(dto.getOpenDate())
                .user(user)
                .build();
    }
}

setter
setter를 사용하게 되면 객체의 불변성을 해치고 객체 외부 어디에서나 상태를 변경할 수 있습니다. 객체의 상태가 의도치 않은 곳에서 변경될 경우 예상 불가한 오류가 발생할 수 있습니다.
Capsule 클래스 내부에 있는 update() 메소드가 바로 모범 케이스입니다. update 작업 자체도 setter 통해서 외부에서 수행할 수 있을텐데 왜 내부적으로 했을까요? 이유는 객체 인스턴스 생성 후 상태 변경은 객체 내부적으로만 수행하는 것이 캡슐화를 준수하는 방식이기 때문입니다.

jucheonsu · 2025-07-20T13:55:14Z

긴 시간동안 코드 리뷰 해주셔서 감사드립니다!
질문을 하나 드리자면 Setter를 모두 없애는 것이 코드 전체적으로 좋을까요?

ysw789 · 2025-07-20T13:58:42Z

긴 시간동안 코드 리뷰 해주셔서 감사드립니다! 질문을 하나 드리자면 Setter를 모두 없애는 것이 코드 전체적으로 좋을까요?

개인적으론 정말 특수한 경우를 제외하곤 setter 사용은 아예 지양하는 것이 좋다고 생각합니다

jucheonsu · 2025-07-20T14:07:53Z

네 감사합니다 바로 수정해서 다시 올리도록 하겠습니다

dohy-eon · 2025-07-20T18:16:01Z

변경사항은 확인 완료했고 스웨거 관련 어노테이션만 간단하게 추가했습니다. 확인 후 코멘트 남겨주세요

jucheonsu · 2025-07-21T00:14:42Z

스웨거 관련 어노테이션 확인 완료했습니다

dohy-eon and others added 10 commits July 18, 2025 16:37

chore: 스웨거 추가 및 시큐리티 설정

e9800e5

refactor: 스웨거 주석 일부 삭제

b108c62

refactor: Security 허용 경로 중복 제거

7accc40

feat: Capsule과 Media entity 및 CapsuleType enum 추가

6b5706c

feat: Capsule과 Media DTO 클래스 추가

565e2ab

feat: Capsule repository와 service 로직 구현

478b42e

feat: Capsule controller 및 API endpoint 구현

50ee6b8

feat: ErrorCode 및 exception handler 추가

d8c1637

refactor: MemoRealApplication @EnableJpaAuditing 어노테이션 추가

3d26d15

test: CapsuleService 테스트 코드 추가

356afc1

jucheonsu self-assigned this Jul 20, 2025

jucheonsu added 👾 feat 새 기능 / New features 🐹 천수 labels Jul 20, 2025

jucheonsu linked an issue Jul 20, 2025 that may be closed by this pull request

[feat] 캡슐 CRUD 구현 #16

Open

jucheonsu requested review from Vloeiolzlr, dohy-eon, hodoon, kjunh972 and ysw789 and removed request for hodoon July 20, 2025 12:20

jucheonsu changed the title ~~Feat/#16~~ [feat] 캡슐 CRUD 구현 Jul 20, 2025

ysw789 requested changes Jul 20, 2025

View reviewed changes

jucheonsu added 4 commits July 21, 2025 02:50

refactor: Controller에서 ResponseEntity return inline 변경

60e53af

refactor: Service에서 user 조회 분리 및 debug print 제거

ee5f65b

refactor: Entity에서 Setter 제거 및 생성자 정리

49fe147

refactor: CapsuleDto를 request/response로 분리, builder 적용

81ce0af

jucheonsu and others added 5 commits July 21, 2025 02:52

remove: CapsuleDto 삭제

26bbbb9

refactor: 테스트 구조 개선

b5ff3b9

refactor: Repository 주석 제거

7526349

git: version control

a9db1de

docs: 스웨거 어노테이션 추가

d50a0c6

dohy-eon approved these changes Jul 20, 2025

View reviewed changes

ysw789 approved these changes Jul 21, 2025

View reviewed changes

		CapsuleResponseDto responseDto = capsuleService.createCapsule(requestDto);
		return ResponseEntity.status(HttpStatus.CREATED).body(responseDto);

		Capsule capsule = requestDto.toEntity();
		capsule.setUser(currentUser);

Conversation

jucheonsu commented Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

[feat] 캡슐 CRUD 구현

😺 Issue

✅ 작업 리스트

⚙️ 작업 내용

📷 테스트 / 구현 내용

🔧 수정 내용

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ysw789 commented Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jucheonsu commented Jul 20, 2025

Uh oh!

ysw789 commented Jul 20, 2025

Uh oh!

jucheonsu commented Jul 20, 2025

Uh oh!

dohy-eon commented Jul 20, 2025

Uh oh!

jucheonsu commented Jul 21, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jucheonsu commented Jul 20, 2025 •

edited

Loading

ysw789 commented Jul 20, 2025 •

edited

Loading