122 | 123 | ※ 해당 내용은 [일급 컬렉션 (First Class Collection)의 소개와 써야할 이유](https://jojoldu.tistory.com/412) 를 기반으로 작성하였습니다. 124 | 125 | 126 | # Reference 127 | - https://jojoldu.tistory.com/412 128 | - https://tecoble.techcourse.co.kr/post/2020-05-08-First-Class-Collection/ 129 | - https://brainbackdoor.tistory.com/140 130 | -------------------------------------------------------------------------------- /우테코 최종 코딩 테스트 후기.md: -------------------------------------------------------------------------------- 1 | 오늘 드디어 우아한테크코스 4기의 선별과정의 마지막 과정인 최종 코딩테스트를 봤습니다. 2 | 3 | 최종 코딩테스트의 문제는 작년 3기의 선별과정의 최종 미션이 3주차 미션과 비슷한 내용이어서 올해도 마지막 3주차 과제였던 [자판기 미션](https://github.com/woowacourse/java-vendingmachine-precourse) 과 비슷한 내용의 미션일거라 예상을 하였습니다. 하지만 저의 예상과는 다르게 3주차 미션과 완전히 다른 미션이 나왔습니다. 4 | 5 | 올해 우테코 4기의 최종 미션은 아래의 링크를 통해 확인해보실 수 있습니다. 6 | > **우테코 4기 최종 미션 - 페어매칭관리 애플리케이션** 7 | > https://github.com/woowacourse/java-pairmatching-precourse 8 | 9 | # 🎯 미션 수행 내용 10 | 이번 미션은 우테코 페어 프로그래밍의 팀 매칭을 프로그래밍하는 미션이었습니다. 11 | 미션의 기능은 크게 **페어 매칭 기능**, **페어 매칭 조회 기능**, **페어 매칭 초기화 기능**이 있습니다. 12 | 기능들 중의 메인 기능은 페어 매칭 기능었으며 해당 기능에서는 입력 값의 유효성 검사, 재매칭 여부, 페어 생성 등의 여러 세부 기능들로 나뉘었습니다. 그리고 프리코스 기간에는 사용하지 않았던 파일 입출력을 통해 크루의 정보를 읽어와야하는 조건 또한 있었습니다. 13 | 14 | 개인적으로는 지난 3주차 미션보다는 어려웠다고 생각됩니다. 15 | 16 | > **제가 최종 미션으로 제출한 코드는 다음 링크를 통해 확인하실 수 있습니다.** 17 | > https://github.com/Seongwon97/java-pairmatching-precourse/tree/Seongwon97 18 | 19 | # 👊🏻 신경쓴 점과 아쉬운 점 20 | ## Todo List 작성 21 | 프리코스 과정동안에는 Todo List를 `README.md`파일의 내용을 삭제하고 진행하였습니다. 그 당시에는 미션을 1주일이라는 기간동안 진행하여 내가 README파일에 새로 작성한 Todo List와 main branch에 있는 초기 README파일을 번갈아보며 미션을 진행하여도 크게 불편하다는 생각은 하지 못하였습니다. 하지만 프리코스 과정이 끝나고 최종 코딩테스트 준비를 하며 시간 제한을 두고 여러 문제를 보니 내가 작성한 Todo list외에도 기존 README파일에 작성되어있는 코드를 실행하였을 때의 출력문 등을 보기 위하여 웹으로 main branch를 접근하여 README파일을 보는 것은 매우 비효율적이라 생각되었습니다. 그래서 이번 최종 미션을 진행하였을 때는 `ToDoList.md` 파일을 새로 생성하여 해당 파일에 내가 이해한 미션의 정보와 Todo list를 작성하였습니다. 22 | 23 |  24 | 25 | ToDoList.md파일과 기존의 README.md파일과 함께 하나의 창으로 화면을 분할하여 기능 구현들을 하다보니 확실히 구현해야할 내용 및 출력 결과 등을 한번에 볼 수 있던 것 같습니다. 26 | 27 | 한 개의 기능 구현이 끝나고 다음 기능 구현으로 넘어갈 때 TodoList를 통해 어떤 기능을 다음에 구현해야하는지 체크하고 README에서 출력 형태를 보다보니 다음 구현할 기능의 이해를 빠르게 할 수 있었던 것 같습니다. 28 | 29 | ## Enum 적극 활용 30 | 이번 미션을 진행하며 코스, 미션레벨, 미션의 종류와 같은 데이터들은 모두 Enum으로 관리하도록 프로그래밍하였습니다. (각각 Course, Level, Mission이라는 enum을 생성하여 사용하였습니다.) 해당 데이터들을 enum으로 관리를 하니 코드의 가독성이 높아졌으며 각각 `isExist()`메서드를 구현하여 사용자로부터 과정, 레벨, 미션의 입력값을 받았을 때 해당 값이 실제 존재하는 값인지 쉽게 판단할 수 도 있던 것 같습니다. 31 | 32 | enum을 사용한 코드의 예시는 다음과 같습니다. 33 | ```java 34 | public enum Course { 35 | BACKEND("백엔드"), 36 | FRONTEND("프론트엔드"); 37 | 38 | private String name; 39 | 40 | Course(String name) { 41 | this.name = name; 42 | } 43 | 44 | public String getName() { 45 | return name; 46 | } 47 | 48 | public static List
65 |
66 | 그러나 프리코스를 진행하며 **the AngularJS commit conventions**을 읽고 공부하며 Commit log의 형식을 통일하였을 때의 장점을 알게 되었고 Commit log의 형식을 바꾸게 되었습니다.
67 |
68 | 그 결과 아래와 같이 어떤 기능을 추가하고 변경한 커밋이며 어떠한 내용을 리펙토링 했는지에 대해 log를 통해 유츄할 수 있게 되었습니다. 이러한 규칙은 여러 팀원들과 함께 큰 프로젝트를 진행할 때 장점을 크게 느낄 수 있을것이라 생각됩니다.
69 |
70 | 
71 |
72 | > **아쉬운점**😥 : 모든 과제를 제출하고 다시 돌아보니 몇몇 log들의 Type을 잘못 설정한 것들이 있었습니다.
73 | 예를들면 코드의 indent를 맞추는 formatting작업을 하는데 `style`이 아닌 `refactor`를 사용하는 등의 잘못된 log를 남긴 것들이 보였습니다.
74 | 이에 다음 2주차 과제부터는 commit log형식을 더욱 더 신경쓰며 학습을 해야겠다는 다짐을 하였습니다.
75 |
76 |
77 | > 학습을 하며 해당 문서를 번역하고 정리하며 [Git 커밋 메세지 규약 정리 - The AngularJS commit conventions.](https://velog.io/@seongwon97/Git-%EC%BB%A4%EB%B0%8B-%EB%A9%94%EC%84%B8%EC%A7%80-%EA%B7%9C%EC%95%BD-%EC%A0%95%EB%A6%AC-The-AngularJS-commit-conventions)를 작성하였습니다.
78 |
79 | 80 | 81 | ## 최종 후기 82 | 프리코스를 진행한지 1주일도 지나지 않았지만 많은 것을 배울 수 있었습니다. 83 | 84 | indent depth를 2까지 허용하는 요구사항 등을 지키고 그동안 접하지 않은 Git커밋 메시지 규약, Java 코드 컨벤션과 같은 내용들을 공부하며 코딩을 하다보니 내가 작성한 코드들의 가독성이 높아진 것을 확인할 수 있었습니다. 85 | 86 | 프리코스를 진행하며 몇일 사이에 이러한 발전을 할 수 있었는데 남은 기간동안 얼마나 더 많은 학습을 하고 발전을 할 수 있을지 기대가 됩니다. 87 | 88 | 남은 프리코스 기간동안도 많은 것을 학습하며 더욱 더 성장하는 개발자가 되도록 하겠습니다.🔥🔥 89 | -------------------------------------------------------------------------------- /Week3 (21.12.8~14)/싱글톤(Singleton) 패턴이란.md: -------------------------------------------------------------------------------- 1 | # 싱글톤 패턴이란? 2 | > 소프트웨어 디자인 패턴에서 싱글턴 패턴(Singleton pattern)을 따르는 클래스는, 생성자가 여러 차례 호출되더라도 실제로 생성되는 객체는 하나이고 최초 생성 이후에 호출된 생성자는 최초의 생성자가 생성한 객체를 리턴한다. 이와 같은 디자인 유형을 싱글턴 패턴이라고 한다. 주로 공통된 객체를 여러개 생성해서 사용하는 DBCP(DataBase Connection Pool)와 같은 상황에서 많이 사용된다. 3 | - 출처: [위키피디아](https://ko.wikipedia.org/wiki/%EC%8B%B1%EA%B8%80%ED%84%B4_%ED%8C%A8%ED%84%B4) 4 | 5 | 간단히 설명하면 싱글톤 패턴은 **객체의 인스턴스를 한개만 생성되게 하는 패턴**입니다. 6 | 7 | 이러한 패턴은 주로 프로그램 내에서 하나로 공유를 해야하는 객체가 존재할 때 해당 객체를 싱글톤으로 구현하여 모든 유저 또는 프로그램들이 해당 객체를 공유하며 사용하도록 할 때 사용됩니다. 8 | 9 | 즉, 싱글톤 패턴은 아래와 같은 상황에 사용을 합니다. 10 | - 프로그램 내에서 하나의 객체만 존재해야 한다. 11 | - 프로그램 내에서 여러 부분에서 해당 객체를 공유하여 사용해야한다. 12 | 13 | ## 싱글톤 패턴을 사용하는 이유 14 | 하나의 인스턴스만을 사용하는 싱글톤 패턴의 이점은 다음과 같습니다 15 | 16 | **1. 메모리 측면의 이점** 17 | 싱글톤 패턴을 사용하게 된다면 한개의 인스턴스만을 고정 메모리 영역에 생성하고 추후 해당 객체를 접근할 때 메모리 낭비를 방지할 수 있다. 18 | 19 | **2. 속도 측면의 이점** 20 | 생성된 인스턴스를 사용할 때는 이미 생성된 인스턴스를 활용하여 속도 측면에 이점이 있다. 21 | 22 | **3. 데이터 공유가 쉽다** 23 | 전역으로 사용하는 인스턴스이기 때문에 다른 여러 클래스에서 데이터를 공유하며 사용할 수 있다. 하지만 동시성 문제가 발생할 수 있어 이 점은 유의하여 설계하여야 한다. 24 | 25 | ## 싱글톤 패턴 구현하기 26 | ```java 27 | public class Singleton { 28 | // 단 1개만 존재해야 하는 객체의 인스턴스로 static 으로 선언 29 | private static Singleton instance; 30 | 31 | // private 생성자로 외부에서 객체 생성을 막아야 한다. 32 | private Singleton() { 33 | } 34 | 35 | // 외부에서는 getInstance() 로 instance 를 반환 36 | public static Singleton getInstance() { 37 | // instance 가 null 일 때만 생성 38 | if (instance == null) { 39 | instance = new Singleton(); 40 | } 41 | return instance; 42 | } 43 | } 44 | 45 | ``` 46 | 싱글톤 패턴의 기본적인 구현 방법은 다음과 같습니다. 47 | 48 | 먼저 `private static`으로 Singleton객체의 instance를 선언하고 `getInstance()`메서드가 처음 실행 될 때만 하나의 instance가 생성되고 그 후에는 이미 생성되어진 instance를 return하는 방식으로 진행이 됩니다. 49 | 50 | 여기서 핵심은 `private`로 된 기본 생성자입니다. 생성자를 `private`로 생성을 하며 외부에서 새로운 객체의 생성을 막아줘야 합니다. 51 | 52 | 53 | ```java 54 | // 같은 instance인지 Test 55 | public class Application { 56 | public static void main(String[] args) { 57 | Singleton singleton1 = Singleton.getInstance(); 58 | Singleton singleton2 = Singleton.getInstance(); 59 | 60 | System.out.println(singleton1); 61 | System.out.println(singleton2); 62 | } 63 | } 64 | /** Output 65 | * vendingmachine.Singleton@15db9742 66 | * vendingmachine.Singleton@15db9742 67 | **/ 68 | ``` 69 | 싱글톤 객체를 생성하는 위의 코드를 실행해보면 두 객체가 하나의 인스턴스를 사용하여 같은 주소 값을 출력하는 것을 확인하실 수 있습니다. 70 | 71 | ## Multi-thread에서의 싱글톤 72 | multi-thread환경에서 싱글 톤을 사용하게 된다면 다음과 같은 문제가 발생할 수 있습니다. 73 | 74 | ### 문제점1. 여러개의 인스턴스 생성 75 | Multi-thread환경에서 instance가 없을 때 동시에 아래의 `getInstance()`메서드를 실행하는 경우 각각 새로운 instance를 생성할 수 있습니다. 76 | ```java 77 | public static Singleton getInstance() { 78 | if (instance == null) { 79 | instance = new Singleton(); 80 | } 81 | return instance; 82 | } 83 | ``` 84 | 85 | ### 문제점 2. 변수 값의 일관성 실패 86 | 다음과 같은 코드가 실행이 되었을 때 여러개의 thread에서 `plusCount()`를 동시에 실행을 한다면 일관되지 않은 값들이 생길 수 있습니다. 87 | ```java 88 | public class Singleton { 89 | private static Singleton instance; 90 | private static int count = 0; 91 | 92 | private Singleton() { 93 | } 94 | 95 | public static Singleton getInstance() { 96 | if (instance == null) { 97 | instance = new Singleton(); 98 | } 99 | return instance; 100 | } 101 | 102 | public static void plusCount() { 103 | count++; 104 | } 105 | } 106 | ``` 107 | 108 | ### 해결법 1. 정적 변수선언에서 인스턴스 생성 109 | 이러한 문제는 아래와 같이 `static` 변수로 singleton 인스턴스를 생성하는 방법으로 해결할 수 있습니다. 아래와 같이 초기에 인스턴스를 생성하게 된다면 multi-thread환경에서도 다른 객체들은 getInstance를 통해 하나의 인스턴스를 공유할 수 있습니다. 110 | ```java 111 | public class Singleton { 112 | private static Singleton instance = new Singleton(); 113 | 114 | private Singleton() { 115 | } 116 | 117 | public static Singleton getInstance() { 118 | return instance; 119 | } 120 | } 121 | ``` 122 | ### 해결법 2. synchronzied의 사용 123 | 아래의 코드와 같이 `synchronzied`를 적용하여 multi-thread에서의 동시성 문제를 해결하는 방법입니다. 하지만 **해당 방법은 Thread-safe를 보장하기 위해 성능 저하가 발생**할 것입니다. 124 | ```java 125 | public class Singleton { 126 | public class Singleton { 127 | private static Singleton instance; 128 | 129 | private Singleton() {} 130 | 131 | public static synchronzied Singleton getInstance() { 132 | if(instance == null) { 133 | instance = new Singleton(); 134 | } 135 | return instance; 136 | } 137 | } 138 | } 139 | ``` 140 | 141 | # 결론 142 | 싱글톤 패턴은 메모리, 속도, 데이터 공유 측면에서 이점이 있습니다. 하지만 그렇다고 해서 싱글톤 패턴이 무조건 좋은 것은 아닙니다. 앞서 말했듯이 multi-thread환경에서는 동시성 문제가 발생할 수 있기에 싱글톤 패턴을 사용하고자 한다면 사용하기 앞서 "해당 객체의 인스턴스가 한 개만 존재하여야 하는지?"의 여부와 "사용을 하였을 때의 동시성 문제가 발생하지 않는지"를 체크를 하며 사용해야 할 것 같습니다. 143 | 144 | # Reference 145 | - https://tecoble.techcourse.co.kr/post/2020-11-07-singleton/ 146 | - https://velog.io/@kyle/%EC%9E%90%EB%B0%94-%EC%8B%B1%EA%B8%80%ED%86%A4-%ED%8C%A8%ED%84%B4-Singleton-Pattern 147 | - https://injae-kim.github.io/dev/2020/08/06/singleton-pattern-usage.html 148 | -------------------------------------------------------------------------------- /Week1 (21.11.24~30)/Test코드에 있는 NsTest & Assertion 분석.md: -------------------------------------------------------------------------------- 1 | # Introduction 2 | 이번 우테코 프리코스를 진행하며 `NsTest` 클래스의 메서드들과 `Assert` 클래스의 메서드를 활용한 테스트 코드를 실행시키다보니 막히는 부분이 있어 정리를 하게 되었습니다. 3 | 4 | 이번 정리를 통해 앞으로 남은 2주간의 프리코스 과정과 2차 테스트에서의 테스트는 지금보다 쉽게 진행할 수 있을 것이라 믿습니다😁😁 5 | 6 |
7 | 8 | ## camp.nextstep.edu.missionutils.test.NsTest 9 | 아래에서 볼 테스트 코드의 람다식을 보면 `run`메서드를 확인할 수 있습니다. 10 | 해당 메서드에 대해 먼저 알아보도록 하겠습니다. 11 | 12 | ### run 13 | ```java 14 | protected final void run(final String... args) { 15 | command(args); 16 | runMain(); 17 | } 18 | ``` 19 | 20 | #### command 21 | ```java 22 | private void command(final String... args) { 23 | final byte[] buf = String.join("\n", args).getBytes(); 24 | System.setIn(new ByteArrayInputStream(buf)); 25 | } 26 | ``` 27 | command메서드는 `String.join`을 통해 parameter값들 사이에 `\n`을 넣어 배열을 연결시키고 `System.setIn`을 이용하여 콘솔을 통해 입력이 되는 것 처럼 해주는 메서드 입니다. 28 | 29 | #### runMain 30 | ```java 31 | protected abstract void runMain(); 32 | ``` 33 | runMain은 추상 클래스로 테스트할 실제 함수를 통해 override해주고 사용해야합니다. 그래서 실제 ApplicationTest파일을 보면 아래와 같이 재정의된 것을 확인할 수 있습니다. 34 | ```java 35 | // Application.java 36 | @Override 37 | public void runMain() { 38 | Application.main(new String[]{}); 39 | } 40 | ``` 41 | 42 |
43 | 44 | ## camp.nextstep.edu.missionutils.test.Assertions 45 | 46 | 프리코스에서 주어진 Test들은 `assertRandomNumberInRangeTest`와 `assertSimpleTest`메서드를 통해 작성되었습니다. 해당 메서드들은 모두 `camp.nextstep.edu.missionutils.test.Assertions`에 존재하며 두 메서드에 대해 알아보도록 하겠습니다. 47 | 48 | ### assertSimpleTest 49 | ```java 50 | public static void assertSimpleTest(final Executable executable) { 51 | assertTimeoutPreemptively(SIMPLE_TEST_TIMEOUT, executable); 52 | } 53 | ``` 54 | assertSimpleTest는 파라미터로 들어오는 executable을 `SIMPLE_TEST_TIMEOUT`내에 수행할 수 있는지 확인하는 메서드이다. 55 | - 여기서 executable은 우테코 1주차 과제의 테스트 코드를 보면 람다식이 위치한 것을 확인할 수 있습니다. 56 | - SIMPLE_TEST_TIMEOUT은 Assertions클래스 필드에 상수로 정의되어 있으며 실행시간?을 정해주는 변수인것 같습니다. 57 | ```java 58 | private static final Duration SIMPLE_TEST_TIMEOUT = Duration.ofSeconds(1L); 59 | private static final Duration RANDOM_TEST_TIMEOUT = Duration.ofSeconds(10L); 60 | ``` 61 | 62 | #### 우테코에서 주어진 Test code 63 | ```java 64 | @Test 65 | void 예외_테스트() { 66 | assertSimpleTest(() -> 67 | assertThatThrownBy(() -> runException("1234")) 68 | .isInstanceOf(IllegalArgumentException.class) 69 | ); 70 | } 71 | ``` 72 | - `assertSimpleTest()` : 괄호 안에 있는 식이 1초 이내에 실행되는지 Test한다. 73 | - `assertThatThrownBy()` : 해당 메서드는 괄호안에 위치한 람다식 안에서 발생하는 exception을 throw하는 메서드이다. 74 | - `runException("1234")` : 해당 메서드는 해당 parameter를 통해 main메서드를 시행시키고 exception을 잡아내는 함수이다. 위의 코드에서는 1234의 값을 넣고 실행하였을 때 try/catch문으로 exception을 잡아낸다. 75 | - `.isInstanceOf(IllegalArgumentException.class)` : 발생한 exception가 `IllegalArgumentException.class`인지 확인 76 | 77 | 78 |
79 | 80 | ### assertRandomNumberInRangeTest 81 | ```java 82 | public static void assertRandomNumberInRangeTest( 83 | final Executable executable, // 람다식의 실행할 메서드 84 | final Integer value, // Input값들? 85 | final Integer... values 86 | ) { 87 | assertRandomTest( 88 | () -> Randoms.pickNumberInRange(anyInt(), anyInt()), 89 | executable, 90 | value, 91 | values 92 | ); 93 | } 94 | ``` 95 | 해당 메서드는 parameter들을 받아 assertRandomTest를 실행시키는 메서드입니다. 96 | assertRandomTest에 대해 알아보도록 하겠습니다. 97 | 98 | #### assertRandomTest 99 | ```java 100 | private static
미션 코드의 진행 순서는 다음과 같습니다. 4 | 1. 자판기가 보유한 금액을 입력합니다. 5 | 2. 1에서 입력된 금액으로 자판기는 랜덤하게 동전을 생성한다. (보유한 동전 출력) 6 | 3. 자판기에서 판매할 상퓸 리스트를 입력합니다. 7 | 4. 음료를 구매할 투입 금액을 입력합니다. 8 | 5. 구매할 음료를 입력한다. 9 | 10 | 위의 4,5번을 잔돈이 상품의 최저 가격보다 적거나, 모든 상품이 소진 된 경우까지 반복한다. 11 | 12 | 6. 잔돈을 반환한다. (잔돈이 부족한 경우 반환할 수 있는 금액만 반환한다.) 13 | 14 |
15 | 16 | ## 🔒 제약사항 & 만들어야 할 필수 메서드 17 | ### 1. Coin 18 | 1. 다음 Coin클래스를 활용해야 한다. 19 | ```java 20 | public enum Coin { 21 | COIN_500(500), 22 | COIN_100(100), 23 | COIN_50(50), 24 | COIN_10(10); 25 | 26 | private final int amount; 27 | 28 | Coin(final int amount) { 29 | this.amount = amount; 30 | } 31 | 32 | // 추가 기능 구현 33 | } 34 | ``` 35 | 36 | 37 | ### 2. 입력 38 | #### 2.1. 입력 조건 39 | 1. 상품명, 가격, 수량은 쉼표(`,`)로 구분하며 개별 상품은 대괄호(`[]`)로 묶어 세미콜론(`:`)으로 구분한다. 40 | ``` 41 | [콜라,1500,20];[사이다,1000,10] 42 | ``` 43 | 2. 옳바르지 않는 입력이 들어오면 `IllegalArgumentException`를 발생 시키고 "[ERROR]"로 시작하는 에러 메시지 출력 후 재입력을 받는다. 44 | 3. 사용자의 입력은 camp.nextstep.edu.missionutils.Console의 readLine()을 활용한다. 45 | 4. 입력 받아야 할 값 list 46 | - 자판기가 보유한 금액 47 | - 상품 list 48 | - 투입금액 49 | - 구입할 상품명 50 | 51 | #### 2.2. 잘못된 입력 정리 (예외 상황) 52 | - [자판기가 보유한 금액] 금액이 숫자가 아닌 경우 53 | - [자판기가 보유한 금액] 금액이 음수인 경우 54 | - [자판기가 보유한 금액] 10원으로 나누어 떨어지지 않는 경우 55 | - [상품] 개별 상품이 세미콜론(`:`)을 기준으로 나뉘지 않은 경우 56 | - [상품] 세미콜론(`:`)을 기준으로 개별 상품으로 나누었을 때 각각의 개별상품이 대괄호(`[]`)로 묶이지 않은 경우 57 | - [상품] 개별 상품의 가격 수량이 쉼표(`,`)로 구분되지 않은 경우 58 | - [상품] 개별 상품의 상품명, 가격, 수량 중 값이 누락된 것이 있을 경우 59 | - [상품 - 상품명] 문장의 시작이 공백으로 시작하는 경우 60 | - [상품 - 가격] 가격이 숫자가 아닌 경우 61 | - [상품 - 가격] 가격이 음수인 경우 62 | - [상품 - 가격] 상품 가격이 100원보다 작은 경우 63 | - [상품 - 가격] 상품 가격이 10원으로 나누어 떨어지지 않는 경우 64 | - [상품 - 수량] 수량이 숫자가 아닌 경우 65 | - [상품 - 수량] 수량이 음수인 경우 66 | - [투입금액] 투입 금액이 숫자가 아닌 경우 67 | - [투입금액] 투입 금액이 음수인 경우 68 | - [구매할 상품] 구매할 상품이 없는 상품인 경우 69 | 70 | ### 3. 출력 71 | #### 3.1 출력 조건 72 | - 잔돈은 반환된 동전만 출력한다. 73 | - 예외 상황 발생 시 `[ERROR]`로 시작하는 에러 문구를 출력해야한다. 74 | - 전체적인 출력 예시 75 | ``` 76 | 자판기가 보유하고 있는 금액을 입력해 주세요. 77 | 450 78 | 79 | 자판기가 보유한 동전 80 | 500원 - 0개 81 | 100원 - 4개 82 | 50원 - 1개 83 | 10원 - 0개 84 | 85 | 상품명과 가격, 수량을 입력해 주세요. 86 | [콜라,1500,20];[사이다,1000,10] 87 | 88 | 투입 금액을 입력해 주세요. 89 | 3000 90 | 91 | 투입 금액: 3000원 92 | 구매할 상품명을 입력해 주세요. 93 | 콜라 94 | 95 | 투입 금액: 1500원 96 | 구매할 상품명을 입력해 주세요. 97 | 사이다 98 | 99 | 투입 금액: 500원 100 | 잔돈 101 | 100원 - 4개 102 | 50원 - 1개 103 | ``` 104 | 105 | ### 4. 그 외의 제약사항 106 | - JDK 8 버전 사용 107 | - Indent depth를 2까지만 허용 108 | - 3항 연산자 사용 금지 109 | - 메서드는 최대한 한가지 기능만! 110 | - 메서드의 길이가 15라인을 넘지 않도록 구현 111 | - Else 사용 금지! -> if절에서 return 하는 방식으로 구현하도록! 112 | - Random, Scanner API대신 camp.nextstep.edu.missionutils에서 제공하는 Randoms, Console API를 활용! 113 | - src/test/java 디렉터리의 ApplicationTest에 있는 모든 테스트 케이스가 성공해야 한다. 114 | 115 | >**3주 차 미션의 목표는 여러 개의 클래스를 분리한 후 서로 관계를 맺어 하나의 프로그램을 완성하는 경험을 하는 것이다!** 116 | >
2주차 과제때 부족하였던 클래스 분리와 클래스간의 관계를 맺는 것에 신경을 써보자!! 117 | 118 |
119 | 120 | # 🛠 구현할 기능 목록 121 | - 자판기 클래스 생성 122 | - 자판기를 실행시키는 메서드 생성 123 | - 상품 클래스 생성 124 | - 상품 리스트 클래스 생성 125 | - 사용자 입력관련 메서드 구현 126 | - 잘못된 입력을 판단하는 메서드 구현 127 | - [자판기가 보유한 금액] 금액이 숫자가 아닌 경우 128 | - [자판기가 보유한 금액] 금액이 음수인 경우 129 | - [자판기가 보유한 금액] 10원으로 나누어 떨어지지 않는 경우 130 | - [상품] 개별 상품이 세미콜론(`:`)을 기준으로 나뉘지 않은 경우 131 | - [상품] 세미콜론(`:`)을 기준으로 개별 상품으로 나누었을 때 각각의 개별상품이 대괄호(`[]`)로 묶이지 않은 경우 132 | - [상품] 개별 상품의 가격 수량이 쉼표(`,`)로 구분되지 않은 경우 133 | - [상품] 개별 상품의 상품명, 가격, 수량 중 값이 누락된 것이 있을 경우 134 | - [상품 - 상품명] 문장의 시작이 공백으로 시작하는 경우 135 | - [상품 - 가격] 가격이 숫자가 아닌 경우 136 | - [상품 - 가격] 가격이 음수인 경우 137 | - [상품 - 가격] 상품 가격이 100원보다 작은 경우 138 | - [상품 - 가격] 상품 가격이 10원으로 나누어 떨어지지 않는 경우 139 | - [상품 - 수량] 수량이 숫자가 아닌 경우 140 | - [상품 - 수량] 수량이 음수인 경우 141 | - [투입금액] 투입 금액이 숫자가 아닌 경우 142 | - [투입금액] 투입 금액이 음수인 경우 143 | - [구매할 상품] 구매할 상품이 없는 상품인 경우 144 | - 초기 자판기의 보유한 동전 세팅하는 메서드 구현 145 | - `camp.nextstep.edu.missionutils.Randoms`의 `pickNumberInList()`를 활용 146 | - 음료를 구매하는 메서드 구현 147 | - 음료의 수량 감소 148 | - 투입 금액의 감소 149 | - 구매 상품의 재고가 0인 경우 예외상황 발생 150 | - 잔돈이 상품 구매하려는 상품 가격보다 적은 경우 151 | - 모든 상품 품절 여부 판단 메서드 구현 152 | - 잔돈 반환 메서드 구현 153 | 154 | 155 | 156 | 157 |
158 | 159 | # 📋 구현 체크 리스트 160 | * [ ] 자판기 클래스 생성 161 | * [ ] 자판기를 실행시키는 메서드 생성 162 | * [ ] 상품 클래스 생성 163 | * [ ]상품 리스트 클래스 생성 164 | * [ ] 사용자 입력관련 메서드 구현 165 | * [ ] 입력 값은 `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용하였는가? 166 | * [ ] 잘못된 입력을 판단하는 메서드 구현 167 | * [ ] 잘못된 값을 입력할 경우 **IllegalArgumentException**을 발생시켰는가? 168 | * [ ] 잘못된 값에 대해 "[ERROR]"를 통한 메시지를 출력 후 입력을 다시 받았는가? 169 | * [ ] [자판기가 보유한 금액] 금액이 숫자가 아닌 경우 170 | * [ ] [자판기가 보유한 금액] 금액이 음수인 경우 171 | * [ ] [자판기가 보유한 금액] 10원으로 나누어 떨어지지 않는 경우 172 | * [ ] [상품] 개별 상품이 세미콜론(`:`)을 기준으로 나뉘지 않은 경우 173 | * [ ] [상품] 세미콜론(`:`)을 기준으로 개별 상품으로 나누었을 때 각각의 개별상품이 대괄호(`[]`)로 묶이지 않은 경우 174 | * [ ] [상품] 개별 상품의 가격 수량이 쉼표(`,`)로 구분되지 않은 경우 175 | * [ ] [상품] 개별 상품의 상품명, 가격, 수량 중 값이 누락된 것이 있을 경우 176 | * [ ] [상품 - 상품명] 문장의 시작이 공백으로 시작하는 경우 177 | * [ ] [상품 - 가격] 가격이 숫자가 아닌 경우 178 | * [ ] [상품 - 가격] 가격이 음수인 경우 179 | * [ ] [상품 - 가격] 상품 가격이 100원보다 작은 경우 180 | * [ ] [상품 - 가격] 상품 가격이 10원으로 나누어 떨어지지 않는 경우 181 | * [ ] [상품 - 수량] 수량이 숫자가 아닌 경우 182 | * [ ] [상품 - 수량] 수량이 음수인 경우 183 | * [ ] [투입금액] 투입 금액이 숫자가 아닌 경우 184 | * [ ] [투입금액] 투입 금액이 음수인 경우 185 | * [ ] [구매할 상품] 구매할 상품이 없는 상품인 경우 186 | * [ ] 초기 자판기의 보유한 동전 세팅하는 메서드 구현 187 | * [ ] `camp.nextstep.edu.missionutils.Randoms`의 `pickNumberInList()`를 활용하였는가? 188 | * [ ] 음료를 구매하는 메서드 구현 189 | * [ ] 음료의 수량 감소 190 | * [ ] 투입 금액의 감소 191 | * [ ] 구매 상품의 재고가 0인 경우 예외상황 발생 192 | * [ ] 잔돈이 상품 구매하려는 상품 가격보다 적은 경우 193 | * [ ] 모든 상품 품절 여부 판단 메서드 구현 194 | * [ ] 잔돈 반환 메서드 구현 195 | 196 |
197 | 198 | * [ ] 출력 형태를 잘 지켰는가? 199 | * [ ] JDK 8 버전을 사용하였는가? 200 | * [ ] indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현하였는가? 201 | * [ ] 3항 연산자를 사용하지 않고 구현하였는가? 202 | * [ ] 모든 테스트케이스가 성공하는가? 203 | * [ ] 모든 메서드의 길이가 15라인을 넘지 않았는가? 204 | * [ ] Else를 사용하지 않았는가? 205 | * [ ] 클래스 분리하는데 노력을 하였는가? 206 | * [ ] 매직넘버 대신 상수(`static final`)로 코드의 가독성을 높였는가? 207 | * [ ] 클래스를 상수, 멤버 변수, 생성자, 메서드 순으로 작성하며 구현 순서를 지켰는가? 208 | 209 | 210 | -------------------------------------------------------------------------------- /Week1 (21.11.24~30)/Unit Test 학습 내용 정리.md: -------------------------------------------------------------------------------- 1 | # Unit Test란? 2 | Unit test는 프로그래밍을 할 때 소스코드의 특정 모듈(메서드)이 의도된 대로 정확히 작동하는지 검증하는 절차입니다. 다시 말해 작성한 모든 메서드들에 대해서 테스트케이스를 작성하는 것을 의미합니다. 3 | 4 | ## Unit Test의 장점 5 | Unit Test를 진행하게 된다면 하나의 기능을 독립적으로 테스트를 하며 코드 변경으로 인해 문제가 발생하여도 짧은 시간안에 해당 문제를 파악할 수 있습니다. 6 | - 새로운 기능 추가 시 수시로 빠르게 테스트 할 수 있다. 7 | - 리팩토링 시에 안정성을 확보할 수 있다. 8 | - 테스팅에 대한 시간과 비용을 절감할 수 있다. 9 | - 코드에 대한 문서가 될 수 있다. 10 | 11 | 이러한 장점들이 있어 실무에서는 Unit Test를 선호하고 있다고 합니다. 12 | 13 | 14 | ## 좋은 Unit Test를 하는 방법 15 | - 1개의 테스트 함수에 대해서는 assert를 최소화해야한다. 16 | - 1개의 테스트 함수에는 1가지 개념만을 테스트하여야 한다. 17 | 18 | 좋고 깨끗한 테스트 코드는 FIRST라는 5가지 규칙을 따라야 한다. 19 | - Fast: 테스트는 빠르게 동작하여 자주 돌릴 수 있어야 한다. 20 | - Independent: 각각의 테스트는 독립적이며 서로 의존해서는 안된다. 21 | - Repeatable: 어느 환경에서도 반복 가능해야 한다. 22 | - Self-Validating: 테스트는 성공 또는 실패로 bool 값으로 결과를 내어 자체적으로 검증되어야 한다. 23 | - Timely: 테스트는 적시에 즉, 테스트하려는 실제 코드를 구현하기 직전에 구현해야 한다. 24 | 25 | 26 | > 출처: https://mangkyu.tistory.com/143 [MangKyu's Diary] 27 | 28 | 29 | ## Java의 간단한 Unit Test 30 | - Java의 Unit Test는 최근에는 JUnit5와 AssertJ 라이브러리를 많이 사용한다고 합니다. 31 | - JUnit5 : 자바의 단위 테스트를 위한 테스팅 프레임워크 32 | - AssertJ : 자바의 단위 테스트를 돕기 위해 다양한 문법을 지원하는 라이브러리 33 |
34 | - 요즘 Unit test는 주로 한개의 단위를 3가지로 나눠서 처리하는 given-when-then패턴을 사용하는 추세라 한다. 35 | - given(준비) : 어떠한 데이터가 준비되었을 때 36 | - when(실행) : 어떠한 함수를 실행하면! (조건을 지정한다고 생각하면 된다.) 37 | - then(검증) : 어떠한 결과가 나와한다. 38 | - verify : 메서드가 호출된 횟수, 타임아웃 시간 체크를 검사할 때 사용 (부가적) 39 | 40 | > `when()`에서 메서드를 통해 조건을 걸 때 매개변수 값이 어떤 값이라도 상관없으면 `any..`로 시작하는 메서드를 사용하며 특정 값을 넣어야 한다면 `eq()`메서드를 활용합니다. 41 | example ) 42 | ```java 43 | when(cal.add(anyInt(), anyInt())). ~~ 44 | when(cal.add(eq(1), eq(4)). ~~ 45 | ``` 46 | 47 | **옳바른 입력값 테스트** 48 | ```java 49 | @DisplayName("옳바른 입력값 테스트") 50 | @Test 51 | void validInputTest() { 52 | // given 53 | final InputUtil inputUtil = new InputUtil(); 54 | System.setIn(new ByteArrayInputStream("123".getBytes())); 55 | 56 | // when 57 | final List
87 |
88 |
89 | ## Stub, Mock의 개념
90 | 프로그래밍을 하게되면 대부분의 객체는 메서드를 시행할 때 다른 객체들과 메시지를 주고받으면서 작업을 하는 것을 알 수 있습니다. 하지만 Unit test는 하나의 모듈에 대한 독립적인 테스트이기 때문에 다른 객체와 메시지를 주고 받는 경우 문제가 발생합니다. 이를 해결하기 위해 메시지를 주고받는 다른 객체 대신에 **Mock Object(가짜 객체)**를 생성하여 테스트합니다.
91 | 또 생성한 Mock Object를 주입하고 어떤 결과를 반환하라고 정해진 결과값을 준비하는데 이것을 **Stub**이라고 합니다.
92 |
93 | > **Mock** : Unit Test를 할 모듈과 메시지를 주고받는 객체를 대신할 가짜 객체이다.
94 | **Stub** : 실제 코드나 아직 준비되지 못한 코드를 호출하여 수행할 때 호출된 요청에 대해 미리 준비해둔 결과를 제공하는 테스트 메커니즘이다.
95 |
96 | ## Mockito란?
97 | Mockito는 개발자가 동작을 직접 제어할 수 있는 가짜(Mock) 객체를 지원하는 테스트 프레임워크입니다. 앞서 말했듯이 개발을 하다보면 객체들간의 의존성이 존재하여 테스트의 어려움이 있습니다. 이러한 문제를 해결하기 위해 Mock Object를 만들어 주입시켜주는데 이를 지원해주는 라이브러리가 Mockito입니다.
98 |
99 | >※ Mockito는 과거에는 static메서드를 지원하지 않는 단점이 있어 PowerMock을 대안으로 사용했으나 Mockito 3.4.0부터는 static method도 지원하고 있습니다.
100 |
101 | ### Mockito사용법
102 | #### 1. Mock 객체의 의존성 주입
103 | Mockito에서 Mock object에 의존성을 주입하기 위해서는 크게 3가지의 어노테이션을 사용합니다.
104 | - `@Mock` : Mock 객체를 만들어 반환해주는 어노테이션
105 |
106 | > `@Mock`을 사용하지 않고 `mock()`메서드를 통해서도 mock객체를 만들 수 있다.
107 | example)
108 | ```java
109 | Hint hint = mock(Hint.class);
110 | ```
111 |
112 | - `@Spy`: Stub하지 않은 메소드들을 원본 메소드 그대로 사용하는 어노테이션
113 | - `@InjectMocks`: @Mock 또는 @Spy로 생성된 가짜 객체를 자동으로 주입시켜주는 어노테이션
114 |
115 | #### 2. Stub
116 | Mockito에서는 아래의 stub메서드들을 지원하고 있습니다.
117 | `doReturn()`: Mock 객체가 특정한 값을 반환해야 하는 경우 사용
118 | ```java
119 | doReturn(3).when(p).add(anyInt(), anyInt());
120 | ```
121 | `doNothing()`: Mock 객체가 아무 것도 반환하지 않는 경우 사용(void)
122 | ```java
123 | @Test
124 | public void example(){
125 | Person p = mock(Person.class);
126 | doNothing().when(p).setAge(anyInt());
127 | p.setAge(20);
128 | verify(p).setAge(anyInt());
129 | }
130 | ```
131 | `doThrow()`: Mock 객체가 예외를 발생시키는 경우 사용
132 | ```java
133 | @Test(expected = IllegalArgumentException.class)
134 | public void example(){
135 | Person p = mock(Person.class);
136 | doThrow(new IllegalArgumentException()).when(p).setName(eq("JDM"));
137 | String name = "JDM";
138 | p.setName(name);
139 | }
140 | ```
141 |
142 | ### Stub의 doReturn, thenReturn의 차이
143 | Mockito를 사용하다보면 코드들에 `doThrow`, `doReturn`등의 형식이 아닌 `thenReturn()`, `thenThrow()`등의 형식도 볼 수 있을 것이다. 둘의 차이점은 다음과 같습니다.
144 |
145 | **doReturn**
146 | - 실제로 메서드를 호출하고 리턴값을 임의로 정의할 수 있다.
147 | - 메서드를 실제로 수행하여 메서드 작업이 오래걸릴 경우 끝날 때 까지 기다려야한다.
148 | - 실제 메서드를 호출하기 때문에 대상 메서드에 문제점이 있을 경우 발견할 수 있다.
149 | ```java
150 | doReturn(6).when(cal).add(2, 4);
151 | ```
152 |
153 | **thenReturn**
154 | - 메서드를 실제로 호출하지 않으며 리턴값을 임의로 정의할 수 있다.
155 | - 실제 메서드를 호출하지 않기 때문에 대상 메서드에 문제점이 있어도 알 수 없다.
156 |
157 | ```java
158 | when(cal.add(2, 4)).thenReturn(6);
159 | ```
160 |
161 | 162 | 163 | # Reference 164 | - https://ko.wikipedia.org/wiki/%EC%9C%A0%EB%8B%9B_%ED%85%8C%EC%8A%A4%ED%8A%B8 165 | - https://mangkyu.tistory.com/143 166 | - https://mangkyu.tistory.com/144 167 | - https://beomseok95.tistory.com/294 168 | - https://jdm.kr/blog/222 169 | - https://medium.com/@SlackBeck/mock-object%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80-85159754b2ac 170 | - https://medium.com/@SlackBeck/%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%8A%A4%ED%85%81-test-stub-%EC%9D%B4%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80-ff9c8840c1b0 171 | - https://m.blog.naver.com/inho1213/80110527396 172 | - https://royleej9.tistory.com/entry/Mockito-doReturn-thenReturn 173 | - http://daplus.net/java-mockito-doreturn-%EA%B3%BC-when-%EC%9D%98-%EC%B0%A8%EC%9D%B4%EC%A0%90/ -------------------------------------------------------------------------------- /Week3 이후부터 최종 테스트 이전까지/최종 코딩테스트 대비 1.md: -------------------------------------------------------------------------------- 1 | # 최종 코딩테스트 일정 2 | 우테코 프리코스 기간이 14일 화요일로 종료가 되었고 바로 평상시와 과제 안내처럼 수요일 15시에 최종 코딩테스트 안내 메일을 받았습니다. 3 | 4 |  5 | 6 | 원래는 오프라인으로 치루는 시험이지만 최근 코로나 확진자가 역대급으로 많이 나오게 되어 지난 3주차 과제 안내에서 말한 바와 같이 올해 최종 코딩테스트는 비대면으로 치루게 되었습니다.. 7 | 8 | 지원자들의 코드 리뷰를 많이 하며 대단하다고 느낀 여러 우테코 지원자들과 우테코 포비님을 직접 뵐 수 있을 기회라고 생각했는데 아쉬운 것 같습니다😥😥 9 | 10 | 11 | # 시험 안내 12 | 시험은 1-6시 예정이며 `Pull Request`는 지원자들이 미리 제출한 지원자의 코드를 보고 테스트를 진행하는 것을 막기 위해 5시 30분 이후로 미션 제출을 할 수 있도록 한 것 같습니다. 13 | 14 | 최종 코딩테스트는 비대면인 만큼 줌으로 지원자와 컴퓨터 모니터가 나오게 라이브로 송출을 하여야 하며 마이크 또한 켜둔 상태로 시험을 치뤄야합니다. 15 | (주말이라 가족들이 모두 있을텐데 미리 말을 해둬야겠어요..😎) 16 | 17 | 그 외의 메인 안내사항으로는 인터넷 구글링이 허용된다는 점이 있는 것 같습니다. 18 | 19 | # 코딩테스트 대비🔥 20 | MVC를 지난 3주차 과제를 하며 익혀 아직 익숙하지 않고 과제 진행을 하면서도 많은 시간들을 소모하였던 저는 최종 테스트에 주어지는 5시간은 시간이 많이 부족할 것이라 생각되어 문제들을 다시 풀어보며 대비를 하고자 마음먹었습니다. 21 | 22 | ## [20211215 수] 코드리뷰 23 | 과제를 받은 수요일인 어제는 평상시와 같이 3주차 과제를 제출한 다른 지원자들의 코드리뷰를 하였습니다. 여러 코드를 보던 중 [조동현 님](https://github.com/woowacourse/java-vendingmachine-precourse/pull/5) 의 코드가 MVC구조가 잘 나뉘어져 있고 여러 기술들을 사용하며 코딩을 한 것 같아 유심히 리뷰하고 배우게 되었습니다. 24 | 25 | 조동현 님의 코드를 상세히 리뷰하며 몇가지 배운 점이 있습니다. 26 | 27 | ### 배운점 1. DTO를 통한 데이터 전달 28 |  29 | 30 | itemParser를 비롯한 모든 데이터들의 전달을 DTO객체를 생성하여 전달하는 방법으로 코딩하였습니다. 해당 방법은 Spring학습을 하였을 때 배우곤 하였는데 우테코의 백엔드 교육생으로 지원한 만큼 DTO를 활용한 데이터 전달 방법은 좋은 프로그래밍 방식이라고 생각되었습니다. 31 | 32 | ### 배운점 2. 기본 메서드의 재정의 33 | 해당 지원자님은 `equals`, `hashCode`, `toString`과 같은 기본 메서드들을 재정의하여 사용하였습니다. 지난 과제를 할 때 `List`로 상품 객체들을 저장하여 관리하면 해당 List에서 특정 상품 객체를 어떻게 불러와야 할지 방법이 떠오르지 않아서 저는 `HashMap`을 통해 상품을 관리하였습니다. 하지만 `equals`와 `hashCode`를 재정의하여 사용한다면 `List`를 사용해도 상품의 이름을 통해 해당 객체로 접근할 수 있을 것 같습니다. 금요일에 이번 과제를 다시 프로그래밍 해볼 예정인데 그 때는 `equals`, `hashCode`를 재정의하여 사용해봐야겠습니다. 34 | 35 |  36 | 37 | 또한 지난 과제를 하며 해당 피드백을 놓쳤었는데 금요일 미션을 다시 풀이할 때는 로그 메시지 성격이 강한 자판기 보유 동전같은 것은 `toString`재정의를 통해 출력을 하도록 해야겠습니다. 38 | 39 | 40 |
41 | 42 | ## [20211216 목] 작년 3주차 미션 풀이 43 | 오늘은 지난해 우테코 3기의 프리코스 3주차 미션이었던 [subway-map-precourse](https://github.com/woowacourse/java-subway-map-precourse) 문제를 `fork`한 후 풀어봤습니다. 44 | 45 | 풀어보지 못한 새로운 미션이기도하고 최종 테스트가 얼마 남지 않았기에 오늘은 시간을 측정하며 문제 풀이를 진행하여 보았습니다. 46 | 47 | ### 구현할 내용 정리 48 | 기능 및 구현할 내용 정리는 최종 테스트를 치룬다는 생각을 하며 평상시와 다르게 최소한의 필요한 내용들만 적으려고 해봤습니다. 그렇게 적은 내용은 다음과 같습니다. 49 | 50 | >#### 구현해야 할 내용 51 | - 역 등록기능 만들기 52 | - 중복된 역 등록 금지 53 | - 역 이름은 2글자 이상이어야 한다. 54 | - 역 이름이 공백으로 시작하는 경우 55 | - 역 이름의 입력이 없는 경우 56 | - 역 삭제기능 만들기 57 | - 노선에서도 삭제 필요 58 | - 역 조회기능 (모든 역 출력) 59 |
60 | - 노선 등록 기능 61 | - 노선 이름이 2글자 이상이어야 한다. 62 | - 노선 이름이 공백으로 시작하는 경우 63 | - 노선 이름의 입력이 없는 경우 64 | - 중복된 노선 이름이 존재하는 경우 65 | - 상행 하행 종접 입력 받기 66 | - 이름이 존재하는 역인지 67 | - 둘의 이름이 유요한지 68 | - 둘의 이름이 겹치지 않는지 체크 69 | - 노선 삭제 기능 70 | - 노선 조회 기능 71 |
72 | - 구간 등록 기능 (노선에 역 추가) 73 | - 노선 입력 74 | - 존재하지 않는 노선인지 체크 75 | - 순서 입력 76 | - 숫자인지 체크 77 | - 해당 순서가 가능한 순서인지 체크 78 | - 노선에 중복된 역 등록 금지 79 | 80 | ### 미션을 하며 새롭게 반영한 내용 81 | #### 1. 기본 메서드의 재정의 82 | 이번 미션을 진행하면서는 지난 3주차 자판기 미션에서 놓쳤던 기본 메서드의 재정의를 하였습니다. 아래의 코드는 노선을 나타내는 `Line`클래스의 일부입니다. 83 | 84 | 노선의 이름이 같은 객체는 같은 객체라고 판단을 하기 위해 `equals`와 `hashCode`메서드를 재정의하였으며 해당 미션의 기능중에 노선 정보를 출력하는 기능은 로그 메시지를 남기는 성격이어서 `toString`을 재정의하여 코드를 작성하였습니다. 85 | ```java 86 | @Override 87 | public int hashCode() { 88 | return Objects.hashCode(name); 89 | } 90 | 91 | @Override 92 | public boolean equals(Object obj) { 93 | if (this == obj) 94 | return true; 95 | if (!(obj instanceof Line)) 96 | return false; 97 | 98 | return this.name.equals(((Line) obj).getName()); 99 | } 100 | 101 | @Override 102 | public String toString() { 103 | return "[INFO] " + this.name; 104 | } 105 | ``` 106 | 107 | #### 2. 더욱 체계가 갖춰진 MVC 108 | 코딩은 역시 많이 해봐야 느는 것 같습니다..지난 미션에서는 "이 기능은..service에 가야하나??아니면 Controller에 가야하나..?"하는 고민을 하며 애매한 위치에 작성된 메서드들이 존재하였다면 오늘 프로그래밍한 미션은 한층 더 체계가 갖춰진 것 같습니다. 109 | 110 | 코드를 작성한 체계는 다음과 같습니다. 111 | - **Controller**는 View와 Service에 위치한 메서드를 호출하여 최종적인 단일 기능의 메서드를 생성합니다. (해당 메서드를 호출하면 완벽하게 실행되도록 말이죠😎) 112 | - **Service**는 Repository와 Controller사이에서 비즈니스 로직들이 위치하여 있습니다. 예를 들면 repository의 데이터를 조회하여 입력값이 유요한지를 체크하는 로직과 repository에 최종 데이터 등록, 삭제를 명령하는 메서드들이 들어가 있습니다. 113 | - **Repository**는 실제 DB라 생각하여 Singleton을 적용하여 관리를 하고 값을 return하는 역할만을 하도록 작성하였습니다. 114 | - **domain**은 해당 프로그램에서 사용되는 객체 클래스 파일이 담겨있습니다. 115 | - **utils**에는 앞에서 말한 코드 외의 입력 값이 조건에 맞는 값인지 체크하는 로직이 담긴 `Validator`클래스와 에러 메시지가 담긴 `ExceptionMessage`가 들어있습니다. 116 | 117 | 코드의 구조는 다음과 같습니다. 118 | 119 |  120 | 121 | #### 3. 스트림과 람다식의 사용 122 | 반복적이고 간단하게 나타낼 수 있는 코드의 경우 스트림과 람다식을 활용하여 코드를 간결하게 만들어보려고 노력하였습니다. 123 | ```java 124 | public static void printStationList(List
153 | > [지하철 노선도 미션](https://github.com/Seongwon97/java-subway-map-precourse/tree/Seongwon97) 154 | 155 | -------------------------------------------------------------------------------- /Week3 (21.12.8~14)/Enum 정복하기.md: -------------------------------------------------------------------------------- 1 | 우테코 프리코스 3주차 과제의 요구사항 중 아래의 enum코드를 사용하라는 조건을 접하게 되었습니다. 2 | 3 | ```java 4 | public enum Coin { 5 | COIN_500(500), 6 | COIN_100(100), 7 | COIN_50(50), 8 | COIN_10(10); 9 | 10 | private final int amount; 11 | 12 | Coin(final int amount) { 13 | this.amount = amount; 14 | } 15 | 16 | // 추가 기능 구현 17 | } 18 | ``` 19 | 20 | 기존까지는 enum을 사용을 크게 하지 않고 간단하게 보기 항목을 정의할 때만 사용을 하여 조건으로 주어진 코드는 새롭기도 하고 이해하기도 어려웠습니다. 코드를 한참 찾아보고 다른 지원자의 코드를 봐도 처음에 이해가 어려웠어서 enum을 이번 기회에 새롭게 공부를 하며 나만의 지식으로 만들기 위해 정리를 해보고자 합니다. 21 | 22 | # enum class란? 23 | enum은 Enumeration의 줄임말로 **서로 연관된 상수들의 집합**이라는 의미를 갖습니다. 우리가 일반적으로 상수(constant)를 정의할 때는 `static final`을 사용하여 정의합니다. 하지만 이러한 기존의 상수는 클래스 내에서 선언하는 부분은 네이밍이 겹칠 수 있고 불필요하게 상수가 많아진다는 단점이 발생합니다. 자바 1.5버전 부터는 `Enum`이 새로 생겨 `static final`로 만들어질 수 있는 단점들을 보완할 수 있게 되었습니다. 24 | 25 | 26 | ## enum의 이점 27 | 1. 코드가 단순해지며, 가독성이 좋아진다. 28 | 2. 인스턴스 생성과 상속을 방지하여 상수의 타입 안정성이 보장됩니다. 29 | 3. enum class를 사용해 새로운 상수들의 타입을 정의함으로정의한 타입 이외의 타입을 가진 테이터 값을 컴파일시 체크한다. 30 | 4. 키워드 enum을 사용하기 때문에 구현의 의도가 열거임을 분명하게 알 수 있다. 31 | 32 | > 출처 : https://limkydev.tistory.com/50 33 | 34 | ## enum의 특징 35 | #### 1. 클래스를 상수처럼 사용할 수 있다. 36 | ```java 37 | public enum Coin { 38 | COIN_500(500), 39 | COIN_100(100), 40 | COIN_50(50), 41 | COIN_10(10); 42 | 43 | private final int amount; 44 | 45 | Coin(final int amount) { 46 | this.amount = amount; 47 | } 48 | } 49 | ``` 50 | 우테코 프리코스의 코드를 보면 `default`생성자는 `private`으로 되어 있는 것을 확인할 수 있습니다. 그리고 이를 `public`으로 변경하는 경우 컴파일 에러가 발생합니다. 51 | 52 |  53 | 54 | 이는 다른 상수들이 클래스 로드 시점에 생성되는 것처럼 enum 또한 생성자가 존재하지만 클래스가 로드되는 시점에서 생성되기에 임의로 생성해서 사용할 수 없는 것입니다. 55 | 56 | 사용을 할 때는 `Coin.COIN_500`과 같이 사용하면 됩니다. 57 | 58 | 59 | #### 2. Enum 클래스를 구현하는 경우 상수 값과 같이 유일하게 하나의 인스턴스가 생성되어 사용된다. 60 | - enum은 `싱글톤`형태로 하나의 애플리케이션 안에서 하개의 인스턴스로 생성되어 사용됩니다. 그래서 enum에 인스턴스 변수를 추가하는 것은 위험할 수 있습니다. 61 | 62 | #### 3. 서로 관련 있는 상수 값들을 모아 enum으로 구현하는 경우가 유용하다. 63 | - 저는 해당 내용이 enum을 사용을 하는 가장 큰 이유라고 생각됩니다. 64 | 65 | #### 4. 클래스와 같은 문법 체계를 따른다. 66 | - 클래스의 형태를 보이고 있어 관련 로직들을 enum클래스 내에서 관리할 수 있습니다. 67 | 68 | #### 5. 상속을 지원하지 않는다. 69 | - enum은 `java.lang.enum`의 상속을 받기 때문에 다른 상속을 지원하지 않는다. 70 | 71 | ## Enum의 API들 72 | ### 1. values() 73 | 74 |  75 | 76 | - `values()`는 Enum 클래스가 갖고 있는 인스턴스가 담긴 배열을 반환하는 작업을 합니다. 77 | 위의 코드를 보면 해당 enum이 가진 모든 인스턴스 값들을 반환하여 출력되는 것을 확인할 수 있습니다. 78 | 79 | 80 | ### 2. valueOf() 81 | - `valueOf()`는 string의 입력을 받아 일치하는 인스턴스의 이름이 존재한다면 해당 인스턴스를 반환해줍니다. 82 | 83 |  84 | 85 | ### 3. toString() 86 | - enum에서 `toString()`은 인스턴스의 이름을 리턴합니다. 87 | 88 | ### 4. name() 89 | - 해당 메서드 또한 인스턴스의 이름을 리턴해줍니다. 90 | 91 | ## 프리코스 3주차에서의 Enum활용 92 | 우테코 프리코스 3주차 자판기 미션을 활용하면서 저는 enum클래스를 다음과 같이 작성하였습니다. 코드를 살펴보면 앞서 말한 enum의 특징인 enum은 클래스와 같은 문법 체계를 따르고 관련있는 상수들을 모아서 관리를 한 것을 확인하실 수 있습니다. 93 | ```java 94 | public enum Coin { 95 | COIN_500(500), 96 | COIN_100(100), 97 | COIN_50(50), 98 | COIN_10(10); 99 | 100 | private final int amount; 101 | 102 | 103 | Coin(final int amount) { 104 | this.amount = amount; 105 | } 106 | 107 | public static List
10 | 11 | # CHANGELOG.md 생성 12 | - 새로운 기능 (new Feature) 13 | - 버그 수정 (bug fixs) 14 | - 주요 변경 사항 (breaking changes) 15 | 변경 로그에서는 위의 3가지 내용을 사용합니다. 16 | 17 | 위의 3가지 목록들은 릴리즈를 수행할 때 관련 커밋에 대한 링크와 함께 스크립트로 생성할 수 있습니다. 18 | 물론 실제 릴리즈 전에 변경로그를 수정하고 배포할 수도 있습니다. 19 | 20 | 마지막 릴리즈 이후의 모든 제목 목록을 출력합니다. 21 | ※ 제목 (subject) : 커밋 메세지의 첫 번째 줄 22 | ```shell 23 | git log
68 | 69 | # 커밋 메시지 형식 70 | ```shell 71 |