자동차 경주 게임 PR

README.md

@@ -1,26 +1,38 @@
-## [NEXTSTEP 플레이그라운드의 미션 진행 과정](https://github.com/next-step/nextstep-docs/blob/master/playground/README.md)
+# 자동차 경주 게임
 
----
-## 학습 효과를 높이기 위해 추천하는 미션 진행 방법
+## 규칙
 
 ---
-1. 피드백 강의 전까지 미션 진행 
-> 피드백 강의 전까지 혼자 힘으로 미션 진행. 미션을 진행하면서 하나의 작업이 끝날 때 마다 add, commit
-> 예를 들어 다음 숫자 야구 게임의 경우 0, 1, 2단계까지 구현을 완료한 후 push
+- indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현한다. 2까지만 허용
+- else 예약어를 쓰지 않는다
+- 3항 연산자를 쓰지 않는다.
+- 함수(또는 메소드)가 한 가지 일만 하도록 최대한 작게 만들어라.
+- **모든 기능을 TDD로 구현해 단위 테스트가 존재해야 한다.**
+- **모든 원시 값과 문자열을 포장한다.**
+- **일급 컬렉션을 쓴다.**
+- **Getter를 쓰지 않는다.**
 
-![mission baseball](https://raw.githubusercontent.com/next-step/nextstep-docs/master/playground/images/mission_baseball.png)
+## 기능 요구사항
 
 ---
-2. 피드백 앞 단계까지 미션 구현을 완료한 후 피드백 강의를 학습한다.
+- 각 자동차에 이름을 부여할 수 있다. 자동차 이름은 5자를 초과할 수 없다.
+- 전진하는 자동차를 출력할 때 자동차 이름을 같이 출력한다.
+- 자동차 이름은 쉼표(,)를 기준으로 구분한다.
+- 전진하는 조건은 0에서 9 사이에서 random 값을 구한 후 random 값이 4이상일 경우이다.
+- 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. 우승자는 한명 이상일 수 있다.
 
----
-3. Git 브랜치를 master 또는 main으로 변경한 후 피드백을 반영하기 위한 새로운 브랜치를 생성한 후 처음부터 다시 미션 구현을 도전한다.
 
-```
-git branch -a // 모든 로컬 브랜치 확인
-git checkout master // 기본 브랜치가 master인 경우
-git checkout main // 기본 브랜치가 main인 경우
+## 구현 사항
 
-git checkout -b 브랜치이름
-ex) git checkout -b apply-feedback
-```
+---
+- [ ] 자동차 이름들을 입력한다.
+    - [x] "자동차 이름"은 5자를 초과 할 수 없다.
+- [ ] "시도 할 횟수"를 입력한다.
+    - [x] 시도 횟수는 음수 일 수 없다.
+- [x] 경기를 시작한다.
+- [x] "시도 횟수" 만큼 자동차들을 움직인다.
+  - [x] 모든 자동차를 움직인다.
+    - [x] 자동차를 움직인다.
+      - [x] 0 이상 9 이하의 랜덤 값을 받는다. 
+      - [x] 4 이상일 경우 한 칸 전진한다.
+- [ ] 우승자를 출력한다.

src/main/java/AbstractNumber.java

@@ -0,0 +1,17 @@
+public abstract class AbstractNumber {
+
+    private final int number;
+
+    public AbstractNumber(int number) {
+        this.number = number;
+    }
+
+    public boolean isMoreThan(int comparisonNumber) {
+        return comparisonNumber <= number;
+    }
+
+    public boolean isLessThan(int comparisonNumber) {
+        return comparisonNumber >= number;
+    }
+
+}

src/main/java/AbstractNumberFactory.java

@@ -0,0 +1,5 @@
+public abstract class AbstractNumberFactory {
+
+    abstract AbstractNumber produce();
+
+}

src/main/java/Car.java

@@ -0,0 +1,48 @@
+import java.util.Objects;
+
+public class Car {
+
+    private final Name name;
+    private Position position;
+    private final MoveStrategy strategy;
+
+    public Car(String name, int position, MoveStrategy strategy) {
+        this(name, strategy);
+        this.position = new Position(position);
+    }
+
+    public Car(String name, MoveStrategy strategy) {
+        validateMoveStrategy(strategy);
+        this.name = new Name(name);
+        this.position = new Position();
+        this.strategy = strategy;
+    }
+
+    private void validateMoveStrategy(MoveStrategy strategy) {
+        if (Objects.isNull(strategy)) {
+            throw new IllegalArgumentException("MoveStrategy must be not null");
+        }
+    }
+
+    public void move() {
+        this.position = strategy.move(this.position);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Car car = (Car) o;
+        return Objects.equals(name, car.name) && Objects.equals(position, car.position);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(name, position);
+    }
+
+}

src/main/java/Cars.java

@@ -0,0 +1,44 @@
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+public class Cars {
+
+    private final List<Car> cars = new ArrayList<>();
+
+    public Cars(List<Car> cars) {
+        validate(cars);
+        this.cars.addAll(cars);
+    }
+
+    private void validate(List<Car> cars) {
+        if (Objects.isNull(cars)) {
+            throw new IllegalArgumentException("cars는 Null일 수 없습니다.");
+        }
+        if (cars.isEmpty()) {
+            throw new IllegalArgumentException("cars는 Enpty 일 수 없습니다.");
+        }
+    }
+
+    public void move() {
+        cars.forEach(Car::move);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Cars cars1 = (Cars) o;
+        return Objects.equals(cars, cars1.cars);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(cars);
+    }
+
+}

src/main/java/MoveByRandomNumberStrategy.java

@@ -0,0 +1,19 @@
+public class MoveByRandomNumberStrategy implements MoveStrategy{
+
+    private final int MOVABLE_CAR_MIN_NUMBER = 4;
+    private final AbstractNumberFactory factory;
+
+    public MoveByRandomNumberStrategy(AbstractNumberFactory factory) {
+        this.factory = factory;
+    }
+
+    @Override
+    public Position move(Position position) {
+        AbstractNumber randomNumber = factory.produce();
+        if (randomNumber.isMoreThan(MOVABLE_CAR_MIN_NUMBER)) {
+            return position.moveOneStep();
+        }
+        return position;
+    }
+
+}

src/main/java/MoveStrategy.java

@@ -0,0 +1,3 @@
+public interface MoveStrategy {
+    Position move(Position position);
+}

src/main/java/Name.java

@@ -0,0 +1,38 @@
+import java.util.Objects;
+
+public class Name {
+
+    private final int MAX_NAME_LENGTH = 5;
+    private final String NAME_LENGTH_OVER_MESSAGE = "자동차 이름은 5자를 초과할 수 없다.";
+
+    private final String name;
+
+    public Name(String name) {
+        validate(name);
+        this.name = name;
+    }
+
+    private void validate(String name) {
+        if (Objects.isNull(name) || name.length() > MAX_NAME_LENGTH) {
+            throw new IllegalArgumentException(NAME_LENGTH_OVER_MESSAGE);
+        }
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Name name1 = (Name) o;
+        return Objects.equals(name, name1.name);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(name);
+    }
+
+}

src/main/java/Position.java

@@ -0,0 +1,45 @@
+import java.util.Objects;
+
+public class Position {
+
+    private final int ZERO = 0;
+
+    private final int step;
+
+    public Position() {
+        this.step = ZERO;
+    }
+
+    public Position(int step) {
+        validate(step);
+        this.step = step;
+    }
+
+    private void validate(int step) {
+        if (step < ZERO) {
+            throw new IllegalArgumentException("step에 음수를 입력할 수 없습니다.");
+        }
+    }
+
+    public Position moveOneStep() {
+        return new Position(step + 1);
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Position position1 = (Position) o;
+        return step == position1.step;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(ZERO, step);
+    }
+
+}

src/main/java/Race.java

@@ -0,0 +1,19 @@
+public class Race {
+
+    private TryCount tryCount;
+
+    private final Cars cars;
+
+    public Race(int tryCount, Cars cars) {
+        this.tryCount = new TryCount(tryCount);
+        this.cars = cars;
+    }
+
+    public void start() {
+        while (!this.tryCount.isComplete()) {
+            cars.move();
+            this.tryCount = tryCount.getNextTryCount();
+        }
+    }
+
+}

src/main/java/RangeableRandomNumber.java

@@ -0,0 +1,23 @@
+public class RangeableRandomNumber extends AbstractNumber {
+
+    private static final int MIN_RANDOM_NUMBER = 0;
+    private static final int MAX_RANDOM_NUMBER = 9;
+
+    private final int max;
+
+    private final int min;
+
+    public RangeableRandomNumber(int number) {
+        super(number);
+        this.max = MAX_RANDOM_NUMBER;
+        this.min = MIN_RANDOM_NUMBER;
+        validate(number);
+    }
+
+    private void validate(int number) {
+        if (number < min || number > max) {
+            throw new IllegalArgumentException("RangeableRandomNumber는 " + min + " 보다 크고 " + max + "보다 작아야 합니다.");
+        }
+    }
+
+}

src/main/java/RangeableRandomNumberFactory.java

@@ -0,0 +1,18 @@
+import java.util.Random;
+
+public class RangeableRandomNumberFactory extends AbstractNumberFactory {
+
+    public final int MAX_RANDOM_NUMBER = 9;
+
+    private final Random random;
+
+    public RangeableRandomNumberFactory() {
+        random = new Random();
+    }
+
+    @Override
+    public AbstractNumber produce() {
+        return new RangeableRandomNumber(random.nextInt(MAX_RANDOM_NUMBER));
+    }
+
+}