기본 콘텐츠로 건너뛰기

냉장고 가계부 프로젝트 18

fridge-web 프로젝트에서 FridgeControllerTests 클래스를 리팩토링한다.
public class FridgeControllerTests extends ControllerBase {
    
    @Override
    protected void setUp() {
        
    }
    
    @Test
    public void findCreateFridgeButtonAndClick() {
        browser.get(BASE_URL + "/fridges");
        WebElement createFridgeBtn = browser.findElementById("btnCreateFridge");
        assertThat(createFridgeBtn).isNotNull();
        
        createFridgeBtn.click();
        assertThat(browser.getCurrentUrl()).isEqualTo(BASE_URL + "/fridges/add");
    }
    
    @Test
    public void fillInCreateFormAndSubmit() {
        browser.get(BASE_URL + "/fridges/add");
        
        String nickname = "myFridge";
        WebElement nicknameElement = browser.findElement(By.name("nickname"));
        nicknameElement.sendKeys(nickname);
        browser.findElementByTagName("form").submit();
        
        WebDriverWait wait = new WebDriverWait(browser, 10);
        wait.until(ExpectedConditions.alertIsPresent());
        Alert alert = browser.switchTo().alert();
        assertThat(alert.getText()).isEqualTo(nickname + "을 생성했습니다.");
        alert.accept();
    }

}

기존에는 create 테스트 메서드 하나에 목록페이지에서 시작해서 등록페이지까지 한번에 테스트를 했는데, 이부분을 두개의 메서드로 나눠서 따로 테스트한다.

findCreateFridgeButtonAndClick 메서드는 /fridges 페이지로 이동해서 버튼을 찾고 클릭해서 등록페이지로 이동하는지를 검증한다.

fillInCreateFormAndSubmit 메서드는 등록 폼 페이지로 이동해서 nickname 필드에 값을 입력하고 submit 한다. 등록처리가 성공적으로 끝나면 alert 가 나오는데 alert의 text를 검증한다.

테스트를 수행해서 이상이 없는지 확인한다.

FridgeControllerTests 클래스에 냉장고 상세, 목록기능 테스트 메서드를 작성한다.
    @MockBean
    private JpaFridgeRepository fridgeRepository;
    
    private Fridge myFridge;
    private static final Integer ID = 1;
    private static final String BASE_PATH = "http://localhost";
    
    @Before
    public void setUp() {
        myFridge = new Fridge("myFridge");
        myFridge.setId(ID);
    }

    @Test
    public void loadFridgeById() throws Exception {
        when(fridgeRepository.findOne(ID)).thenReturn(myFridge);
        final ResultActions resultAction = mvc.perform(get("/fridges/" + ID));
        resultAction.andExpect(status().isOk());
        verifyResultActions(resultAction);
    }

    @Test
    public void findAllFridges() throws Exception {
        List<Fridge> fridges = Arrays.asList(myFridge);
        given(fridgeRepository.findAll()).willReturn(fridges);
        
        final ResultActions result = mvc.perform(get("/fridges").accept(MediaType.APPLICATION_JSON_UTF8));
        result.andExpect(status().isOk())
            .andExpect(content().contentType(MediaType.APPLICATION_JSON_UTF8))
            .andExpect(jsonPath("_links.self.href", equalTo(BASE_PATH + "/fridges")))
            .andExpect(jsonPath("_embedded.fridgeResourceList[0].id", equalTo(myFridge.getId().intValue())))
            .andExpect(jsonPath("_embedded.fridgeResourceList[0].nickname", equalTo(myFridge.getNickname())))
            .andExpect(jsonPath("_embedded.fridgeResourceList[0]._links.self.href", equalTo(BASE_PATH + "/fridges/" + myFridge.getId().intValue())));
    }

별도의 로직은 없으므로 repository에서 호출해서 사용하기 위해 JpaFridgeRepository Mock객체를 생성한다. loadFridgeById 테스트 메서드는 /fridges/{id} URL 을 GET방식으로 호출하면 응답상태코드는 ok, 응답본문은 verifyResultActions 메서드에서 검증한다.
findAllFridges 테스트 메서드는 /fridges URL을 GET방식으로 호출하면 응답상태코드는 ok, 응답본문은 json 형태로 전달받은 List 형태의 Fridge를 검증한다.

FridgeController 클래스를 구현한다.
    @Autowired
    private JpaFridgeRepository jpaFridgeRepository;

    @GetMapping("/{id}")
    public ResponseEntity<FridgeResource> loadFridgeById(@PathVariable final int id) {
        Fridge fridge = jpaFridgeRepository.findOne(id);
        if(fridge == null) {
            return ResponseEntity.noContent().build();
        }
        return ResponseEntity.ok(assembler.toResource(fridge));
    }

    @GetMapping
    public ResponseEntity<Resources<FridgeResource>> findAllFridges() {
        List<Fridge> fridges = jpaFridgeRepository.findAll();
        List<FridgeResource> fridgeResources = assembler.toResources(fridges);
        Link link = linkTo(methodOn(FridgeController.class).findAllFridges()).withSelfRel();
        Resources<FridgeResource> resources = new Resources<>(fridgeResources, link);
        return ResponseEntity.ok(resources);
    }

loadFridgeById메서드는 id값을 uri변수로 전달받고, JpaFridgeRepository.findOne 메서드를 이용해서 단일 로우를 검색하고 결과가 없을 경우 noContent 응답상태코드를 전달하고, 로우가 있다면 assembler를 이용해서 fridge객체를 resource 객체로 변환해서 응답하며 응답상태코드는 OK 로 리턴한다.

findAllFridges 메서드는 repository에서 findAll 메서드를 호출한다. 리턴된 List를 assembler를 이용해서 Resources 객체로 변환하고 link를 설정하고 응답본문에 전달한다.

API가 완성되었으므로 UI를 구현하기 위해 fridge-web 프로젝트를 연다.
먼저 FridgeControllerTests 테스트 메서드부터 작성한다. 형태는 food와 매우 비슷하다. 단순한 CRUD가 반복되므로 food와 비슷할 수 밖에 없다.
    @Autowired
    private RestTemplate restTemplate;
    
    private static final String FRIDGE_API_URL = "http://localhost:8081";

    @Test
    public void clickAnchorTagFromFridges() {
        FridgeCommand fridge = new FridgeCommand();
        fridge.setNickname("myFridge");
        fridge.setId(createFridge(fridge));
        
        browser.get(BASE_URL + "/fridges");
        
        String viewPageUrl = BASE_URL + "/fridges/" + fridge.getId();
        
        List<WebElement> anchors = browser.findElementsByLinkText(fridge.getNickname());
        assertThat(anchors).filteredOn(new Condition<WebElement>() {
            @Override
            public boolean matches(WebElement element) {
                return element.getAttribute("href").equals(viewPageUrl);
            }
        });
        
        WebElement anchorTag = anchors.stream()
                .filter(element -> element.getAttribute("href").equals(viewPageUrl))
                .findAny()
                .orElse(null);
        
        anchorTag.click();
        
        assertThat(browser.getCurrentUrl()).isEqualTo(viewPageUrl);
    }
    
    private Integer createFridge(FridgeCommand fridgeCommand) {
        String nickname = fridgeCommand.getNickname();
        ResponseEntity<FridgeCommand> response = restTemplate.postForEntity(FRIDGE_API_URL + "/fridges", nickname, FridgeCommand.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
        FridgeCommand fridge = response.getBody();
        assertThat(fridge.getId()).isPositive();
        return fridge.getId();
    }

RestTemplate은 등록 API를 호출하기 위해 선언한다. FRIDGE_API_URL 은 API 서버 URL이다. 전체적으로 FoodControllerTests 클래스와 다르지 않다.

FridgeController를 구현한다.
    @GetMapping
    public String fridges(Model model) {
        ResponseEntity<Resources<FridgeCommand>> response = restTemplate.exchange("/fridges", 
                HttpMethod.GET, 
                null, 
                new ParameterizedTypeReference<Resources<FridgeCommand>>() {}, 
                Collections.emptyMap());
        if(response.getStatusCode().is2xxSuccessful()) {
            model.addAttribute("fridgeList", response.getBody().getContent());
        }
        return "fridges/fridges";
    }

    @GetMapping("/{id}")
    public String updateFridgeForm(@PathVariable int id, Model model) {
        ResponseEntity<FridgeCommand> response = restTemplate.getForEntity("/fridges/{id}", FridgeCommand.class, id);
        if(response.getStatusCode().is2xxSuccessful()) {
            model.addAttribute("fridgeCommand", response.getBody());
        }
        return "fridges/updateFridgeForm";
    }

updateFridgeForm 메서드는 /fridges/{id} 형태의 URL을 GET 방식으로 매핑된다. 실제 API서버를 RestTemplate 으로 HTTP 통신하여 fridge 객체를 불러온다. 응답상태가 성공이면 model에 fridgeCommand 라는 키를 가지는 fridge 인스턴스를 View로 보낸다. View name은 updateFridgeForm 이다.

비어있던 fridges 메서드에 목록을 불러오는 통신을 한다. 통신이 성공적으로 응답하면 model에 fridgeList 를 추가한다.

fridges.html View 페이지를 구현한다.
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
  <title>Fridge</title>
  <script th:inline="javascript" th:if="${!#strings.isEmpty(registerMessage)}">
  alert([[${registerMessage}]]);
  </script>
</head>
<body>
  <h2>Fridges</h2>
  <a href="/fridges/add" th:href="@{/fridges/add}" id="btnCreateFridge">등록</a>
  <table>
  <thead>
  <tr>
    <th>ID</th>
    <th>Nickname</th>
  </tr>
  </thead>
  <tbody>
  <tr th:each="fridge : ${fridgeList}">
    <td th:text="${fridge.id}">1</td>
    <td><a href="/fridges/1" th:href="@{/fridges/{id}(id=${fridge.id})}" th:text="${fridge.nickname}">myFridge</a></td>
  </tr>
  </tbody>
  </table>
</body>
</html>

기존의 anchor Tag만 있던 목록 View는 Table태그를 추가한다. 열(Col)은 ID, Nickname 을 보여주고 nickname은 상세기능을 위해 anchor tag로 감싼다.

다음은 상세 View 파일이다.
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
  <title>Fridge</title>
</head>
<body>
  <h2>냉장고 상세</h2>
  <form th:action="@{/fridges/{id}(id=${fridgeCommand.id})}" th:object="${fridgeCommand}" th:method="put">
 <div th:if="${#fields.hasErrors('*')}">
     <ul>
         <li th:each="err : ${#fields.errors('*')}" th:text="${err}">Input is incorrect</li>
     </ul>
 </div>
    <label for="nickname">이름: 
     <input type="text" th:field="*{nickname}" />
    </label><br/>
    <button type="submit">저장</button>
  </form>
</body>
</html>

method가 post에서 put방식으로 변경된 부분을 제외하면 fridge 등록 View와 차이가 없다.

테스트를 수행하여 문제가 없는지 확인한다.

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

이 블로그의 인기 게시물

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