기본 콘텐츠로 건너뛰기

냉장고 가계부 프로젝트 21

fridge-web 프로젝트의 FridgeCommand 클래스에는 fridge API 서버의 HTTP통신 응답본문에 포함된 foods 컬렉션을 마샬링할 수 있도록 List<FoodCommand> 필드를 추가한다.
반대로, FoodCommand 클래스는 Fridge 필드가 추가되어서 두 클래스의 양방향 관계를 연결한다.
public class FridgeCommand {
    ...
    
    private List<FoodCommand> foods;
    
    // Getter / Setter

    public List<FoodCommand> getFoods() {
        return foods;
    }
    public void setFoods(List<FoodCommand> foods) {
        this.foods = foods;
    }

}
public class FoodCommand {
    ...

    private FridgeCommand fridge;

    // Getter / Setter / Constructor

    public FridgeCommand getFridge() {
        return fridge;
    }
    public void setFridge(FridgeCommand fridge) {
        this.fridge = fridge;
    }

    // toString    
}

Command 객체가 수정되므로 뷰파일들도 수정한다.(UI 관련해서는 github를 참고)
UI 구현이 완료되면 FridgeControllerTests 클래스에 테스트 메서드를 추가한다.
public class FridgeControllerTests extends ControllerBase {
    ...
    
    private FoodCommand food = new FoodCommand("파스퇴르 우유 1.8L", 1, new Date());
    private SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
    
    @Test
    public void hasContentsFromFridgesTable() {
        food.setFridge(fridge);
        FoodCommand foodCommand = createFood(food);
        
        browser.get(BASE_URL + "/fridges");
        assertThat(browser.findElement(By.tagName("a")).getText()).isEqualTo(fridge.getNickname());
        
        WebElement table = browser.findElement(By.tagName("table"));
        assertThat(table.isDisplayed()).isTrue();
        
        List<WebElement> tr = table.findElement(By.tagName("tbody")).findElements(By.tagName("tr"));
        assertThat(tr.size()).isEqualTo(1);
        
        List<WebElement> td = tr.get(0).findElements(By.tagName("td"));
        assertThat(td.size()).isEqualTo(3);
        assertThat(td.get(0).getText()).isEqualTo(foodCommand.getName());
        assertThat(td.get(1).getText()).isEqualTo(Integer.toString(foodCommand.getQuantity()));
        assertThat(td.get(2).getText()).isEqualTo(sdf.format(foodCommand.getExpiryDate()));
    }
    
    private FoodCommand createFood(FoodCommand foodCommand) {
        ResponseEntity<FoodCommand> response = restTemplate.postForEntity(CORE_API_URL + "/foods", foodCommand, FoodCommand.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
        
        FoodCommand food = response.getBody();
        assertThat(food.getId()).isPositive();
        return food;
    }
}

hasContentsFromFridgesTable 메서드는 fridges 뷰페이지에서 생성된 fridge의 nickname과 foods 목록 테이블이 존재하는지 검사한다.
fridge 객체 생성은 setUp메서드에서 실행되므로 추가적으로 작업할 내용은 없다. 생성된 fridge의 식품을 추가하기위해 createFood 메서드를 생성했다. createFood 메서드는 API 서버로 food 객체를 전달한다. 생성이 완료되면 food객체를 리턴한다.
목록 페이지로 브라우져 주소를 입력해서 이동한 뒤 앵커태그의 text가 새로생긴 fridge 객체의 nickname과 동일한지 검사한다.
table태그가 존재하는지 확인한다. foods 컬렉션이 fridge 객체 응답본문에 포함되어 있다면 table태그를 감싸는 div태그가 노출된다.
table태그의 tbody내부에 tr태그의 개수가 1개인지 확인함으로써 등록한 식품의 개수는 1개라는 것을 검사한다.
tr태그 내의 td태그 text는 총 3개이고, 각각 인덱스 순서대로 식품의 이름, 수량, 유통기한을 나타낸다.
해당 테스트를 실행하면 에러가 발생한다.
fridge 프로젝트에서 Food 클래스는 fridge 필드가 @JsonIgnore 애너테이션이 선언되어 있기 때문에 fridge-web 프로젝트에서 fridge객체를 요청바디에 전달해도 마샬링에서 제외되기 때문이다.
이를 위해서는 별도의 Request 전담 DTO 클래스가 필요하다. FoodRequest 클래스를 생성한다.
public class FoodRequest {
    private Long id;
    private String name;
    private Integer quantity;
    private Date expiryDate;
    private Fridge fridge;
    public Long getId() {
        return id;
    }
    public void setId(Long id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public Integer getQuantity() {
        return quantity;
    }
    public void setQuantity(Integer quantity) {
        this.quantity = quantity;
    }
    public Date getExpiryDate() {
        return expiryDate;
    }
    public void setExpiryDate(Date expiryDate) {
        this.expiryDate = expiryDate;
    }
    public Fridge getFridge() {
        return fridge;
    }
    public void setFridge(Fridge fridge) {
        this.fridge = fridge;
    }
    
    public Food toFood() {
        Food food = new Food(getName(), 
                getQuantity(), 
                getExpiryDate());
        food.setId(getId());
        food.setFridge(getFridge());
        return food;
    }
    
    @Override
    public String toString() {
        return "FoodRequest [id=" + id + ", name=" + name + ", quantity=" + quantity + ", expiryDate=" + expiryDate
                + ", fridge=" + fridge + "]";
    }

}

private 필드와 접근자,수정자로 구성된 DTO이며, 별도로 toFood 메서드를 보유하는데 FoodRequest 객체의 데이터를 새로운 Food 클래스에 담아서 리턴한다.
FoodController 클래스에서 요청바디에 Food를 파라미터로 전달받는 두개의 컨트롤러 메서드(postFood, updateFood)를 FoodRequest로 변경한다.
public class FoodController {
    ...
    @PostMapping
    public ResponseEntity<FoodResource> postFood(@RequestBody final FoodRequest foodRequest) {
        Food newFood = jpaFoodService.save(foodRequest.toFood());
        URI location = MvcUriComponentsBuilder.fromController(getClass())
                .path("/{id}")    
                .buildAndExpand(newFood.getId())
                .toUri();
        return ResponseEntity.created(location).body(assembler.toResource(newFood));
    }
    
    @PutMapping("/{id}")
    public ResponseEntity<?> updateFood(@PathVariable final long id, @RequestBody final FoodRequest foodRequest) {
        if(jpaFoodRepository.findOne(id) != null) {
            jpaFoodService.save(foodRequest.toFood());
        }
        return ResponseEntity.noContent().build();
    }
    ...
}

jpaFoodService.save 메서드의 파라미터로 Food클래스 타입을 받으므로 FoodRequest.toFood 메서드를 호출해서 전달한다.

fridge 프로젝트, fridge-web 프로젝트의 테스트를 수행해서 문제가 없는지 확인한다.
fridge-web 프로젝트에서 FoodControllerTests.fillInFoodRegisterFormAndSubmit
테스트 메서드에서 실패한다.
fridges 뷰페이지에서 식품을 추가할때 fridge의 id를 query 파라미터로 전달하는데, FoodControllerTests 클래스에서는 쿼리스트링도 받지않고, 부모 Fridge 객체가 생성되지 않은 상태로 테스트가 진행되었기 때문이다.
먼저 fillInFoodRegisterFormAndSubmit 메서드에서 브라우져로 등록페이지를 열때 URL 스트링값을 다음과 같이 수정한다.
public class FoodControllerTests extends ControllerBase {
    ...
    @Test
    public void fillInFoodRegisterFormAndSubmit() {
        browser.get(BASE_URL + "/foods/add?fridge.id=1");
        ...
    }
    ...
}

이렇게 해서 테스트하면 fridge API서버에서는 Fridge 데이터가 존재하지 않는다고 에러를 발생한다. 결국 Fridge 객체를 생성하고 그 ID를 전달해야한다. 생성 메서드를 작성한다.
public class FoodControllerTests extends ControllerBase {
    ...
    @Test
    public void fillInFoodRegisterFormAndSubmit() {
        FridgeCommand fridge = createFridge("myFridge");
        browser.get(BASE_URL + "/foods/add?fridge.id=" + fridge.getId());
        
        LocalDateTime expiryDate = LocalDateTime.ofInstant(food.getExpiryDate().toInstant(), ZoneId.systemDefault());
        
        WebElement nameElement = browser.findElement(By.name("name"));
        WebElement quantityElement = browser.findElement(By.name("quantity"));
        WebElement expiryDateElement = browser.findElement(By.name("expiryDate"));
        nameElement.sendKeys(food.getName());
        quantityElement.sendKeys(Integer.toString(food.getQuantity()));
        expiryDateElement.sendKeys(expiryDate.format(DateTimeFormatter.ofPattern("yyyy")));
        expiryDateElement.sendKeys(Keys.TAB);
        expiryDateElement.sendKeys(expiryDate.format(DateTimeFormatter.ofPattern("MMdd")));
        browser.findElementByTagName("form").submit();
        
        WebDriverWait wait = new WebDriverWait(browser, 10);
        wait.until(ExpectedConditions.alertIsPresent());
        
        Alert alert = browser.switchTo().alert();
        assertThat(alert.getText()).isEqualTo("식품을 저장했습니다.");
        alert.accept();
    }
    
    private FridgeCommand createFridge(String nickname) {
        ResponseEntity<FridgeCommand> response = restTemplate.postForEntity(CORE_API_URL + "/fridges", nickname, FridgeCommand.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
        FridgeCommand fridge = response.getBody();
        assertThat(fridge.getId()).isPositive();
        return fridge;
    }
    ...
}

createFridge 메서드는 Fridge 객체를 새로 생성하고 fillInFoodRegisterFormAndSubmit 메서드에서 호출해서 생성된 Fridge의 ID를 쿼리스트링으로 넘겨준다.
이제 다시 전체 테스트를 수행해서 문제가 없는지 확인한다.

테스트가 성공적으로 종료되면 리팩토링 차례다. FridgeControllerTests 클래스에서는 Food객체를 생성하는 메서드가 추가되었고, FoodControllerTests 클래스에서는 Fridge객체를 생성하는 메서드가 추가되었다. 두 메서드를 추상메서드로 옮겨서 중복을 제거한다.
setUp 메서드에서 fridge 더미데이터를 삭제하는 부분도 두 클래스에서 중복되므로 추상메서드로 올린다.
다음은 ControllerBase 추상메서드 소스코드다.
@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)
public abstract class ControllerBase {
    ...
    @Before
    public void init() {
        BASE_URL = host + ":" + port;
        restTemplate.delete(CORE_API_URL + "/fridges", Collections.emptyMap());
        setUp();
    }
    
    ...

    protected FridgeCommand createFridge(String nickname) {
        ResponseEntity<FridgeCommand> response = restTemplate.postForEntity(CORE_API_URL + "/fridges", nickname, FridgeCommand.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
        FridgeCommand fridge = response.getBody();
        assertThat(fridge.getId()).isPositive();
        return fridge;
    }
    
    protected FoodCommand createFood(FoodCommand foodCommand) {
        ResponseEntity<FoodCommand> response = restTemplate.postForEntity(CORE_API_URL + "/foods", foodCommand, FoodCommand.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
        
        FoodCommand food = response.getBody();
        assertThat(food.getId()).isPositive();
        return food;
    }

}

createFridge, createFood 메서드를 이동시키고 init 메서드에 더미데이터를 삭제하는 메서드를 옮겼다. FridgeControllerTests 클래스는 다음과 같다.
public class FridgeControllerTests extends ControllerBase {
    private FridgeCommand fridge;
    
    @Override
    protected void setUp() {
        fridge = createFridge("myFridge");
    }

    ...
    
}

fridge 객체를 생성하는 부분만 setUp 메서드에 남았다. 다음은 FoodControllerTests 클래스다.
public class FoodControllerTests extends ControllerBase {
    private FoodCommand food;
    private FridgeCommand fridge;
    
    @Override
    protected void setUp() {
        fridge = createFridge("myFridge");
        
        FoodCommand foodCommand = new FoodCommand("파스퇴르 우유 1.8L", 1, new Date());
        foodCommand.setFridge(fridge);
        food = createFood(foodCommand);
    }
    
    ...
        
    @Test
    public void fillInFoodRegisterFormAndSubmit() {
        browser.get(BASE_URL + "/foods/add?fridge.id=" + fridge.getId());
        
        LocalDateTime expiryDate = LocalDateTime.ofInstant(food.getExpiryDate().toInstant(), ZoneId.systemDefault());
        
        WebElement nameElement = browser.findElement(By.name("name"));
        WebElement quantityElement = browser.findElement(By.name("quantity"));
        WebElement expiryDateElement = browser.findElement(By.name("expiryDate"));
        nameElement.sendKeys(food.getName());
        quantityElement.sendKeys(Integer.toString(food.getQuantity()));
        expiryDateElement.sendKeys(expiryDate.format(DateTimeFormatter.ofPattern("yyyy")));
        expiryDateElement.sendKeys(Keys.TAB);
        expiryDateElement.sendKeys(expiryDate.format(DateTimeFormatter.ofPattern("MMdd")));
        browser.findElementByTagName("form").submit();
        
        WebDriverWait wait = new WebDriverWait(browser, 10);
        wait.until(ExpectedConditions.alertIsPresent());
        
        Alert alert = browser.switchTo().alert();
        assertThat(alert.getText()).isEqualTo("식품을 저장했습니다.");
        alert.accept();
    }
    
    @Test
    public void clickAnchorTagFromFood() {
        Long id = food.getId();
        
        browser.get(BASE_URL + "/foods");
        
        String viewPageUrl = BASE_URL + "/foods/" + id;
        
        List<WebElement> anchors = browser.findElementsByLinkText(food.getName());
        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);
    }
    
    ...
    
}

setUp 메서드에서 fridge 객체를 생성하고 food 객체도 생성하는 메서드 파라미터로 전달한다. 다른 테스트 메서드들은 생성된 food 객체 픽스처를 바로 사용한다.
테스트를 수행해서 문제가 없는지 확인한다.

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

이 블로그의 인기 게시물

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 버튼이...

레거시 코드 활용 전략 - 마이클 C. 페더스

2장. 효과적인 피드백 활용 레거시 코드 변경 알고리즘 변경 지점을 식별한다. 테스트 지점을 찾는다. 의존관계를 깬다. 테스트 루틴을 작성한다. 변경시키고 리팩토링한다. 3장. 감지와 분리 레거시코드를 원자 단위까지 분리하여 변경지점을 식별한다. 의존관계를 가진 객체의 경우 Mock/Fake 객체를 사용하기 위해 인터페이스로 의존성을 깬다. 테스트 루틴을 작성 -> 수정 -> 테스트 성공 -> 리팩토링 단계를 반복한다. 4장. 봉합 자바에서는 클래스패스를 이용한 다른 버전의 클래스를 만들수 있다. 5장. 레거시 코드를 위한 도구 JUnit 6장. 고칠 건 많고 시간은 없고 발아(Sprout) Method / Class: 메서드/클래스를 추가 포장(Wrap) Method / Class: 기존 메서드/클래스를 포장하는 메서드/클래스를 추가(데코레이터 패턴) 7장. 코드 하나 바꾸는데 왜 이리 오래 걸리지? 의존관계 반전 원칙 당신의 코드가 인터페이스에 종속되는 경우, 그 의존관계는 사실 경미한 수준으로 눈에 잘 띄지 않는다. 인터페이스가 변하지 않는 한, 코드를 변경시킬 필요는 없다. 또한 인터페이스들은 그들 아래에 위치한 코드에 비해 훨씬 적은 빈도로 변경된다. 인터페이스를 하나 가지고 있는 경우, 그 인터페이스를 구현하는 클래스들을 편집하거나 그 인터페이스를 구현하기 위한 새로운 클래스들을 추가할 수 있다. 물론 그 인터페이스를 사용하는 코드에 영향을 주지도 않는다. 이런 이유 때문에 구체 클래스보다는 인터페이스나 추상 클래스에 종속되는 편이 좋다. 덜 변하는 것들에 종속됨으로써 특정 변경이 초래할지도 모를 대규모 재컴파일 사태의 위험을 최소화할 수 있다. 8장. 특징, 어떻게 추가할까? 테스트 주도 개발 실패 테스트 케이스를 작성한다. 컴파일되게 만든다. 테스트에 통과하도록 만든다. 중복을 제거한다. 반복한다....

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