Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[숫자 야구 게임] 조동현 미션 제출합니다. #423

Closed
wants to merge 43 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
75866fa
docs(readme): README에 구현할 기능 목록 작성
devHudi Nov 24, 2021
a33fb4a
feat: 목표 랜덤 숫자 생성
devHudi Nov 24, 2021
53516fa
docs(readme): 목표 숫자 (랜덤 숫자) 생성 기능 개발 완료 반영
devHudi Nov 24, 2021
653c3ce
feat: 사용자에게 3자리 숫자 입력 받기
devHudi Nov 24, 2021
a28cf18
docs(readme): 사용자에게 3자리 숫자 입력받기 기능 개발 완료 반영
devHudi Nov 25, 2021
bf18da2
docs(readme): 고려할 예외 사항 목록 작성
devHudi Nov 25, 2021
43bc617
refactor: Numbers 클래스를 상속하는 TargetNumbers 클래스 구현
devHudi Nov 25, 2021
15c0eec
docs(readme): 반복 입력 받기를 구현 기능 목록에 추가
devHudi Nov 25, 2021
54d4d8f
feat: 입력 숫자 비교 및 결과 계산 기능 구현
devHudi Nov 25, 2021
7586de5
docs(readme): 입력 숫자 비교 및 결과 계산 기능 개발 완료 반영
devHudi Nov 25, 2021
33ce97a
docs(readme): 처리한 예외 사항 반영
devHudi Nov 25, 2021
137abfb
feat: 사용자에게 입력받은 숫자에 대한 힌트 표시 구현
devHudi Nov 25, 2021
fcc5071
docs(readme): 힌트 표시 기능 구현 목록 반영
devHudi Nov 25, 2021
c598dd9
fix(hint): 낫싱 표기 누락 해결
devHudi Nov 25, 2021
9732277
feat: 사용자가 모든 숫자를 맞출 때 까지 반복 입력받는 기능 구현
devHudi Nov 25, 2021
7a96d01
docs(readme): 반복 입력 기능 구현 완료 기능 목록에 반영
devHudi Nov 25, 2021
39e1874
feat: 게임 종료, 재시작 선택 기능 구현
devHudi Nov 25, 2021
e28e874
docs(readme): 게임 종료, 재시작 기능 구현 반영
devHudi Nov 25, 2021
03df57f
docs(readme): 구현할 기능 목록에 게임 재시작시 목표숫자 재생성 추가
devHudi Nov 25, 2021
c8bc592
feat: 게임 재시작시 목표 숫자 재생성 구현
devHudi Nov 25, 2021
e703194
docs(readme): 구현할 기능 목록 중 게임 재시작시 목표 숫자 재생성 완료 표시
devHudi Nov 25, 2021
e0e5658
refactor: 숫자가 아닌 문자열에 대한 예외처리를 Number 가 아닌 Numbers 클래스에서 하도록 개선
devHudi Nov 25, 2021
1fb1f10
style: 각 import 그룹 사이 빈줄 추가
devHudi Nov 29, 2021
efd6c16
style: 한줄로 선언된 두개의 변수를 두줄로 분할
devHudi Nov 29, 2021
447b0aa
refactor: 메서드명을 더 명확하게 변경
devHudi Nov 29, 2021
0865ff4
style: 한줄로 선언된 두개의 변수를 두줄로 분할
devHudi Nov 29, 2021
e555b8b
style: 한줄로 끝나는 조건문에 중괄호 추가
devHudi Nov 29, 2021
6eb89f2
rafactor: Numbers 클래스의 find 메소드가 받는 인자의 형을 int에서 Number 로 변경
devHudi Nov 29, 2021
1310558
style: 클래스 최 상단 빈줄 제거
devHudi Nov 29, 2021
afe82d2
refactor: TargetNumbers 클래스의 compare 메소드 이름을 compareTo 로 변경
devHudi Nov 29, 2021
45abbae
refactor: Game 클래스의 start 메소드 이름을 startGame 으로 변경
devHudi Nov 29, 2021
6778047
refactor: 게임 종료 후 재시작 입력을 담는 RestartOrQuitSelection 클래스를 정의하여 로직 개선
devHudi Nov 29, 2021
5ff8d32
refactor: 입력값에 대한 예외를 validateRange 함수에서 직접 throw 하도록 변경
devHudi Nov 29, 2021
6c7fbb4
refactor: InputView가 사용자로부터 숫자를 입력받아 직접 Numbers 객체를 반환하도록 개선
devHudi Nov 29, 2021
aa3a527
refactor: Hint 클래스를 더 직관적인 이름인 PredictionResult 로 변경
devHudi Nov 29, 2021
d2337b8
refactor: PredictionResult 에 직접 승리 여부를 확인할 수 있는 isWin 메소드 추가
devHudi Nov 29, 2021
2725598
refactor: 가독성 향상을 위해 startGame 메소드 로직을 do while 로 개선
devHudi Nov 29, 2021
537aaba
refactor: 사용자로부터 숫자를 입력받는 로직을 startRound 로부터 분리
devHudi Nov 29, 2021
aabd269
refactor: Game 클래스의 startRound 메소드의 접근제어자를 public 에서 private 으로 변경
devHudi Nov 29, 2021
19ff070
refactor: Numbers 에서 find 대신 hasNumber, isSamePosition 메소드를 제공하도록 개선
devHudi Nov 29, 2021
bbf3c32
refactor: Numbers 클래스의 생성자 인자 유효성 검증을 각 메소드로 분리하여 구현
devHudi Nov 29, 2021
dbd4194
fix: 음수를 입력하면 정상 숫자로 인식하는 오류 해결
devHudi Nov 29, 2021
1bcb587
refactor: 상수 이름을 의미가 명확하게 변경
devHudi Nov 29, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
139 changes: 13 additions & 126 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,130 +1,17 @@
# 미션 - 숫자 야구 게임
## 구현할 기능 목록

## 🔍 진행방식
- [X] 목표 숫자 (랜덤 숫자) 생성
- [x] 사용자에게 3자리 숫자 입력받기
- [x] 사용자에게 입력받은 숫자와 목표 숫자 비교하여, 결과 계산하기
- [x] 사용자에게 입력받은 숫자에 대한 힌트 표시하기
- [x] 사용자가 모든 숫자를 맞출 때 까지 반복하여 입력받기
- [x] 게임 종료 후 새로 시작 및 종료 선택하는 로직 추가하기
- [x] 게임 재시작시 목표 숫자 재 생성

- 미션은 **기능 요구사항, 프로그래밍 요구사항, 과제 진행 요구사항** 세 가지로 구성되어 있다.
- 세 개의 요구사항을 만족하기 위해 노력한다. 특히 기능을 구현하기 전에 기능 목록을 만들고, 기능 단위로 커밋 하는 방식으로 진행한다.
## 고려할 예외 사항 목록

## ✉️ 미션 제출 방법
- [x] 사용자가 숫자가 아닌 값을 입력했을 때 처리
- [x] 사용자가 아무 값도 입력하지 않았을 때 처리
- [x] 사용자가 3자리가 아닌 숫자를 입력했을 때 처리
- [x] 사용자가 재시작 관련 입력을 1, 2 이외의 값을 입력했을 때 처리

- 미션 구현을 완료한 후 GitHub을 통해 제출해야 한다.
- GitHub을 활용한 제출 방법은 [프리코스 과제 제출 문서](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse) 를 참고해 제출한다.
- GitHub에 미션을 제출한 후 [우아한테크코스 지원 플랫폼](https://apply.techcourse.co.kr) 에 접속하여 프리코스 과제를 제출한다.
- 자세한 방법은 [링크](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse#제출-가이드) 를 참고한다.
- **Pull Request만 보내고, 지원 플랫폼에서 과제를 제출하지 않으면 최종 제출하지 않은 것으로 처리되니 주의한다.**

## ✔️ 과제 제출 전 체크리스트 - 0점 방지

- 터미널에서 `java -version`을 실행해 자바 8인지 확인한다. 또는 Eclipse, IntelliJ IDEA와 같은 IDE의 자바 8로 실행하는지 확인한다.
- 터미널에서 맥 또는 리눅스 사용자의 경우 `./gradlew clean test`, 윈도우 사용자의 경우 `gradlew.bat clean test` 명령을 실행했을 때 모든 테스트가 통과하는지 확인한다.

---

## 🚀 기능 요구사항

기본적으로 1부터 9까지 서로 다른 수로 이루어진 3자리의 수를 맞추는 게임이다.

- 같은 수가 같은 자리에 있으면 스트라이크, 다른 자리에 있으면 볼, 같은 수가 전혀 없으면 포볼 또는 낫싱이란 힌트를 얻고, 그 힌트를 이용해서 먼저 상대방(컴퓨터)의 수를 맞추면 승리한다.
- 예) 상대방(컴퓨터)의 수가 425일 때
- 123을 제시한 경우 : 1스트라이크
- 456을 제시한 경우 : 1볼 1스트라이크
- 789를 제시한 경우 : 낫싱
- 위 숫자 야구 게임에서 상대방의 역할을 컴퓨터가 한다. 컴퓨터는 1에서 9까지 서로 다른 임의의 수 3개를 선택한다. 게임 플레이어는 컴퓨터가 생각하고 있는 3개의 숫자를 입력하고, 컴퓨터는 입력한 숫자에 대한 결과를 출력한다.
- 이 같은 과정을 반복해 컴퓨터가 선택한 3개의 숫자를 모두 맞히면 게임이 종료된다.
- 게임을 종료한 후 게임을 다시 시작하거나 완전히 종료할 수 있다.
- 사용자가 잘못된 값을 입력할 경우 `IllegalArgumentException`을 발생시킨 후 애플리케이션은 종료되어야 한다.
- 아래의 프로그래밍 실행 결과 예시와 동일하게 입력과 출력이 이루어져야 한다.

<br>

## ✍🏻 입출력 요구사항

### ⌨️ 입력

- 3자리의 수
- 게임이 끝난 경우 재시작/종료를 구분하는 1과 2 중 하나의 수

### 🖥 출력

- 입력한 수에 대한 결과를 볼, 스트라이크 개수로 표시

```
1볼 1스트라이크
```

- 하나도 없는 경우

```
낫싱
```

- 3개의 숫자를 모두 맞힐 경우

```
3스트라이크
3개의 숫자를 모두 맞히셨습니다! 게임 종료
```

### 💻 프로그래밍 실행 결과 예시

```
숫자를 입력해주세요 : 123
1볼 1스트라이크
숫자를 입력해주세요 : 145
1볼
숫자를 입력해주세요 : 671
2볼
숫자를 입력해주세요 : 216
1스트라이크
숫자를 입력해주세요 : 713
3스트라이크
3개의 숫자를 모두 맞히셨습니다! 게임 종료
게임을 새로 시작하려면 1, 종료하려면 2를 입력하세요.
1
숫자를 입력해주세요 : 123
1볼
```

<br>

---

## 🎱 프로그래밍 요구사항

- 프로그램을 실행하는 시작점은 `Application`의 `main()`이다.
- JDK 8 버전에서 실행 가능해야 한다. **JDK 8에서 정상 동작하지 않을 경우 0점 처리**한다.
- 자바 코드 컨벤션을 지키면서 프로그래밍한다.
- https://naver.github.io/hackday-conventions-java
- indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현한다. 2까지만 허용한다.
- 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
- 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메소드)를 분리하면 된다.
- 3항 연산자를 쓰지 않는다.
- 함수(또는 메소드)가 한 가지 일만 하도록 최대한 작게 만들어라.

### 프로그래밍 요구사항 - Randoms, Console

- JDK에서 기본 제공하는 Random, Scanner API 대신 `camp.nextstep.edu.missionutils`에서 제공하는 `Randoms`, `Console` API를 활용해 구현해야 한다.
- Random 값 추출은 `camp.nextstep.edu.missionutils.Randoms`의 `pickNumberInRange()`를 활용한다.
- 사용자가 입력하는 값은 `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다.
- 프로그램 구현을 완료했을 때 `src/test/java` 디렉터리의 `ApplicationTest`에 있는 모든 테스트 케이스가 성공해야 한다. **테스트가 실패할 경우 0점 처리한다.**

<br>

---

## 📈 과제 진행 요구사항

- 미션은 [java-baseball-precourse](https://github.com/woowacourse/java-baseball-precourse) 저장소를 Fork/Clone해 시작한다.
- **기능을 구현하기 전에 java-baseball-precourse/README.md 파일에 구현할 기능 목록을 정리**해 추가한다.
- **Git의 커밋 단위는 앞 단계에서 README.md 파일에 정리한 기능 목록 단위**로 추가한다.
- [AngularJS Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153) 참고해 commit log를 남긴다.
- 과제 진행 및 제출 방법은 [프리코스 과제 제출 문서](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse) 를 참고한다.

<br>

---

## 📝 License

This project is [MIT](https://github.com/woowacourse/java-baseball-precourse/blob/master/LICENSE) licensed.
9 changes: 6 additions & 3 deletions src/main/java/baseball/Application.java
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
package baseball;

import controller.Game;

public class Application {
public static void main(String[] args) {
//TODO: 숫자 야구 게임 구현
}
public static void main(String[] args) {
Game game = new Game();
game.startGame();
}
}
45 changes: 45 additions & 0 deletions src/main/java/controller/Game.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
package controller;

import domain.Numbers;
import domain.PredictionResult;
import domain.RestartOrQuitSelection;
import domain.TargetNumbers;
import view.InputView;
import view.OutputView;

public class Game {
private TargetNumbers targetNumbers;

private void createNewTargetNumbers() {
this.targetNumbers = new TargetNumbers();
}

public void startGame() {
do {
createNewTargetNumbers();
startRound();
} while (checkRestart());
}

private void startRound() {
while (true) {
PredictionResult predictionResult = getPrediction();
OutputView.printHint(predictionResult);

if (predictionResult.isWin()) {
break;
}
}
}

private boolean checkRestart() {
RestartOrQuitSelection selection = InputView.inputRestart();
return selection.isRestart();
}

private PredictionResult getPrediction() {
Numbers numbers = InputView.inputNumbers();
return this.targetNumbers.compareTo(numbers);
}

}
33 changes: 33 additions & 0 deletions src/main/java/domain/Number.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
package domain;

public class Number {
private final int number;

public Number(int number) {
validateRange(number);
this.number = number;
}

private void validateRange(int number) {
if (number < 1 || number > 9) {
throw new IllegalArgumentException("숫자는 1과 9 사이어야합니다.");
}
}

public int getNumber() {
return this.number;
}

@Override
public boolean equals(Object obj) {
if (obj instanceof Number) {
return this.number == ((Number)obj).getNumber();
}
return false;
}

@Override
public int hashCode() {
return this.number;
}
}
65 changes: 65 additions & 0 deletions src/main/java/domain/Numbers.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
package domain;

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class Numbers {
protected static final int NUMBERS_SIZE = 3;
protected static final int MIN_NUMBER = 1;
protected static final int MAX_NUMBER = 9;

protected List<Number> numbers;

public Numbers() {
}

public Numbers(String input) {
validateDigit(input);
validateLength(input);
validateDuplication(input);

this.numbers = generateNumbersFromInput(input);
}

private void validateDigit(String input) {
try {
Arrays.stream(input.split(""))
.forEach(Integer::parseInt);
} catch (NumberFormatException e) {
throw new IllegalArgumentException("숫자만 입력할 수 있습니다.");
}
}

private void validateLength(String input) {
if (input.length() != NUMBERS_SIZE) {
throw new IllegalArgumentException("3글자를 입력해야합니다.");
}
}

private void validateDuplication(String input) {
boolean isDuplicated = Arrays.stream(input.split(""))
.distinct()
.count() < NUMBERS_SIZE;

if (isDuplicated) {
throw new IllegalArgumentException("서로 다른 숫자를 입력해야합니다.");
}
}

private List<Number> generateNumbersFromInput(String input) {
return Arrays.stream(input.split(""))
.map(letter -> new Number(Integer.parseInt(letter)))
.collect(Collectors.toList());
}

public boolean hasNumber(Number number) {
return this.numbers.contains(number);
}

public boolean isSamePosition(Number number, int position) {
int numberIndex = this.numbers.indexOf(number);
return numberIndex == position;
}

}
23 changes: 23 additions & 0 deletions src/main/java/domain/PredictionResult.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
package domain;

public class PredictionResult {
private final int ball;
private final int strike;

public PredictionResult(int ball, int strike) {
this.ball = ball;
this.strike = strike;
}

public int getBall() {
return this.ball;
}

public int getStrike() {
return this.strike;
}

public boolean isWin() {
return this.strike == 3;
}
}
29 changes: 29 additions & 0 deletions src/main/java/domain/RestartOrQuitSelection.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
package domain;

public class RestartOrQuitSelection {
private static final String RESTART_INPUT = "1";
private static final String QUIT_INPUT = "2";

private final String selection;

public RestartOrQuitSelection(String selection) {
validateSelection(selection);
this.selection = selection;
}

private void validateSelection(String selection) {
if (selection.equals(RESTART_INPUT)) {
return;
}

if (selection.equals(QUIT_INPUT)) {
return;
}

throw new IllegalArgumentException("1 또는 2 만 입력할 수 있습니다.");
}

public boolean isRestart() {
return this.selection.equals(RESTART_INPUT);
}
}
Loading