Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
ac14f0a
chore: jdk17로 세팅
tiemo0708 Mar 26, 2025
a4e0fde
docs: 기능 구현 목록 작성
tiemo0708 Mar 26, 2025
b3e9976
feat: 단일 로또 티켓(6개의 숫자)를 관리하는 도메인 구현
tiemo0708 Mar 26, 2025
f0038bf
feat: 무작위 로또 번호 생성기 구현
tiemo0708 Mar 26, 2025
ba98353
refactor: 에러 메시지 상수명을 명확하게 변경
tiemo0708 Mar 26, 2025
9e8689d
feat: 로또 티켓들을 관리하는 기능을 일급컬렉션으로 추가
tiemo0708 Mar 26, 2025
a526508
fix: .gitignore에 의해 무시되던 소스 파일 추적되도록 수정
tiemo0708 Mar 26, 2025
557fcad
feat: 로또 저장소 구현
tiemo0708 Mar 26, 2025
8cbecbb
feat: 로또 구매 유즈케이스 구현
tiemo0708 Mar 26, 2025
4450b08
chore: 서비스 패키지 구조 변경
tiemo0708 Mar 26, 2025
3ea24f6
feat: 로또 구매 수량에 대한 입력값 검증기능 추가
tiemo0708 Mar 26, 2025
e9695f6
refactor: 로또 티켓의 저장, 조회 방식 수정
tiemo0708 Mar 26, 2025
43ad699
refactor: 불필요한 인수래핑 제거
tiemo0708 Mar 26, 2025
31ef64e
refactor: validateEmpty 메소드로 분리
tiemo0708 Mar 26, 2025
bd7bf7a
feat: 입출력 기능 생성
tiemo0708 Mar 26, 2025
9f7af55
feat: 금액을 입력받아 로또를 저장하고 불러오도록 연결
tiemo0708 Mar 26, 2025
040c6a0
fix: 로또번호가 오름차순 정렬되도록 수정
tiemo0708 Mar 26, 2025
3ea3861
refactor: format 중복호출 제거
tiemo0708 Mar 26, 2025
a469b7c
style: 줄 맞춤 수정
tiemo0708 Mar 26, 2025
5aec8c8
refactor: 인스턴스화 방지 추가
tiemo0708 Mar 27, 2025
d6ca561
refactor: 많이 사용되는 로또 범위를 공통 클래스에서 상수처리
tiemo0708 Mar 27, 2025
a3d26bf
refactor: 인터페이스 이름을 명시적으로 변경
tiemo0708 Mar 27, 2025
e5f1046
feat: 당첨번호와 보너스번호의 입력검증 기능 추가
tiemo0708 Mar 27, 2025
07c1252
feat: 로또 당첨번호를 관리하는 도메인 객체 추가
tiemo0708 Mar 27, 2025
5320637
feat: 당첨 등수에 대한 객체관리 추가
tiemo0708 Mar 27, 2025
6474b2b
feat: 당첨 등수와 수익률 계산 도메인 모델 생성
tiemo0708 Mar 27, 2025
6ddceef
feat: 사용자가 입력한 값으로 발행된 로또번호와 비교해 당첨통계와 수익률을 계산해 보여주는 기능 추가
tiemo0708 Mar 27, 2025
50ad94e
docs: 기능 목록 업데이트
tiemo0708 Mar 27, 2025
f31c9aa
chore: 코드스멜 제거
tiemo0708 Mar 27, 2025
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
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ build/
*.iws
*.iml
*.ipr
out/


### NetBeans ###
/nbproject/private/
Expand Down
316 changes: 85 additions & 231 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,231 +1,85 @@
# 객체지향 코드 연습 - 로또([우아한테크코스 프리코스 - lotto](https://github.com/woowacourse-precourse/java-lotto))

## 🔍 진행 방식

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

## 📮 미션 제출 방법

- 미션 구현을 완료한 후 GitHub을 통해 제출해야 한다.
- 해당 리포지토리를 fork/clone
- 미션 구현
- 미션 구현 과정에서 학습한 내용, 고민했던 점 등을 기록한 본인 깃헙 아이디 이름 md파일 작성(ex. 5uhwann.md)
- 구현 완료 한 코드는 해당 리포지토리에 pr 작성
- pr 타이틀: [#주차]객체지향 코드 연습(깃헙 아이디)
- ex. [2주차] 객체지향 코드 연습(TaetaetaE01)
- 미션 구현에서 기록한 md파일은 [COW-Spring-4](https://github.com/COW-edu/COW-Spring-4) 리포지토리에 pr 작성 - 미션 구현 pr 링크 첨부

- **해당 리포지토리에만 Pull Request만 보내고 [COW-Spring-4](https://github.com/COW-edu/COW-Spring-4) 리포지토리에 과제를 제출하지 않으면 최종 제출하지 않은 것으로 처리되니 주의한다.**

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

- 기능 구현을 모두 정상적으로 했더라도 **요구 사항에 명시된 출력값 형식을 지켜야**한다.
- 기능 구현을 완료한 뒤 아래 가이드에 따라 테스트를 실행했을 때 모든 테스트가 성공하는지 확인한다.
- **테스트가 실패할 경우 0점으로 처리**되므로, 반드시 확인 후 제출한다.


### ~~테스트 실행 가이드~~

- ~~터미널에서 `java -version`을 실행하여 Java 버전이 11인지 확인한다. Eclipse 또는 IntelliJ IDEA와 같은 IDE에서 Java 11로 실행되는지 확인한다.~~
- ~~터미널에서 Mac 또는 Linux 사용자의 경우 `./gradlew clean build` 명령을 실행하고,
Windows 사용자의 경우 `gradlew.bat clean test` 명령을 실행할 때 모든 테스트가 아래와 같이 통과하는지 확인한다.~~

```
BUILD SUCCESSFUL in 0
```

---

## 🚀 기능 요구 사항

로또 게임 기능을 구현해야 한다. 로또 게임은 아래와 같은 규칙으로 진행된다.

```
- 로또 번호의 숫자 범위는 1~45까지이다.
- 1개의 로또를 발행할 때 중복되지 않는 6개의 숫자를 뽑는다.
- 당첨 번호 추첨 시 중복되지 않는 숫자 6개와 보너스 번호 1개를 뽑는다.
- 당첨은 1등부터 5등까지 있다. 당첨 기준과 금액은 아래와 같다.
- 1등: 6개 번호 일치 / 2,000,000,000원
- 2등: 5개 번호 + 보너스 번호 일치 / 30,000,000원
- 3등: 5개 번호 일치 / 1,500,000원
- 4등: 4개 번호 일치 / 50,000원
- 5등: 3개 번호 일치 / 5,000원
```

- 로또 구입 금액을 입력하면 구입 금액에 해당하는 만큼 로또를 발행해야 한다.
- 로또 1장의 가격은 1,000원이다.
- 당첨 번호와 보너스 번호를 입력받는다.
- 사용자가 구매한 로또 번호와 당첨 번호를 비교하여 당첨 내역 및 수익률을 출력하고 로또 게임을 종료한다.
- 사용자가 잘못된 값을 입력할 경우 `IllegalArgumentException`를 발생시키고, "[ERROR]"로 시작하는 에러 메시지를 출력 후 종료한다.

### 입출력 요구 사항

#### 입력

- 로또 구입 금액을 입력 받는다. 구입 금액은 1,000원 단위로 입력 받으며 1,000원으로 나누어 떨어지지 않는 경우 예외 처리한다.

```
14000
```

- 당첨 번호를 입력 받는다. 번호는 쉼표(,)를 기준으로 구분한다.

```
1,2,3,4,5,6
```

- 보너스 번호를 입력 받는다.

```
7
```

#### 출력

- 발행한 로또 수량 및 번호를 출력한다. 로또 번호는 오름차순으로 정렬하여 보여준다.

```
8개를 구매했습니다.
[8, 21, 23, 41, 42, 43]
[3, 5, 11, 16, 32, 38]
[7, 11, 16, 35, 36, 44]
[1, 8, 11, 31, 41, 42]
[13, 14, 16, 38, 42, 45]
[7, 11, 30, 40, 42, 43]
[2, 13, 22, 32, 38, 45]
[1, 3, 5, 14, 22, 45]
```

- 당첨 내역을 출력한다.

```
3개 일치 (5,000원) - 1개
4개 일치 (50,000원) - 0개
5개 일치 (1,500,000원) - 0개
5개 일치, 보너스 볼 일치 (30,000,000원) - 0개
6개 일치 (2,000,000,000원) - 0개
```

- 수익률은 소수점 둘째 자리에서 반올림한다. (ex. 100.0%, 51.5%, 1,000,000.0%)

```
총 수익률은 62.5%입니다.
```

- 예외 상황 시 에러 문구를 출력해야 한다. 단, 에러 문구는 "[ERROR]"로 시작해야 한다.

```
[ERROR] 로또 번호는 1부터 45 사이의 숫자여야 합니다.
```

#### 실행 결과 예시

```
구입금액을 입력해 주세요.
8000

8개를 구매했습니다.
[8, 21, 23, 41, 42, 43]
[3, 5, 11, 16, 32, 38]
[7, 11, 16, 35, 36, 44]
[1, 8, 11, 31, 41, 42]
[13, 14, 16, 38, 42, 45]
[7, 11, 30, 40, 42, 43]
[2, 13, 22, 32, 38, 45]
[1, 3, 5, 14, 22, 45]

당첨 번호를 입력해 주세요.
1,2,3,4,5,6

보너스 번호를 입력해 주세요.
7

당첨 통계
---
3개 일치 (5,000원) - 1개
4개 일치 (50,000원) - 0개
5개 일치 (1,500,000원) - 0개
5개 일치, 보너스 볼 일치 (30,000,000원) - 0개
6개 일치 (2,000,000,000원) - 0개
총 수익률은 62.5%입니다.
```

---

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

- JDK 11 버전에서 실행 가능해야 한다. **JDK 11에서 정상적으로 동작하지 않을 경우 0점 처리한다.**
- 프로그램 실행의 시작점은 `Application`의 `main()`이다.
- `build.gradle` 파일을 변경할 수 없고, 외부 라이브러리를 사용하지 않는다.
- [Java 코드 컨벤션](https://github.com/woowacourse/woowacourse-docs/tree/master/styleguide/java) 가이드를 준수하며 프로그래밍한다.
- 프로그램 종료 시 `System.exit()`를 호출하지 않는다.
- 프로그램 구현이 완료되면 `ApplicationTest`의 모든 테스트가 성공해야 한다. **테스트가 실패할 경우 0점 처리한다.**
- 프로그래밍 요구 사항에서 달리 명시하지 않는 한 파일, 패키지 이름을 수정하거나 이동하지 않는다.
- indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현한다. 2까지만 허용한다.
- 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
- 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메서드)를 분리하면 된다.
- 3항 연산자를 쓰지 않는다.
- 함수(또는 메서드)가 한 가지 일만 하도록 최대한 작게 만들어라.
- JUnit 5와 AssertJ를 이용하여 본인이 정리한 기능 목록이 정상 동작함을 테스트 코드로 확인한다.

### 추가된 요구 사항

- 함수(또는 메서드)의 길이가 15라인을 넘어가지 않도록 구현한다.
- 함수(또는 메서드)가 한 가지 일만 잘 하도록 구현한다.
- else 예약어를 쓰지 않는다.
- 힌트: if 조건절에서 값을 return하는 방식으로 구현하면 else를 사용하지 않아도 된다.
- else를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.
- Java Enum을 적용한다.
- 도메인 로직에 단위 테스트를 구현해야 한다. 단, UI(System.out, System.in, Scanner) 로직은 제외한다.
- 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 분리해 구현한다.
- 단위 테스트 작성이 익숙하지 않다면 `test/java/lotto/LottoTest`를 참고하여 학습한 후 테스트를 구현한다.

### 라이브러리

- [`camp.nextstep.edu.missionutils`](https://github.com/woowacourse-projects/mission-utils)에서 제공하는 `Randoms` 및 `Console` API를 사용하여 구현해야 한다.
- Random 값 추출은 `camp.nextstep.edu.missionutils.Randoms`의 `pickUniqueNumbersInRange()`를 활용한다.
- 사용자가 입력하는 값은 `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다.

#### 사용 예시

```java
List<Integer> numbers = Randoms.pickUniqueNumbersInRange(1, 45, 6);
```

### Lotto 클래스

- 제공된 `Lotto` 클래스를 활용해 구현해야 한다.
- `Lotto`에 매개 변수가 없는 생성자를 추가할 수 없다.
- `numbers`의 접근 제어자인 private을 변경할 수 없다.
- `Lotto`에 필드(인스턴스 변수)를 추가할 수 없다.
- `Lotto`의 패키지 변경은 가능하다.

```java
public class Lotto {
private final List<Integer> numbers;

public Lotto(List<Integer> numbers) {
validate(numbers);
this.numbers = numbers;
}

private void validate(List<Integer> numbers) {
if (numbers.size() != 6) {
throw new IllegalArgumentException();
}
}

// TODO: 추가 기능 구현
}
```

---

## ✏️ 과제 진행 요구 사항

- 미션은 [practice-oop-lotto](https://github.com/COW-edu/practice-oop-lotto) 저장소를 Fork & Clone해 시작한다.
- **기능을 구현하기 전 `docs/README.md`에 구현할 기능 목록을 정리**해 추가한다.
- **Git의 커밋 단위는 앞 단계에서 `docs/README.md`에 정리한 기능 목록 단위**로 추가한다.
- [커밋 메시지 컨벤션](https://gist.github.com/stephenparish/9941e89d80e2bc58a153) 가이드를 참고해 커밋 메시지를 작성한다.
# java-lotto-precourse
### 기능 구현 목록

- [ ] **로또 구입 금액 입력 기능**
- [ ] 사용자가 로또 구입 금액을 입력한다
- [ ] 구입 금액이 1,000 단위로 나누어 떨어져야한다
- [ ] **로또 번호 생성 기능**
- [ ] 사용자가 입력한 금액에 따라 로또 티켓 수량을 계산한다.
- [ ] 각 로또 티켓마다 1~45 사이의 중복되지 않는 6개의 번호를 생성한다.
- [ ] 로또 번호는 오름차순으로 정렬하여 생성한다.
- [ ] **로또 티켓 발행 및 출력 기능**
- [ ] 생성된 로또 티켓의 번호를 화면에 출력한다
Comment on lines +4 to +12
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

아직 구현하지 못한 기능일까요? 체크가 누락된 것 같아요!

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

앗 그렇네요 감사합니다


예시:

```

8개를 구매했습니다.
[8, 21, 23, 41, 42, 43]
[3, 5, 11, 16, 32, 38]
...

```

- [x] **당첨 번호 입력 기능**
- [x] 사용자가 당첨 번호 6개를 입력하게 한다
- [x] 입력된 당첨 번호가 1~45 사이의 숫자로 이루어져 있는지 검증한다
- [x] 중복되지 않는 번호만 입력받도록 유효성을 검사한다.
- [x] **보너스 번호 입력 기능**
- [x] 사용자가 보너스 번호 1개를 입력하도록 한다.
- [x] 입력된 보너스 번호가 1~45 사이의 숫자인지 검증한다
- [x] 당첨 번호와 중복되지 않는지를 검증한다
- [x] **로또 당첨 결과 계산 기능**
- [x] 사용자가 구매한 각 로또 티켓과 당첨 번호를 비교하여 등수를 계산한다

당첨 기준:

- **1등**: 6개 번호 일치
- **2등**: 5개 번호 + 보너스 번호 일치
- **3등**: 5개 번호 일치
- **4등**: 4개 번호 일치
- **5등**: 3개 번호 일치
- **꽝**: 2개 이하 번호 일치
- [x] **수익률 계산 기능**
- [x] 사용자가 입력한 금액과 당첨금액을 바탕으로 수익률을 계산한다
- [x] 수익률을 소수점 둘째 자리에서 반올림하여 출력한다

예시:

```

총 수익률은 62.5%입니다.

```

- [x] **당첨 결과 및 수익률 출력 기능**
- [x] 당첨 결과를 화면에 출력한다.
- [x] 수익률을 화면에 출력한다

예시:

```
복사
3개 일치 (5,000원) - 1개
4개 일치 (50,000원) - 0개
5개 일치 (1,500,000원) - 0개
5개 일치, 보너스 볼 일치 (30,000,000원) - 0개
6개 일치 (2,000,000,000원) - 0개
총 수익률은 62.5%입니다.

```


### 에외처리

- [x] **구입 금액 입력 오류**
- [x] 입력금액이 1,000원 단위가 아닐경우
- [x] 입력금액이 숫자가 아닌 경우
- [x] **당첨 번호 입력 오류**
- [x] 중복된 번호가 있는경우
- [x] 1~45 사이의 숫자가 아닐 경우
- [x] **보너스 번호 입력오류**
- [x] 당첨 번호와 중복될 경우
- [x] 1~45 사이의 숫자가 아닐 경우
- [x] 보너스 번호를 2개이상 입력한 경우
2 changes: 1 addition & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ dependencies {

java {
toolchain {
languageVersion = JavaLanguageVersion.of(11)
languageVersion = JavaLanguageVersion.of(17)
}
}

Expand Down
Binary file modified gradle/wrapper/gradle-wrapper.jar
Binary file not shown.
4 changes: 3 additions & 1 deletion gradle/wrapper/gradle-wrapper.properties
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.8.1-bin.zip
distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
Loading