기본 콘텐츠로 건너뛰기

냉장고 가계부 프로젝트 22

fridge 프로젝트의 FoodService 인터페이스의 구현클래스 JpaFoodService 의 클래스명을 일관된 네이밍을 위해서 FoodServiceImpl 클래스로 변경한다.

Fridge는 냉장고를 의미하는데 아직 개인화(Personalization) 서비스는 지원하지 않고있다. 아직은 개발단계이므로 Security를 적용하면 개발 편의성이 떨어지므로 우선은 개인화 관련 컬럼을 추가해서 작업을 진행하고 추후에 security 모듈을 적용하도록 한다.

개인화 서비스는 Fridge 단계에서 식별가능한 참조컬럼만 있으면 된다. Food는 Fridge의 자식 관계를 가지므로 Fridge 모델이 개인화되면 자연스럽게 Food도 개인화영역에 들어온다.
Fridge 의 개인화는 1:1 관계를 맺는다. 즉, User 한명당 하나의 Fridge 만을 가지도록 제약한다.

(이제부터는 설계된 코드만 기록한다.)
Fridge 클래스에 long userId 필드와 접근자/수정자를 추가한다. userId 필드는 사용자 개인을 식별할 수 있는 회원번호와 동일한 개념의 데이터를 표현한다.
@Entity(name="fridge")
public class Fridge {
    ... 
    private Long userId;
    
    // Get/Set/Constructor
    
    public Long getUserId() {
        return userId;
    }
    
    public void setUserId(Long userId) {
        this.userId = userId;
    }

    @Override
    public String toString() {
        return "Fridge [id=" + id + ", nickname=" + nickname + ", userId=" + userId + "]";
    }

}

Fridge 테이블 생성 쿼리도 변경한다. schema.sql 파일을 열어서 Fridge 테이블에 user_id 컬럼을 추가한다.
CREATE TABLE fridge (
    id INTEGER GENERATED BY DEFAULT AS IDENTITY(START WITH 1, INCREMENT BY 1) PRIMARY KEY,
    nickname VARCHAR(45) NOT NULL,
    user_id BIGINT
);

Fridge 데이터를 데이터베이스에서 불러올 때, 개인 식별키를 이용할 수 있도록 JpaFridgeRepository 인터페이스에 다음 메서드를 추가한다.
@Repository
public interface JpaFridgeRepository extends JpaRepository<Fridge, Integer> {
    Fridge findByUserId(Long userId);

}

스프링DATA JPA 에서 Query Creation 기능을 이용해서 일정한 패턴의 메서드명으로 표현하면 쿼리가 완성된다. 위의 메서드는 user_id 컬럼이 쿼리 조건절에 추가된다.

FridgeService 인터페이스에서 create 메서드는 새로운 Fridge를 생성하는 로직이 담겨있다. 해당 메서드에 userId 파라미터를 추가하고, 구현 클래스(FridgeServiceImpl) 도 수정한다.
@Transactional
public interface FridgeService {
    Fridge create(String nickname, long userId);

    Fridge save(Fridge fridge);

    void remove(int id);

    void removeAll();
}
@Service
public class FridgeServiceImpl implements FridgeService {
    
    @Autowired
    JpaFridgeRepository jpaFridgeRepository;
    
    @Override
    public Fridge create(String nickname, long userId) {
        Fridge fridge = new Fridge(nickname);
        fridge.setUserId(userId);
        return jpaFridgeRepository.save(fridge);
    }

    ...

}

FridgeService를 이용해서 Fridge 객체를 생성하는 부분은 FridgeController에 있다. 해당 코드도 수정한다.
@RestController
@RequestMapping("/fridges")
public class FridgeController {
    ...

    @PostMapping
    public ResponseEntity<FridgeResource> create(@RequestBody final FridgeRequest fridgeRequest) {
        Fridge fridge = fridgeService.create(fridgeRequest.getNickname(), fridgeRequest.getUserId());
        URI location = MvcUriComponentsBuilder.fromController(getClass())
                .path("/{id}")    
                .buildAndExpand(fridge.getId())
                .toUri();
        return ResponseEntity.created(location).body(assembler.toResource(fridge));
    }
    
    ...
    
    @PutMapping("/{id}")
    public ResponseEntity<?> updateFridge(@PathVariable final int id, @RequestBody final FridgeRequest fridgeRequest) {
        if(jpaFridgeRepository.findOne(id) != null) {
            fridgeService.save(fridgeRequest.toFridge());
        }
        return ResponseEntity.noContent().build();
    }
    
    ...

}

create 메서드는 요청바디에 Fridge 객체를 받는데, 이 부분은 Food와 마찬가지로 JsonIgnore 애너테이션으로 인한 foods 컬렉션을 파싱하지 못하는 문제가 있기때문에 요청 파라미터를 전담할 DTO객체 FridgeRequest 를 만들어서 사용한다.
변경된 fridgeService의 create 메서드에 nickname, userId 파라미터를 전달한다.
updateFridge 메서드도 요청파라미터에 Fridge 객체를 FridgeRequest 객체로 변경하고 toFridge 메서드를 이용해서 저장한다.
다음은 FridgeRequest 클래스이다.
public class FridgeRequest {
    private Integer id;
    private String nickname;
    private List<Food> foods;
    private Long userId;
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getNickname() {
        return nickname;
    }
    public void setNickname(String nickname) {
        this.nickname = nickname;
    }
    public List<Food> getFoods() {
        return foods;
    }
    public void setFoods(List<Food> foods) {
        this.foods = foods;
    }
    public Long getUserId() {
        return userId;
    }
    public void setUserId(Long userId) {
        this.userId = userId;
    }
    public Fridge toFridge() {
        Fridge fridge = new Fridge(getNickname(), getFoods());
        fridge.setId(getId());
        fridge.setUserId(getUserId());
        return fridge;
    }
    @Override
    public String toString() {
        return "FridgeRequest [id=" + id + ", nickname=" + nickname + ", foods=" + foods + ", userId=" + userId + "]";
    }
}

Fridge 클래스와 동일한 필드에 접근자/수정자가 달려있고 toFridge 유틸리티 메서드와 toString 메서드를 오버라이드했다.

FridgeResource 클래스와 FridgeResourceAssembler 클래스에도 userId 필드를 추가한다.
public class FridgeResource extends ResourceSupport {
    @JsonProperty
    Integer id;
    @JsonProperty
    String nickname;
    @JsonProperty
    List foods;
    @JsonProperty
    Long userId;
}
public class FridgeResourceAssembler extends ResourceAssemblerSupport<Fridge, FridgeResource> {

    public FridgeResourceAssembler() {
        super(FridgeController.class, FridgeResource.class);
    }

    @Override
    public FridgeResource toResource(Fridge fridge) {
        FridgeResource resource = new FridgeResource();
        resource.id = fridge.getId();
        resource.nickname = fridge.getNickname();
        resource.foods = fridge.getFoods();
        resource.userId = fridge.getUserId();
        resource.add(linkTo(FridgeController.class).slash(resource.id).withSelfRel());
        return resource;
    }

}

FridgeController 에서 userId를 요청 파라미터로 전달해서 나의 냉장고 데이터를 응답하는 컨트롤러 메서드를 작성한다.
    @GetMapping("/me/{userId}")
    public ResponseEntity<FridgeResource> loadMyFridge(@PathVariable final long userId) {
        Fridge fridge = jpaFridgeRepository.findByUserId(userId);
        if(fridge == null) {
            return ResponseEntity.noContent().build();
        }
        return ResponseEntity.ok(assembler.toResource(fridge));
    }

URL /fridges/me/{userId} 를 Get방식으로 호출하면 loadMyFridge 메서드가 매핑되며, URI 변수로 전달된 userId 값을 repository의 findByUserId 메서드에 파라미터로 전달한다. 리턴값이 null이면 noContent 상태값을 응답으로 리턴하고, 아니라면 OK 상태코드와 함께 fridge 객체를 리턴한다.

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

이 블로그의 인기 게시물

Dolphin 3

100자 이내의 짧은 글을 쓸 수 있는 게시판 제공. Dolphin Project에서 가장 메인 서비스는 예적금 시뮬레이터이므로, 다른 기능 구현은 차후로 미뤄뒀지만, 사용자와 소통할 수 있는 최소한의 기능은 제공하는게 맞다는 생각이 들어 아주 단순한 게시판 기능을 제공합니다. 사용자가 글을 쓰려면 로그인을 먼저 해야합니다. 글을 등록 후 삭제할 때 글 작성자를 식별할 수 있어야 하기 때문입니다. 게시판은 Dolphin Frontend Main 페이지에 자리잡았습니다. 사용자가 가장 먼저 만나게 되는 웹페이지이므로 적당하다고 생각합니다. 다음은 로그인을 하기 전 사용자가 볼 수 있는 메인 페이지입니다. 글 상단에는 작성일(MMM-dd-yyyy)과 작성자 고유번호(#numbers)가 노출됩니다. Dolphin 은 네이버 로그인을 사용하기 때문에, 사용자를 식별할 수 있는 정보는 저 고유번호가 됩니다. 하단에는 글 내용이 자리잡습니다. 스크린샷에서는 Hello, world!! 라는 문구가 보이네요. 글은 최대 100자까지 허용합니다. 버튼 두개(Newer, Older) 는 페이징 버튼인데, Newer는 최근페이지로 이동을 하며, Older는 지나간 글을 보는 페이징버튼입니다. 기본 페이지 사이즈는 20개입니다. 오른쪽으로 보이는 글 작성 폼은 현재 로그인 하기 전이므로 textarea 는 disabled 처리되어 있고 Login버튼이 자리잡고 있습니다. 다음은 사용자가 로그인 한 뒤의 메인페이지입니다. 변경된 부분은 사용자 고유번호 뒤에 Remove 버튼이 나타났습니다. 해당 글 작성자가 로그인한 사용자일 경우에만 보이게 됩니다. 오른쪽 글 작성 폼도 이제 활성화 되었습니다. 아주 단순한 Textarea 창과 Submit 버튼이 자리잡고 있습니다. 다음은 작성자가 아닌 다른 사용자가 로그인한 경우 입니다. 사용자 고유번호(#54097272) 옆에 Remove 버튼이...

Dolphin 2

별도의 회원가입 없이 소셜 로그인 기능 제공으로 간편한 로그인 가능. Dolphin 프론트엔드는 회원가입 절차가 따로 없고, 간단하게 소셜 로그인 기능을 제공함으로써 회원가입, 인증절차를 생략했습니다. 우선, 간단하게 국내에서 잘 알려진 네이버의 API를 사용합니다. 네이버 개발자센터 웹사이트 에서 네이버 아이디로 로그인 기능을 살펴봅니다. 개발 문서를 자세히 살펴보고 API 신청을 합니다. 애플리케이션의 이름을 정하고 필요한 정보를 필수/선택에 체크합니다. 밑으로 내려보면 로그인 API 서비스 환경 부분에서 환경 추가 셀렉트박스에서 PC 웹을 선택하면 다음과 같은 입력폼이 나타납니다. 서비스 URL은 내 웹애플리케이션의 URL이 될 예정입니다. 지금은 개발상태이므로 localhost를 입력했습니다. Callback URL은 네이버 OAuth 인증 url로 호출하면, 인증절차 후 네이버에서 리다이렉트해줄 url을 뜻합니다. 저는 /naver/login 으로 했습니다. 등록이 완료되면 client-id와 client-secret 값을 제공해줍니다. 이 값을 이용해서 인증처리를 할 수 있습니다. spring.io 웹사이트의 튜토리얼 문서를 보면 Facebook 소셜 로그인 기능에 대한 설명이 자세하게 나와있습니다. 이 부분을 참고합니다. Spring Boot and OAuth2 pom.xml 파일에 의존성을 추가하고 Application 클래스에 @EnableOAuth2Sso 애너테이션을 선언합니다. 튜토리얼대로 application.yaml 파일(application.properties)에 설정 정보를 입력합니다. clientId, clientSecret 값은 네이버 개발자센터에서 받은 대로 입력합니다. accessTokenUri는 네이버의 경우 https://nid.naver.com/oauth2.0/token 입니다. userAuthorizationUri는 네이버의 경우 https://ni...

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...