[1단계 - 자동차 경주] 페드로(류형욱) 미션 제출합니다.

docs/README.md

@@ -0,0 +1,49 @@
+## 주요 기능
+
+1. 사용자가 자동차 이름 입력
+2. 시도할 횟수 입력
+3. 입력된 횟수만큼 각 자동차를 이동
+4. 이동 종료 후 최종 우승자 출력
+
+---
+
+### 자동차 이름 입력
+
+- [x]  이름 입력 안내 문구 출력
+- [x]  사용자로부터 이름 입력받는 기능
+- [x]  이름을 쉼표 기준으로 구분하여 저장하는 기능
+
+### 시도할 횟수 입력
+
+- [x]  횟수 입력 안내 문구를 출력
+- [x]  사용자로부터 이동할 횟수를 입력받는 기능
+
+### 자동차 이동(게임 진행)
+
+- [x]  "실행 결과" 문구 출력
+- [x]  각 자동차별 1자리 난수 생성 기능
+- [x]  난수값이 4 이상인지 확인하는 기능
+- [x]  난수값이 4 이상인 자동차의 위치를 1 증가시키는 기능
+- [x]  각 라운드 별 실행 결과(자동차 위치) 출력하는 기능
+- [x]  입력된 횟수만큼 라운드를 반복하는 기능
+
+### 우승자 출력
+
+- [x]  우승자(가장 멀리 이동한 자동차)를 판별하는 기능
+    - 모든 자동차들의 이동 거리가 0인 경우에는 우승자는 발생하지 않는다.
+    - [x]  “우승한 자동차가 없습니다” 출력~
+- [x]  우승자 출력 기능
+    - [x]  공동 우승자의 경우 ","로 구분하여 출력해야 함
+
+---
+
+## 예외처리
+
+- 자동차 이름 입력 시 유효한 입력이 아니라면 재 시도
+    - 입력된 이름들의 유효성 검증
+        - [x]  이름은 5자 이하만 가능
+        - [x]  중복된 이름 설정 불가
+        - [x]  [a-zA-Z]+
+- 이동 횟수 입력 시 유효한 입력이 아니라면 재 시도
+    - 이동할 횟수의 유효성 검증
+        - [x]  자연수가 아닌 입력이 전달되는 경우 예외 처리

src/main/java/racingcar/Application.java

@@ -0,0 +1,13 @@
+package racingcar;
+
+import java.io.IOException;
+import racingcar.controller.GameController;
+
+public class Application {
+    public static void main(String[] args) throws IOException {
+        GameController controller = new GameController();
+        controller.init();
+        controller.play();
+        controller.finish();
+    }
+}

src/main/java/racingcar/controller/GameController.java

@@ -0,0 +1,85 @@
+package racingcar.controller;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+import racingcar.model.Car;
+import racingcar.model.CarGroup;
+import racingcar.utils.NameParser;
+import racingcar.utils.InputValidator;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
+public class GameController {
+    private final CarGroup carGroup = new CarGroup();
+    private List<String> names;
+    private int moveCount;
+
+    public void init() throws IOException {
+        readCarNames();
+        readMoveCount();
+        initCars(names);
+    }
+
+    private void readCarNames() throws IOException {
+        boolean isValid = false;
+        while (!isValid) {
+            isValid = doReadCarNames();
+        }
+    }
+
+    private boolean doReadCarNames() throws IOException {
+        try {
+            OutputView.printlnInputName();
+            names = NameParser.parse(InputView.inputNames());
+            InputValidator.validateCarName(names);
+        } catch (IllegalArgumentException e) {
+            OutputView.printException(e.getMessage());
+            return false;
+        }
+        return true;
+    }
+
+    private void readMoveCount() throws IOException {
+        boolean isValid = false;
+        while (!isValid) {
+            isValid = doReadMoveCount();
+        }
+    }
+
+    private boolean doReadMoveCount() throws IOException {
+        try {
+            OutputView.printlnInputMoveCount();
+            moveCount = InputView.inputMoveCount();
+            InputValidator.validateMoveCount(moveCount);
+        } catch (IllegalArgumentException e) {
+            OutputView.printException(e.getMessage());
+            return false;
+        }
+        return true;
+    }
+
+    private void initCars(List<String> carNames) {
+        for (String name : carNames) {
+            carGroup.add(new Car(name));
+        }
+    }
+
+    public void play() {
+        OutputView.printResultDescription();
+        for (int i = 0; i < moveCount; i++) {
+            Map<String, Integer> raceResponse = carGroup.race();
+            OutputView.printPosition(raceResponse);
+        }
+    }
+
+    public void finish() {
+        List<String> winners = carGroup.findWinners();
+        if (winners.isEmpty()) {
+            OutputView.printNoWinner();
+            return;
+        }
+
+        OutputView.printWinnerList(winners);
+    }
+}

src/main/java/racingcar/model/Car.java

@@ -0,0 +1,35 @@
+package racingcar.model;
+
+public class Car {
+    private static final int MOVE_THRESHOLD = 4;
+    private final String name;
+    private int position;
+
+    public Car(String name) {
+        this.name = name;
+        this.position = 0;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public int getPosition() {
+        return position;
+    }
+
+    public int move(int randomNumber) {
+        if (randomNumber >= MOVE_THRESHOLD) {
+            position++;
+        }
+        return position;
+    }
+
+    public boolean isMoved() {
+        return position > 0;
+    }
+
+    public boolean isSamePosition(int position) {
+        return this.position == position;
+    }
+}

src/main/java/racingcar/model/CarGroup.java

@@ -0,0 +1,40 @@
+package racingcar.model;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import racingcar.utils.RandomNumberGenerator;
+
+public class CarGroup {
+    private final List<Car> cars = new ArrayList<>();
+
+    public void add(Car car) {
+        cars.add(car);
+    }
+
+    public Map<String, Integer> race() {
+        Map<String, Integer> raceResponse = new HashMap<>();
+        for (Car car : cars) {
+            int nextPosition = car.move(RandomNumberGenerator.generate());
+            raceResponse.put(car.getName(), nextPosition);
+        }
+
+        return raceResponse;
+    }
+
+    public List<String> findWinners() {
+        int maxPosition = findMaxPosition();
+        return cars.stream()
+                .filter((car -> car.isMoved() && car.isSamePosition(maxPosition)))
+                .map(Car::getName)
+                .toList();
+    }
+
+    private int findMaxPosition() {
+        return cars.stream()
+                .mapToInt(Car::getPosition)
+                .max()
+                .orElse(0);
+    }
+}

src/main/java/racingcar/utils/InputValidator.java

@@ -0,0 +1,41 @@
+package racingcar.utils;
+
+import java.util.List;
+
+public class InputValidator {
+    public static void validateCarName(List<String> names) {
+        validateDuplicateNames(names);
+        for (String name : names) {
+            validateNameLength(name);
+            validateNameCharacters(name);
+        }
+    }
+
+    private static void validateNameLength(String name) {
+        if (name.length() > 5) {
+            throw new IllegalArgumentException("자동차의 이름은 5글자를 초과할 수 없습니다.");
+        }
+    }
+
+    private static void validateDuplicateNames(List<String> names) {
+        int distinctNamesCount = (int) names.stream()
+                .distinct()
+                .count();
+
+        if (distinctNamesCount != names.size()) {
+            throw new IllegalArgumentException("자동차의 이름은 중복될 수 없습니다.");
+        }
+    }
+
+    private static void validateNameCharacters(String name) {
+        if (!name.matches("^[a-zA-Z]*$")) {
+            throw new IllegalArgumentException("자동차의 이름은 영어로만 이루어져야 합니다.");
+        }
+    }
+
+    public static void validateMoveCount(int moveCount) {
+        if (moveCount <= 0) {
+            throw new IllegalArgumentException("이동 횟수는 자연수여야 합니다.");
+        }
+    }
+}

src/main/java/racingcar/utils/NameParser.java

@@ -0,0 +1,14 @@
+package racingcar.utils;
+
+import java.util.Arrays;
+import java.util.List;
+
+public class NameParser {
+    private static final String DELIMITER = ",";
+
+    public static List<String> parse(String rawNames) {
+        String[] names = rawNames.split(DELIMITER);
+        return Arrays.stream(names)
+                .toList();
+    }
+}

src/main/java/racingcar/utils/RandomNumberGenerator.java

@@ -0,0 +1,12 @@
+package racingcar.utils;
+
+import java.util.Random;
+
+public class RandomNumberGenerator {
+    private static final int RANDOM_BOUND = 10;
+
+    public static int generate() {
+        Random random = new Random();
+        return random.nextInt(RANDOM_BOUND);
+    }
+}

src/main/java/racingcar/view/InputView.java

@@ -0,0 +1,19 @@
+package racingcar.view;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+
+public class InputView {
+    private static final BufferedReader br = new BufferedReader(new InputStreamReader(System.in));
+
+    public static String inputNames() throws IOException {
+        return br.readLine();
+    }
+
+    public static int inputMoveCount() throws IOException {
+        String moveCount = br.readLine();
+        return Integer.parseInt(moveCount);
+    }
+}
+

src/main/java/racingcar/view/OutputView.java

@@ -0,0 +1,51 @@
+package racingcar.view;
+
+import java.util.List;
+import java.util.Map;
+
+public class OutputView {
+    private static final String WINNER_DESCRIPTION = "가 최종 우승했습니다.";
+    private static final String RESULT_DESCRIPTION = "실행 결과";
+    private static final String NO_WINNER_DESCRIPTION = "최대 이동 거리가 0이므로 우승한 자동차가 없습니다.";
+    private static final String NAME_INPUT_DESCRIPTION = "경주할 자동차 이름을 입력하세요(이름은 쉼표(,)를 기준으로 구분).";
+    private static final String MOVE_COUNT_INPUT_DESCRIPTION = "시도할 회수는 몇회인가요?";
+
+    private static final String POSITION_METER = "-";
+
+    public static void printResultDescription() {
+        System.out.println();
+        System.out.println(RESULT_DESCRIPTION);
+    }
+
+    public static void printPosition(Map<String, Integer> carPositions) {
+        StringBuilder sb = new StringBuilder();
+        carPositions.forEach(
+                (name, position) -> sb.append(name).append(":").append(POSITION_METER.repeat(position)).append("\n")
+        );
+        System.out.println(sb);
+    }
+
+    public static void printException(String message) {
+        System.out.println(message);
+    }
+
+    public static void printWinnerList(List<String> winners) {
+        List<String> names = winners.stream()
+                .toList();
+
+        String winnerNames = String.join(", ", names);
+        System.out.println(winnerNames + WINNER_DESCRIPTION);
+    }
+
+    public static void printNoWinner() {
+        System.out.println(NO_WINNER_DESCRIPTION);
+    }
+
+    public static void printlnInputName() {
+        System.out.println(NAME_INPUT_DESCRIPTION);
+    }
+
+    public static void printlnInputMoveCount() {
+        System.out.println(MOVE_COUNT_INPUT_DESCRIPTION);
+    }
+}