[전남대 BE_나제법] 미션 제출합니다.

README.md

@@ -1 +1,92 @@
-# java-racingcar-precourse
+# java-racingcar-precourse
+***
+## 패키지 구조
+***
+```
+├── RacingGameApplication.java
+├── config
+│   └── constant
+│       └── Rule.java
+├── controller
+│   └── RacingGameController.java
+├── domain
+│   ├── Car.java
+│   └── Cars.java
+├── exception
+│   └── constant
+│       └── ErrorMessage.java
+├── util
+│   └── RandomNumberGenerator.java
+├── validator
+│   ├── AttemptCountValidator.java
+│   └── CarNameValidator.java
+└── view
+    ├── InputView.java
+    ├── OutputView.java
+    └── constant
+        ├── InputMessage.java
+        └── OutputMessage.java
+```
+
+### config 패키지
+> 게임 설정과 관련된 파일이 위치합니다.  
+* `Rule.java`
+  * 레이싱 게임을 진행함에 있어 지켜야 할 규칙에 대해 상수로 정의합니다.
+
+### controller 패키지
+> Model과 View를 이어주는 Controller가 위치합니다.
+* `RacingGameController.java`
+  * 레이싱 게임을 진행하기 위한 컨트롤러
+
+### domain 패키지
+> 레이싱 게임을 구성하기 위한 도메인이 위치합니다.
+* `Car.java`
+  * 레이싱 게임에 참여하는 한 대의 자동차를 의미합니다.
+
+
+* `Cars.java`
+  * 레이싱 게임에 참여하는 자동차들의 집합을 의미합니다.
+  * 자동차의 집합 중 승자를 판단할 수 있습니다.
+
+### exception 패키지
+> 레이싱 게임 진행 중 발생하는 예외에 대한 정보가 위치합니다.
+* `ErrorMessage.java`
+  * 게임 중 발생하는 예외 메시지에 대해 정의합니다.
+
+### util 패키지
+> 게임 진행에 필요한 유틸리티 클래스들이 위치합니다.
+* `RandomNumberGenerator.java`
+  * 자동차를 움직이기 위한 난수를 발생시킵니다.
+
+### validator 패키지
+> 게임에 사용되는 검증기가 위치합니다.
+* `AttemptCountValidator.java`
+  * 레이싱 실행 횟수에 대하여 검증합니다.
+    * 입력값이 숫자가 맞는지 검증합니다.
+    * 입력값이 양의 정수가 맞는지 검증합니다.   
+
+
+* `CarNameValidator.java`
+  * 자동차 이름에 대한 검증을 실시합니다.
+    * 이름이 존재하는지 검증합니다.
+    * 이름의 길이가 적절한지 검증합니다.
+    * 이름에 빈 문자열이 있는지 검증합니다.
+    * 이름 입력에 대해 중복이 존재하는지 검증합니다.
+
+### view 패키지
+> view 계층이 위치합니다.
+* `InputView.java`
+  * 입력에 필요한 내용을 출력합니다.
+  * 적절한 입력이 발생할 때까지 사용자로부터 입력을 받습니다.
+
+
+* `OutputView.java`
+  * 게임의 결과에 대해 출력합니다.
+
+
+* `InputMessage.java`
+  * 입력에 필요한 메시지를 정의합니다.
+
+
+* `OutputMessage.java`
+  * 출력에 필요한 메시지를 정의합니다.

src/main/java/game/RacingGameApplication.java

@@ -0,0 +1,18 @@
+package game;
+
+import game.controller.RacingGameController;
+import game.view.InputView;
+import game.view.OutputView;
+import java.util.Scanner;
+
+public class RacingGameApplication {
+
+    public static void main(String[] args) {
+        InputView inputView = new InputView(new Scanner(System.in));
+        OutputView outputView = new OutputView();
+        RacingGameController racingGameController = new RacingGameController(inputView, outputView);
+
+        racingGameController.startGame();
+    }
+
+}

src/main/java/game/config/constant/Rule.java

@@ -0,0 +1,14 @@
+package game.config.constant;
+
+public class Rule {
+
+    private Rule() {
+    }
+
+    public static final String NAME_DELIMITER = ",";
+    public static final int MAX_NAME_LENGTH = 5;
+    public static final int MIN_NAME_LENGTH = 1;
+    public static final int MAX_RANDOM_VALUE = 9;
+    public static final int MOVEMENT_THRESHOLD = 4;
+    public static final String CAR_POSITION_MAKER = "-";
+}

src/main/java/game/controller/RacingGameController.java

@@ -0,0 +1,33 @@
+package game.controller;
+
+import game.domain.Cars;
+import game.view.InputView;
+import game.view.OutputView;
+import game.view.constant.OutputMessage;
+import java.util.List;
+
+public class RacingGameController {
+
+    private InputView inputView;
+    private OutputView outputView;
+
+    public RacingGameController(InputView inputView, OutputView outputView) {
+        this.inputView = inputView;
+        this.outputView = outputView;
+    }
+
+    public void startGame() {
+        List<String> carNames = inputView.enterCarNames();
+        Cars cars = Cars.fromCarNames(carNames);
+
+        int attemptCount = inputView.enterAttemptCount();
+        System.out.println(OutputMessage.RESULT);
+        for (int i = 0; i < attemptCount; i++) {
+            cars.move();
+            outputView.printResult(cars);
+        }
+
+        outputView.printWinner(cars);
+    }
+
+}

src/main/java/game/domain/Car.java

@@ -0,0 +1,69 @@
+package game.domain;
+
+import game.config.constant.Rule;
+import game.validator.CarNameValidator;
+import java.util.Objects;
+
+public class Car {
+
+    private final String name;
+    private int position;
+
+    public Car(String name) {
+        this(name, 0);
+    }
+
+    public Car(String name, int position) {
+        CarNameValidator.validateNameLength(name);
+        this.name = name;
+        this.position = position;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public int getPosition() {
+        return position;
+    }
+
+    public int move(int randomValue) {
+        if(canMove(randomValue)) {
+            this.position++;
+        }
+        return this.position;
+    }
+
+    private boolean canMove(int randomValue) {
+        return randomValue >= Rule.MOVEMENT_THRESHOLD;
+    }
+
+    public boolean isWinner(int maxPosition) {
+        return position == maxPosition;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Car car = (Car) o;
+        return position == car.position && Objects.equals(name, car.name);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(name, position);
+    }
+
+    @Override
+    public String toString() {
+        return "Car{" +
+            "name='" + name + '\'' +
+            ", position=" + position +
+            '}';
+    }
+}

src/main/java/game/domain/Cars.java

@@ -0,0 +1,91 @@
+package game.domain;
+
+import game.config.constant.Rule;
+import game.exception.constant.ErrorMessage;
+import game.util.RandomNumberGenerator;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.List;
+import java.util.NoSuchElementException;
+import java.util.Objects;
+
+public class Cars {
+
+    private List<Car> carList;
+
+    private Cars(List<Car> carList) {
+        this.carList = carList;
+    }
+
+    public static Cars fromCarNames(List<String> carNames) {
+        return new Cars(carNames.stream().map(Car::new).toList());
+    }
+
+    public static Cars fromCarList(List<Car> carList) {
+        return new Cars(carList);
+    }
+
+    public void move() {
+        carList.forEach(car -> car.move(RandomNumberGenerator.getNumber(Rule.MAX_RANDOM_VALUE)));
+    }
+
+    public Cars findWinners() {
+        int maxPosition = getMaxPosition();
+        List<Car> winners = carList.stream()
+            .filter(car -> car.isWinner(maxPosition))
+            .toList();
+        return new Cars(winners);
+    }
+
+    public int getMaxPosition() {
+        return carList.stream()
+            .map(Car::getPosition)
+            .max(Comparator.naturalOrder())
+            .orElseThrow(() -> new NoSuchElementException(ErrorMessage.EMPTY_LIST.getMessage()));
+    }
+
+    public List<String> getCarNames() {
+        return carList.stream().map(Car::getName).toList();
+    }
+
+    public List<Car> getCarList() {
+        return Collections.unmodifiableList(carList);
+    }
+
+    /**
+     * 리스트의 순서와 상관없이 내부 원소만 비교하여 동등성을 판단합니다
+     *
+     * @param o 비교할 Cars 인스턴스
+     * @return 동등여부
+     */
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Cars cars = (Cars) o;
+        return new HashSet<>(carList).equals(new HashSet<>(cars.getCarList()));
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(carList);
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder stringBuilder = new StringBuilder();
+        stringBuilder.append("Cars = ");
+        carList.forEach(car ->
+            stringBuilder.append("(")
+                .append(car.getName())
+                .append(", position: ")
+                .append(car.getPosition())
+                .append(")"));
+        return stringBuilder.toString();
+    }
+}

src/main/java/game/exception/constant/ErrorMessage.java

@@ -0,0 +1,22 @@
+package game.exception.constant;
+
+import static game.config.constant.Rule.*;
+
+public enum ErrorMessage {
+
+    INVALID_NAME_LENGTH("[ERROR] %d ~ %d 글자를 벗어난 이름이 존재합니다!".formatted(MIN_NAME_LENGTH, MAX_NAME_LENGTH)),
+    DUPLICATE_NAME_FOUND("[ERROR] 중복된 이름이 존재합니다!"),
+    INVALID_NUMBER_INPUT("[ERROR] 숫자를 입력해주세요!"),
+    INVALID_ATTEMPT_COUNT_INPUT("[ERROR] 1 이상의 숫자를 입력해주세요!"),
+    EMPTY_LIST("[ERROR] 리스트가 비어 있습니다!");
+    private final String message;
+
+    ErrorMessage(String message) {
+        this.message = message;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+
+}

src/main/java/game/util/RandomNumberGenerator.java

@@ -0,0 +1,21 @@
+package game.util;
+
+import java.util.Random;
+
+public class RandomNumberGenerator {
+
+    private static Random random = new Random();
+
+    private RandomNumberGenerator() {
+    }
+
+    /**
+     * 파라미터로 전달받은 범위 안에서 무작위 음이 아닌 정수를 반환합니다.
+     * @param maxRange 난수의 최댓값
+     * @return 음이 아닌 정수
+     */
+    public static int getNumber(int maxRange) {
+        return random.nextInt(maxRange + 1);
+    }
+
+}