Final practice

docs/README.md

@@ -0,0 +1,75 @@
+# 자동차 경주 게임
+
+## 어플리케이션 흐름
+
+1. 자동차 이름 입력
+    1. 자동차 이름은 ,로 구분
+        - 입력이 `,`로 끝나는 경우 예외 발생
+    2. 각 이름은 5자 이하만 가능
+    3. 자동차 이름은 중복될 수 없다.
+2. 이동 시도 횟수 입력
+    1. 숫자 입력시 예외 발생
+    2. 0, 또는 음수 입력시 예외 발생
+3. 각 라운드 별 이동 시도 후 결과 출력
+4. 최종 우승자 출력
+
+## 어플리케이션 구성
+
+### domain
+
+#### \[Car]
+
+#### Car
+
+이름과 위치 정보를 가진다.
+
+- 기능
+    - 숫자를 입력받아 이동 가능하다면 위치 정보를 업데이트 후 이동 여부를 반환한다.
+
+#### Cars
+
+자동차 객체들을 관리한다.
+
+- 기능
+    - 숫자를 생성해 각 자동차 객체를 이동시킨다.
+    - 자동차들의 진행 결과를 받아온다.
+    - 우승자의 이름을 반환한다.
+
+#### \[numberGenerator]
+
+#### MoveNumber
+
+이동에 사용할 숫자를 래핑한다.
+
+#### NumberGenerator
+
+- 기능
+    - 숫자 하나를 반환한다.
+
+#### RandomNumberGenerator
+
+- 기능
+    - 0~9 사이에서 랜덤으로 숫자를 생성해 반환한다.
+
+### view
+
+#### InputView
+
+- 기능
+    - 자동차 이름 입력
+        - `,`를 기준으로 나눠서 List<String> 반환
+    - 시도할 횟수 입력
+        - 시도 횟수가 0 이하라면 예외 발생
+
+#### OutputView
+
+- 기능
+    - 라운드 결과 출력
+    - 최종 우승자 출력
+
+## 고민
+
+자동차의 위치 정보는 어느 곳에서 저장하는 것이 가장 자연스러울까?
+-> 출력에서도 Car 객체를 그대로 넘기자. 그렇기에 자동차의 위치 정보 또한 자동차에서 관리하자
+우승자 비교는 어떤 식으로 구현하는 것이 가장 자연스러울까?
+-> 자동차들의 경주 결과 비교는 자동차의 책임이 아닌, 게임 스태프의 책임으로 생각했음

docs/최종코테_준비.md

@@ -0,0 +1,45 @@
+# 최종 코테를 대비하기 위해 어떤 준비가 가능할까
+
+- 필요없는 고민을 줄이기
+    - 어떤 메서드에만 `static`을 사용할 지 기준 미리 정하기
+    - DTO를 사용할지, getter를 사용할지 미리 정하기
+        - 나는 getter를 사용하기로 결정
+    - 검증 로직을 Validator로 분리할지, 도메인 내부에서 모두 검증할지 정하기
+    - 전체 어플리케이션 흐름 관리를 어디서 할지 정하기
+        - Application.main() 활용할 것 같음
+    - 상수 추출은 어떻게 할지 기준 세우기
+        - `enum`은 언제 사용할지
+        - 각 클래스 내부 VS 상수 클래스
+        - 상수 클래스 VS 인터페이스
+    - 의존성 주입 -> 별도의 Config 클래스 만들지 말기 (그냥 파라미터로 주입정도만)
+    - 각 디자인 패턴을 사용할 기준 정하기
+        - 빌더 패턴은 시간이 오래 걸리니 사용 X
+        - 전략 패턴
+            - 예외 처리
+        - 정적 팩토리 메서드
+            - 생성자의 파라미터로 필드값 자체를 전달해 주는 것이 아니라 로직이 필요한 경우
+    - 출력 메시지 상수로 관리할 지 정하기 -> 상수로 X
+    - Javadoc -> X
+    - 인터페이스 VS 추상클래스
+    - 상속 VS 조합
+    - Optional VS enum의 "유효하지 않음" 값
+- 리팩토링 우선순위 정하기
+- README.md 작성 연습
+- 정규 표현식 연습하기
+
+- 리팩토링 리스트
+    - 단위 테스트
+    - 상수 추출
+    - 메서드 추출
+    - 원시값 래핑
+    - 추상화 제공
+    - 네이밍
+        - 네이밍에 변수 타입 넣지 말기
+    - 통합 테스트
+
+## 기억할 것
+
+- 꾸준히 기능 단위로 커밋하기
+- 변수는 선언시 무조건 `private final`, 나중에 필요하면 변경
+- 조건 연산자를 사용한 코드는 조건 연산자 앞에서 줄바꿈
+- Console 닫아주기

src/main/java/racingcar/Application.java

@@ -1,7 +1,23 @@
 package racingcar;
 
+import racingcar.domain.InitController;
+import racingcar.domain.PlayController;
+import racingcar.domain.car.Cars;
+
 public class Application {
+    private static final InitController initController = new InitController();
+    private static final PlayController playController = new PlayController();
+
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        Cars cars = initController.initCars();
+        int rounds = initController.getRounds();
+        initController.closeConsole();
+
+        playController.printResultTitle();
+        for (int round = 0; round < rounds; round++) {
+            playController.move(cars);
+            playController.printRoundResult(cars);
+        }
+        playController.printWinner(cars);
     }
 }

src/main/java/racingcar/RacingConst.java

@@ -0,0 +1,10 @@
+package racingcar;
+
+public interface RacingConst {
+    int RACING_NUMBER_START = 0;
+    int RACING_NUMBER_END = 9;
+    int RACING_NUMBER_MOVE = 4;
+
+    String DELIMITER = ",";
+    String WINNER_DELIMITER = ", ";
+}

src/main/java/racingcar/domain/InitController.java

@@ -0,0 +1,23 @@
+package racingcar.domain;
+
+import java.util.List;
+import racingcar.domain.car.Cars;
+import racingcar.domain.numbergenerator.RandomNumberGenerator;
+import racingcar.view.InputView;
+
+public class InitController {
+    private final InputView inputView = new InputView();
+
+    public Cars initCars() {
+        List<String> names = inputView.getNames();
+        return new Cars(names, new RandomNumberGenerator());
+    }
+
+    public int getRounds() {
+        return inputView.getRoundNumber();
+    }
+
+    public void closeConsole() {
+        inputView.closeConsole();
+    }
+}

src/main/java/racingcar/domain/PlayController.java

@@ -0,0 +1,28 @@
+package racingcar.domain;
+
+import java.util.List;
+import racingcar.domain.car.Car;
+import racingcar.domain.car.Cars;
+import racingcar.view.OutputView;
+
+public class PlayController {
+    private final OutputView outputView = new OutputView();
+
+    public void move(Cars cars) {
+        cars.move();
+    }
+
+    public void printResultTitle() {
+        outputView.printResultTitle();
+    }
+
+    public void printRoundResult(Cars cars) {
+        List<Car> roundResult = cars.getCars();
+        outputView.printRountResult(roundResult);
+    }
+
+    public void printWinner(Cars cars) {
+        List<String> winnerNames = cars.getWinner();
+        outputView.printWinners(winnerNames);
+    }
+}

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

@@ -0,0 +1,35 @@
+package racingcar.domain.car;
+
+import racingcar.domain.numbergenerator.MoveNumber;
+
+public class Car {
+    private static final int INIT_POSITION = 0;
+    private static final int DISTANCE_INCREASE = 1;
+    private final CarName name;
+    private int position;
+
+    public Car(String name) {
+        this.name = new CarName(name);
+        this.position = INIT_POSITION;
+    }
+
+    public boolean move(MoveNumber number) {
+        if (number.canMove()) {
+            this.position += DISTANCE_INCREASE;
+            return true;
+        }
+        return false;
+    }
+
+    public boolean at(int position) {
+        return this.position == position;
+    }
+
+    public String getName() {
+        return name.getName();
+    }
+
+    public int getPosition() {
+        return position;
+    }
+}

src/main/java/racingcar/domain/car/CarName.java

@@ -0,0 +1,23 @@
+package racingcar.domain.car;
+
+import racingcar.exception.RacingException;
+
+public class CarName {
+    public static final int NAME_MAX_LEN = 5;
+    private final String name;
+
+    public CarName(String name) {
+        validateName(name);
+        this.name = name;
+    }
+
+    private void validateName(String name) {
+        if (name.isBlank() || name.length() > NAME_MAX_LEN) {
+            throw RacingException.INVALID_CARS_NAME.makeException();
+        }
+    }
+
+    public String getName() {
+        return name;
+    }
+}

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

@@ -0,0 +1,61 @@
+package racingcar.domain.car;
+
+import java.util.List;
+import racingcar.domain.numbergenerator.NumberGenerator;
+import racingcar.exception.RacingException;
+
+public class Cars {
+    private final List<Car> cars;
+    private final NumberGenerator numberGenerator;
+
+    public Cars(List<String> carNames, NumberGenerator numberGenerator) {
+        validateCars(carNames);
+        cars = carNames.stream()
+                .map(Car::new)
+                .toList();
+        this.numberGenerator = numberGenerator;
+    }
+
+    private void validateCars(List<String> carNames) {
+        validateNotEmpty(carNames);
+        validateNotDuplicated(carNames);
+    }
+
+    private void validateNotDuplicated(List<String> carNames) {
+        int distinctSize = (int) carNames.stream()
+                .distinct()
+                .count();
+        if (distinctSize != carNames.size()) {
+            throw RacingException.DUPLICATE_CARS_NAME.makeException();
+        }
+    }
+
+    private void validateNotEmpty(List<String> carNames) {
+        if (carNames.isEmpty()) {
+            throw RacingException.NO_CAR_FOUNDED.makeException();
+        }
+    }
+
+    public void move() {
+        cars.forEach(car -> car.move(numberGenerator.generate()));
+    }
+
+    public List<Car> getCars() {
+        return cars;
+    }
+
+    public List<String> getWinner() {
+        int winnersPosition = getWinnersPosition();
+        return cars.stream()
+                .filter(car -> car.at(winnersPosition))
+                .map(Car::getName)
+                .toList();
+    }
+
+    private int getWinnersPosition() {
+        return cars.stream()
+                .mapToInt(Car::getPosition)
+                .max()
+                .getAsInt();
+    }
+}

src/main/java/racingcar/domain/numbergenerator/MoveNumber.java

@@ -0,0 +1,23 @@
+package racingcar.domain.numbergenerator;
+
+import racingcar.RacingConst;
+import racingcar.exception.RacingException;
+
+public class MoveNumber {
+    private final int number;
+
+    public MoveNumber(int number) {
+        validateNumber(number);
+        this.number = number;
+    }
+
+    private void validateNumber(int number) {
+        if (number < RacingConst.RACING_NUMBER_START || number > RacingConst.RACING_NUMBER_END) {
+            throw RacingException.INVALID_NUMBERS.makeException();
+        }
+    }
+
+    public boolean canMove() {
+        return this.number >= RacingConst.RACING_NUMBER_MOVE;
+    }
+}

src/main/java/racingcar/domain/numbergenerator/NumberGenerator.java

@@ -0,0 +1,10 @@
+package racingcar.domain.numbergenerator;
+
+@FunctionalInterface
+public interface NumberGenerator {
+    default MoveNumber generate() {
+        return new MoveNumber(pickNumber());
+    }
+
+    int pickNumber();
+}

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

@@ -0,0 +1,14 @@
+package racingcar.domain.numbergenerator;
+
+import camp.nextstep.edu.missionutils.Randoms;
+import racingcar.RacingConst;
+
+public class RandomNumberGenerator implements NumberGenerator {
+
+    @Override
+    public int pickNumber() {
+        return Randoms.pickNumberInRange(RacingConst.RACING_NUMBER_START,
+                RacingConst.RACING_NUMBER_END);
+    }
+
+}