[스프링 화요일 3팀] 차서영 미션 제출합니다.

README.md

@@ -2,3 +2,80 @@
 
 자동차 경주 미션 저장소
 
+## 설정 사항
+
+- (중요) JDK 17 버전으로 진행한다.
+
+## **기능 요구사항**
+
+- 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.
+- 각 자동차에 이름을 부여할 수 있다. 전진하는 자동차를 출력할 때 자동차 이름을 같이 출력한다.
+- 자동차 이름은 쉼표(,)를 기준으로 구분하며 이름은 5자 이하만 가능하다.
+- 사용자는 몇 번의 이동을 할 것인지를 입력할 수 있어야 한다.
+- 전진하는 조건은 0에서 9 사이에서 random 값을 구한 후 random 값이 4 이상일 경우 전진하고, 3 이하의 값이면 멈춘다.
+- 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. 우승자는 한 명 이상일 수 있다.
+
+## **실행 결과**
+
+- 위 요구사항에 따라 3대의 자동차가 5번 움직였을 경우 프로그램을 실행한 결과는 다음과 같다.
+
+```
+경주할 자동차 이름을 입력하세요(이름은 쉼표(,)를 기준으로 구분).
+kokodak,kuku,cucu
+시도할 회수는 몇회인가요?
+5
+실행 결과
+kokodak : -
+kuku : -
+cucu : -
+kokodak : --
+kuku : -
+cucu : --
+kokodak : ---
+kuku : --
+cucu : ---
+kokodak : ----
+kuku : ---
+cucu : ----
+kokodak : -----
+kuku : ----
+cucu : -----
+kokodak : -----
+kuku : ----
+cucu : -----
+kokodak, cucu가 최종 우승했습니다.
+```
+
+## **프로그래밍 요구사항**
+
+- **모든 로직에 단위 테스트를 구현한다. 단, UI(System.out, System.in) 로직은 제외**
+- **자바 코드 컨벤션을 지키면서 프로그래밍한다.**
+    - 참고문서: https://google.github.io/styleguide/javaguide.html 또는 https://myeonguni.tistory.com/1596
+- **`규칙 1: 한 메서드에 오직 한 단계의 들여쓰기(indent)만 한다.`**를 지키며 구현한다.
+    - 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
+    - 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메소드)를 분리하면 된다.
+- **`규칙 2: else 예약어를 쓰지 않는다.`**를 지키며 구현한다.
+    - 힌트: if 조건절에서 값을 return하는 방식으로 구현하면 else를 사용하지 않아도 된다.
+    - else를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.
+- **함수(또는 메소드)의 길이가 15라인을 넘어가지 않도록 구현한다.**
+    - 함수(또는 메소드)가 한 가지 일만 잘 하도록 구현한다.
+
+**MVC 패턴으로 리팩터링 후의 main 메소드 예시**
+
+```java
+import view.InputView;
+import view.ResultView;
+import domain.RacingGame;
+
+public class RacingMain {
+    public static void main(final String... args) {
+        final var carNames = InputView.getCarNames();
+        final var tryCount = InputView.getTryCount();
+
+        final var racingGame = new RacingGame(carNames, tryCount);
+        racingGame.race();
+
+        ResultView.printWinners(racingGame.getWinners());
+    }
+}
+```

docs/README.md

@@ -0,0 +1,39 @@
+# domain
+- ## Car(자동차) ##
+    - 이름
+    - 전진 거리
+
+- ## CarName(자동차 이름) ##
+    - 미입력 or 5글자 초과 확인
+
+- ## Distance(이동 거리) ##
+    - 정지 or 거리 증가
+
+- ## Cars(자동차 리스트) ##
+    - 자동차들의 정보(중복 이름 X)
+    - 우승자 판별
+
+- ## TryConut(시도 횟수) ##
+    - 음수 입력 X (횟수 상한은 없나??)
+
+# ~~dto~~
+
+# controller
+- 이름 입력받아서 Cars로 저장
+
+# utils
+- ## Parser ##
+    - 이름: 쉼표 기준으로 분리
+    - 시도 횟수
+
+- ## RandomNumberGenerator ##
+    - 0~9 랜덤 숫자 생성기
+
+# view
+- ## InputView ##
+    - 자동차 이름 입력
+    - 시도 횟수 입력
+
+- ## OutView ##
+    - 실행 결과 출력
+    - 우승자 출력

src/main/java/controller/RacingcarController.java

@@ -0,0 +1,4 @@
+package controller;
+
+public class RacingcarController {
+}

src/main/java/domain/Car.java

@@ -0,0 +1,28 @@
+package domain;
+
+public class Car {
+
+    private static final int CAN_MOVE_NUMBER = 4;
+    private final CarName carName;
+    private final Distance distance;
+
+
+    public Car(String carName) {
+        this.carName = new CarName(carName);
+        this.distance = new Distance();
+    }
+
+    public void move(int number) {
+        if (number >= CAN_MOVE_NUMBER) {
+            distance.increaseDistance();
+        }
+    }
+
+    public String getCarName() {
+        return carName.getCarName();
+    }
+
+    public int getDistance() {
+        return distance.getDistance();
+    }
+}

src/main/java/domain/CarName.java

@@ -0,0 +1,23 @@
+package domain;
+
+public class CarName {
+    private final String carName;
+
+    public CarName(String carName) {
+        validateCarName(carName);
+        this.carName = carName;
+    }
+
+    public String getCarName() {
+        return carName;
+    }
+
+    private void validateCarName(String carName) {  //이름 글자수 확인(없거나, 5글자 초과일 시)
+        if (carName.isEmpty()) {
+            throw new IllegalArgumentException("이름이 반드시 존재해야 합니다.");
+        }
+        if (carName.length() > 5) {
+            throw new IllegalArgumentException("이름은 5글자 이하여야 합니다.");
+        }
+    }
+}

src/main/java/domain/Cars.java

@@ -0,0 +1,53 @@
+package domain;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+public class Cars {
+
+    private static final String DUPLICATED_NAMES_MASSAGE= "자동차의 이름은 중복될 수 없습니다.";
+    private static final int DEFAULT_DISTANCE = 0;
+    private final List<Car> cars;
+
+    public Cars(List<String> carNames) {
+        final List<Car> cars= generateCars(carNames);
+        validateDuplication(carNames);
+        this.cars = cars;
+    }
+
+    private List<Car> generateCars(List<String> cars) {
+        return cars.stream()
+                .map(Car::new)
+                .collect(Collectors.toList());
+    }
+
+//    이름 중복 확인
+    private void validateDuplication(List<String> carNames) {
+        Set<String> duplicationCheck = new HashSet<>(carNames);
+        if (carNames.size() != duplicationCheck.size()) {
+            throw new IllegalArgumentException(DUPLICATED_NAMES_MASSAGE);
+        }
+    }
+
+//    최대 이동 거리 구하기
+    private int findMaxDistance() {
+        return cars.stream()
+                .mapToInt(Car::getDistance)
+                .max()
+                .orElse(DEFAULT_DISTANCE);
+    }
+
+//    최대 이동 거리와 같은 위치에 있는 자동차들 찾기
+    public List<Car> findWinner() {
+        int maxDistance = findMaxDistance();
+        return cars.stream()
+                .filter(car -> car.getDistance() == maxDistance)
+                .collect(Collectors.toList());
+    }
+
+    public List<Car> getCars() {
+        return cars;
+    }
+}

src/main/java/domain/Distance.java

@@ -0,0 +1,19 @@
+package domain;
+
+public class Distance {
+
+    private static final int INITIAL_VALUE = 0;
+    private int distance;
+
+    public Distance() {
+        this.distance = INITIAL_VALUE;
+    }
+
+    public void increaseDistance() {
+        distance++;
+    }
+
+    public int getDistance() {
+        return distance;
+    }
+}

src/main/java/domain/TryCount.java

@@ -0,0 +1,32 @@
+package domain;
+
+public class TryCount {
+
+    private static final String NOT_POSITIVE_INTEGER_MESSAGE = "시도 횟수는 양의 정수여야 합니다";
+    private static final int MINIMUM_COUNT = 1;
+
+    private int tryCount;
+
+    public TryCount(int tryCount) {
+        validate(tryCount);
+        this.tryCount = tryCount;
+    }
+
+    private void validate(int tryCount) {
+        if (tryCount <= 0) {
+            throw new IllegalArgumentException(NOT_POSITIVE_INTEGER_MESSAGE);
+        }
+    }
+
+    public void decrease() {
+        tryCount--;
+    }
+
+    public boolean isRemain() {
+        return tryCount >= MINIMUM_COUNT;
+    }
+
+    public int getTryCount() {
+        return tryCount;
+    }
+}

src/main/java/utils/Parser.java

@@ -0,0 +1,23 @@
+package utils;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class Parser {
+
+    private static final String NOT_POSITIVE_INTEGER = "시도 횟수는 정수여야 합니다";
+    public static List<String> parseNames(String input) {
+        return Arrays.stream(input.split(","))
+                .map(String::trim)
+                .collect(Collectors.toList());
+    }
+
+    public static int parseCount(String input) {
+        try {
+            return Integer.parseInt(input);
+        } catch (NumberFormatException e) {
+            throw new IllegalArgumentException(NOT_POSITIVE_INTEGER);
+        }
+    }
+}

src/main/java/utils/RandomNumberGenerator.java

@@ -0,0 +1,7 @@
+package utils;
+
+public class RandomNumberGenerator {
+    public int generate() {
+        return (int) (Math.random()*10);
+    }
+}

src/main/java/view/InputView.java

@@ -0,0 +1,29 @@
+package view;
+
+import utils.Parser;
+
+import java.util.List;
+import java.util.Scanner;
+
+public class InputView {
+    private static final String READ_CAR_NAMES_MESSAGE = "경주할 자동차 이름을 입력하세요(이름은 쉼표(,)를 기준으로 구분).";
+    private static final String READ_TRY_COUNT_MESSAGE = "시도할 횟수는 몇회인가요?";
+
+    private final Scanner scanner;
+
+    public InputView(Scanner scanner) {
+        this.scanner = scanner;
+    }
+
+    public List<String> readCarNames() {
+        System.out.println(READ_CAR_NAMES_MESSAGE);
+        String input = scanner.nextLine();
+        return Parser.parseNames(input);
+    }
+
+    public int readTryCount() {
+        System.out.println(READ_TRY_COUNT_MESSAGE);
+        String input = scanner.nextLine();
+        return Parser.parseCount(input);
+    }
+}

src/main/java/view/OutputView.java

@@ -0,0 +1,39 @@
+package view;
+
+import domain.Car;
+import domain.Cars;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class OutputView {
+
+    private static final String RESULT_MESSAGE = "실행 결과";
+    private static final String STATUS_FORMAT = "%s : %s\n";
+    private static final String WINNER_FORMAT = "%s가 최종 우승했습니다.";
+    private static final String HYPHEN = "-";
+
+    public void printResult() {
+        System.out.println(RESULT_MESSAGE);
+    }
+
+    public void printStatus(List<Car> cars) {
+        for (Car car : cars) {
+            String currentDistance = getCurrentDistance(car.getDistance());
+            System.out.printf(STATUS_FORMAT, car.getCarName(), currentDistance);
+        }
+        System.out.println();
+    }
+
+    public void printWinners(List<Car> cars) {
+        List<String> carNames = cars.stream()
+                .map(Car::getCarName)
+                .toList();
+        String winners = String.join(",", carNames);
+        System.out.printf(WINNER_FORMAT, winners);
+    }
+
+    private String getCurrentDistance(int distance) {
+        return HYPHEN.repeat(distance);
+    }
+}