고생하셨습니다.

🎉 PR 머지 완료! 🎉

Author: JihwanYeom

README.md

@@ -8,37 +8,68 @@
 모든 라운드가 끝난 뒤 가장 많이 이동한 자동차들이 우승하게 됩니다.
 
 ## 🎮게임 규칙
-* 🚗 게임에 참가할 자동차 수와 라운드 수를 정하고 게임을 시작합니다.
+* 🚗 게임에 참가할 자동차 이름을 입력합니다(자동차 이름의 길이는 5이하여야 합니다)
 
 
-* 🎲 게임이 시작되면 모든 차는 매 라운드마다 랜덤으로 발생한 0부터 10까지의 숫자 중 3 이하가 나올 경우 정지해있고, 4이상의 숫자가 나올 경우 1만큼 전진합니다.
+* 🏁 라운드 수를 정하고 게임을 시작합니다.
+
+
+* 🎲 게임이 시작되면 모든 차는 매 라운드마다 랜덤으로 발생한 0부터 9까지의 숫자 중 3 이하가 나올 경우 정지해있고, 4이상의 숫자가 나올 경우 1만큼 전진합니다.
 
 
 * 🏆 모든 라운드가 끝나고 우승한 자동차를 확인하면 됩니다.
 
 ## 🔧프로젝트 설계
-프로젝트는 크게 자동차, 게임을 구현한 두개의 클래스로 작성되었습니다.
-### 🚗자동차 클래스
-* 자동차 클래스는 필드로 이름과 이동 거리를 가지고 있습니다.   
+프로젝트는 MVC 모델을 적용하여 controller, domain((model), view 
+패키지로 이루어져 있습니다. 메인 클래스를 실행하면 controller 객체의
+게임 실행 메서드가 실행되어 게임이 진행됩니다.
 
 
-* 생성자는 이름을 매개변수로 받아 초기화하고 이동거리를 0으로 초기화합니다.
+### ⚙️Domain
+* domain 패키지는 자동차, 자동차의 리스트, 레이싱, 랜덤 변수 생성 클래스로 이루어져
+있습니다.
 
 
-* 자동차의 이동 메서드는 매개변수로 받은 값이 4 이상일 경우 이동거리를 1 증가시킵니다.
+* 자동차 클래스는 이름과 이동한 거리를 저장하고 있으며 생성된 랜덤 변수에 
+따라 한 칸 전진하는 메서드, 자신의 현재 위치가 주어진 값과 같은지 반환하는 
+메서드로 구성되어 있습니다.
 
-### 🎮Game 클래스
-* 참가하는 차들과 우승한 차를 저장하기 위해 두 개의 리스트를 가지고 있습니다.
 
-   
-* 게임 실행 메서드는 차 갯수와 라운드 수를 매개변수로 받아 게임 초기화, 게임 진행, 우승자 선정을 수행합니다.
+* 자동차 리스트 클래스는 자동차들의 배열을 저장하고 있습니다. 또한 리스트에
+저장된 자동차들을 이동시키는 메서드, 리스트에 저장된 자동차 중 가장 멀리
+이동한 자동차의 이동 거리를 반환하는 메서드, 어떤 한 위치에 있는 모든 자동차
+들의 리스트를 반환하는 메서드로 이루어져 있습니다.
+
+
+* 레이싱 클래스는 참가한 자동차들의 리스트를 저장하고 있으며 참가한 자동차들을
+전부 이동시키는 메서드와 참가한 자동차들 중 우승자들의 리스트를 반환하는
+메서드를 가지고 있습니다.
+
+
+* 랜덤 변수 생성 클래스는 0부터 9사이의 숫자를 생성해서 반환하는 메서드를
+가지고 있습니다.
+
+### 💻View
+- view 패키지는 입력을 담당하는 클래스와 출력을 담당하는 클래스를 담당하는
+클래스로 이루어져 있습니다.
+
+
+- 입력을 담당하는 클래스는 자동차들의 이름을 양식에 맞게 입력받아 이를 문자열의
+배열로 변환하여 반환하는 메서드와, 라운드 수를 입력받는 메서드로 이루어져 있습니다.
+
+
+- 출력을 담당하는 클래스는 사용자 입력 요청을 출력하는 메서드와 게임 현황을
+출력하는 메서드, 우승자 리스트를 출력하는 메서드를 가지고 있습니다.
 
 
-* 게임 초기화 메서드는 게임 실행 중 가장 먼저 호출되어 차 갯수를 매개변수로 받아 갯수만큼 자동차 객체를 생성하여 리스트에 저장합니다. 현 단계에서는 차 이름이 순차적으로 자동생성됩니다.( ex)Car_1, Car_2, ... )
+- 출력의 양식을 지키기 위한 포맷팅 메서드도 출력을 담당하는 클래스에
+포함되어 있습니다
 
 
-* 라운드 진행 메서드는 라운드 수만큼 실행되며 게임에 참여한 모든 차의 이동 메서드를 호출합니다.   
-이때 각 자동차마다 랜덤 변수 생성기를 통해 0부터 10까지의 숫자 중 하나를 매개변수로 줍니다
+### 🎮Controller
 
 
-* 우승자 선정 메서드는 모든 라운드가 끝난 후 가장 먼 거리를 이동한 차들을 우승자 리스트에 저장합니다.
+* Controller 클래스는 domain과 view의 클래스들을 이용하여 게임을 진행합니다
+게임 실행 메서드가 실행되면 사용자에게 자동차 이름과 라운드 수를 입력받아
+레이싱을 수행합니다. 레이싱이 끝나면 우승자 리스트를 출력하고 메서드가
+종료됩니다.

src/main/java/Car.java

@@ -0,0 +1,9 @@
+import controller.RacingController;
+
+public class RacingApplication {
+
+    public static void main(String[] args) {
+        new RacingController().run();
+    }
+
+}

src/main/java/Game.java

@@ -0,0 +1,50 @@
+package controller;
+
+import domain.Car;
+import domain.Cars;
+import domain.Racing;
+import domain.NumberGenerator;
+import domain.RandomNumberGenerator;
+import java.util.ArrayList;
+import java.util.List;
+import view.InputView;
+import view.OutputView;
+
+public class RacingController {
+
+    private static final NumberGenerator randomGenerator = new RandomNumberGenerator();
+
+    public void run() {
+
+        OutputView.printInputCarNames();
+        List<String> carNames = InputView.getCarNames();
+        Cars cars = Cars.from(createCars(carNames));
+
+        OutputView.printInputRoundNumber();
+        int roundNumber = InputView.getRoundNumber();
+
+        Racing racing = new Racing(cars);
+
+        OutputView.printResult();
+        playRace(racing, cars, roundNumber);
+
+        Cars winnerList = racing.findWinners();
+        OutputView.printWinners(winnerList.getCars());
+    }
+
+    public List<Car> createCars(List<String> names) {
+        List<Car> cars = new ArrayList<>();
+        for (String name : names) {
+            cars.add(new Car(name, randomGenerator));
+        }
+        return cars;
+    }
+
+    public void playRace(Racing racing, Cars cars, int roundNumber) {
+        for (int i = 0; i < roundNumber; i++) {
+            racing.playRound();
+            OutputView.printProcess(cars.getCars());
+        }
+    }
+
+}

src/main/java/RacingApplication.java

@@ -0,0 +1,35 @@
+package domain;
+
+public class Car {
+
+    private static final int CRITICAL_NUMBER_TO_MOVE = 4;
+
+    private final Name name;
+    private int distance;
+    private final NumberGenerator numberGenerator;
+
+    public Car(String name, NumberGenerator numberGenerator) {
+        this.name = Name.from(name);
+        this.distance = 0;
+        this.numberGenerator = numberGenerator;
+    }
+
+    public void move() {
+        if (numberGenerator.generateNumber() >= CRITICAL_NUMBER_TO_MOVE) {
+            distance++;
+        }
+    }
+
+    public boolean hasSamePosition(int position) {
+        return distance == position;
+    }
+
+    public String getName() {
+        return name.getName();
+    }
+
+    public int getDistance() {
+        return distance;
+    }
+
+}

src/main/java/controller/RacingController.java

@@ -0,0 +1,70 @@
+package domain;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+public class Cars {
+
+    private static final int MAX_CAR_NUMBER = 10;
+
+    private final List<Car> cars;
+
+    private Cars(List<Car> cars) {
+        this.cars = cars;
+    }
+
+    public static Cars from(List<Car> cars) {
+        checkCarNumber(cars);
+        checkDuplicates(cars);
+        return new Cars(new ArrayList<>(cars));
+    }
+
+    public static void checkCarNumber(List<Car> cars) {
+        if (cars.size() > MAX_CAR_NUMBER) {
+            throw new IllegalArgumentException("[Error] 차의 개수는 10대를 초과할 수 없습니다.");
+        }
+    }
+
+    public static void checkDuplicates(List<Car> cars) {
+        if (hasDuplicates(cars)) {
+            throw new IllegalArgumentException("[Error] 차의 이름은 중복될 수 없습니다.");
+        }
+    }
+
+    private static boolean hasDuplicates(List<Car> cars) {
+        Set<String> nameSet = new HashSet<>();
+        return cars.stream()
+                .map(Car::getName)
+                .anyMatch(name -> !nameSet.add(name));
+    }
+
+    public void move() {
+        for (Car car : cars) {
+            car.move();
+        }
+    }
+
+    public int getMaxDistance() {
+        int maxDistance = 0;
+        for (Car car : cars) {
+            maxDistance = Math.max(maxDistance, car.getDistance());
+        }
+        return maxDistance;
+    }
+
+    public Cars findCarsHasSamePosition(int position) {
+        List<Car> carsHasSamePosition = cars.stream()
+                .filter(car -> car.hasSamePosition(position))
+                .collect(Collectors.toList());
+
+        return new Cars(carsHasSamePosition);
+    }
+
+    public List<Car> getCars() {
+        return new ArrayList<>(cars);
+    }
+
+}

src/main/java/domain/Car.java

@@ -0,0 +1,35 @@
+package domain;
+
+public class Name {
+
+    private static final int MAX_LENGTH = 5;
+
+    private final String name;
+
+    private Name(final String name) {
+        this.name = name;
+    }
+
+    public static Name from(final String name) {
+        checkBlank(name);
+        checkLength(name);
+        return new Name(name);
+    }
+
+    public static void checkLength(String name) {
+        if (name.length() > MAX_LENGTH) {
+            throw new IllegalArgumentException("[Error] 이름은 " + MAX_LENGTH + "자를 초과할 수 없습니다.");
+        }
+    }
+
+    public static void checkBlank(String name) {
+        if (name.trim().isEmpty()) {
+            throw new IllegalArgumentException("[Error] 이름은 공백으로 이루어질 수 없습니다.");
+        }
+    }
+
+    public String getName() {
+        return name;
+    }
+
+}

src/main/java/domain/Cars.java

@@ -0,0 +1,5 @@
+package domain;
+
+public interface NumberGenerator {
+    int generateNumber();
+}