[그리디] 김하늘 자동차 경주 미션 3, 4단계 제출합니다.

README.md

@@ -0,0 +1,34 @@
+#자동차 경주 미션
+
+##기능
+
+- 자동차 이름 입력: 쉼표(,)로 구분된, 1자 이상 5자 이하의 자동차 이름을 입력받는다.
+- 시도 횟수 입력: 경주를 진행할 총 라운드 수를 입력받는다.
+- 전진 또는 정지: 각 자동차는 매 라운드마다 0~9 사이의 무작위 값을 생성하여, 4 이상일 경우 전진한다.
+- 라운드별 결과 출력: 매 라운드가 끝날 때마다 모든 자동차의 현재 위치를 출력한다.
+- 최종 우승자 발표: 경주가 끝난 후, 가장 멀리 전진한 자동차를 최종 우승자로 발표한다. (공동 우승 가능)
+
+##조건
+
+- MVC 패턴을 적용하여 역할을 분리한다.
+- 모든 로직에 단위 테스트를 구현한다.
+- indent(인덴트, 들여쓰기) depth를 2를 넘지 않도록 구현한다.
+- 3항 연산자를 쓰지 않는다.
+- else 예약어를 쓰지 않는다.
+- 함수(또는 메소드)의 길이가 15라인을 넘어가지 않도록 구현한다.
+- 함수(또는 메소드)가 한 가지 일만 잘 하도록 구현한다.
+
+##프로젝트 구조
+
+- model
+    * Car.java: 자동차 객체 (이름, 위치 상태 및 유효성 검사)
+    * Cars.java: 자동차 목록을 관리하는 일급 컬렉션
+    * MoveCarStrategy.java: NumberGenerator에 따라 자동차 이동 여부를 결정하는 전략.
+    * Race.java: 경주 상태 및 로직 관리
+    * NumberGenerator: 숫자 생성을 위한 인터페이스
+    * RandomNumberGenerator:NumberGenerator의 구현체
+- controller
+    * RacingGameController.java: 게임 전체 흐름 관리
+- view
+    * InputView.java: 사용자 입력 담당
+    * OutputView.java: 결과 출력 담당

src/main/java/RaceMain.java

@@ -0,0 +1,11 @@
+import controller.RacingGameController;
+import model.strategy.NumberGenerator;
+import model.strategy.RandomNumberGenerator;
+
+public class RaceMain {
+    public static void main(String[] args) {
+        NumberGenerator numberGenerator = new RandomNumberGenerator();
+        RacingGameController controller = new RacingGameController(numberGenerator);
+        controller.run();
+    }
+}

src/main/java/controller/RacingGameController.java

@@ -0,0 +1,51 @@
+package controller;
+
+import model.domain.Car;
+import model.domain.Cars;
+import model.strategy.MoveCarStrategy;
+import model.strategy.NumberGenerator;
+import model.domain.Race;
+import view.InputView;
+import view.OutputView;
+
+import java.util.List;
+
+public class RacingGameController {
+
+    private final NumberGenerator numberGenerator;
+
+    public RacingGameController(NumberGenerator numberGenerator) {
+        this.numberGenerator = numberGenerator;
+    }
+
+    public void run() {
+        Cars cars = setupCars();
+        Race race = new Race(cars, new MoveCarStrategy(numberGenerator));
+
+        int rounds = InputView.readRounds();
+        runRace(race, rounds);
+        OutputView.printWinners(race.getWinners());
+
+        InputView.close();
+    }
+
+    private Cars setupCars() {
+        String[] carNames = InputView.readCarNames();
+        return Cars.fromNames(List.of(carNames));
+    }
+
+    private void runRace(Race race, int rounds) {
+        OutputView.printRaceStartMessage();
+        for (int i = 0; i < rounds; i++) {
+            race.runRound();
+            printCurrentPositions(race.getCars());        }
+    }
+
+    private void printCurrentPositions(List<Car> cars) {
+        for (Car car : cars) {
+            OutputView.printSingleCarStatus(car.getCarName(), car.getPosition());
+        }
+        OutputView.printNewLine();
+    }
+
+}

src/main/java/model/domain/Car.java

@@ -0,0 +1,40 @@
+package model.domain;
+
+public class Car {
+
+    private static final int MOVE_DISTANCE = 1;
+    private static final int MAX_NAME_LENGTH = 5;
+
+    private final String carName;
+    private int position;
+
+    private Car(String name) {
+        this.carName = name;
+        this.position = 0;
+    }
+
+    public static Car fromName(String name) {
+        String trimmedName = name.trim();
+        validateName(trimmedName);
+        return new Car(trimmedName);
+    }
+
+    private static void validateName(String name) {
+        if (name.length() > MAX_NAME_LENGTH) {
+            throw new IllegalArgumentException("자동차 이름은 5자 이하만 가능합니다.");
+        }
+    }
+
+    public void moveForward() {
+        position += MOVE_DISTANCE;
+    }
+
+    public String getCarName() {
+        return carName;
+    }
+
+    public int getPosition() {
+        return position;
+    }
+
+}

src/main/java/model/domain/Cars.java

@@ -0,0 +1,49 @@
+package model.domain;
+
+import model.strategy.MoveCarStrategy;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class Cars {
+
+    private final List<Car> cars;
+
+    public Cars(List<Car> cars) {
+        this.cars = cars;
+    }
+
+    public static Cars fromNames(List<String> carNames) {
+        List<Car> carList = carNames.stream()
+                .map(Car::fromName)
+                .collect(Collectors.toList());
+        return new Cars(carList);
+    }
+
+    public void moveEachCar(MoveCarStrategy moveCarStrategy) {
+        for (Car car : cars) {
+            moveCarStrategy.tryMove(car);
+        }
+    }
+
+    public List<String> findWinners() {
+        int maxPosition = getMaxPosition();
+        return cars.stream()
+                .filter(car -> car.getPosition() == maxPosition)
+                .map(Car::getCarName)
+                .collect(Collectors.toList());
+    }
+
+    private int getMaxPosition() {
+        return cars.stream()
+                .mapToInt(Car::getPosition)
+                .max()
+                .orElse(0);
+    }
+
+    public List<Car> getCars() {
+        return Collections.unmodifiableList(cars);
+    }
+
+}

src/main/java/model/domain/Race.java

@@ -0,0 +1,29 @@
+package model.domain;
+
+import model.strategy.MoveCarStrategy;
+
+import java.util.List;
+
+public class Race {
+
+    private Cars cars;
+    private MoveCarStrategy moveCarStrategy;
+
+    public Race(Cars cars, MoveCarStrategy moveCarStrategy) {
+        this.cars = cars;
+        this.moveCarStrategy = moveCarStrategy;
+    }
+
+    public void runRound() {
+        cars.moveEachCar(moveCarStrategy);
+    }
+
+    public List<String> getWinners() {
+        return cars.findWinners();
+    }
+
+    public List<Car> getCars() {
+        return cars.getCars();
+    }
+
+}

src/main/java/model/strategy/MoveCarStrategy.java

@@ -0,0 +1,27 @@
+package model.strategy;
+
+import model.domain.Car;
+
+public class MoveCarStrategy {
+
+    private static final int MOVE_THRESHOLD = 4;
+
+    private final NumberGenerator numberGenerator;
+
+    public MoveCarStrategy(NumberGenerator numberGenerator) {
+        this.numberGenerator = numberGenerator;
+    }
+
+    public void tryMove(Car car) {
+        int randomNumber = numberGenerator.generate();
+
+        if (shouldMove(randomNumber)) {
+            car.moveForward();
+        }
+    }
+
+    private boolean shouldMove(int randomNumber) {
+        return randomNumber >= MOVE_THRESHOLD;
+    }
+
+}

src/main/java/model/strategy/NumberGenerator.java

@@ -0,0 +1,5 @@
+package model.strategy;
+
+public interface NumberGenerator {
+    int generate();
+}

src/main/java/model/strategy/RandomNumberGenerator.java

@@ -0,0 +1,14 @@
+package model.strategy;
+
+import java.util.Random;
+
+public class RandomNumberGenerator implements NumberGenerator {
+
+    private static final Random random = new Random();
+    private static final int RANDOM_NUMBER_BOUND = 10;
+
+    @Override
+    public int generate() {
+        return random.nextInt(RANDOM_NUMBER_BOUND);
+    }
+}

src/main/java/view/InputView.java

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

src/main/java/view/OutputView.java

@@ -0,0 +1,31 @@
+package view;
+
+import model.domain.Car;
+
+import java.util.List;
+
+public class OutputView {
+
+    public static void printSingleCarStatus(String name, int position) {
+        System.out.print(name + " : ");
+        printPosition(position);
+        System.out.println();
+    }
+
+    public static void printNewLine() {
+        System.out.println();
+    }
+
+    public static void printRaceStartMessage() {
+        System.out.println("\n실행 결과");
+    }
+
+    private static void printPosition(int position) {
+        System.out.print("-".repeat(position));
+    }
+
+    public static void printWinners(List<String> winners) {
+        System.out.println(String.join(", ", winners) + "가 최종 우승했습니다.");
+    }
+
+}

src/test/java/model/domain/CarTest.java

@@ -0,0 +1,41 @@
+package model.domain;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.DisplayNameGeneration;
+import org.junit.jupiter.api.DisplayNameGenerator;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+@DisplayName("model.domain.Car 클래스 테스트")
+@SuppressWarnings("NonAsciiCharacters")
+@DisplayNameGeneration(DisplayNameGenerator.ReplaceUnderscores.class)
+public class CarTest {
+
+    @Test
+    void 자동차_생성_시_이름과_초기_위치가_올바르게_설정된다() {
+        String name = "car";
+
+        Car car = Car.fromName(name);
+
+        assertEquals(name, car.getCarName());
+        assertEquals(0, car.getPosition());
+    }
+
+    @Test
+    void moveForward_호출_시_위치가_1_증가한다() {
+        Car car = Car.fromName("car");
+
+        car.moveForward();
+
+        assertEquals(1, car.getPosition());
+    }
+
+    @Test
+    void 자동차_이름이_5자를_초과하면_예외가_발생한다() {
+        String carName = "testCar";
+
+        assertThrows(IllegalArgumentException.class, () -> Car.fromName(carName));
+    }
+}