[디디] 레이싱게임 리뷰요청 드립니다.

README.md

@@ -1,5 +1,86 @@
 # java-racingcar
 자동차 경주 게임 미션 저장소
 
+
+
+## TDD - 문자열 덧셈 계산기
+
+### 요구사항
+
+- 쉼표(,) 또는 콜론(:)을 구분자로 가지는 문자열을 입력받는다.
+  - 또는, 커스텀 구분자를 가지는 문자열을 입력받는다.
+- 입력받은 문자열을 구분자를 통해 분리한다.
+- 분리한 값을 정수로 변환하여, 모두 더한다.
+- 더한 값을 출력한다.
+
+### 구현단위
+
+- 덧셈 테스트 코드 구현
+- 빈 값이나 null값이 들어오는 경우에 대한 테스트 코드 구현
+- 숫자 1개만 들어오는 경우에 대한 테스트 코드 구현
+- 숫자 여러개가 들어오는 경우에 대한 테스트 코드 구현
+- 숫자가 음수인 경우에 대한 테스트 코드 구현
+- 숫자 이외의 값이 들어오는 경우에 대한 테스트 코드 구현
+- 커스텀 구분자를 사용했을 경우에 대한 테스트 코드 구현
+
+### 예외처리
+
+- RuntimeException : 숫자 이외의 값이 들어가거나, 음수가 전달될 경우 발생
+
+
+
+## 자동차 경주 게임
+
+### 요구사항
+
+- 임의의 개수의 자동차 이름을 입력한다.
+  - 각 자동차의 이름은 쉼표로 구분된다.
+  - 각 자동차의 이름은 5글자 이하만 가능하다.
+- 이동할 횟수를 입력한다.
+  - 이동할 횟수는 정수값만 입력이 가능하다.
+- 자동차는 랜덤으로 전진하거나 그 자리에 머무른다.
+  - 0부터 9 사이의 난수를 생성하여, 그 값이 4 이상이면 전진한다.
+- 자동차 경주가 완료된 후, 누가 우승했는지 출력한다.
+  - 우승자는 1명 이상이다.
+
+### 구현단위
+
+**[TDD]**
+
+**Input**
+
+- 이름 1개 입력 시 가능여부 검증
+  - 빈 값이 들어오는 경우도 검증됨
+- 이름 여러개 입력 시 분리 기능 검증
+- 이름 여러개 입력 시 이름 길이 검증
+- 횟수 입력 시 타입 에러 검증
+- 횟수 입력 시 음수 입력 검증
+
+**RacingGame**
+
+- 자동차의 이동 기능 테스트
+- 랜덤값 생성 테스트
+- 우승자 확인 테스트
+- 레이싱게임 실행 결과 테스트
+
+**Output**
+
+- 자동차 이동 시 출력되는 로그값 생성 테스트
+
+
+
+**[UI 로직]**
+
+**View**
+
+- InputView 구현
+- OutputView 구현
+
+
+
+### 예외처리
+
+- IllegalArgumentException : 이름의 길이가 1~5글자 사이가 아니거나, 횟수가 양수인 Integer값이 아닐 때 예외 발생
+
 ## 우아한테크코스 코드리뷰
 * [온라인 코드 리뷰 과정](https://github.com/woowacourse/woowacourse-docs/blob/master/maincourse/README.md)

src/main/java/racinggame/controller/Main.java

@@ -0,0 +1,24 @@
+package racinggame.controller;
+
+import racinggame.domain.*;
+import racinggame.view.InputView;
+import racinggame.view.OutputView;
+
+public class Main {
+    public static void main(String... args) {
+        Names names = new Names(InputView.inputName());
+        Repeat repeat = new Repeat(InputView.inputRepeat());
+        Cars cars = new Cars(names);
+        RacingGame racingGame = new RacingGame();
+        int maxPosition = 0;
+
+        OutputView.printResultFormat();
+        for (int i = 0; i < repeat.getRepeat(); i++) {
+            maxPosition = racingGame.moveCars(cars, maxPosition);
+            OutputView.printCarsLog(cars);
+        }
+        Winners winners = cars.makeWinners(maxPosition);
+        OutputView.printWinnersLog(winners);
+    }
+}
+

src/main/java/racinggame/domain/Car.java

@@ -0,0 +1,41 @@
+package racinggame.domain;
+
+public class Car {
+    private static final int FORWARD_NUMBER = 4;
+    private static final int START_POSITION = 0;
+    private final String name;
+    private int position;
+
+    public Car(String name) {
+        this(name, START_POSITION);
+    }
+
+    public Car(String name, int position) {
+        this.name = name;
+        this.position = position;
+    }
+
+    public boolean move(int random) {
+        if (random >= FORWARD_NUMBER) {
+            position++;
+            return true;
+        }
+        return false;
+    }
+
+    public boolean isSamePosition(int position) {
+        return this.position == position;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public int getPosition() {
+        return position;
+    }
+
+    public int getMaxPosition(int maxPosition) {
+        return Math.max(position, maxPosition);
+    }
+}

src/main/java/racinggame/domain/Cars.java

@@ -0,0 +1,29 @@
+package racinggame.domain;
+
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
+public class Cars implements Iterable<Car> {
+    private List<Car> cars;
+
+    public Cars(Names names) {
+        cars = names.makeCars();
+    }
+
+    public Winners makeWinners(int maxPosition) {
+        List<Car> winners = new ArrayList<>();
+
+        for (Car car : cars) {
+            if (car.isSamePosition(maxPosition)) {
+                winners.add(car);
+            }
+        }
+        return new Winners(winners);
+    }
+
+    public Iterator<Car> iterator() {
+        return cars.iterator();
+    }
+
+}

src/main/java/racinggame/domain/MoveCarsOnlyFalse.java

@@ -0,0 +1,16 @@
+package racinggame.domain;
+
+import racinggame.domain.Car;
+import racinggame.domain.Cars;
+import racinggame.domain.Strategy;
+
+public class MoveCarsOnlyFalse implements Strategy {
+    public int moveCars(Cars cars, int maxPosition) {
+        for (Car car : cars) {
+            if (car.move(0)) {
+                maxPosition = car.getMaxPosition(maxPosition);
+            }
+        }
+        return maxPosition;
+    }
+}

src/main/java/racinggame/domain/MoveCarsOnlyTrue.java

@@ -0,0 +1,12 @@
+package racinggame.domain;
+
+public class MoveCarsOnlyTrue implements Strategy {
+    public int moveCars(Cars cars, int maxPosition) {
+        for (Car car : cars) {
+            if (car.move(7)) {
+                maxPosition = car.getMaxPosition(maxPosition);
+            }
+        }
+        return maxPosition;
+    }
+}

src/main/java/racinggame/domain/Names.java

@@ -0,0 +1,61 @@
+package racinggame.domain;
+
+import racinggame.view.InputView;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+
+public class Names {
+    public static final String LENGTH_ERROR_MESSAGE = "이름의 길이는 1자 이상, 5자" +
+            " 이하만 가능합니다.";
+    private static final String SPLIT_DELIMITER = ",";
+    private static final int NAME_LENGTH_LIMIT = 5;
+    private List<String> names;
+
+    public Names() {
+        this(InputView.inputName());
+    }
+
+    public Names(String inputNames) {
+        names = splitInputByComma(inputNames);
+        validateInput();
+    }
+
+    public List<Car> makeCars() {
+        List<Car> cars = new ArrayList<>();
+        for (String name : names) {
+            cars.add(new Car(name));
+        }
+        return cars;
+    }
+
+    public static List<String> splitInputByComma(String inputNames) {
+        String[] splitName = inputNames.split(SPLIT_DELIMITER);
+        return Arrays.asList(splitName);
+    }
+
+    public void validateInput() {
+        if (Objects.isNull(names)) {
+            throw new IllegalArgumentException(LENGTH_ERROR_MESSAGE);
+        }
+        for (String name : names) {
+            validateNameLength(name);
+        }
+    }
+
+    private static void validateNameLength(String name) {
+        if (isNullName(name) || name.isEmpty() || isLongerThanFive(name)) {
+            throw new IllegalArgumentException(LENGTH_ERROR_MESSAGE);
+        }
+    }
+
+    private static boolean isNullName(String name) {
+        return Objects.isNull(name);
+    }
+
+    private static boolean isLongerThanFive(String name) {
+        return name.length() > NAME_LENGTH_LIMIT;
+    }
+}

src/main/java/racinggame/domain/RacingGame.java

@@ -0,0 +1,22 @@
+package racinggame.domain;
+
+import java.util.Random;
+
+public class RacingGame implements Strategy {
+    public static final int NUMBER_BOUND = 10;
+
+    public static int generateRandom() {
+        Random rand = new Random();
+        rand.setSeed(System.nanoTime());
+        return rand.nextInt(NUMBER_BOUND);
+    }
+
+    public int moveCars(Cars cars, int maxPosition) {
+        for (Car car : cars) {
+            if (car.move(generateRandom())) {
+                maxPosition = car.getMaxPosition(maxPosition);
+            }
+        }
+        return maxPosition;
+    }
+}

src/main/java/racinggame/domain/Repeat.java

@@ -0,0 +1,43 @@
+package racinggame.domain;
+
+import racinggame.view.InputView;
+
+public class Repeat {
+    public static final String NUMBER_FORMAT_ERROR_MESSAGE = "횟수는 정수만 " +
+            "가능합니다.";
+    public static final String NOT_POSITIVE_ERROR_MESSAGE = "횟수는 1이상의" +
+            " 정수만 가능합니다.";
+    private final int repeat;
+
+    public Repeat() {
+        this(InputView.inputRepeat());
+    }
+
+    public Repeat(int repeat) {
+        this.repeat = repeat;
+    }
+
+    public Repeat(String repeat) {
+        this(validateRepeat(repeat));
+    }
+
+    private static int validateRepeat(String repeat) {
+        try {
+            int parseRepeat = Integer.parseInt(repeat);
+            validateRepeatPositive(parseRepeat);
+            return parseRepeat;
+        } catch (NumberFormatException e) {
+            throw new IllegalArgumentException(NUMBER_FORMAT_ERROR_MESSAGE);
+        }
+    }
+
+    private static void validateRepeatPositive(int repeat) {
+        if (repeat <= 0) {
+            throw new IllegalArgumentException(NOT_POSITIVE_ERROR_MESSAGE);
+        }
+    }
+
+    public int getRepeat() {
+        return repeat;
+    }
+}

src/main/java/racinggame/domain/Strategy.java

@@ -0,0 +1,5 @@
+package racinggame.domain;
+
+public interface Strategy {
+    int moveCars(Cars cars, int maxPosition);
+}

src/main/java/racinggame/domain/Winners.java

@@ -0,0 +1,19 @@
+package racinggame.domain;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class Winners {
+    List<String> winners;
+
+    public Winners(List<Car> winnerCars) {
+        winners = new ArrayList<>();
+        for (Car car : winnerCars) {
+            winners.add(car.getName());
+        }
+    }
+
+    public List<String> getWinners() {
+        return winners;
+    }
+}

src/main/java/racinggame/view/InputView.java

@@ -0,0 +1,21 @@
+package racinggame.view;
+
+import java.util.Scanner;
+
+public class InputView {
+    private static final Scanner scanner = new Scanner(System.in);
+
+    /* 인스턴스를 사용하지 않으므로 추가 */
+    private InputView() {
+    }
+
+    public static String inputName() {
+        OutputView.printNameFormat();
+        return scanner.nextLine();
+    }
+
+    public static String inputRepeat() {
+        OutputView.printRepeatFormat();
+        return scanner.nextLine();
+    }
+}