Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/kos5667/test-driven-development-with-java

Java와 Spring으로 하는 TDD 연습 및 여러가지 케이스 정리
https://github.com/kos5667/test-driven-development-with-java

assertj gradle java11 junit-jupiter junit4 junit5 spring-boot tdd tdd-java

Last synced: about 2 months ago
JSON representation

Java와 Spring으로 하는 TDD 연습 및 여러가지 케이스 정리

Awesome Lists containing this project

README 

        
# 🚀String 클래스에 대한 학습 테스트 - 1단계

## 요구사항 1

* "1,2"을 ,로 split 했을 때 1과 2로 잘 분리되는지 확인하는 학습 테스트를 구현한다.

* "1"을 ,로 split 했을 때 1만을 포함하는 배열이 반환되는지에 대한 학습 테스트를 구현한다.



## 힌트

* 배열로 반환하는 값의 경우 assertj의 contains()를 활용해 반환 값이 맞는지 검증한다.

* 배열로 반환하는 값의 경우 assertj의 containsExactly()를 활용해 반환 값이 맞는지 검증한다.



## 요구사항 2

* "(1,2)" 값이 주어졌을 때 String의 substring() 메소드를 활용해 ()을 제거하고 "1,2"를 반환하도록 구현한다.



## 요구사항 3

* "abc" 값이 주어졌을 때 String의 charAt() 메소드를 활용해 특정 위치의 문자를 가져오는 학습 테스트를 구현한다.

* String의 charAt() 메소드를 활용해 특정 위치의 문자를 가져올 때 위치 값을 벗어나면 StringIndexOutOfBoundsException이 발생하는 부분에 대한 학습 테스트를 구현한다.

* JUnit의 @DisplayName을 활용해 테스트 메소드의 의도를 드러낸다.



* 힌트

  AssertJ Exception Assertions 문서 참고



* 자주 발생하는 Exception의 경우 Exception별 메서드 제공하고 있음

* assertThatIllegalArgumentException()

* assertThatIllegalStateException()

* assertThatIOException()

* assertThatNullPointerException()



## Set Collection에 대한 학습 테스트

* 다음과 같은 Set 데이터가 주어졌을 때 요구사항을 만족해야 한다.



```java 

public class SetTest {

    private Set numbers;

    

    @BeforeEach

    void setUp() {

        numbers = new HashSet<>();

        numbers.add(1);

        numbers.add(1);

        numbers.add(2);

        numbers.add(3);

    }

    

    // Test Case 구현

}

```

## 요구사항 1

* Set의 size() 메소드를 활용해 Set의 크기를 확인하는 학습테스트를 구현한다.



## 요구사항 2

* Set의 contains() 메소드를 활용해 1, 2, 3의 값이 존재하는지를 확인하는 학습테스트를 구현하려한다.

* 구현하고 보니 다음과 같이 중복 코드가 계속해서 발생한다.

* JUnit의 ParameterizedTest를 활용해 중복 코드를 제거해 본다.



```java

    @Test

    void contains() {

        assertThat(numbers.contains(1)).isTrue();

        assertThat(numbers.contains(2)).isTrue();

        assertThat(numbers.contains(3)).isTrue();

    }

```



## 힌트

```java

@ParameterizedTest

@ValueSource(strings = {"", "  "})

void isBlank_ShouldReturnTrueForNullOrBlankStrings(String input) {

    assertThat(Strings.isBlank(input)).isTrue();

}

```



## 요구사항 3

* 요구사항 2는 contains 메소드 결과 값이 true인 경우만 테스트 가능하다. 입력 값에 따라 결과 값이 다른 경우에 대한 테스트도 가능하도록 구현한다.

* 예를 들어 1, 2, 3 값은 contains 메소드 실행결과 true, 4, 5 값을 넣으면 false 가 반환되는 테스트를 하나의 Test Case로 구현한다.



## 힌트

* Guide to JUnit 5 Parameterized Tests 문서에서 @CsvSource를 활용한다.



# 🚀2단계 - 문자열 덧셈 계산기

## 2단계 실습 시작



## 문자열 덧셈 계산기를 통한 TDD 실습

# 기능 요구사항

* 쉼표(,) 또는 콜론(:)을 구분자로 가지는 문자열을 전달하는 경우 구분자를 기준으로 분리한 각 숫자의 합을 반환 (예: “” => 0, "1,2" => 3, "1,2,3" => 6, “1,2:3” => 6)

* 앞의 기본 구분자(쉼표, 콜론)외에 커스텀 구분자를 지정할 수 있다. 커스텀 구분자는 문자열 앞부분의 “//”와 “\n” 사이에 위치하는 문자를 커스텀 구분자로 사용한다. 예를 들어 “//;\n1;2;3”과 같이 값을 입력할 경우 커스텀 구분자는 세미콜론(;)이며, 결과 값은 6이 반환되어야 한다.

* 문자열 계산기에 숫자 이외의 값 또는 음수를 전달하는 경우 RuntimeException 예외를 throw한다.



# 프로그래밍 요구사항

* 메소드가 너무 많은 일을 하지 않도록 분리하기 위해 노력해 본다.



* 기능 요구사항 분리 및 힌트

1. 빈 문자열 또는 null 값을 입력할 경우 0을 반환해야 한다.(예 : “” => 0, null => 0)

   기능 요구사항 분리 및 힌트

```java

    if (text == null) {}

            if (text.isEmpty()) {}

    }

```

2. 숫자 하나를 문자열로 입력할 경우 해당 숫자를 반환한다.(예 : “1”)

```java

   int number = Integer.parseInt(text);

```



3. 숫자 두개를 컴마(,) 구분자로 입력할 경우 두 숫자의 합을 반환한다.(예 : “1,2”)

```java

   String[] numbers = text.split(",");

// 앞 단계의 구분자가 없는 경우도 split()을 활용해 구현할 수 있는지 검토해 본다.

```



4. 구분자를 컴마(,) 이외에 콜론(:)을 사용할 수 있다. (예 : “1,2:3” => 6)

```java

String[] tokens= text.split(",|:");

```



5. “//”와 “\n” 문자 사이에 커스텀 구분자를 지정할 수 있다. (예 : “//;\n1;2;3” => 6)

```java

   // java.util.regex 패키지의 Matcher, Pattern import

   Matcher m = Pattern.compile("//(.)\n(.*)").matcher(text);

   if (m.find()) {

   String customDelimiter = m.group(1);

   String[] tokens= m.group(2).split(customDelimiter);

   // 덧셈 구현

   }

```



6. 음수를 전달할 경우 RuntimeException 예외가 발생해야 한다. (예 : “-1,2,3”)

* 구글에서 “junit4 expected exception”으로 검색해 해결책을 찾는다.



## TestCase 소스 코드

```java

import org.junit.jupiter.api.Test;



import static org.assertj.core.api.Assertions.assertThat;

import static org.assertj.core.api.Assertions.assertThatThrownBy;



public class StringAddCalculatorTest {

@Test

public void splitAndSum_null_또는_빈문자() {

int result = StringAddCalculator.splitAndSum(null);

assertThat(result).isEqualTo(0);



        result = StringAddCalculator.splitAndSum("");

        assertThat(result).isEqualTo(0);

    }



     @Test

    public void splitAndSum_숫자하나() throws Exception {

        int result = StringAddCalculator.splitAndSum("1");

        assertThat(result).isEqualTo(1);

    }



    @Test

    public void splitAndSum_쉼표구분자() throws Exception {

        int result = StringAddCalculator.splitAndSum("1,2");

        assertThat(result).isEqualTo(3);

    }



    @Test

    public void splitAndSum_쉼표_또는_콜론_구분자() throws Exception {

        int result = StringAddCalculator.splitAndSum("1,2:3");

        assertThat(result).isEqualTo(6);

    }



    @Test

    public void splitAndSum_custom_구분자() throws Exception {

        int result = StringAddCalculator.splitAndSum("//;\n1;2;3");

        assertThat(result).isEqualTo(6);

    }



    @Test

    public void splitAndSum_negative() throws Exception {

        assertThatThrownBy(() -> StringAddCalculator.splitAndSum("-1,2,3"))

                .isInstanceOf(RuntimeException.class);

    }

}

```



AssertJ Exception Assertions



# 🚀3단계 - 자동차 경주

## 기능 요구사항

* 초간단 자동차 경주 게임을 구현한다.

* 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.

* 사용자는 몇 대의 자동차로 몇 번의 이동을 할 것인지를 입력할 수 있어야 한다.

* 전진하는 조건은 0에서 9 사이에서 random 값을 구한 후 random 값이 4이상일 경우이다.

* 자동차의 상태를 화면에 출력한다. 어느 시점에 출력할 것인지에 대한 제약은 없다.

### 실행 결과

* 위 요구사항에 따라 3대의 자동차가 5번 움직였을 경우 프로그램을 실행한 결과는 다음과 같다.

```java

자동차 대수는 몇 대 인가요?

3

시도할 회수는 몇 회 인가요?

5



실행 결과

-

-

-



--

-

--



---

--

---



----

---

----



----

----

-----

```



### 힌트

* 값을 입력 받는 API는 Scanner를 이용한다.



* 랜덤 값은 자바 java.util.Random 클래스의 nextInt(10) 메소드를 활용한다.



## 프로그래밍 요구사항

* 모든 로직에 단위 테스트를 구현한다. 단, UI(System.out, System.in) 로직은 제외

    * 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 구분한다.

    * UI 로직을 InputView, ResultView와 같은 클래스를 추가해 분리한다.

* 자바 코드 컨벤션을 지키면서 프로그래밍한다.

    * 이 과정의 Code Style은 intellij idea Code Style. Java을 따른다.

    * intellij idea Code Style. Java을 따르려면 code formatting 단축키(Windows : Ctrl + Alt + L. Mac : ⌥ (Option) + ⌘ (Command) + L.)를 사용한다.

* else 예약어를 쓰지 않는다.

    * 힌트: if 조건절에서 값을 return하는 방식으로 구현하면 else를 사용하지 않아도 된다.

    * else를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.



# 🚀4단계 - 자동차 경주(우승자)

## 기능 요구사항

* 각 자동차에 이름을 부여할 수 있다. 자동차 이름은 5자를 초과할 수 없다.

* 전진하는 자동차를 출력할 때 자동차 이름을 같이 출력한다.

* 자동차 이름은 쉼표(,)를 기준으로 구분한다.

* 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. 우승자는 한명 이상일 수 있다.

### 실행 결과

* 위 요구사항에 따라 3대의 자동차가 5번 움직였을 경우 프로그램을 실행한 결과는 다음과 같다.

```java

경주할 자동차 이름을 입력하세요(이름은 쉼표(,)를 기준으로 구분).

pobi,crong,honux

시도할 회수는 몇회인가요?

5



실행 결과

pobi : -

crong : -

honux : -



pobi : --

crong : -

honux : --



pobi : ---

crong : --

honux : ---



pobi : ----

crong : ---

honux : ----



pobi : -----

crong : ----

honux : -----



pobi : -----

crong : ----

honux : -----



pobi, honux가 최종 우승했습니다.

```



### 힌트

* 규칙 1: 한 메서드에 오직 한 단계의 들여쓰기(indent)만 한다.

    * indent가 2이상인 메소드의 경우 메소드를 분리하면 indent를 줄일 수 있다.

    * else를 사용하지 않아 indent를 줄일 수 있다.

* 자동차 이름을 쉼표(,)를 기준으로 분리하려면 String 클래스의 split(",") 메소드를 활용한다.

```java

String[] names = inputName.split(",");

```

* 사용자가 입력한 이름의 숫자 만큼 자동차 대수를 생성한다.

* 자동차는 자동차 이름과 위치 정보를 가지는 Car 객체를 추가해 구현한다.



## 프로그래밍 요구사항

* indent(인덴트, 들여쓰기) depth를 2를 넘지 않도록 구현한다. 1까지만 허용한다.

    * 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.

    * 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메소드)를 분리하면 된다.

* 함수(또는 메소드)의 길이가 15라인을 넘어가지 않도록 구현한다.

    * 함수(또는 메소드)가 한 가지 일만 잘 하도록 구현한다.

* 모든 로직에 단위 테스트를 구현한다. 단, UI(System.out, System.in) 로직은 제외

    * 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 구분한다.

    * UI 로직을 InputView, ResultView와 같은 클래스를 추가해 분리한다.

* 자바 코드 컨벤션을 지키면서 프로그래밍한다.

    * 참고문서: https://google.github.io/styleguide/javaguide.html 또는 https://myeonguni.tistory.com/1596

* else 예약어를 쓰지 않는다.

    * 힌트: if 조건절에서 값을 return하는 방식으로 구현하면 else를 사용하지 않아도 된다.

    * else를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.



## 기능 목록 및 commit 로그 요구사항

* 기능을 구현하기 전에 README.md 파일에 구현할 기능 목록을 정리해 추가한다.

* git의 commit 단위는 앞 단계에서 README.md 파일에 정리한 기능 목록 단위로 추가한다.



# 🚀 5단계 - 자동차 경주(리팩토링)

## 리팩토링 요구사항

* 핵심 비지니스 로직을 가지는 객체를 domain 패키지, UI 관련한 객체를 view 패키지에 구현한다.

* MVC 패턴 기반으로 리팩토링해 view 패키지의 객체가 domain 패키지 객체에 의존할 수 있지만, domain 패키지의 객체는 view 패키지 객체에 의존하지 않도록 구현한다.

  ![MVC 이미지][https://oopy.lazyrockets.com/api/v2/notion/image?src=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F0bae1821-b9b6-4243-ace1-0e36f6d59606%2FUntitled.png&blockId=52a35b94-5803-40d4-a11a-28dfbed1c307]