[feat] 캡슐 CRUD / IPFS 연동 by si-zero · Pull Request #25 · KES-DASOM/MemoReal_Backend

si-zero · 2025-07-20T16:30:19Z

😺 Issue

[feat] 캡슐 CRUD 구현 #18

✅ 작업 리스트

캡슐 CRUD 구현
스웨거 연동
IPFS 연동
전역 에러

⚙️ 작업 내용

캡슐 CRUD 구현
- 캡슐을 엔티티, 레포지토리, 컨트롤러, 서비스, Dto로 계층을 나눠 구현
- 이미지/동영상 또한, CID로 저장
스웨거 연동
- 스웨거 UI를 통한 빠른 테스트 가능토록 설정
- UI로 시각적으로 확인 가능
IPFS 연동
전역 에러

📷 테스트 / 구현 내용

캡슐 등록

이미지 등록 확인

🤔 문제점 / 궁금한 점 (필요 시)

만들면서도 지금 뭘 만드는건지 정확하게 모르겠는데, 혹시 나중에 강의 좀 들을 수 있을까요;

📁 참고 자료

https://jonghoonpark.com/2025/02/08/spring-boot-login-system-example [출처] 박종훈 기술블로그
https://dev-allday.tistory.com/77 [출처] 매일 코딩하는 사람 ve-log
https://non-stop.tistory.com/466 [출처] 승민아 티스토리 - 게시판
https://www.youtube.com/watch?v=5Uj6uR3fp-U [출처] Simply Explained 유튜브, IPFS란?

kwonhee1 · 2025-07-22T03:46:12Z

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

+
+        Capsule saved = capsuleService.createCapsule(dto, cid);
+        return ResponseEntity.status(HttpStatus.CREATED).body(saved);
+    }


@PostMapping
public ResponseEntity createCapsule(@ModelAttribute InputDto dto);

InputDto {
MultipartFile meiaFile;
String data;
}

@ModelAttribute annotion을 사용해 String과 MultipartFile 동시에 받을 수 있음

@ModelAttribute 라는 어노테이션 사용하여 컨트롤러 코드 구조 변경해봤습니다 감사합니당.

@PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public ResponseEntity<CapsuleDto.Select> createCapsule(@ModelAttribute CapsuleDto.Create requestDto) { CapsuleDto.Select created = capsuleService.createCapsule(requestDto); return ResponseEntity.status(HttpStatus.CREATED).body(created); }

구조 변경하면서 Dto도 기존에는 기능별로 나뉘어져 있었는데 구조 합쳐서 다시 만들었습니다

public class CapsuleDto { // 캡슐 생성 @Getter @Setter @NoArgsConstructor @AllArgsConstructor public static class Create { private String capsuleType; private String title; private String content; private Date openTime; // 이미지 & 동영상 private MultipartFile mediaFile; } // 캡슐 조회 @Getter @Setter @NoArgsConstructor @AllArgsConstructor public static class Select { private Long casuleId; private String capsuleType; private String title; private String content; private Date openTime; } // 캡슐 수정 @Getter @Setter @NoArgsConstructor @AllArgsConstructor public static class Update { private String capsuleType; private String title; private String content; private Date openTime; } }

이런식으로 변경했는데, 어노테이션이 겹치는 부분이 너무 많은데 괜찮은거 맞을까용;;;
리뷰 감사합니다. 배워갑니당 >0<

kwonhee1 · 2025-07-22T03:47:27Z

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

+@Getter
+@Setter
+public class CapsuleCreateRequestDto {
+


Dto class의 경우
spring boot에 의해 json parsing되는 일이 많음으로
@NoArgStructure을 꼭 붙여준다 (없을시 기본 생성되지만 명시하는게 좋음)

해당 부분 반영하여 코드 수정하겠습니다. 감사합니다 :)

kwonhee1 · 2025-07-22T03:48:07Z

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

+
+public class CapsuleSelectResponseDto {
+
+    @Getter


Getter는 dto column에 두지 말고
class위에 둘것

앗; 알겠습니다. 바로 반영하겠습니다. 감사합니당

kwonhee1 · 2025-07-22T03:49:09Z

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

+
+    // IPFS CID 필드 ( 이미지 / 동영상 )
+    private String mediaCid;
+


column 마다
@column annotion붙이기

// 캡슐 아이디 @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long capsuleId; // 캡슐 종류 @Column(nullable = false) private String capsuleType; // 제목 @Column(nullable = false) private String title; // 내용 @Column private String content; // 캡슐 오픈일 @Column private Date openTime; // IPFS CID 필드 ( 이미지 / 동영상 ) @Column private String mediaCid;

엔티티 구조도 @column 사용하여 변경했습니당. 감사합니다 :):)

kwonhee1 · 2025-07-22T03:52:37Z

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

+
+        return capsuleRepository.save(capsule);
+    }
+


createCapule 함수의 위치가 올바르지 않음

확장중 다른 service에서 CapuleService에 의존성을 가진다면 createCapules함수에도 의존성을 가지게 됨

dto -> entity 함수는 대부분 dto에 의존성을 가짐으로
dto로 옮기는게 좋음

@Getter
@Setter
@NoArgStructor
class Dto {
int id; String col;
public Entity toEntity() { return Entity.builder(). .. .build(); } // dto -> entity 함수
public static Dto of(Entity entity) { return new Dto(); } // entity -> dto 함수
}

이 부분은 아직 완벽하게 이해를 못해서 좀 더 알아보고 수정하여 다시 코멘트 올리겠습니다!

kwonhee1 · 2025-07-22T03:55:31Z

src/main/java/com/dasom/MemoReal/domain/ipfs/controller/IpfsController.java

+            return ResponseEntity.ok(cid);
+        } catch (Exception e) {
+            return ResponseEntity.internalServerError().body("IPFS 파일 업로드 실패: " + e.getMessage());
+        }


catch (Exception e) { ... }는 다른 모든 exception또한 처리해버림 (만약 다른 부분에서 exception이 발생해도 무조건 "파일 업로드 실패" 라는 404를 반환하게됨)
때문에
IpfsService :: 27줄에서 throw 한 exception을 CustomIpfsException으로 class를 생성해서 던지고
catch(CustomIpfsException e) { ... } 으로 처리하는게 맞음

해당 전역 에러 처리도 다시 한 번 공부해서 수정하겠습니다.

kwonhee1 · 2025-07-22T03:56:37Z

src/main/java/com/dasom/MemoReal/domain/ipfs/service/IpfsService.java

+
+    public IpfsService() {
+        this.ipfs = new IPFS("/ip4/127.0.0.1/tcp/5001"); // IPFS 데몬 주소
+    }


IpfsConfig 에서 이미 @bean으로 등록했음 새로 생성하지 말고 주입을 받아 사용하면 됨

@bean 어노테이션도 한 번 더 찾아보고 수정하겠습니다. 감사합니다!.!

si-zero added 7 commits July 21, 2025 00:27

chore: 스웨거, IPFS 세팅

c37ba30

feat: 캡슐 엔티티, 컨트롤러, 서비스, 레포지토리, Dto 기능 추가

3a1c26c

fix: 에러 코드 버그에 따라 코드 수정

7034f14

feat: 캡슐 관련 에러 코드 추가

8f79547

feat: 에러 코드 출력을 위한 Dto 추가

387948b

feat: IPFS 저장소 사용을 위한 세팅 및 기능 추가

675afe7

feat: 스웨거 콘피그 세팅

11450e8

si-zero self-assigned this Jul 20, 2025

si-zero added ⚙️ setting 프로젝트 환경설정 / Settings for project 👾 feat 새 기능 / New features 📦 chore 세세한 변경사항 / tiny changes 🐵 시영 labels Jul 20, 2025

kwonhee1 reviewed Jul 22, 2025

View reviewed changes


		// IPFS CID 필드 ( 이미지 / 동영상 )
		private String mediaCid;

Conversation

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

Uh oh!

😺 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!

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!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

si-zero commented Jul 20, 2025 •

edited

Loading