[자동차 경주] 김민겸 미션 제출합니다.

docs/README.md

@@ -0,0 +1,42 @@
+# 💪 프로젝트 개요
+
+자동차 경주 게임을 구현한다.
+자동차의 이름과 전진을 시도할 횟수를 입력받고, 자동차를 전진시킨 후 우승자를 선정한다.
+
+# 📝 구현 기능 목록
+
+### 자동차 이름을 입력하는 기능
+
+- [x] `경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)`를 출력한다.
+- [x] 자동차의 이름을 입력받는다.
+  - [x] 빈 문자열이 아님을 검증한다.
+  - [x] 올바른 구분자로 구분되었음을 검증한다.
+  - [x] 중복되는 이름이 없음을 검증한다.
+  - [x] 5자 이하의 이름인지 검증한다.
+
+### 시도할 횟수를 입력하는 기능
+
+- [x] `시도할 회수는 몇회인가요?`를 출력한다.
+- [x] 시도할 횟수를 입력한다.
+  - [x] 빈 문자열이 아님을 검증한다.
+  - [x] 1 이상의 숫자로 이루어져 있음을 검증한다.
+
+### 자동차를 전진하는 기능
+
+- [x] 입력한 횟수만큼 자동차 전진을 시도한다.
+- [x] 무작위 값을 생성하고 전진하는 조건을 검사한다.
+- [x] 조건에 부합한다면 자동차를 전진시킨다.
+
+### 자동차의 상태를 출력하는 기능
+
+- [x] 모든 자동차의 이름과 이동한 갯수를 뷰에 전달한다.
+- [x] 뷰에서 자동차 이름을 출력하고 이동한 갯수를 `-`로 출력한다.
+
+### 우승자를 출력하는 기능
+
+- [x] 가장 많이 이동한 자동차를 선정한다.
+- [x] `최종 우승자 : pobi`와 같이 우승자를 출력한다.
+
+# 🛠 시스템 흐름도
+
+![img.png](흐름도.png)

src/main/java/racingcar/Application.java

@@ -1,7 +1,17 @@
 package racingcar;
 
+import camp.nextstep.edu.missionutils.Console;
+import racingcar.controller.GameManager;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
 public class Application {
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        GameManager gameManager = new GameManager(
+                new InputView(),
+                new OutputView()
+        );
+        gameManager.run();
+        Console.close();
     }
 }

src/main/java/racingcar/controller/GameManager.java

@@ -0,0 +1,36 @@
+package racingcar.controller;
+
+import java.util.List;
+import racingcar.domain.Cars;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
+public class GameManager {
+    private final InputView inputView;
+    private final OutputView outputView;
+
+    public GameManager(InputView inputView, OutputView outputView) {
+        this.inputView = inputView;
+        this.outputView = outputView;
+    }
+
+    public void run() {
+        Cars cars = new Cars(inputView.readCarNames());
+        int count = inputView.readTryCount();
+
+        for (int i = 0; i < count; i++) {
+            play(cars);
+        }
+        complete(cars);
+    }
+
+    private void play(Cars cars) {
+        cars.moveCars();
+        outputView.printResult(cars);
+    }
+
+    private void complete(Cars cars) {
+        List<String> winners = cars.selectWinners();
+        outputView.printWinners(winners);
+    }
+}

src/main/java/racingcar/domain/Car.java

@@ -0,0 +1,39 @@
+package racingcar.domain;
+
+import racingcar.global.util.RandomNumberGenerator;
+
+public class Car {
+    private static final int THRESHOLD = 4;
+    private static final int START = 0;
+    private static final int END = 9;
+    public static final int INTERVAL = 1;
+    private Name name;
+    private int moved;
+
+    public Car(Name name) {
+        this.name = name;
+        this.moved = 0;
+    }
+
+    public void move() {
+        if (canMove()) {
+            moved += INTERVAL;
+        }
+    }
+
+    private boolean canMove() {
+        int number = RandomNumberGenerator.generate(START, END);
+        if (number >= THRESHOLD) {
+            return true;
+        }
+        return false;
+    }
+
+    public int moved() {
+        return moved;
+    }
+
+    public String name() {
+        return name.getValue();
+    }
+}

src/main/java/racingcar/domain/Cars.java

@@ -0,0 +1,47 @@
+package racingcar.domain;
+
+import java.util.List;
+
+public class Cars {
+    private final List<Car> cars;
+
+    public Cars(List<String> cars) {
+        this.cars = generateToCars(cars);
+    }
+
+    private List<Car> generateToCars(List<String> cars) {
+        return cars.stream()
+                .map(name -> new Car(new Name(name)))
+                .toList();
+    }
+
+    public void moveCars() {
+        for (Car car : cars) {
+            car.move();
+        }
+    }
+
+    public List<String> selectWinners() {
+        int maxMoved = getMaxMoved();
+
+        return cars.stream()
+                .filter(car -> car.moved() == maxMoved)
+                .map(Car::name)
+                .toList();
+    }
+
+    private int getMaxMoved() {
+        return cars.stream()
+                .mapToInt(car -> car.moved())
+                .max()
+                .orElseThrow(IllegalStateException::new);
+    }
+
+    public int size() {
+        return cars.size();
+    }
+
+    public Car get(int i) {
+        return cars.get(i);
+    }
+}

src/main/java/racingcar/domain/Name.java

@@ -0,0 +1,31 @@
+package racingcar.domain;
+
+import racingcar.global.exception.CustomException;
+import racingcar.global.exception.ErrorMessage;
+
+public class Name {
+    public static final int MIN = 1;
+    public static final int MAX = 5;
+    private final String name;
+
+    public Name(String name) {
+        Validator.validateRange(name.length(), MIN, MAX);
+        this.name = name;
+    }
+
+    public String getValue() {
+        return name;
+    }
+
+    public static class Validator {
+        private static void validateRange(int length, int start, int end) {
+            if (isInvalidRange(length, start, end)) {
+                throw CustomException.from(ErrorMessage.INVALID_LENGTH_ERROR);
+            }
+        }
+
+        private static boolean isInvalidRange(int number, int start, int end) {
+            return number < start || number > end;
+        }
+    }
+}

src/main/java/racingcar/global/exception/CustomException.java

@@ -0,0 +1,13 @@
+package racingcar.global.exception;
+
+public class CustomException extends IllegalArgumentException {
+    private static final String PREFIX = "[ERROR] ";
+
+    private CustomException(ErrorMessage errorMessage) {
+        super(PREFIX + errorMessage.getMessage());
+    }
+
+    public static CustomException from(ErrorMessage errorMessage) {
+        return new CustomException(errorMessage);
+    }
+}

src/main/java/racingcar/global/exception/ErrorMessage.java

@@ -0,0 +1,18 @@
+package racingcar.global.exception;
+
+public enum ErrorMessage {
+    BLANK_INPUT_ERROR("빈 문자열이 입력되었습니다."),
+    INVALID_LENGTH_ERROR("잘못된 길이의 문자열을 입력하였습니다. "),
+    DUPLICATED_CAR_ERROR("자동차의 이름이 중복되었습니다."),
+    INVALID_TRY_COUNT_ERROR("잘못된 시도 횟수의 입력입니다.");
+
+    private final String message;
+
+    ErrorMessage(String message) {
+        this.message = message;
+    }
+
+    public String getMessage() {
+        return this.message;
+    }
+}

src/main/java/racingcar/global/util/RandomNumberGenerator.java

@@ -0,0 +1,9 @@
+package racingcar.global.util;
+
+import camp.nextstep.edu.missionutils.Randoms;
+
+public class RandomNumberGenerator {
+    public static int generate(int start, int end) {
+        return Randoms.pickNumberInRange(start, end);
+    }
+}

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

@@ -0,0 +1,67 @@
+package racingcar.view;
+
+import java.util.Arrays;
+import java.util.List;
+import racingcar.global.exception.CustomException;
+import racingcar.global.exception.ErrorMessage;
+import racingcar.view.console.ConsoleReader;
+import racingcar.view.console.ConsoleWriter;
+
+public class InputView {
+    private static final String CAR_NAMES_NOTICE = "경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)`를 출력한다.";
+    public static final String CAR_NAMES_SEPARATOR = ",";
+    public static final String TRY_COUNT_NOTICE = "시도할 회수는 몇회인가요?";
+
+    public List<String> readCarNames() {
+        ConsoleWriter.printlnMessage(CAR_NAMES_NOTICE);
+        return Validator.validateCarNames(ConsoleReader.enterMessage());
+    }
+
+    public int readTryCount() {
+        ConsoleWriter.printlnMessage(TRY_COUNT_NOTICE);
+        return Validator.validateNumber(ConsoleReader.enterMessage());
+    }
+
+    private static class Validator {
+        private static List<String> validateCarNames(String message) {
+            List<String> cars = parseStringToList(message, CAR_NAMES_SEPARATOR);
+            validateDuplicated(cars);
+            return cars;
+        }
+
+        private static void validateDuplicated(List<String> items) {
+            if (hasDuplicated(items)) {
+                throw CustomException.from(ErrorMessage.DUPLICATED_CAR_ERROR);
+            }
+        }
+
+        private static boolean hasDuplicated(List<String> items) {
+            return items.size() != calculateUniqueCount(items);
+        }
+
+        private static int calculateUniqueCount(List<String> items) {
+            return (int) items.stream()
+                    .distinct()
+                    .count();
+        }
+
+        private static List<String> parseStringToList(String message, String separator) {
+            return Arrays.stream(split(message, separator)).toList();
+        }
+
+        private static String[] split(String message, String separator) {
+            return message.split(separator, -1);
+        }
+
+        private static int validateNumber(String message) {
+            if (isNotNumber(message)) {
+                throw CustomException.from(ErrorMessage.INVALID_TRY_COUNT_ERROR);
+            }
+            return Integer.parseInt(message);
+        }
+
+        private static boolean isNotNumber(String str) {
+            return !str.matches("^[1-9]+$");
+        }
+    }
+}

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

@@ -0,0 +1,42 @@
+package racingcar.view;
+
+import java.util.List;
+import racingcar.domain.Car;
+import racingcar.domain.Cars;
+import racingcar.view.console.ConsoleWriter;
+
+public class OutputView {
+    private static final String RESULT_NOTICE = "실행 결과";
+    private static final String WINNER_NOTICE = "최종 우승자 : %s";
+    private static final String WINNER_SEPARATOR = ", ";
+
+    public void printResult(Cars cars) {
+        ConsoleWriter.printlnMessage(RESULT_NOTICE);
+        printCarsStatus(cars);
+        ConsoleWriter.println();
+    }
+
+    private void printCarsStatus(Cars cars) {
+        for (int i = 0; i < cars.size(); i++) {
+            Car car = cars.get(i);
+            printCarStatus(car, i);
+        }
+    }
+
+    private void printCarStatus(Car car, int i) {
+        String name = car.name();
+        int moved = car.moved();
+        ConsoleWriter.printlnMessage(name + " : " + "-".repeat(moved));
+    }
+
+    public void printWinners(List<String> winners) {
+        ConsoleWriter.printlnFormat(
+                WINNER_NOTICE,
+                generateWinnerResult(winners)
+        );
+    }
+
+    private String generateWinnerResult(List<String> winners) {
+        return String.join(WINNER_SEPARATOR, winners);
+    }
+}

src/main/java/racingcar/view/console/ConsoleReader.java

@@ -0,0 +1,24 @@
+package racingcar.view.console;
+
+import camp.nextstep.edu.missionutils.Console;
+import racingcar.global.exception.CustomException;
+import racingcar.global.exception.ErrorMessage;
+
+public final class ConsoleReader {
+    public static String enterMessage() {
+        return Validator.validate(Console.readLine());
+    }
+
+    private static class Validator {
+        public static String validate(String message) {
+            validateBlankInput(message);
+            return message;
+        }
+
+        private static void validateBlankInput(String message) {
+            if (message.isBlank()) {
+                throw CustomException.from(ErrorMessage.BLANK_INPUT_ERROR);
+            }
+        }
+    }
+}