[1단계 - 자동차 경주 구현] 미아(이종미) 미션 제출합니다.

README.md

@@ -1,7 +1,36 @@
-# java-racingcar
+# [자동차 경주] 구현 기능 목록
 
-자동차 경주 미션 저장소
+## 핵심 구현 기능
 
-## 우아한테크코스 코드리뷰
+1. 이름을 가진 N대의 자동차를 생성한다.
+2. 사용자가 입력한 횟수만큼 각 자동차는 전진 또는 정지할 수 있다.
+3. 전진하는 조건은 0에서 9 사이에서 random 값을 구한 후 random 값이 4 이상일 경우 전진하고, 3 이하의 값이면 멈춘다.
+4. 한 명 이상의 우승자를 구한다.
+    1. 모든 자동차의 전진 횟수가 0회인 경우도 우승으로 간주한다.
 
-- [온라인 코드 리뷰 과정](https://github.com/woowacourse/woowacourse-docs/blob/master/maincourse/README.md)
+## 입출력 기능
+
+### 입력
+
+1. 자동차 이름들을 담은 문자열을 입력한다.
+    1. 각 자동차 이름은 다섯 글자 이하로 한다.
+    2. 각 자동차 이름은 쉼표로 구분된다.
+2. 시도할 회수를 입력한다.
+
+### 출력
+
+1. 각 시도 마다 실행 결과를 출력한다.
+    1. 이름의 순서는 입력된 순서로 출력한다.
+    2. 1회 전진 시 ‘-’ 1개를 출력한다.
+    3. 1회 정지 시 아무것도 출력하지 않는다.
+2. 우승자 이름을 출력한다.
+    1. 이름의 순서는 입력된 순서로 출력한다.
+    2. 각 이름은 쉼표로 구분한다.
+
+## 예외 처리 기능
+
+1. 자동차 이름이 1자 미만 5자 초과인 경우 예외로 처리한다.
+2. 중복된 자동차 이름이 입력된 경우 예외로 처리한다.
+3. 아예 빈 문자열 혹은 null이 입력된 경우 예외로 처리한다.
+4. 시도할 회수에 정수가 아닌 문자열이 입력된 경우 예외로 처리한다.
+5. 시도할 회수에 0 또는 양이 아닌 정수가 입력된 경우 예외로 처리한다.

src/main/java/racingcar/Application.java

@@ -0,0 +1,10 @@
+package racingcar;
+
+import racingcar.manager.RacingManager;
+
+public class Application {
+    public static void main(String[] args) {
+        RacingManager manager = new RacingManager();
+        manager.racingController().start();
+    }
+}

src/main/java/racingcar/controller/RacingController.java

@@ -0,0 +1,68 @@
+package racingcar.controller;
+
+import racingcar.domain.Car;
+import racingcar.domain.Cars;
+import racingcar.domain.RandomNumberGenerator;
+import racingcar.domain.RandomNumberGeneratorImpl;
+import racingcar.util.Parser;
+import racingcar.util.Validator;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
+import java.util.List;
+
+public class RacingController {
+    private final InputView inputView;
+    private final OutputView outputView;
+
+    public RacingController(final InputView inputView, final OutputView outputView) {
+        this.inputView = inputView;
+        this.outputView = outputView;
+    }
+
+    public void start() {
+        final List<String> carNames = readCarNames();
+        final Cars cars = new Cars(carNames);
+        final int tryCount = readTryCount();
+
+        outputView.printResultMsg();
+        RandomNumberGenerator randomNumberGenerator = new RandomNumberGeneratorImpl();
+        for(int i = 0 ; i < tryCount; i++) {
+            moveCars(cars, randomNumberGenerator);
+        }
+
+        final List<Car> winners = cars.determineWinner();
+        outputView.printWinners(winners);
+        inputView.closeScanner();
+    }
+
+    private List<String> readCarNames() {
+        try {
+            String carNames = inputView.readCarNames();
+            Validator.validateNullName(carNames);
+            List<String> parsedCarNames = Parser.parseCarNames(carNames);
+            Validator.validateCarNames(parsedCarNames);
+            return parsedCarNames;
+        } catch (IllegalArgumentException e) {
+            outputView.printErrorMsg(e.getMessage());
+            return readCarNames();
+        }
+    }
+
+    private int readTryCount() {
+        try {
+            String tryCount = inputView.readTryCount();
+            int parsedTryCount = Validator.validateInteger(tryCount);
+            Validator.validateTryCount(parsedTryCount);
+            return parsedTryCount;
+        } catch (IllegalArgumentException e) {
+            outputView.printErrorMsg(e.getMessage());
+            return readTryCount();
+        }
+    }
+
+    private void moveCars(final Cars cars, final RandomNumberGenerator randomNumberGenerator) {
+        cars.moveAll(randomNumberGenerator);
+        outputView.printCarPosition(cars);
+    }
+}

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

@@ -0,0 +1,35 @@
+package racingcar.domain;
+
+public class Car {
+    private static final int MOVEMENT_CRITERIA = 3;
+
+    private final String name;
+    private int movement;
+
+    public Car(final String name) {
+        this.name = name;
+        this.movement = 0;
+    }
+
+    public void move(final int condition) {
+        if (condition > MOVEMENT_CRITERIA ) {
+            this.movement += 1;
+        }
+    }
+
+    public boolean isSameCount(final int count) {
+        return this.movement == count;
+    }
+
+    public boolean isAlsoWinner(final Car car) {
+        return car.isSameCount(movement);
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public int getMovement() {
+        return movement;
+    }
+}

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

@@ -0,0 +1,32 @@
+package racingcar.domain;
+
+import java.util.Comparator;
+import java.util.List;
+
+public class Cars {
+    private final List<Car> cars;
+
+    public Cars(final List<String> names) {
+        this.cars = names.stream().map(Car::new).toList();
+    }
+
+    public void moveAll(final RandomNumberGenerator randomNumberGenerator) {
+        for(Car car: cars) {
+            final int condition = randomNumberGenerator.generate();
+            car.move(condition);
+        }
+    }
+
+    public List<Car> getCars() {
+        return this.cars;
+    }
+
+    public List<Car> determineWinner() {
+        final Car winnerCar = cars.stream()
+                .max(Comparator.comparing(Car::getMovement))
+                .get();
+        return cars.stream()
+                .filter(car -> car.isAlsoWinner(winnerCar))
+                .toList();
+    }
+}

src/main/java/racingcar/domain/RandomNumberGenerator.java

@@ -0,0 +1,5 @@
+package racingcar.domain;
+
+public interface RandomNumberGenerator {
+    int generate();
+}

src/main/java/racingcar/domain/RandomNumberGeneratorImpl.java

@@ -0,0 +1,10 @@
+package racingcar.domain;
+
+import java.util.Random;
+
+public class RandomNumberGeneratorImpl implements RandomNumberGenerator {
+    public int generate() {
+        Random random = new Random();
+        return random.nextInt(10);
+    }
+}

src/main/java/racingcar/manager/RacingManager.java

@@ -0,0 +1,19 @@
+package racingcar.manager;
+
+import racingcar.controller.RacingController;
+import racingcar.view.InputView;
+import racingcar.view.OutputView;
+
+public class RacingManager {
+    private InputView inputView() {
+        return new InputView();
+    }
+
+    private OutputView outputView() {
+        return new OutputView();
+    }
+
+    public RacingController racingController() {
+        return new RacingController(inputView(), outputView());
+    }
+}

src/main/java/racingcar/util/Parser.java

@@ -0,0 +1,12 @@
+package racingcar.util;
+
+import java.util.Arrays;
+import java.util.List;
+
+public class Parser {
+    public static List<String> parseCarNames(final String input) {
+        return Arrays.stream(input.split(","))
+                .map(String::trim)
+                .toList();
+    }
+}

src/main/java/racingcar/util/Validator.java

@@ -0,0 +1,46 @@
+package racingcar.util;
+
+import java.util.List;
+import java.util.Set;
+
+public class Validator {
+    public static void validateNullName(final String carNames) {
+        if(carNames == null) {
+            throw new IllegalArgumentException("자동차 이름 목록은 null일 수 없습니다.");
+        }
+    }
+
+    public static void validateCarNames(final List<String> carNames) {
+        for(String carName: carNames) {
+            validateCarNamesFormat(carName);
+        }
+        validateDuplicatedNames(carNames);
+    }
+
+    private static void validateCarNamesFormat(final String carName) {
+        if (carName.isBlank() || carName.isEmpty() || carName.length() > 5) {
+            throw new IllegalArgumentException("자동차 이름은 1자 이상 5자 이하여야 합니다.");
+        }
+    }
+
+    private static void validateDuplicatedNames(final List<String> carNames) {
+        final Set<String> uniqueNames = Set.copyOf(carNames);
+        if(uniqueNames.size() != carNames.size()) {
+            throw new IllegalArgumentException("자동차 이름은 중복될 수 없습니다.");
+        }
+    }
+
+    public static int validateInteger(final String tryCount) {
+        try {
+            return Integer.parseInt(tryCount);
+        } catch (NumberFormatException e) {
+            throw new IllegalArgumentException("시도 회수는 정수여야 합니다.");
+        }
+    }
+
+    public static void validateTryCount(final int tryCount) {
+        if (tryCount < 1) {
+            throw new IllegalArgumentException("시도할 회수는 양의 정수여야 합니다.");
+        }
+    }
+}

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

@@ -0,0 +1,24 @@
+package racingcar.view;
+
+import java.util.Scanner;
+
+public class InputView {
+    private static final String CAR_NAMES_INPUT_MSG = "경주할 자동차 이름을 입력하세요(이름은 쉼표(,)를 기준으로 구분).";
+    private static final String TRY_COUNT_INPUT_MSG = "시도할 회수는 몇회인가요?";
+
+    private final Scanner scanner = new Scanner(System.in);
+
+    public String readCarNames() {
+        System.out.println(CAR_NAMES_INPUT_MSG);
+        return scanner.nextLine();
+    }
+
+    public String readTryCount() {
+        System.out.println(TRY_COUNT_INPUT_MSG);
+        return scanner.nextLine();
+    }
+
+    public void closeScanner() {
+        scanner.close();
+    }
+}

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

@@ -0,0 +1,39 @@
+package racingcar.view;
+
+import java.util.List;
+import racingcar.domain.Car;
+import racingcar.domain.Cars;
+
+public class OutputView {
+    private static final String RESULT_MSG = "실행 결과";
+    private static final String POSITION_FORM = "%s : %s";
+    private static final String TRACE = "-";
+    private static final String WINNER_MSG = "%s가 최종 우승했습니다.";
+
+    public void printCarPosition(final Cars cars) {
+        for(Car car : cars.getCars()) {
+            final String name = car.getName();
+            final String traces = makeTraces(car.getMovement());
+            System.out.println(String.format(POSITION_FORM, name, traces));
+        }
+        System.out.println();
+    }
+
+    private String makeTraces(final int count) {
+        return TRACE.repeat(count);
+    }
+
+    public void printWinners(final List<Car> winners) {
+        List<String> winnerNames = winners.stream().map(Car::getName).toList();
+        final String names = String.join(", ", winnerNames);
+        System.out.println(String.format(WINNER_MSG, names));
+    }
+
+    public void printResultMsg() {
+        System.out.println(RESULT_MSG);
+    }
+
+    public void printErrorMsg(String errorMsg) {
+        System.out.println(errorMsg);
+    }
+}