[1 - 6단계 - 방탈출 예약 관리] 망쵸(김주환) 미션 제출합니다. #7

3Juhwan · 2024-04-23T12:59:03Z

고생하셨습니다~~~

* Update .gitignore Co-authored-by: 3Juhwan <[email protected]> * docs(readme): 1단계 기능 요구사항 추가 Co-authored-by: 3Juhwan <[email protected]> * feat(adminController): 어드민 메인 페이지를 응답하는 기능 구현 Co-authored-by: 3Juhwan <[email protected]> * docs(readme): 2단계 기능 요구사항 추가 Co-authored-by: 3Juhwan <[email protected]> * feat(reservationController): 저장된 예약 정보를 조회하는 API 구현 Co-authored-by: 3Juhwan <[email protected]> * docs(readme): 3단계 기능 요구사항 추가 Co-authored-by: 3Juhwan <[email protected]> * feat(reservationController): 예약을 추가하고 삭제하는 기능 구현 Co-authored-by: 3Juhwan <[email protected]> * refactor(reservationController): 예약 삭제 시 id값을 가져와서 비교하지 않고 질의하도록 변경 Co-authored-by: 3Juhwan <[email protected]> --------- Co-authored-by: HyungUk Ryu <[email protected]>

HH:mm:ss -> HH:mm

Libienz · 2024-04-25T01:50:59Z

docs/README.md

+# 1단계 기능 요구사항 - 홈 화면
+
+- [x] `/admin` 으로 `GET` 요청 시 어드민 메인 페이지를 응답한다.
+
+# 2단계 기능 요구사항 - 예약 조회
+- [x] `/reservations` 으로 `GET` 요청 시 저장된 예약 정보를 응답한다.
+- [x] `/admin/reservation` 으로 `GET` 요청 시 예약 관리 페이지를 응답한다.
+
+# 3단계 기능 요구사항 - 예약 추가/취소
+- [x] `/reservations` 으로 `POST` 요청 시 예약을 추가한다.
+- [x] `/reservations/{id}` 으로 `DELETE` 요청 시 해당 `id`의 예약을 삭제한다.


기능 요구사항 👍
API 명세도 있으면 좋을 듯!

Libienz · 2024-04-25T01:53:26Z

src/main/java/roomescape/controller/AdminController.java

+@Controller
+@RequestMapping("/admin")
+public class AdminController {


어쩌다가 알게된 건데 망쵸의 의견도 궁금하네

@RequestMapping을 통해서 리소스를 계층화 할 수 있잖아
그런데 이런 방식으로 url을 잘라놓으면 전역적으로 찾을 떄 (cmd + shift + f) 찾기 어렵다는 말도 있더라고

/admin/resrervation 을 찾을 수 없음

망쵸는 어떻게 생각!?

나도 그 방식이 좋다고 생각해
다음 미션부터 @RequestMapping 보다 Mapping 애너테이션에 모든 URI를 넣으려고!

Libienz · 2024-04-25T01:55:32Z

src/main/java/roomescape/controller/ReservationController.java

+        List<Reservation> reservations = reservationRepository.findAll();
+        List<ReservationResponseDto> reservationResponseDtos = reservations.stream()
+                .map(ReservationResponseDto::from)
+                .toList();


매핑하는 과정을 컨트롤러에 두었군
나랑 똑같네 👏

DTO는 뷰라고 생각했고 DTO는 뷰와 도메인을 모두 알고 있는 컨트롤러에서 다루어져야 한다는 개인적인 생각이야

Libienz · 2024-04-25T01:57:54Z

src/main/java/roomescape/controller/ReservationController.java

+        Reservation savedReservation = reservationRepository.save(new Reservation(
+                reservationRequestDto.name(),
+                reservationRequestDto.date(),
+                reservationRequestDto.time()


Dto에서 값을 꺼내와서 Reservation 객체를 생성하고 있네 👍
RequestDto에서 toEntity를 구현하는 방법이 있고 이러한 방법이 그렇게 어색하지는 않은가봐

웨지랑 나눈 이야기가 있는데 궁금하면 한번 확인해보시오!
코멘트

Libienz · 2024-04-25T02:01:13Z

src/main/java/roomescape/controller/ReservationController.java

+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete(@PathVariable(name = "id") long id) {
+        reservationRepository.deleteById(id);
+
+        return ResponseEntity.noContent().build();
+    }


@PathVariable의 경로 이름(name = "id")과 변수명이 같을 경우 (long id) 생략 가능하다던데 이는 빌드와 실행 옵션에 따라 달라지는 부분이더라

설정에 따라 동작이 달라질 수 있는 코드는 좋지 않기에 지금처럼 @PathVarable에 파라미터를 함께 전달하는 것이 좋은 것 같아 👍
다만 name은 생략할 수 있을 듯!

Libienz · 2024-04-25T02:03:48Z

src/main/java/roomescape/domain/Reservation.java

+package roomescape.domain;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+public class Reservation {
+    private final long id;
+    private final String name;
+    private final LocalDate date;
+    private final LocalTime time;
+


도메인은 비즈니스 로직을 담은 협력 객체, 엔티티는 DB 테이블과 일대일 매핑되는 영속화 대상 객체

나는 레벨 1 체스 미션에서 위와 가이 학습했었어

다만 망쵸의 현행처럼 도메인과 엔티티를 엄격하게 구분하는 경우는 많지 않다고 하더라!
관련한 코멘트

Libienz · 2024-04-25T02:04:28Z

src/main/java/roomescape/dto/ReservationRequestDto.java

+    public static void validateName(String name) {
+        Objects.requireNonNull(name);
+        if (name.length() < NAME_LENGTH_MIN || NAME_LENGTH_MAX < name.length()) {
+            throw new IllegalArgumentException();
+        }
+    }
+
+    private void validateDate(LocalDate date) {
+        Objects.requireNonNull(date);
+        if (date.isBefore(LocalDate.now())) {
+            throw new IllegalArgumentException();
+        }
+    }
+
+    private void validateTime(LocalTime time) {
+        Objects.requireNonNull(time);
+        if (time.isBefore(LocalTime.of(RESERVATION_TIME_MIN, 0))
+                || time.isAfter(LocalTime.of(RESERVATION_TIME_MAX, 0))) {
+            throw new IllegalArgumentException();
+        }


어떤 것을 검증하는지 확실한 메서드 명을 주는게 좋을 듯!?

추가적으로 Objects.requireNonNull()은 단순히 NPE 만을 발생시키기에 (물론 발생시키지 않는 것 보다는 괜춘겠지만)
불친절하다는 생각이야 ( 나도 Objects.requireNonNull()만 썻다가 리뷰 받음)

망쵸의 결론도 궁금하군 🤔

Libienz · 2024-04-25T02:08:07Z

docs/README.md

+# 1단계 기능 요구사항 - 홈 화면
+


예약 날짜는 현재보다 이전일 수 없다 등등 여러 도메인 규칙들이 보이는데 이러한 것도 정리되어 있는 것이 좋을 것 같아!

레벨 - 1을 까먹지 말라는 네오의 가르침..!

Libienz · 2024-04-25T02:09:59Z

src/main/java/roomescape/domain/Reservation.java

+    public Reservation(String name, LocalDate date, LocalTime time) {
+        this(0L, name, date, time);
+    }


0과 Null은 의미가 천차만별이라고 생각해

만약 아이디가 없음을 의도한 것이라면 nullable함을 설정해야된다고 생각함! (Wrapper Type)

추가적으로 ID는 null 표현 때문에 Wrapper 타입이 거의 강제된다고 하더라고 🤔

Libienz

하이 망쵸 🙌
리뷰하다가 뭘 잘못눌러서 리뷰가 여러방 나갔네 쏘리 😂

망쵸는 이미 여러가지를 알고 있는 것 같지만 리뷰 남겨봤어 ㅎ..
내가 배운 것 검증하기 위한 목적도 있고 망쵸랑 여러 얘기 나눠보고 싶은 이유도 있고 해서 망쵸가 이미 알고 있는 것 같은 부분에 대한 리뷰도 들어갔다는 점 양해 부탁할게 🙏

남은 미션들도 화이팅 👏

Libienz · 2024-04-25T02:11:32Z

src/main/java/roomescape/domain/Reservation.java

+    public Reservation(String name, LocalDate date, LocalTime time) {
+        this(0L, name, date, time);
+    }


추가적으로 ID는 null 표현 때문에 Wrapper 타입이 거의 강제된다고 하더라고 🤔

Libienz · 2024-04-25T02:12:32Z

src/main/java/roomescape/dto/ReservationResponseDto.java

+public record ReservationResponseDto(long id, String name, LocalDate date,
+                                     @JsonFormat(pattern = "HH:mm") LocalTime time) {


@JsonFormat 몰랐는데 알아갑니다 🙇🏻‍♂️

Libienz · 2024-04-25T02:13:38Z

src/main/java/roomescape/repository/H2ReservationRepositoryImpl.java

+@Repository
+public class H2ReservationRepositoryImpl implements ReservationRepository {


...Impl이라는 클래스 명은 인터페이스에 대한 구현체가 단 하나일 때 사용하는 관례적 이름이라고 나는 알고 있어
지금처럼 구현체가 여러개인 경우에는 다른 이름이 좀 더 좋지 않을까 하는 개인적인 생각!

Libienz · 2024-04-25T02:15:20Z

src/main/java/roomescape/repository/InMemoryReservationRepositoryImpl.java

+    private final List<Reservation> reservations = Collections.synchronizedList(new ArrayList<>());
+    private final AtomicLong index = new AtomicLong(0);


Collections.synchronizedList(new ArrayList<>());는 처음 보네 멀티 스레드 환경에서 동기화를 보장해주나봐 👀
새로운 것 학습하고 갑니다

Libienz · 2024-04-25T02:25:44Z

src/test/java/roomescape/controller/ReservationControllerTest.java

+@Import(InMemoryReservationRepositoryImpl.class)
+@WebMvcTest(ReservationController.class)
+class ReservationControllerTest {
+    @Autowired


와 테스트 잘써놨다 👍

나 계층들 테스트가 제일 걱정이었는데 망쵸꺼 보면서 공부해야할 듯 💪🏻

kelly6bf

망쵸! 미션 고생했어요! 사용하신 어노테이션들을 보니 스프링 경험이 꽤 있다고 느껴졌어요! 그래서 크게 리뷰할 내용은 없네요 👀

다시한번 미션 너무 고생했어요!

kelly6bf · 2024-04-24T13:45:44Z

src/main/java/roomescape/repository/H2ReservationRepositoryImpl.java

+import javax.sql.DataSource;
+import java.util.List;
+
+@Primary


혹시 당신도.. 대영한카르텔..? 농담입니다ㅎ 우선적으로 주입될 빈을 설정하기 위해서 @Primary 어노테이션을 사용해주셨군요! 굳!

kelly6bf · 2024-04-25T00:36:56Z

src/main/java/roomescape/dto/ReservationRequestDto.java

+        validateDateTime(date, time);
+    }
+
+    public static void validateName(String name) {


아무래도 가장 고민되는 지점이죠? 우린 레벨1에서 특정 도메인의 값 검증은 해당 도메인 클래스에 위임하는게 좋다고 배웠지만. 막상 스프링 관점에서 보면 DTO에서 검증하는게 크게 나쁘지 않은거 같구요 🤔 (더군다나 스프링의 @Validation을 사용하면 훨씬 편리하고 강력하게 검증을 할 수 있는데 말이죠...ㅎ)

값에 대한 검증 책임은 DTO vs Domain

망쵸의 의견이 궁금해요 ☺️

PS. 무려 7년전에도 같은 주제로 선배 개발자들이 열심히 토론하고있더라구요! 의견 역시 가지각색이고요 👀
https://stackoverflow.com/questions/42280355/spring-rest-api-validation-should-be-in-dto-or-in-entity

kelly6bf · 2024-04-25T04:35:40Z

src/test/java/roomescape/repository/H2ReservationRepositoryImplTest.java

+import static org.assertj.core.api.Assertions.assertThatCode;
+import static org.assertj.core.api.SoftAssertions.assertSoftly;
+
+@Transactional


@Transactional을 사용해주셨네요! 비즈니스로직에는 따로 @transactional이 보이지 않던데 테스트 데이터 롤백용으로 사용했을까요?

테스트에서 데이터 롤백용으로 @Transactional을 사용해야하는지는 현업자분들 사이에서도 논쟁이 오간다고해요! 망쵸는 어떤 의견인지, 사용해도 괜찮다면 단점보다 큰 장점이 무엇인지 의견이 궁금해요!

관련해서 재밌는 글을 하나 발견해서 공유드립니다! 😋
https://jojoldu.tistory.com/761

3Juhwan and others added 30 commits April 18, 2024 00:18

fix: API 포맷 변경

16a398b

HH:mm:ss -> HH:mm

refactor: ContentType 세팅 코드 삭제

b829c3c

refactor: 예약 요청 DTO 추가

0663d5a

feat: 상태코드 변경

cfa2452

refactor: admin api의 uri prefix 공통 처리

c21deef

fix: html 네비게이션에 하이퍼링크 수정

948d536

refactor: 테스트 포트 번호 수정, @DirtiesContext 제거

6fd8012

fix: 변경된 상태 코드를 테스트에 반영

e941bed

chore: H2 DB 세팅

03a8a4a

refactor: reservations URI를 클래스 단위로 맵핑

1cec379

feat: 예약 repository 인터페이스 추가

ffbed0e

feat: 예약 controller에 repository 주입

292223e

feat: 예약 repository h2 구현체 추가

496ef6b

feat: 예약 pk 생성 책임을 DB에 위임, 저장할 시 엔티티 반환

21b5bf4

test: 어드민 예약 페이지 HTTP 요청 테스트 추가

5e7ccdf

refactor: Map에서 SqlParameterSource로 교체

37aa4e7

test: 예약 repository 테스트 추가

537a3e3

test: 삭제할 예약이 존재하지 않는 경우에 대한 테스트 추가

67b42f9

rename: 기존 controller 테스트를 appceptance 테스트로 변경

f357078

feat: 인메모리 repository 추가

fbba62e

fix: 애플리케이션 컨테이너 뜰 때마다 table id를 1로 초기화

cf6eadd

refactor: 인텔리제이 빌드를 위해 경로 명시

78822a9

style: 테스트명에 마침표 삭제

de4f254

test: 예약 시점을 미래로 수정

f6d740b

fix: 기존 예약 테스트에 존재했던 DB(auto-increase)에 대한 의존성 제거

8c2213a

test: controller 슬라이스 테스트

0bfbd46

feat: dto에 예약 정책 추가

d47c5ae

test: 예약 controller 예외 상황 테스트 추가

248c01a

fix: 성공적인 POST 요청에 대한 HTTP 응답 코드를 200에서 201로 변경

a31c4e0

Libienz reviewed Apr 25, 2024

View reviewed changes

kelly6bf requested changes Apr 25, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[1 - 6단계 - 방탈출 예약 관리] 망쵸(김주환) 미션 제출합니다. #7

[1 - 6단계 - 방탈출 예약 관리] 망쵸(김주환) 미션 제출합니다. #7

3Juhwan commented Apr 23, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

3Juhwan Apr 25, 2024 •

edited

Loading

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024 •

edited

Loading

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz left a comment

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

Libienz Apr 25, 2024

kelly6bf left a comment

kelly6bf Apr 24, 2024

kelly6bf Apr 25, 2024

kelly6bf Apr 25, 2024

		public record ReservationResponseDto(long id, String name, LocalDate date,
		@JsonFormat(pattern = "HH:mm") LocalTime time) {

		@Repository
		public class H2ReservationRepositoryImpl implements ReservationRepository {

		private final List<Reservation> reservations = Collections.synchronizedList(new ArrayList<>());
		private final AtomicLong index = new AtomicLong(0);

[1 - 6단계 - 방탈출 예약 관리] 망쵸(김주환) 미션 제출합니다. #7

Are you sure you want to change the base?

[1 - 6단계 - 방탈출 예약 관리] 망쵸(김주환) 미션 제출합니다. #7

Conversation

3Juhwan commented Apr 23, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

3Juhwan Apr 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Libienz Apr 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Libienz left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kelly6bf left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

3Juhwan Apr 25, 2024 •

edited

Loading

Libienz Apr 25, 2024 •

edited

Loading