[연습] 자동차 경주

docs/README.md

@@ -0,0 +1,39 @@
+# 🚗 구현 기능 목록
+
+## 자동차
+- [x] 각 자동차에 이름을 부여할 수 있다.
+  - [x] **[예외처리]** 자동차의 이름이 5자 초과일 경우 예외처리한다.
+- [x] 전진하거나 멈출 수 있다.
+  - [x] 연료가 4 이상일 경우 전진한다.
+  - [x] **[예외처리]** 연료가 0 미만 9 초과의 값이 들어오면 예외처리한다.
+
+
+## 자동차 경주 게임
+- [x] 경주에 참여할 자동차들을 등록한다.
+  - [x] **[예외처리]** 참여할 자동차는 최소 1대여야한다.
+- [x] 이동 횟수를 등록한다.
+  - [x] **[예외처리]** 이동횟수가 0 이하면 예외처리한다.
+- [x] 자동차 경주를 시작한다.
+  - [x] 각 이동횟수마다 각 자동차에게 랜덤한 연료를 주입한다.
+- [x] 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다.(여러명의 우승자가 나올 수 있다.)
+
+
+## 입력
+- [x] 자동차 이름은 쉼표(,)를 기준으로 구분하며 이름을 입력받는다.
+  - [x] **[예외처리]** 쉼표를 기준으로 나눴을 때 자동차 이름이 0보다 작거나 5보다 크면 예외처리한다.
+- [x] 사용자는 몇 번의 이동을 할 것인지를 입력할 수 있어야 한다.
+  - [x] **[예외처리]** 이동 횟수는 숫자여야 한다.
+- [x] 사용자가 잘못된 값을 입력할 경우 에러 메시지를 출력 후 그 부분부터 입력을 다시 받는다.
+
+
+## 출력
+- [x] 자동차 이름과 자동차의 현재 위치를 출력한다.
+- [x] 최종 우승자를 출력한다. 
+  - [x] 우승자가 여러 명일 경우 쉼표(,)를 이용하여 구분한다.
+
+---
+## 동작 순서
+1. 경주에 등록할 자동차를 입력받는다.
+2. 경주 시도 횟수를 입력받는다.
+3. 시도 횟수 만큼 자동차가 전진하거나 멈춘다.
+4. 경주가 종료되고 우승자를 알려준다.

src/main/java/racingcar/Application.java

@@ -3,5 +3,7 @@
 public class Application {
     public static void main(String[] args) {
         // TODO 구현 진행
+        MainController mainController = new MainController();
+        mainController.run();
     }
 }

src/main/java/racingcar/Car.java

@@ -1,12 +1,51 @@
 package racingcar;
 
 public class Car {
+
+    public static final int MIN_FUEL = 0;
+    public static final int MAX_FUEL = 9;
+    public static final int MIN_MOVE_FUEL = 4;
+
+    public static final int MAX_NAME_LENGTH = 5;
+
     private final String name;
     private int position = 0;
 
     public Car(String name) {
+        validateName(name);
         this.name = name;
     }
 
     // 추가 기능 구현
+    private void validateName(String name) {
+        if (name.length() > MAX_NAME_LENGTH) {
+            throw new IllegalArgumentException(Message.CAR_NAME_VALIDATION);
+        }
+    }
+
+
+    public void moveOrStop(int fuel) {
+        validateFuel(fuel);
+        if (fuel >= MIN_MOVE_FUEL) {
+            move();
+        }
+    }
+
+    private void validateFuel(int fuel) {
+        if (fuel < MIN_FUEL || fuel > MAX_FUEL) {
+            throw new IllegalArgumentException(Message.CAR_FUEL_VALIDATION);
+        }
+    }
+
+    private void move() {
+        position++;
+    }
+
+    public int getCurrentPosition() {
+        return position;
+    }
+
+    public String getName() {
+        return name;
+    }
 }

src/main/java/racingcar/CarGame.java

@@ -0,0 +1,70 @@
+package racingcar;
+
+import camp.nextstep.edu.missionutils.Randoms;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class CarGame {
+
+    private final List<Car> cars;
+    private int moveCounts;
+
+    public CarGame() {
+        cars = new ArrayList<>();
+    }
+
+    public void registerCar(List<String> cars) {
+        validateCars(cars);
+        for (String carName : cars) {
+            this.cars.add(new Car(carName));
+        }
+    }
+
+    private void validateCars(List<String> cars) {
+        if (cars.isEmpty()) {
+            throw new IllegalArgumentException(Message.NUMBER_OF_CARS_VALIDATION);
+        }
+    }
+
+    public List<Car> getCars() {
+        return cars;
+    }
+
+    public void registerMoveCounts(int moveCounts) {
+        validateMoveCounts(moveCounts);
+        this.moveCounts = moveCounts;
+    }
+
+    private void validateMoveCounts(int moveCounts) {
+        if (moveCounts <= 0) {
+            throw new IllegalArgumentException(Message.MOVE_COUNTS_VALIDATION);
+        }
+    }
+
+    public void startRacing() {
+        if (checkIsOver()) {
+            throw new IllegalStateException(Message.GAME_OVER);
+        }
+        for (Car car : cars) {
+            car.moveOrStop(getRandomFuel());
+        }
+        moveCounts--;
+    }
+
+    public boolean checkIsOver() {
+        return moveCounts <= 0;
+    }
+
+    private int getRandomFuel() {
+        return Randoms.pickNumberInRange(Car.MIN_FUEL, Car.MAX_FUEL);
+    }
+
+    public List<String> announceWinners() {
+        return cars.stream()
+            .filter(car -> car.getCurrentPosition() == cars.stream().map(Car::getCurrentPosition)
+                .max(Integer::compareTo).orElse(0))
+            .map(Car::getName)
+            .collect(Collectors.toList());
+    }
+}

src/main/java/racingcar/MainController.java

@@ -0,0 +1,57 @@
+package racingcar;
+
+import java.util.List;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
+public class MainController {
+
+    private final CarGame carGame;
+    private final InputView inputView;
+    private final OutputView outputView;
+
+    public MainController() {
+        carGame = new CarGame();
+        inputView = new InputView();
+        outputView = new OutputView();
+    }
+
+    public void run() {
+        registerCars();
+        registerMoveCounts();
+        startRace();
+        endRace();
+    }
+
+    private void registerCars() {
+        try {
+            List<String> inputCars = inputView.inputCars();
+            carGame.registerCar(inputCars);
+        } catch (IllegalArgumentException e) {
+            outputView.printError(e.getMessage());
+            registerCars();
+        }
+    }
+
+    private void registerMoveCounts() {
+        try {
+            int moveCounts = inputView.inputMoveCounts();
+            carGame.registerMoveCounts(moveCounts);
+        } catch (IllegalArgumentException e) {
+            outputView.printError(e.getMessage());
+            registerMoveCounts();
+        }
+    }
+
+    private void startRace() {
+        outputView.printRaceStart();
+        while (!carGame.checkIsOver()) {
+            carGame.startRacing();
+            outputView.printCars(carGame.getCars());
+        }
+    }
+
+    private void endRace() {
+        outputView.printWinners(carGame.announceWinners());
+    }
+}

src/main/java/racingcar/Message.java

@@ -0,0 +1,17 @@
+package racingcar;
+
+public class Message {
+
+    public static final String CAR_NAME_VALIDATION = "자동차의 이름은 1~5자여야 합니다.";
+    public static final String CAR_FUEL_VALIDATION = "연료는 0 이상 9 이하의 값이어야 합니다.";
+    public static final String NUMBER_OF_CARS_VALIDATION = "등록할 자동차는 최소 1대여야 합니다.";
+    public static final String MOVE_COUNTS_VALIDATION = "이동횟수는 최소 1회 이상이어야 합니다.";
+    public static final String GAME_OVER = "경기가 종료되었습니다.";
+
+    public static final String INPUT_CAR_MESSAGE = "경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)";
+    public static final String INPUT_MOVE_COUNTS_MESSAGE = "시도할 회수는 몇회인가요?";
+    public static final String INPUT_NUMBER_ERROR = "숫자만 입력이 가능합니다.";
+
+    public static final String OUTPUT_RACE_RESULT = "\n실행 결과";
+
+}

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

@@ -0,0 +1,49 @@
+package racingcar.view;
+
+import camp.nextstep.edu.missionutils.Console;
+import java.util.Arrays;
+import java.util.List;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+import racingcar.Car;
+import racingcar.Message;
+
+public class InputView {
+
+    public static final String CAR_REGEX = ",";
+    private static final String ONLY_NUMBER_REGEX = "^[0-9]+$";
+
+    public List<String> inputCars() {
+        System.out.println(Message.INPUT_CAR_MESSAGE);
+        String input = Console.readLine();
+        validateInputCars(input);
+        String[] inputCars = input.split(CAR_REGEX);
+        return Arrays.stream(inputCars).collect(Collectors.toList());
+    }
+
+    private void validateInputCars(String input) {
+        if (input.endsWith(CAR_REGEX)) {
+            throw new IllegalArgumentException(Message.CAR_NAME_VALIDATION);
+        }
+
+        String[] inputCars = input.split(CAR_REGEX);
+        for (String inputCar : inputCars) {
+            if (inputCar.length() > Car.MAX_NAME_LENGTH) {
+                throw new IllegalArgumentException(Message.CAR_NAME_VALIDATION);
+            }
+        }
+    }
+
+    public int inputMoveCounts() {
+        System.out.println(Message.INPUT_MOVE_COUNTS_MESSAGE);
+        String input = Console.readLine();
+        validateNumber(input);
+        return Integer.parseInt(input);
+    }
+
+    private void validateNumber(String input) {
+        if (!Pattern.matches(ONLY_NUMBER_REGEX, input)) {
+            throw new IllegalArgumentException(Message.INPUT_NUMBER_ERROR);
+        }
+    }
+}

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

@@ -0,0 +1,51 @@
+package racingcar.view;
+
+import java.util.List;
+import racingcar.Car;
+import racingcar.Message;
+
+public class OutputView {
+
+    public static final String CAR_FORMAT = "%s : %s\n";
+    public static final String MOVE_UNIT = "-";
+    public static final String DELIMITER = ", ";
+    public static final String ERROR_SUFFIX = "[ERROR]";
+    public static final String WINNER_FORMAT = "최종 우승자 : %s";
+    public static final String ERROR_FORMAT = "%s %s\n";
+
+    public void printCars(List<Car> cars) {
+        for (Car car : cars) {
+            printCar(car);
+        }
+        printNewLine();
+    }
+
+    private void printNewLine() {
+        System.out.println();
+    }
+
+    public void printRaceStart() {
+        System.out.println(Message.OUTPUT_RACE_RESULT);
+    }
+
+    private void printCar(Car car) {
+        System.out.printf(CAR_FORMAT, car.getName(), getMove(car.getCurrentPosition()));
+    }
+
+    private String getMove(int currentPosition) {
+        StringBuilder stringBuilder = new StringBuilder();
+        for (int i = 0; i < currentPosition; i++) {
+            stringBuilder.append(MOVE_UNIT);
+        }
+        return stringBuilder.toString();
+    }
+
+    public void printWinners(List<String> winners) {
+        String winnersName = String.join(DELIMITER, winners);
+        System.out.printf(WINNER_FORMAT, winnersName);
+    }
+
+    public void printError(String errorMessage) {
+        System.out.printf(ERROR_FORMAT, ERROR_SUFFIX, errorMessage);
+    }
+}