Spring Boot] 프로젝트를 진행하는 과정에서 원칙 정리

1. Optional 사용

• Java8 부터 추가된 문법. 요즘에는 Null을 직접 반환하는 대신 값이 없으면 Optional 을 사용하는 추세다.

// 코드 1. 일치하는 값이 없으면 Null 반환
public Member findByLoginId(String loginId) {
    List<Member> all = findAll();
    for (Member m : all) {
        if (m.getLoginId().equals(loginId)) {
            return m;
        }
    }
    return null;
}

// 코드 2. Optional<> 사용
public Optional<Member> findByLoginId(String loginId) {
    List<Member> all = findAll();
    for (Member m : all) {
        if (m.getLoginId().equals(loginId)) {
            return Optional.of(m);
        }
    }
    return Optional.empty();
}

// 코드 3. lambda 형식 사용. 코드가 간결해짐. 추천하는 방식
public Optional<Member> findByLoginId(String loginId) {
    return findAll().stream()
            .filter(m -> m.getLoginId().equals(loginId))
            .findFirst();
}

 

2. ConcurrentHashMap

hashmap vs concurrenthashmap

인프런 질문

클래스 변수, 인스턴스 변수, 지역 변수 설명

• 동시성이 문제가 되는 상황에서는 HashMap보다는 ConcurrentHashMap을 사용해야 한다. 예를 들어서 스프링의 빈이 싱글톤인데, 여기에서 멤버 변수를 사용하면 여러 쓰레드에서 해당 멤버 변수를 공유해서 사용하게 되고, 이때 문제가 발생할 수 있음.
• 지역 변수는 쓰레드간에 공유되지 않기 때문에 HashMap을 사용하는 것이 올바르다.
  • 멤버 변수: 클래스 변수, 인스턴스 변수가 여기에 포함됨
  • 지역 변수
  • 두 변수에 대한 자세한 설명은 위의 링크 참고

 

3. Spring Boot Package Structure

Spring Boot 2.0 — Project Structure and Best Practices (Part 2)

인프런-"프로젝트 폴더 구조와 강의 일정에 관하여 질문"

Spring Guide - 패키지 구조 가이드

[Spring boot] 디렉터리 패키지 구조의 선택

Spring Boot 서비스의 큰 흐름

• DTO(Data Transfer Object): 데이터 전송 객체. 기능은 없고 데이터를 전달만 하는 용도로 사용되는 객체를 의미한다.
  • DTO에 기능이 있어도 상관없다. 객체의 주 목적이 데이터 전달이라면 DTO라고 할 수 있다.
• DTO의 경우 맨 마지막에 사용되는 패키지에 넣거나, 혹은 Service, Repository 등 여러 곳에서 사용된다면 따로 dto package를 만들어서 사용하는 것도 괜찮다.

계층형 구조 예시

도메인형 구조 예시

결론

• 패키지 구조에 정답은 없다. 프로젝트가 성장함에 따라 프로젝트 구조도 현재 상황에 맞추어 성장하고 변경된다.
• Spring Guide - 패키지 구조 가이드 링크를 참고하면, 최근 기술 동향에서는 도메인형 구조가 더 적합하다고 한다.
• 단순히 개인 혹인 팀 프로젝트에서는 계층형 구조가 더 나아 보일 수 있지만, 예를 들어 controller package 내에 controller class가 여러 개가 생성되는 경우, 도메인형 구조로 변경하는 것이 나을 것으로 보인다.
• 본 프로젝트에서는, Spring Guide - 패키지 구조 가이드 그리고 [Spring boot] 디렉터리 패키지 구조의 선택 링크를 참고하여 domain / global 을 분리한 domain형 구조로 프로젝트를 진행할 계획

 

기타

• hexagonal architecture 라는 개념이 존재하는데, 이는 지금 단계에서 이해하지 못하였음.

 

 

4. Content-Type Header vs Accept Header

개념에 대한 설명은 구글 검색 참고

Spring Framework에서 구현

/**
 * Content-Type 헤더 기반 추가 매핑 Media Type
 * consumes="application/json"
 * consumes="!application/json"
 * consumes="application/*"
 * consumes="*\/*"
 * MediaType.APPLICATION_JSON_VALUE
 */
@PostMapping(value = "/mapping-consume", consumes = MediaType.APPLICATION_JSON_VALUE)
public String mappingConsumes() {
    log.info("mappingConsumes");
    return "ok";
}

/**
 * Accept 헤더 기반 Media Type
 * produces = "text/html"
 * produces = "!text/html"
 * produces = "text/*"
 * produces = "*\/*"
 */
@PostMapping(value = "/mapping-produce", produces = MediaType.TEXT_HTML_VALUE)
public String mappingProduces() {
    log.info("mappingProduces");
    return "ok";
}

 

5. RestTemplate과 WebClient

RestTemplate과 WebClient

• 스프링 어플리케이션에서 HTTP 요청할 때 사용하는 방법으로 RestTemplate과 WebClient가 있다. 스프링 5.0 이전까지는 클라이언트에서 HTTP 접근을 위해 사용한 것은 RestTemplate 이었다. 스프링 5.0 에서 WebClient가 나왔고 현재는 WebClient를 사용하기를 권고하고 있다.

 

6. Lombok 라이브러리 사용 시 주의사항

엔티티를 설계할 때, 실무에서는 가급적 Getter는 열어두고, Setter는 꼭 필요한 경우에만 사용하는 것을 권장한다. 즉, Lombok @Data 어노테이션 사용을 최대한 지양하라는 것으로 해석된다.

• 더 좋은 방식은, Setter는 사용하지 않고, 엔티티를 변경할 때는 비즈니스 메서드를 별도로 만드는 것이다. 이것의 장점은, 변경 지점을 Setter에 비해 명확하게 파악할 수 있다.