[Kotlin + SpringBoot + RESTApi] 오늘의 찌개 Today's Jjigae

Github : https://github.com/HAN-SEOHYUN/todaysjjigae

 

🔨 소개

매일 저녁 반복되는 메뉴 고민을 덜기 위해 제작했습니다.

• '오늘의 찌개' 에서 찌개를 랜덤으로 선택해드립니다.
• 사용자의 선호도가 높은 찌개는 추첨확률이 높습니다.
• 좋아하는 찌개를 등록, 수정, 삭제 가능합니다.
• API 서버만 구현되었습니다.

 

🪛목표

• Kotlin 언어 학습
• REST API
• 자체 Exception 클래스 생성 : 발생할 수 있는 모든 예외를 고려하여 예외처리

 

⚙️개발 환경

• Gradle
• Kotlin 1.6.21
• Springboot 2.7.5
• Mysql (AWS RDS)
• Spring Data JPA

 

🛠️프로젝트 구조

• DTO : 계층 간 데이터 전송을 위한 객체 생성
• Entity : 도메인 모델
• Mapper 인터페이스 / 클래스 : 객체와 DTO 간의 변환을 돕는 메서드 작성 ( fromEntity(ENTITY) , toEntity(DTO) )
• Repository 인터페이스 : JpaRepository - JPA 관련 작업들을 별도의 코드 없이 처리 가능하게 도움
• Service : 비즈니스 로직 처리
• Exception : 예외 처리
• Resource : 컨트롤러

 

---

POSTMAN API TEST

 

▶ 랜덤 찌개 추천

request

response

 

[Kotlin] 목록에서 랜덤으로 1개만 가져오기 (response : objectDTO)

 

 

▶ new 찌개 등록

request

response

 

Exception : auto_increment 인 id 를 직접 입력한다면 ? 

 ㄴ JjigaeException 발생 : message "Id must be null"

 

 

▶ 모든 찌개 List 가져오기

request

response

Exception : 등록된 Object 가 없다면 ? 

 ㄴ JjigaeException 발생 : message "List of Jjigae is empty"

 

▶ 찌개 수정하기

before and after

 

Exception : 해당 Object 를 찾을 수 없어 수정이 불가하다면 ?

 ㄴ JjigaeException 발생 : message "Jjigae with id ${jjigaeDTO.id} id not present"

 

▶ 찌개 삭제하기

Exception : 해당 Object 를 찾을 수 없어 삭제가 불가하다면 ?

 ㄴ JjigaeException 발생 : message "Jjigae with id $id is not present"