728x90
서론
- Java의 학습을 위해, 미션 학습을 진행하고 있습니다. 첫번째 미션으로는 “숫자야구게임”을 진행해보려고 합니다.
- Step1부터 점진적으로 확장해 나가는것이 목표입니다.
- 가장 중요한건 확장가능한 설계와 도메인 모델 정의, 테스트 코드 작성을 통한 안정적인 애플리케이션 구현을 가지고 해당 미션을 진행해보려고 합니다.
- 의도적으로 꼼꼼한 테스트 코드와 원시값 포장을 진행하였습니다. 해당 부분은 참고해주시면 좋을거 같습니다.
미션 요구사항
- 숫자야구게임이란?
- 1부터 9까지 서로 다른 수로 이루어진 3자리의 수를 맞추는 게임입니다.
- 컴퓨터와 싸우는 게임으로 컴퓨터가 뽑은 랜덤의 숫자를 뽑을수 있도록 합니다.
상세 스펙
- 명령어
- 1을 입력하면 게임을 시작합니다.
- 9를 입력하면 애플리케이션을 종료합니다.
- 게임을 시작하면 1~9 서로 다른 임의의 수 3개를 선택합니다. 게임 플레이어는 컴퓨터가 생각하고 있는 3개의 숫자를 입력하고, 컴퓨터는 입력한 숫자에 대한 결과를 출력해야 합니다.
- 번호를 입력 한 뒤에 힌트에 대한 정의
- 스트라이크: 이전에 뽑은 숫자에서 위치와 실제 숫자와 같은 경우
- 볼: 이전에 뽑은 숫자에서 위치는 다르지만 숫자가 존재하는 경우
- 낫싱: 이전에 뽑은 숫자에서 아예 존재하지 않은 경우
- 애플리케이션을 종료하는 값(9)를 입력하지 전까지 게임을 계속 진행할 수 있다.
- 콘솔 실행 결과
게임을 새로 시작하려면 1, 종료하려면 9를 입력하세요.
1
컴퓨터가 숫자를 뽑았습니다.
숫자를 입력해주세요 : 123
1볼 1스트라이크
숫자를 입력해주세요: 145
1볼
숫자를 입력해주세요: 671
2볼
숫자를 입력해주세요: 216
1스트라이크
숫자를 입력해주세요: 713
3스트라이크
3개의 숫자를 모두 맞히셨습니다.
-------게임 종료-------
게임을 새로 시작하려면 1, 종료하려면 9를 입력하세요.
9
애플리케이션이 종료되었습니다.
테크스펙
기술 스택
- Java17 / Junit 5.9.1 / assertJ 3.25.3
모델링
- Enum: Command
- value: int
- Commend를 실행할 수 있는 숫자를 정의내린다.
- value: int
- VO: Number
- value: int
- 숫자 야구게임에서 사용하는 1~9의 숫자를 정의내리는 Value Object입니다.
- 일급컬렉션(VO): BaseBallNumbers
- value: List<Number>
- 실제 중복되지 않는 1~9의 3개의 상태를 가지고 있는 Value Object이자 일급컬렉션입니다.
- Domain: Computer
- numbers: BaseBallNumbers
- 임의의 숫자 1~9까지 중에 3개를 뽑은 List를 상태로 가지고 있습니다.
정책 요구사항
- 숫자야구게임에서 사용되는 숫자의 List는 중복되는 값이 들어가면 안된다.
- 예제) 숫자가 1,2,3이면 가능하지만, 1,1,2면 에러가 발생해야 한다.
- 숫자야구게임에서 사용되는 숫자는 3개이다.
- 예제) 숫자가 1,2,3이면 가능하지만, 1,2 이면 에러가 발생해야 한다.
- 애플리케이션을 종료하기 전까지는 게임이 계속 진행되어야 한다.
- 컴퓨터가 가지고 있는 숫자들중에 위치와 숫자가 아예 같으면 스트라이크라고 한다.
- 예를들어 컴퓨터가 1,2,3이라는 숫자를 가지고 있을때, 1,4,5를 사용자가 입력하면 1의 값은 스트라이크다.
- 컴퓨터가 가지고 있는 숫자들중에 위치는 다르지만 숫자를 가지고 있다면 볼이라고 한다.
- 예를들어 컴퓨터가 1,2,3이라는 숫자를 가지고 있을때, 4,5, 1를 사용자가 입력하면 1의 값은 볼이다.
- 컴퓨터가 가지고 있는 숫자들과 사용자가 입력한 숫자들이 아예 다르면 낫싱이라고 한다.
- 예를들어 컴퓨터가 1,2,3이라는 숫자를 가지고 있을때, 4,5,6을 사용자가 입력한 경우 해당 부분에서는 낫싱이다.
- 모든 숫자가 스트라이크여야 사용자는 승리할 수 있다.
- 예를들어 컴퓨터가 1,2,3이라는 숫자를 가지고 있을 때, 1,2,3을 사용자가 입력하면 해당 게임은 사용자의 승리로 종료된다.
기술적 부분
- 컴퓨터는 1~9까지의 임의의 수중에 3개를 골라야 하는데, 해당 부분은 랜덤이기 떄문에 실제 테스트 코드를 작성할때 제어할수 없는 값으로 칭한다.
- 관련되어서는 Interface를 도입해 확장 가능한 영역으로 처리한다.
- 예를들어, BaseBallNumbersGenerator Interface를 만들어, 구현체를 만들어서 가장 밖에서 코드를 제어할수 있게 한다.
- 1~9까지의 Number에 대한 값은 변경되지 않을 값으로써 성능(메모리 공간 확보)를 위해 캐싱을 진행한다.
- 참고링크: 반복적으로 사용되는 인스턴스 캐싱하기
- 랜덤으로 3개의 숫자를 빼는 방법은 두가지가 있다. 관련해서 밴치마킹을 진행해 어떤것이 더 좋을지 판단해본다.
- 1~9의 숫자를 가지고 있는 List를 Shuffle을 진행하고, 앞에서 3개의 숫자를 추출한다.
- index를 랜덤으로 만들어서 index를 이용해 랜덤으로 숫자를 추출한다.
결론
- 의도적으로 맨처음 테크스펙을 작성하고 관련된 흐름으로 흘러가도록 노력해보려고 한다.
- 2편에서는 실제 도메인을 어떻게 설계하였는지 작성해보려고 합니다.
728x90
728x90
'Backend > Java' 카테고리의 다른 글
| [번역] Memory-Hogging Enum.values() Method(메모리를 과도하게 사용하는 Enum.values() 메서드) (0) | 2024.04.12 |
|---|---|
| [숫자야구게임 Step1] 도메인 구현 (0) | 2024.04.12 |
| List내에 있는 값들중에 3개의 값만 랜덤으로 뽑는 방법을 알아보자. (0) | 2024.04.09 |
| 콘솔 애플리케이션을 만들었을때, 통합 테스트를 해보자. (with. Scanner, System.out.println) (0) | 2023.12.31 |
| [번역] Unit Testing of System.out.println() with JUnit (0) | 2023.12.30 |
