[그리디] 이규형 자동차 경주 미션 3, 4단계 제출합니다.

README.md

@@ -1,22 +1,37 @@
-# 자동차 경주
+# 자동차 경주 게임 (Car Racing Game)
 
-## 설명
-- 자동차 전진(4이상) 또는 정지(3이하)
-- 자동차 리스트 저장으로 n대의 자동차 경주 가능
-- 우승자 찾기 가능
-- 랜덤 숫자 생성 가능
+## 프로젝트 개요
 
-## 패키지 구조
+콘솔에서 실행되는 자동차 경주 게임입니다.
+자동차 이름을 입력받아 여러 대의 자동차 객체를 생성하고, 입력한 횟수만큼 라운드를 진행하며 각 자동차가 무작위 값에 따라 전진하거나 멈춥니다. 모든 라운드가 끝나면 가장 멀리 이동한 자동차(들)이 우승자로
+선정됩니다.
+
+## 게임 규칙
+
+- 자동차 이름은 쉼표(,)로 구분해서 여러 대를 한 번에 입력받습니다.
+- 자동차 이름은 5자를 초과할 수 없습니다.
+- 0~9 사이의 랜덤 값을 구해, 4 이상이면 전진하고 3 이하면 멈춥니다.
+- 사용자가 입력한 횟수만큼 라운드를 반복하며, 매 라운드마다 각 자동차의 위치를 출력합니다.
+- 가장 멀리 이동한 자동차가 우승자이며, 공동 우승자가 나올 수 있습니다.
+
+## 패키지 / 클래스 구조
+
+```
+Application.java              # 입력/출력을 조립하는 실행 진입점(main 메서드)
+
+domain
+├── Car.java                  # 이름과 위치를 가지며, 4 이상이면 전진
+├── Cars.java                 # n대의 Car를 리스트로 관리, 이름 배열로 Cars를 생성하는 정적 팩토리(createCars) 포함
+├── RandomNumber.java         # 랜덤 값 생성 인터페이스
+├── DefaultRandomNumber.java  # RandomNumber의 실제 구현체 (0~9 사이 랜덤 값)
+└── RacingGame.java           # 한 라운드씩 경주를 진행
+
+view
+├── InputView.java            # 자동차 이름/시도 횟수 입력받기
+└── ResultView.java           # 라운드별 진행 상황, 최종 우승자 출력
+
+test/domain
+├── CarTest.java              # 전진/정지, 이름 검증(null/blank/5자 초과) 테스트
+├── CarsTest.java             # 이동, 우승자 판별, 이름 배열로 생성하는 로직 테스트
+└── FixedRandomNumber.java    # 테스트용 고정값 RandomNumber 구현체
 ```
-racingcar
-├── Car.java             # 이름과 위치를 가지며, 4 이상이면 전진
-├── Cars.java            # n대의 Car를 리스트로 관리
-├── RandomNumber.java    # 0~9 사이 랜덤 값 생성
-├── CarMove.java         # 주어진 라운드 수만큼 자동차들을 이동
-└── FindCarWinner.java   # 가장 높은 위치의 자동차를 우승으로 판별
-
-test/racingcar
-├── CarMovingTest.java     # 전진 또는 정지 테스트
-├── CarsTest.java          # 자동차 목록 저장 테스트
-└── FindCarWinnerTest.java # 단독/공동 우승자 테스트
-```

src/main/java/Application.java

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

src/main/java/controller/RacingController.java

@@ -0,0 +1,38 @@
+package controller;
+
+import static domain.Cars.createCars;
+import static view.InputView.readCarName;
+import static view.InputView.readTryCount;
+import static view.ResultView.printFinalWinners;
+import static view.ResultView.printRound;
+
+import domain.Cars;
+import domain.DefaultRandomNumber;
+import domain.RacingGame;
+
+public class RacingController {
+
+    public void run() {
+        //자동차 이름 입력받기
+        String[] carNameArray = readCarName();
+        //자동차 생성시키기
+        Cars carsList = createCars(carNameArray);
+        //시도할 횟수 받기
+        int tryCount = readTryCount();
+        System.out.println();
+        //시도 횟수만큼 경주시키기 (단, 경주할떄마다 값 출력하기)
+        RacingGame racingGame = new RacingGame(carsList, new DefaultRandomNumber(), tryCount);
+        raceCars(racingGame, carsList);
+        //최종 우승자 출력하기
+        printFinalWinners(racingGame.findWinners());
+    }
+
+    //시도 횟수만큼 경주시키기 (단, 경주할떄마다 값 출력하기)
+    private void raceCars(RacingGame racingGame, Cars carsList) {
+        for (int i = 0; i < racingGame.getTryCount(); i++) {
+            racingGame.carRaceOnce();
+            //경주할때마다 값 출력하기
+            printRound(carsList);
+        }
+    }
+}

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

@@ -1,20 +1,29 @@
-package racingcar;
+package domain;
 
 public class Car {
     private static final int FORWARD_CONDITION = 4;
+    private static final int MAX_CAR_NAME_LENGTH = 5;
+    private static final int MIN_CAR_POSITION = 0;
     //static은 클랫 전체가 공유하는 변수
 
     private final String carName;
     //final이 자바스크립트의 const와 유사?
     //private는 이제 직접 수정못하게하는? 외부에서 직접 접근 불가하게 하는것?
 
-    private int carPosition = 0;
+    private int carPosition;
 
-    public Car(String carName) {
+    public Car(String carName, int carPosition) {
         if (carName == null || carName.isBlank()) {
             throw new IllegalArgumentException("자동차 이름은 비어있을 수 없습니다.");
         }
+        if (carName.length() > MAX_CAR_NAME_LENGTH) {
+            throw new IllegalArgumentException("자동차 이름은 5자를 초과할 수 없습니다.");
+        }
+        if (carPosition < MIN_CAR_POSITION) {
+            throw new IllegalArgumentException("자동차 위치는 0 이상이어야 합니다.");
+        }
         this.carName = carName;
+        this.carPosition = carPosition;
     }
 
     public String getCarName() {

src/main/java/domain/Cars.java

@@ -0,0 +1,77 @@
+package domain;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+public class Cars {
+
+    private final List<Car> cars;
+
+    public Cars(List<Car> cars) {
+        validateNoDuplicateNames(cars); //중복이름 예외검증
+        this.cars = new ArrayList<>(cars);
+    }
+
+    public List<Car> getCars() {
+        return Collections.unmodifiableList(cars); //외부에서 수정 못하게 막는거
+    }
+
+    public int size() {
+        return cars.size();
+    }
+
+    public void move(RandomNumber randomNumber) {
+        for (int i = 0; i < cars.size(); i++) {
+            int number = randomNumber.getRandomNumber();
+            cars.get(i).moveIfPossible(number);
+        }
+    }
+
+    //자동차 생성시키기(위치가 여기가 맞는것같음)
+    public static Cars createCars(String[] carNameArray) {
+        List<Car> cars = new ArrayList<>();
+        for (String name : carNameArray) {
+            cars.add(new Car(name.trim(), 0));
+        }
+        return new Cars(cars);
+    }
+
+    private void validateNoDuplicateNames(List<Car> cars) {
+        Set<String> duplicateNames = new HashSet<>(); //[학습] Set은 중복을 허용하지 않는 자료구조
+        for (Car car : cars) {
+            if (!duplicateNames.add(car.getCarName())) { //false면 중복이니까
+                throw new IllegalArgumentException("자동차 이름은 중복될 수 없습니다.");
+                //중복 검증을 하여, 동일한 이름의 자동차가 존재하면 예외를 발생시킵니다.
+            }
+        }
+    }
+
+    //계산은 여기서
+    public int getMaxPosition() {
+        int maxPosition = 0;
+        for (Car car : cars) {
+            maxPosition = Math.max(maxPosition, car.getCarPosition());
+        }
+        return maxPosition;
+    }
+
+    // 특정 위치에 있는 자동차들을 반환
+    public List<Car> carsAt(int position) {   // "이 위치에 있는 차들 줘"
+        List<Car> result = new ArrayList<>();
+        for (Car car : cars) {
+            result.addAll(carAt(car, position));
+        }
+        return result;
+    }
+    //add로 하면 값을 car로 받아야하는데 이때 우승자가 없는경우 반환값을 정하기 어려워 addAll 사용
+
+    private List<Car> carAt(Car car, int position) {
+        if (car.samePosition(position)) {
+            return List.of(car);
+        }
+        return List.of();
+    }
+}

src/main/java/racingcar/RandomNumber.java → src/main/java/domain/DefaultRandomNumber.java

@@ -1,11 +1,12 @@
-package racingcar;
+package domain;
 
 import java.util.Random;
 
-public class RandomNumber {
+public class DefaultRandomNumber implements RandomNumber {
 
     private final Random randomNumber = new Random(); //굳이 변수선언 안하고 한방에 넣어도 되겠다는 생각?
 
+    @Override
     public int getRandomNumber() {
         return randomNumber.nextInt(10); // 0~9까지 랜덤숫자를 생성하기.
     }

src/main/java/domain/RacingGame.java

@@ -0,0 +1,28 @@
+package domain;
+
+import java.util.List;
+
+public class RacingGame {
+    private final Cars cars;
+    private final RandomNumber randomNumber;
+    private final int tryCount;
+
+    public RacingGame(Cars cars, RandomNumber randomNumber, int tryCount) {
+        this.cars = cars;
+        this.randomNumber = randomNumber;
+        this.tryCount = tryCount;
+    }
+
+    public void carRaceOnce() {
+        cars.move(randomNumber);
+    }
+
+    public int getTryCount() {
+        return tryCount;
+    }
+
+    public List<Car> findWinners() {
+        int maxPosition = cars.getMaxPosition();
+        return cars.carsAt(maxPosition);
+    }
+}

src/main/java/domain/RandomNumber.java

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

src/main/java/view/InputView.java

@@ -0,0 +1,25 @@
+package view;
+
+import java.util.Scanner;
+
+public class InputView {
+    private static Scanner scanner = new Scanner(System.in);
+
+    //자동차 이름 입력받기
+    //static 쓰면 클래스 전체에서 공유하는거라서, 객체 생성 안하고 바로 쓸수있음
+    public static String[] readCarName() {
+        System.out.println("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)");
+        String carNames = scanner.nextLine();
+        //쉼표기준으로 잘라서 넣게끔 하는거구나 split()
+        return carNames.split(",");
+    }
+
+    //자동차 생성시키기는 Cars로 옮겼음
+
+    //시도할 횟수 받기
+    public static int readTryCount() {
+        System.out.println("시도할 횟수는 몇회인가요?");
+        return scanner.nextInt();
+        //nextInt()는 콘솔 입력에서 정수 하나(다음 토큰)를 읽어서 int로 반환하는 메서드임.
+    }
+}

src/main/java/view/ResultView.java

@@ -0,0 +1,29 @@
+package view;
+
+import domain.Car;
+import domain.Cars;
+import java.util.ArrayList;
+import java.util.List;
+
+public class ResultView {
+
+    //라운드간 우승자 출력하기
+    public static void printRound(Cars carsList) {
+        for (Car car : carsList.getCars()) {
+            System.out.println(car.getCarName() + " : " + "-".repeat(car.getCarPosition()));
+        }
+        System.out.println();
+    }
+    //repeat()는 문자열 반복 메서드임. car.getCarPosition()만큼 "-"를 반복해서 출력하는거.
+
+    //최종 우승자 출력하기
+    public static void printFinalWinners(List<Car> winners) {
+        List<String> names = new ArrayList<>();
+        for (Car car : winners) {
+            names.add(car.getCarName()); // Car에서 이름만 뽑아서 새 리스트에 담음
+        }
+        System.out.println(String.join(", ", names) + "가 최종 우승했습니다.");
+    }
+    //String.join(", ", ["neo", "brown"]) → "neo, brown" 이렇게 합쳐주는거임.
+
+}