[자동차 경주 게임] 최현구 미션 제출합니다.

README.md

@@ -1,4 +1,99 @@
 # 미션 - 자동차 경주 게임
+## 🔍 객체 목록
+- Car 객체
+    - Car가 아는 것
+        - 자신의 이름
+        - 자신의 위치
+    - Car가 하는 것
+        - position 이동
+        - 자신의 position 상태 반환
+        - 자신이 우승자인지 판단
+    - 유저 입력에 따른 Car 이름 설정
+    - 유저 입력 예외처리
+- Cars 객체 (일급 컬렉션?)
+    - Cars가 아는 것
+        - Car 리스트
+    - Cars가 하는 것
+        - Car 들에게 각자의 position 반환 요청
+        - Car 들에게 각자 우승자인지 판별요청
+- GasTank 객체
+    - GasTank가 아는 것
+        - 정지, 출발 기준
+    - GasTank가 하는 것
+        - 정지, 출발 결정
+- Lap 객체
+    - Lap이 아는 것
+        - 최종 lap
+        - 현재 lap
+    - Lap이 하는 것
+        - 최종 lap과 현재 lap 비교
+- ~~Track 객체~~ Racing 컨트롤러
+    - Racing이 아는 것
+        - (없음)
+    - Racing이 하는 것
+        - Lap만큼 Racing 루프 반복하기
+        - 도메인들의 메서드 결과 View에 전달하기
+
+<br>
+
+## 🎯 구현할 기능 목록
+- 멈춤(0-3), 전진(4-9) 구현 ✔️
+    - 0~9 랜덤 값 클래스 Gas 구현 ✔️
+- 유저 입력에 따른 멈춤, 전진 기능 반복 ✔️
+    - 유저 입력 예외처리 ✔️
+- 최종 우승자 출력 구현 ✔️
+- 시도 회수별 게임 진행 상황(실행 결과) 출력 ✔
+
+<br>
+
+## 🤔 예외처리 목록
+- 자동차 이름️ ✔️
+    - 5자리 초과️ ✔️
+    - 빈 문자열 ✔️
+    - ',' 이외 빈 문자열 혹은 공백(space) ✔️
+    - 중복 이름 ✔️
+- Track 루프 횟수 ✔️
+    - 숫자가 아닌 경우 ✔️
+    - 빈 문자열 ✔️
+    - 음수인 경우 ✔️
+
+
+<br>
+
+## 😅 ️꾸준히 확인할 목록
+- README.md 가 죽지 않도록 꾸준히 업데이트
+- **접근제한 꼼꼼하게 확인하기**
+    - 인스턴스/클래스 변수는 최대한 숨기자
+- **static 남발하지 않기**
+    - 객체의 필드(인스턴스 변수, 멤버)가 없는 경우에만 클래스(static) 메소드 생성
+    - 객체의 전체 인스턴스 수를 파악하기 위한 클래스(static) 변수 사용
+        - (인스턴스 추적을 위해서만 상위 class를 개설하는 것은 낭비)
+- **확장성 계속 고려하기**
+    - Car
+        - Car 객체가 랜덤 확률이 아닌 다른 로직으로 이동할 땐?
+        - 랜덤 확률을 이용하는 다른 이동수단 객체(Boat, Airplane)가 생길 땐?
+- **객체 끌어오지 말고 메세지만 보내라**
+    - "현관 비밀번호 바꿔라"를 기억하자
+- 의미 없는 주석 달지 않기
+    - 메소드, 변수 명을 더 상세하게 달자
+- 문자열, 숫자를 하드코딩 하지 말자
+    - static final 로 상수처리
+    - ~~상수전용 클래스 생성을 고려해보자~~
+    - 상수는 사용되는 클래스에 있는게 좋아보인다
+- 구현 순서도 convention 이다
+    ```java
+    class A {
+        1. 상수(static final) 또는 클래스 변수
+        2. 인스턴스 변수
+        3. 생성자
+        4. 메소드
+    }
+    ```
+- 일급 컬렉션을 공부하고, 적용해보자
+- 단순한 데이터도 최대한 포장하자
+- 검증은 View보다 해당 객체 생성자에서 진행하자
+
+<br>
 
 ## 🚀 기능 요구사항
 - 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.

src/main/java/racingcar/Application.java

@@ -3,8 +3,11 @@
 import java.util.Scanner;
 
 public class Application {
+
     public static void main(String[] args) {
         final Scanner scanner = new Scanner(System.in);
         // TODO 구현 진행
+        Racing racing = new Racing();
+        racing.start(scanner);
     }
 }

src/main/java/racingcar/Car.java

@@ -1,12 +1,75 @@
 package racingcar;
 
+import java.util.ArrayList;
+
 public class Car {
+
+    private static final String ENTER_LINE = "\n";
+    private static final String WHITE_SPACE = " ";
+    private static final String NO_STRING = "";
+    private static final String COLON = " : ";
+    private static final String DASH = "-";
+    private static final int MAX_LENGTH = 5;
+    private static final int EMPTY = 0;
+
     private final String name;
+    private final GasTank gasTank;
     private int position = 0;
 
-    public Car(String name) {
+    private Car(String name) {
+        validateEmpty(name);
+        validateLength(name);
         this.name = name;
+        this.gasTank = GasTank.randomChargeGasTank();
     }
 
     // 추가 기능 구현
+    public static Car newCar(String name) {
+        return new Car(name);
+    }
+
+    public void tryForward() {
+        if (gasTank.isEnoughGas()) {
+            position++;
+        }
+    }
+
+
+    private void validateEmpty(String name) {
+        if (name.length() == EMPTY || name.replaceAll(WHITE_SPACE, NO_STRING).length() == EMPTY) {
+            throw new IllegalArgumentException("자동차 이름을 입력해주세요.");
+        }
+    }
+
+    private void validateLength(String name) {
+        if (name.length() > MAX_LENGTH) {
+            throw new IllegalArgumentException("각 자동차의 이름은 5자 이하여야 합니다.");
+        }
+    }
+
+    public void currentPosition(StringBuilder positions) {
+        positions.append(name);
+        positions.append(COLON);
+        positions.append(convertPosition());
+        positions.append(ENTER_LINE);
+    }
+
+    private StringBuilder convertPosition() {
+        StringBuilder position = new StringBuilder();
+        for (int i = 0; i < this.position; i++) {
+            position.append(DASH);
+        }
+        return position;
+    }
+
+    public int award(ArrayList<String> winners, int max_distance) {
+        if (max_distance < position) {
+            winners.clear();
+            max_distance = position;
+        }
+        if (max_distance == position) {
+            winners.add(name);
+        }
+        return max_distance;
+    }
 }

src/main/java/racingcar/Cars.java

@@ -0,0 +1,77 @@
+package racingcar;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.Set;
+
+public class Cars {
+
+    private static final String WHITE_SPACE = " ";
+    private static final String NO_STRING = "";
+    private static final String COMMA = ",";
+    private static final char CHAR_COMMA = ',';
+    private static final int EMPTY = 0;
+    private static final int INIT_ZERO = 0;
+
+    private final ArrayList<Car> cars;
+
+    private Cars(String carNames) {
+        validateEmpty(carNames);
+        validateCommaCount(carNames);
+        validateDuplicate(carNames);
+        this.cars = enrollCars(carNames);
+    }
+
+    public static Cars newCars(String carNames) {
+        return new Cars(carNames);
+    }
+
+
+    private void validateEmpty(String carNames) {
+        if (carNames.replaceAll(WHITE_SPACE, NO_STRING).length() == EMPTY) {
+            throw new IllegalArgumentException("자동차 이름을 입력해주세요.");
+        }
+    }
+
+
+    private void validateCommaCount(String carNames) {
+        if (carNames.charAt(carNames.length() - 1) == CHAR_COMMA) {
+            throw new IllegalArgumentException("자동차 이름이 충분히 입력되지 않았습니다.");
+        }
+    }
+
+    private void validateDuplicate(String carNames) {
+        ArrayList<String> listCarNames = new ArrayList<>(Arrays.asList(carNames.split(COMMA)));
+        Set<String> setCarNames = new HashSet<>(Arrays.asList(carNames.split(COMMA)));
+        if (listCarNames.size() != setCarNames.size()) {
+            throw new IllegalArgumentException("중복된 이름은 안됩니다.");
+        }
+    }
+
+    private ArrayList<Car> enrollCars(String carNames) {
+        ArrayList<Car> cars = new ArrayList<>();
+        for (String carName : carNames.split(COMMA)) {
+            cars.add(Car.newCar(carName));
+        }
+        return cars;
+    }
+
+    public StringBuilder continueRacing() {
+        StringBuilder positions = new StringBuilder();
+        for (Car car : cars) {
+            car.tryForward();
+            car.currentPosition(positions);
+        }
+        return positions;
+    }
+
+    public ArrayList<String> awardWinners() {
+        ArrayList<String> winners = new ArrayList<>();
+        int max_distance = INIT_ZERO;
+        for (Car car : cars) {
+            max_distance = car.award(winners, max_distance);
+        }
+        return winners;
+    }
+}

src/main/java/racingcar/GasTank.java

@@ -0,0 +1,21 @@
+package racingcar;
+
+import utils.RandomUtils;
+
+public class GasTank {
+
+    private static final int MIN_GAS = 0;
+    private static final int MAX_GAS = 9;
+    private static final int ENOUGH_GAS = 4;
+
+    private GasTank() {
+    }
+
+    public static GasTank randomChargeGasTank() {
+        return new GasTank();
+    }
+
+    public boolean isEnoughGas() {
+        return RandomUtils.nextInt(MIN_GAS, MAX_GAS) >= ENOUGH_GAS;
+    }
+}

src/main/java/racingcar/Lap.java

@@ -0,0 +1,37 @@
+package racingcar;
+
+public class Lap {
+
+    private static final int ZERO = 0;
+
+    private final int lap;
+    private int currentLap = 0;
+
+    private Lap(String lap) {
+        int validateLap = validateInteger(lap);
+        validateOverZero(validateLap);
+        this.lap = validateLap;
+    }
+
+    public static Lap newLap(String lap) {
+        return new Lap(lap);
+    }
+
+    private int validateInteger(String lap) {
+        try {
+            return Integer.parseInt(lap);
+        } catch (NumberFormatException e) {
+            throw new IllegalArgumentException("시도 횟수는 숫자여야 합니다.");
+        }
+    }
+
+    private void validateOverZero(int lap) {
+        if (lap <= ZERO) {
+            throw new IllegalArgumentException("시도 횟수는 1 이상이어야 합니다.");
+        }
+    }
+
+    public boolean isEnd() {
+        return currentLap++ == lap;
+    }
+}

src/main/java/racingcar/Racing.java

@@ -0,0 +1,39 @@
+package racingcar;
+
+import java.util.Scanner;
+
+public class Racing {
+
+    public void start(Scanner scanner) {
+        Cars cars = entryCars(scanner);
+        Lap lap = entryLap(scanner);
+
+        View.printStartRacing();
+        while (!lap.isEnd()) {
+            View.printRacing(cars.continueRacing());
+        }
+        View.printWinners(cars.awardWinners());
+    }
+
+    private Cars entryCars(Scanner scanner) {
+        while (true) {
+            try {
+                View.printPleaseInputCars();
+                return Cars.newCars(scanner.nextLine());
+            } catch (IllegalArgumentException e) {
+                View.printError(e.getMessage());
+            }
+        }
+    }
+
+    private Lap entryLap(Scanner scanner) {
+        while (true) {
+            try {
+                View.printPleaseInputLap();
+                return Lap.newLap(scanner.nextLine());
+            } catch (IllegalArgumentException e) {
+                View.printError(e.getMessage());
+            }
+        }
+    }
+}