3단계 지하철 구간 관리

목차

3단계 종료

1. API Response응답 결과에는 올바른 정보를 담는다.

httpStatus.created는 자원의 생성이 잘 되었음을 의미한다.

그리고 생성된 자원에 대해서 요청 메세지를 Location 헤더로 응답한다고 한다.

그래서, 나는 구간(Section)을 생성해서 저장했으므로 해당 구간의 아이디를 Location에 담아줬지만,

이렇게 받환받은 Location에 매핑되는 구간조회 API는 존재하지 않으며 사실 필요도 없다.

line을 조회하면 section정보를 얻을 수 있기에 Location은 line조회 path를 반환하는게 맞다.

HTTP 201 Created 는 요청이 성공적으로 처리되었으며, 자원이 생성되었음을 나타내는 성공 상태 응답 코드입니다. 해당 HTTP 요청에 대해 회신되기 이전에 정상적으로 생성된 자원은 회신 메시지의 본문(body)에 동봉되고, 구체적으로는 요청 메시지의 URL이나, 헤더의 내용에 위치하게 됩니다. 이 상태코드(status code)는 일반적으로 요청(request)에 대한 응답결과(result)로써 사용합니다. BCD tables only load in the browser

https://developer.mozilla.org/ko/docs/Web/HTTP/Status/201

2. dtoentity 변환 로직은 DTO나 Entity에게 책임을 주도록 하자.

private Section createSection(SectionRequest request) {
	return Section.Builder()
                .upStation(findStationById(request.getUpStationId()))
                .downStation(findStationById(request.getDownStationId()))
                .distance(request.getDistance())
                .build();
}
Java
복사

기존에 request를 Section으로 변환해주는 서비스계층 메소드였다.

다른 많은 dtoentity 메소드는 각각의 dto나 entity에 넣어놓고 해당 메소드만 서비스계층에 뒀던 이유는 상행역(upStation)과 하행역(downStation)의 아이디를 통해 조회를해서 Station Entity를 받아올 필요가 있었기 때문인데, 이 부분은 그냥 서비스 계층에서는 해당 지하철역 엔티티를 조회한다음 이 엔티티들을 파라미터로 넘겨서 DTO에서 Entity를 생성하도록 코드를 변경했다.

3. dtoentity의 로직은 entity보다는 dto나 converter를 이용하자.

dto는 view의 요구사항에 맞춰 만들어진 객체이기에 요구사항 변경에따른 변경이 잦은편이다.

그렇기에 entity에서 dto를 참조하면 dto의 잦은 변경으로 entity도 변경되야하는 경우가 생긴다.

그렇기에 dto와 entity간의 변환은 dto혹은 converter 레이어를 만들어 처리하는게 좋다.

4. 일급 컬렉션을 사용해 콜렉션을 관리하자.

TDD때도 나왔던 이야기로 콜렉션 필드는 일급 콜렉션을 이용하면 관련 로직의 응집도를 높힐 수 있다.

일급 컬렉션 (First Class Collection)의 소개와 써야할 이유

최근 클린코드 & TDD 강의의 리뷰어로 참가하면서 많은 분들이 공통적으로 어려워 하는 개념 한가지를 발견하게 되었습니다. 바로 일급 컬렉션인데요. 왜 객체지향적으로, 리팩토링하기 쉬운 코드로 갈려면 일급 컬렉션이 필요한지에 대해 많은 분들이 공감하지 못하는걸 보게 되었습니다. 그래서 이번 시간에는 일급 컬렉션 (First Class Collection) 이 무엇인지, 어떤 장점들이 있는지에 대해 소개드립니다.

https://jojoldu.tistory.com/412

더하여 JPA에서 콜렉션을 일급 콜렉션으로 다루고싶다면, Embedded / Embeddable 어노테이션을 이용하면 된다.

JPA Entity에서 일급 컬렉션 사용하기

최근 프로젝트를 진행하던 중 두 Entity를 양방향으로 묶고, 로직을 추가하던 중에 @OneToMany 부분의 List를 가공해야 하는 일이 생겼습니다.컬렉션을 가공할 일이 생기면 가장 먼저 떠오르는 것은 일급 컬렉션인데요.지금까지 그럴 일이 없어서인지 한번도 엔티티 안에서 일급 컬렉션을 사용해 본 적이 없었다는 것을 깨달았습니다. 상황은 다음과 같았습니다.

https://wbluke.tistory.com/23

5. 래퍼 클래스보다는 원시값을 사용하자.

Effective Java #49 객체화된 기본 자료형 대신 기본 자료형을 이용하라

자바의 자료형 시스템은 기본 자료형, 참조 자료형 두가지로 나누어진다. 모든 자료형애는 대응되는 참조 자료형이 있는데 객체화된 기본 자료형이라고 불린다. boolean, int, double의 객체화된 기본 자료형은 Boolean, Integer, Double이다. 자바1.5 부터 자동 객체화(autoboxing)과 자동 비객체화(auto-unboxing)가 언어의 일부가 되었다. 이 기능들은 기본 자료형과 객체 표현형 간의 차이가 있으므로, 둘 가운ㄷ 무엇을 사용하고 있는 지를 아는 것이 중요하며, 어떤 것을 사용할지 신중하게 결정해야 한다.

https://ktko.tistory.com/entry/Effective-Java-49-%EA%B0%9D%EC%B2%B4%ED%99%94%EB%90%9C-%EA%B8%B0%EB%B3%B8-%EC%9E%90%EB%A3%8C%ED%98%95-%EB%8C%80%EC%8B%A0-%EA%B8%B0%EB%B3%B8-%EC%9E%90%EB%A3%8C%ED%98%95%EC%9D%84-%EC%9D%B4%EC%9A%A9%ED%95%98%EB%9D%BC

래퍼 클래스에서는 NullPointerException의 위험이 있고 퍼포먼스 적으로도 차이가 있다. 더하여 객체화 되었기 때문에 실제 값은 같더라도 동등비교시 오류가 발생할 수 있다.