기본 콘텐츠로 건너뛰기

냉장고 가계부 프로젝트 24

Food 클래스의 멤버변수가 많아지면서 생성자를 이용한 객체생성이 복잡해졌다. 식품명과 수량은 반드시 입력해야 하고, 유통기한은 별도의 로직이 들어가야한다. id, fridge 필드 또한 setter 를 이용할 경우도 있고 아닐 경우도 있다. 이를 해결하고자, Food 클래스에 빌더를 추가한다.
@Entity(name="food")
public class Food {
    @Id
    @GeneratedValue(strategy=GenerationType.IDENTITY)
    private Long id;
    
    @ManyToOne
    @JsonIgnore
    private Fridge fridge;
    private String name;
    private int quantity;
    
    @Temporal(TemporalType.DATE)
    private Date expiryDate;
    
    public static final int DEFAULT_EXPIRY_DAYS = 7;
    
    protected Food() {}
    
    public Long getId() {
        return id;
    }
    public Fridge getFridge() {
        return fridge;
    }
    public void setFridge(Fridge fridge) {
        this.fridge = fridge;
    }
    public String getName() {
        return name;
    }
    public int getQuantity() {
        return quantity;
    }
    public Date getExpiryDate() {
        return expiryDate;
    }
    
    private void setDefaultExpiryDate() {
        this.expiryDate = Date.from(LocalDate.now().plusDays(DEFAULT_EXPIRY_DAYS).atStartOfDay(ZoneId.systemDefault()).toInstant());
    }
    
    @Override
    public int hashCode() {
        return Objects.hashCode(getId());
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj)
            return true;
        if (obj == null || getClass() != obj.getClass())
            return false;
        Food other = (Food) obj;
        return Objects.equals(getId(), other.getId());
    }
    
    public static class Builder {
        private Long id;
        private final String name;
        private final int quantity;
        private Date expiryDate;
        private Fridge fridge;
        
        public Builder(String name, int quantity) {
            this.name = name;
            this.quantity = quantity;
        }
        
        public Builder id(Long id) {
            this.id = id;
            return this;
        }
        
        public Builder expiryDate(Date expiryDate) {
            this.expiryDate = expiryDate;
            return this;
        }
        
        public Builder fridge(Fridge fridge) {
            this.fridge = fridge;
            return this;
        }
        
        public Food build() {
            return new Food(this);
        }
    }
    
    private Food(Builder builder) {
        this.id = builder.id;
        this.name = builder.name;
        this.quantity = builder.quantity;
        this.expiryDate = builder.expiryDate;
        if(this.expiryDate == null) {
            setDefaultExpiryDate();
        }
        this.fridge = builder.fridge;
    }
    
}

불필요한 setter, 사용하지 않는 메서드(decreaseQuantity)는 삭제하고, 내부에 Builder 정적 클래스를 생성했다. 객체생성에 필수 필드인 name, quantity는 빌더 생성자에서 바로 전달받고, 나머지 필드는 선택적으로 받을 수 있다.

expiryDate 필드는 유통기한을 나타내는데 사용자가 유통기한을 입력하지 않으면 입력한 시점에서부터 DEFAULT_EXPIRY_DAYS 값만큼 N일 더한 값을 필드에 할당한다.
setDefaultExpiryDate 메서드는 현재날짜로부터 N을 더하는 기능을 담당한다.

Food 클래스가 크게 변경되었으므로, 컴파일에러가 나는 부분을 전부 수정하고, new 생성자를 이용해서 객체를 생성했던 부분들도 전부 빌더를 이용하도록 수정한다. 수정이 완료되면 테스트를 통해 문제가 없는지 확인한다.

그런데, Date 타입의 expiryDate를 Java8 의 LocalDate를 사용해서 변경하는 방법은 좀 불편하다. 필드를 LocalDate 타입으로 변경한다.
@Entity(name="food")
public class Food {
    ...
    private LocalDate expiryDate;
    
    // Getter/Setter

    public LocalDate getExpiryDate() {
        return expiryDate;
    }
    
    private void setDefaultExpiryDate() {
        this.expiryDate = LocalDate.now().plusDays(DEFAULT_EXPIRY_DAYS);
    }
    
    // hashCode, equals
    
    public static class Builder {
        private Long id;
        private final String name;
        private final int quantity;
        private LocalDate expiryDate;
        private Fridge fridge;
        
        public Builder(String name, int quantity) {
            this.name = name;
            this.quantity = quantity;
        }
        
        public Builder id(Long id) {
            this.id = id;
            return this;
        }
        
        public Builder expiryDate(LocalDate expiryDate) {
            this.expiryDate = expiryDate;
            return this;
        }
        
        public Builder fridge(Fridge fridge) {
            this.fridge = fridge;
            return this;
        }
        
        public Food build() {
            return new Food(this);
        }
    }
    
    private Food(Builder builder) {
        this.id = builder.id;
        this.name = builder.name;
        this.quantity = builder.quantity;
        this.expiryDate = builder.expiryDate;
        if(this.expiryDate == null) {
            setDefaultExpiryDate();
        }
        this.fridge = builder.fridge;
    }
    
}

변경 후 setDefaultExpiryDate 메서드의 코드가 좀 줄었다. 굳이 힘들게 Date타입으로 캐스팅하지 않아도 된다. expiryDate 필드에 선언되었던 @Temporal 애너테이션을 없앴다. @Temporal 애너테이션은 java.util.Date, java.util.Timestamp 클래스에일 경우에만 선언한다.

변경된 내용으로 인해 컴파일 에러가 난 부분을 수정하고, 테스트 클래스도 수정하고 나서 테스트를 수행하면 실패한다. 하이버네이트 의존라이브러리를 등록해야한다.
pom.xml에 다음과 같이 추가한다.
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-java8</artifactId>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
</dependency>

jackson-datatype-jsr310은 JSON 타입으로 컨버팅할 때 LocalDate 값이 장황하게 나오는 부분을 줄여준다.
출처: Java 8 Date(Time) 와 JPA 그리고 스프링 부트, Spring Jpa java8 date (LocalDateTime) 와 Jackson

fridge-web 프로젝트에서도 마찬가지로 FoodCommand 클래스를 LocalDate 타입으로 변경하고, 컴파일 에러가 나는 부분을 수정한다. 테스트를 실행하면 에러가 발생하는데 마찬가지로 jackson-data-type-jsr310 의존성을 추가한다. 의존성을 추가하고 나서 다시 테스트를 수행하면 thymeleaf 에서 오류가 발생한다. localDate 값을 #dates.format 형식으로 변환하는 부분이 java.util.Date 타입이기 때문이다. 여기는 라이브러리를 추가하고 thymeleaf utility도 #temporals.format 으로 수정해야한다.
<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-java8time</artifactId>
</dependency>

이제 다시 테스트를 수행해서 문제가 없는지 확인한다.
출처: HOW-TO: JAVA 8 DATE & TIME WITH THYMELEAF AND SPRING BOOT

이전글: 냉장고 가계부 프로젝트 23
다음글: 냉장고 가계부 프로젝트 25

이 블로그의 인기 게시물

Dolphin 1

금융감독원 OPEN API를 사용하여 데이터 수집 금융감독원 금융상품통합비교공시 사이트에서 제공하는 OPEN API 를 사용합니다. 먼저, API 키를 신청합니다. https://finlife.fss.or.kr/PageLink.do?link=openapi/certification&menuId=2000119  로 접속합니다. 약관에 동의하고 본인인증 후, 신상정보를 넘기면 바로 API 키를 받을 수 있습니다. 상세 및 테스트 페이지를 들어가보면 요청 파라미터와 응답 API 형태를 확인할 수 있습니다. 요청은 다음과 같습니다. 읽어보면 서비스 명에 따라 url이 달라지는 부분을 제외하면 요청 URL은 크게 달라지지 않습니다. 파라미터에 인증키, 권역코드, 페이지번호를 전달하면 됩니다. 응답부분은 서비스마다 다르지만 공통 응답 형태는 다음과 같습니다. 에러코드, 에러메시지, 전체 개수, 전체 페이지, 현재 페이지 번호 입니다. 예금상품 조회 서비스나 적금상품 조회 서비스의 경우 공통적으로 금융회사 코드와 이름을 전달해주는데 해당 금융회사의 상세한 정보를 보려면 금융회사 조회 서비스도 호출하는게 나중에 좋을것 같습니다. Spring으로 HTTP 통신을 위해서 Apache HttpComponent 라이브러리를 사용합니다. 메이븐에 다음과 같이 의존성을 추가합니다. <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> </dependency> 다음은 API를 호출하는 간단한 소스코드 조각입니다. CloseableHttpClient httpClient = HttpClients.createDefault(); URI uri = new URIBuilder() .setScheme("http") .setHos...

Effective Java

생성자 대신 정적 팩터리 메서드를 사용할 수 없는지 생각해 보라 생성자 인자가 많을 때는 Builder 패턴 적용을 고려하라 private 생성자나 enum 자료형은 싱글턴 패턴을 따르도록 설계하라 객체 생성을 막을 때는 private 생성자를 사용하라 불필요한 객체는 만들지 말라 유효기간이 지난 객체 참조는 폐기하라 종료자 사용을 피하라 equals를 재정의할 때는 일반 규약을 따르라 equals를 재정의할 때는 반드시 hashCode도 재정의하라 toString은 항상 재정의하라 clone을 재정의할 때는 신중하라 Comparable 구현을 고려하라 클래스와 멤버의 접근 권한은 최소화하라 public 클래스 안에는 public 필드를 두지 말고 접근자 메서드를 사용하라 변경 가능성을 최소화하라 계승하는 대신 구성하라 계승을 위한 설계와 문서를 갖추거나, 그럴 수 없다면 계승을 금지하라 추상 클래스 대신 인터페이스를 사용하라 인터페이스는 자료형을 정의할 때만 사용하라 태그 달린 클래스 대신 클래스 계층을 활용하라 전략을 표현하고 싶을 때는 함수 객체를 사용하라 멤버 클래스는 가능하면 static으로 선언하라 새 코드에는 무인자 제네릭 자료형을 사용하지 마라 무점검 경고(unchecked warning)를 제거하라 배열 대신 리스트를 써라 가능하면 제네릭 자료형으로 만들 것 가능하면 제네릭 메서드로 만들 것 한정적 와일드카드를 써서 API 유연성을 높여라 형 안전 다형성 컨테이너를 쓰면 어떨지 따져보라 int 상수 대신 enum을 사용하라 ordinal 대신 객체 필드를 사용하라 비트 필드(bit field) 대신 EnumSet을 사용하라 ordinal을 배열 첨자로 사용하는 대신 EnumMap을 이용하라 확장 가능한 enum을 만들어야 한다면 인터페이스를 이용하라 작명 패턴 대신 어노테이션을 사용하라 Override 어노테이션은 일관되게 사용하라 자료형을 정의할 때 표식 인터페이스를 사용하라...

냉장고 가계부 프로젝트 14

fridge-web 프로젝트에서 api 서버와 통신할때 URL을 매번 중복해서 입력하는 부분을 제거하기 위해 RestTemplate 빈 등록메서드를 수정한다. @Bean public RestTemplate restTemplate(RestTemplateBuilder builder) { return builder.rootUri("http://localhost:8081").build(); } builder에 rootUri 메서드를 호출해서 api 서버 url을 미리 설정하고 build해서 RestTemplate 객체를 반환하면 RestTemplate을 사용하는 부분에서는 root 다음 경로만 넘겨주면 된다. WebFoodController 클래스의 restTemplate 사용부분을 전부 수정한다. @GetMapping public String foods(Model model) { ResponseEntity<Resources<FoodCommand>> response = restTemplate.exchange("/foods", HttpMethod.GET, null, new ParameterizedTypeReference<Resources<FoodCommand>>() {}, Collections.emptyMap()); .... 다른 메서드들도 동일하게 수정한다. Food 클래스에서도 이제 더이상 사용하지 않는 Cloneable과 hashCode, equals 메서드를 정리한다. Guava 의존라이브러리도 다른곳에서는 사용하지 않으므로 정리한다. 식품에 대한 최소한의 기능은 구현하였다. 이번에는 냉장고 라는 개념을 모델링한다. 식품들이 들어가고 나가는 곳은 냉장고이기 때문에 냉장고라는...