[자동차 경주 게임] 이영수 미션 제출합니다.

docs/README.md

@@ -0,0 +1,93 @@
+# 🏎️ java-racingcar
+
+
+##  ⚠️ 구현 전 체크리스트
+### 🖥️ 프로그래밍 요구 사항
+##### 프로젝트가 JDK 17 버전인가?
+
+##### Java 코드 컨벤션 가이드를 준수하기 위해 이를 알고 있는가?
+
+---  ### 📚 과제 진행 요구 사항
+
+##### 미션은 java-racingcar-6 저장소를 Fork & Clone 하는가?
+
+##### 기능 구현하기 전 docs/README.md 에 구현할 기능 목록을 정리해 추가하였는가?
+
+---  ### 🔘 기능 요구 사항
+
+#### 👦🏻 사용자 요구사항
+
+##### ✅ 사용자는 경주할 레이서들의 이름을 입력할 수 있다.
+	`camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다. 
+##### ✅ 사용자는 시도할 횟수를 입력할 수 있다.
+    `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다.
+
+#### 🔎 검증자 요구사항
+
+##### ✅ 사용자가 정해진 형식 ( 이름,이름,이름,... ) 에 맞게 입력 했는지 검증할 수 있다.
+    ` 형식이 맞지 않을시 , "입력된 값이 형식에 맞지 않습니다!" 메시지를 포함해 IllegalArgumentException 을 발생시킨다.
+
+##### ✅ 사용자가 입력한 이름들이 일정 길이 이하 ( Default : <=5 ) 인지 검증할 수 있다.
+    ` 일정 길이를 초과한 이름이 있을시 , "이름이 너무 깁니다!" 메시지를 포함해 IllegalArgumentException 을 발생시킨다.
+
+##### ✅ 사용자 입력한 이름에 중복이 있는지 검증할 수 있다.
+    ` 중복된 이름이 있을시 , "중복된 이름이 있습니다!" 메세지를 포함해 IllegalArgumentException 을 발생시킨다.
+
+##### ✅ 사용자 입력한 횟수가 양의 정수인지 검증할 수 있다.
+    ` 입력한 횟수가 양의 정수가 아닐 시 , "양의 정수를 입력해주세요!" 메시지를 포함해 IllegalArgumentException 을 발생시킨다.
+
+#### 🖥️서버 요구사항
+
+##### ✅ 해당 경주에 참여 하는 레이서 명단을 접수할 수 있다.
+
+##### ✅ 경주를 진행 하는 횟수를 접수할 수 있다.
+
+##### ✅ 경주를 시작할 수 있다.
+
+##### ✅ 경주 완료한 후 , 우승자 를 시상 한다.
+
+#### 🖨️ 출력자 요구사항
+
+##### ✅ 현재 경기 상황을 출력한다.
+
+##### ✅ 우승자를 출력한다.
+
+#### 🧑‍🔧 레이서 요구사항
+
+##### ✅ 자동차 공장에서 , 경주할 차를 받을수 있다.
+
+##### ✅ 자동차의 전진여부에 따라 , 현재 위치에서 일정 칸 전진할 수 있다.
+    ` 기본으로 정해진 일정 칸은 1칸이다.
+
+#### 🏎️ 자동차 요구사항
+
+##### ✅ 최소값 에서 최대값 사이의 무작위 숫자를 생성한다.
+	` camp.nextstep.edu.missionutils.Randoms`의 `pickNumberInRange()`를 활용한다.
+    ` 기본으로 정해진 최소값은 0 , 최대값은 9 이다.
+
+##### ✅ 무작위로 생성된 숫자가 일정 값 이상일 경우 전진할 수 있다.
+    ` 기본으로 정해진 일정 값은 4 이다.
+
+#### 🏭 자동차 공장 요구사항
+
+##### ✅ 새로운 차를 생성해서 줄 수 있다.
+
+
+##  🕶️ 구현 후 체크리스트
+
+###  🎯 프로그래밍 요구 사항
+
+#### 추가된 요구 사항
+
+##### ✅ indent 의 depth 가 3을 넘기지 않는가?
+##### ✅ 3항 연산자를 쓰지 않는가?
+##### ✅ 함수 와 메소드가 한 가지 일만 하는가?
+##### ✅ 위 기능 목록에 대한 테스트 코드를 전부 작성하였는가?
+
+
+##### ✅ System.exit() 를 호출하지 않는가?
+##### ✅ 프로그램 구현 완료 시 ApplicationTest 의 모든 테스트가 성공하는가?
+##### ✅ build.gradle 및 외부 라이브러리를 사용하지 않았는가?
+
+##### ✅ `camp.nextstep.edu.missionutils`에서 제공하는 `Randoms` 및 `Console` API를 사용하여 구현했는가?
+##### ✅ Java 코드 컨벤션 가이드 준수해 프로그래밍 했는가?

src/main/java/racingcar/Application.java

@@ -1,7 +1,22 @@
 package racingcar;
 
+import racingcar.player.Player;
+import racingcar.server.Server;
+
 public class Application {
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        Player player = new Player();
+        Server server = new Server();
+
+        System.out.println("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)");
+        String racerListString = player.getPlayerInput();
+        server.confirmRacerList(racerListString);
+
+        System.out.println("시도할 회수는 몇회인가요?");
+        String racerRoundString = player.getPlayerInput();
+        server.confirmRaceRound(racerRoundString);
+
+        server.startRace();
+        server.finishRace();
     }
 }

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

@@ -0,0 +1,19 @@
+package racingcar.car;
+
+import camp.nextstep.edu.missionutils.Randoms;
+import racingcar.configs.Config;
+
+public class Car {
+
+    public boolean checkCarSpeedIsExceedThreshold(){
+        int randomSpeed = generateRandomSpeed();
+        if (randomSpeed >= Config.FORWARD_THRESHOLD){
+            return true;
+        }
+        return false;
+    }
+    public int generateRandomSpeed(){
+        int randomSpeed = Randoms.pickNumberInRange(Config.MINIMUM_VALUE,Config.MAXIMUM_VALUE);
+        return randomSpeed;
+    }
+}

src/main/java/racingcar/car/CarFactory.java

@@ -0,0 +1,7 @@
+package racingcar.car;
+
+public class CarFactory {
+    public static Car getNewCarInstance(){
+        return new Car();
+    }
+}

src/main/java/racingcar/configs/Config.java

@@ -0,0 +1,9 @@
+package racingcar.configs;
+
+public class Config {
+    public final static Integer MINIMUM_VALUE = 0;
+    public final static Integer MAXIMUM_VALUE = 9;
+    public final static Integer FORWARD_THRESHOLD = 4;
+    public final static Integer FORWARD_DISTANCE = 1;
+    public final static String POS_INDICATOR = "-";
+}

src/main/java/racingcar/player/Player.java

@@ -0,0 +1,18 @@
+package racingcar.player;
+
+import camp.nextstep.edu.missionutils.Console;
+
+import java.util.NoSuchElementException;
+
+public class Player{
+    public static String inputErrorMessage = "입력을 해주세요!";
+    public String getPlayerInput(){
+
+        try {
+            String playerInput = Console.readLine();
+            return playerInput;
+        }catch (NoSuchElementException e){
+            throw new IllegalArgumentException(inputErrorMessage);
+        }
+    }
+}

src/main/java/racingcar/racer/Racer.java

@@ -0,0 +1,30 @@
+package racingcar.racer;
+
+import racingcar.car.Car;
+import racingcar.car.CarFactory;
+
+import racingcar.configs.Config;
+
+public class Racer {
+    private final String name;
+    private final Car raceCar;
+    private int currentPos;
+    public Racer(String racerName){
+        raceCar = CarFactory.getNewCarInstance();
+        name = racerName;
+        currentPos = 0;
+    }
+    public void runRaceEachStep(){
+        if (canMoveForward()){
+            currentPos+= Config.FORWARD_DISTANCE;
+        }
+    }
+    private boolean canMoveForward(){
+        return raceCar.checkCarSpeedIsExceedThreshold();
+    }
+    public int getCurrentPos(){
+        return currentPos;
+    }
+    public boolean isCarInitialized(){return raceCar!=null;};
+    public String getName(){return name;}
+}

src/main/java/racingcar/server/Server.java

@@ -0,0 +1,70 @@
+package racingcar.server;
+
+import racingcar.racer.Racer;
+
+import racingcar.utils.Printer;
+import racingcar.utils.Parser;
+import racingcar.utils.Validator;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class Server {
+    private List<Racer> racerList;
+    private int raceRound;
+    public Server(){
+        racerList = new ArrayList<>();
+    }
+
+    public void confirmRacerList(String racerListString){
+        Validator.validateUserInputIsCorrectFormat(racerListString);
+        List<String> racerNameList = Parser.parseStringToListSplitComma(racerListString);
+        addRacerToList(racerNameList);
+    }
+    private void addRacerToList(List<String> racerNameList){
+        for ( String racerName : racerNameList){
+            racerList.add(new Racer(racerName));
+        }
+    }
+    public void confirmRaceRound(String raceRoundString){
+        Validator.validateUserInputIsCorrectRound(raceRoundString);
+        int raceRound = Integer.parseInt(raceRoundString);
+        this.raceRound = raceRound;
+    }
+    public void startRace(){
+        System.out.println("실행 결과");
+        for (int i = 0; i < raceRound; i++){
+            continueRace();
+            Printer.printCurrentRaceResult(racerList);
+        }
+
+    }
+    private void continueRace(){
+        for (Racer racer : racerList){
+            racer.runRaceEachStep();
+        }
+    }
+    public void finishRace(){
+        List<String> winnerList = aggregateRaceResults();
+        Printer.printFinalResult(winnerList);
+    }
+    private List<String> aggregateRaceResults(){
+        int maxPos = 0;
+        for ( Racer racer : racerList){
+            int racerPos = racer.getCurrentPos();
+            if ( racerPos>= maxPos){
+                maxPos = racerPos;
+            }
+        }
+        List<String> winnerList = new ArrayList<>();
+        for ( Racer racer : racerList){
+            if ( racer.getCurrentPos() == maxPos){
+                winnerList.add(racer.getName());
+            }
+        }
+        return winnerList;
+    }
+    public List<Racer> getRacerList(){ return racerList; }
+    public int getRaceRound() { return raceRound;}
+
+}

src/main/java/racingcar/utils/Parser.java

@@ -0,0 +1,10 @@
+package racingcar.utils;
+
+import java.util.Arrays;
+import java.util.List;
+
+public class Parser {
+    public static List<String> parseStringToListSplitComma(String paringString){
+        return Arrays.asList(paringString.split(","));
+    }
+}

src/main/java/racingcar/utils/Printer.java

@@ -0,0 +1,27 @@
+package racingcar.utils;
+
+import racingcar.configs.Config;
+import racingcar.racer.Racer;
+
+import java.util.List;
+
+public class Printer {
+    public static void printCurrentRaceResult(List<Racer>racerList){
+        for (Racer racer : racerList){
+            String name = racer.getName();
+            Integer racerPos = racer.getCurrentPos();
+
+            StringBuilder sb = new StringBuilder();
+            sb.append(name).append(" : ").append(Config.POS_INDICATOR.repeat(racerPos));
+            System.out.println(sb.toString());
+        }
+        System.out.println();
+    }
+    public static void printFinalResult(List<String>winnerList){
+        StringBuilder sb = new StringBuilder();
+        sb.append("최종 우승자 : ");
+        sb.append(String.join(", ", winnerList));
+        System.out.println(sb.toString());
+    }
+
+}

src/main/java/racingcar/utils/Validator.java

@@ -0,0 +1,53 @@
+package racingcar.utils;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+public class Validator {
+    public static void validateUserInputIsCorrectFormat(String userInput){
+        List<String> toValidateRacerNameList = Parser.parseStringToListSplitComma(userInput);
+        for (String validateRacerName : toValidateRacerNameList){
+            validateRacerNameIsContainSpecificSymbol(validateRacerName);
+            validateRacerNameWithinMaxLength(validateRacerName);
+        }
+        validateRacerNameIsNotDuplicated(toValidateRacerNameList);
+    }
+    private static void validateRacerNameIsContainSpecificSymbol(String racerName){
+        for (char element : racerName.toCharArray()){
+            if (Character.isLetterOrDigit(element)){
+                continue;
+            }
+            throw new IllegalArgumentException("입력된 값이 형식에 맞지 않습니다!");
+        }
+    }
+    private static void validateRacerNameWithinMaxLength(String racerName){
+        if (racerName.length()>5){
+            throw new IllegalArgumentException("이름이 너무 깁니다!");
+        }
+    }
+    private static void validateRacerNameIsNotDuplicated(List<String> racerNameList){
+        Set<String> stringSet = new HashSet<>();
+        stringSet.addAll(racerNameList);
+        if (racerNameList.size() == stringSet.size())
+            return;
+        throw new IllegalArgumentException("중복된 이름이 있습니다!");
+    }
+    public static void validateUserInputIsCorrectRound(String userInput){
+        validateUserInputIsInteger(userInput);
+        Integer count = Integer.parseInt(userInput);
+        validateIntegerIsPositiveInteger(count);
+    }
+    private static void validateUserInputIsInteger(String userInput){
+        try{
+            Integer.parseInt(userInput);
+        }catch (NumberFormatException e){
+            throw new IllegalArgumentException("양의 정수를 입력해주세요!");
+        }
+    }
+    private static void validateIntegerIsPositiveInteger(Integer count){
+        if (count<=0){
+            throw new IllegalArgumentException("양의 정수를 입력해주세요!");
+        }
+    }
+}