Name	Name	Last commit message	Last commit date
parent directory ..
Assignment2Skeleton	Assignment2Skeleton
README.md	README.md
demo.gif	demo.gif

Wafflestudio Android Seminar 2 - Assignment

과제 목표

Room DB의 개념을 이해하고 사용할 수 있다.
- ViewModel이 데이터를 영구적으로 저장할 수 없음을 이해하고 Room DB를 활용해 영구적인 정보 저장을 구현할 수 있다.
- Database - Repository - ViewModel - View 로 이어지는 데이터의 흐름을 이해한다.
RecyclerView의 개념을 이해하고 사용할 수 있다.
- Adapter, ViewHolder의 역할을 알고 구현할 수 있다.

SimpleTodo Application을 Android Application으로 구현한다.
사용자는 floating button을 클릭하여 title과 content라는 두 문자열을 가진 새로운 Todo를 추가할 수 있다. (CREATE)
Todo는 RecyclerView를 통해 구현한 UI 에 나타나야 한다 (READ)
사용자가 뷰의 Todo item의 DONE 버튼을 누를 시 해당 Todo item을 삭제한다. (DLELTE)
위 TODO 데이터는 안드로이드 로컬 데이터베이스에 저장하여 앱을 재시작하더라도 남아있어야 한다. (Android Room 을 통해 구현 가능)
- 기본적인 Table(Entity)은 이미 뼈대 코드에 구현해 놓았다 (Todo.kt)
뼈대 코드의 경우 이 레포지토리의 Assignment2Skeleton 폴더에 제공된다.
뼈대 코드는 사용해도 좋고, 직접 a-z를 만들어 보아도 좋다.
과제의 채점은 pass / fail 로 구체적인 기준은 두지 않고, 앞서 언급된 Simple Todo Application의 명세를 만족하면 pass 이다.
- 다만, Repository Pattern 과 Room Database 를 활용하여 완결성 있는 MVVM pattern의 앱을 작성해야 한다.
- MVVM Pattern은 뼈대 코드에 이미 구현되어 있다.
- 뼈대 코드를 사용할 경우 이미 구현된 MVVM Pattern 코드를 보고 데이터의 흐름을 이해한다.

suspend fun은 코루틴의 요소 중 하나로 async programming을 구현하기 위해 사용되었다. 이 내용은 다음 세미나에서 자세하게 다룰 것이나, Room에서 DB의 접근을 main thread에서 허용하지 않기 때문에 부득이하게 이번 과제에서 사용하게 되었다.
사용 방법은 다음과 같다.
1. TodoDao.kt 에서 LiveData를 사용하지 않는 (즉, READ 작업이 아닌 경우) 함수에 대해 suspend fun으로 선언한다.
```
@Query("SELECT ...")
fun getSomething(): LiveData<...>  // suspend 필요 X

@Insert
suspend fun insertSomething(something: ...)  // suspend 필요 O
```
1. Repository에서도 suspend fun으로 선언하여 ViewModel에서 사용할 수 있도록 한다.
2. ViewModel에서 다음과 같이 선언하여 일반 fun으로 바꿔준다.
```
fun insertSomething(something: ...) {
    viewModelScope.launch {
        somethingRepository.insertSomething(something)
    }
}
```
ViewModel의 함수 내에서 viewModelScope.launch 로 Repository의 suspend fun을 감싸주면 된다.
1. Activity에서 잘 사용한다.
```
binding.someButton.setOnClickListener {
    viewModel.insertSomething(somethingData)
}
```

본인의 github에 생성했던 waffle-android-assign repository를 그대로 사용한다.
기존에 사용하던 깃의 master branch에서 git checkout -b assignment2 등으로 새로운 branch로 이동한다.
다음의 방식을 사용하여 과제를 진행한다.
- Android Studio를 통해 waffle-android-assign 폴더 안에 Assignment2 라는 이름의 새로운 프로젝트를 만들어 진행한다.
- wafflestudio/19.5-rookies repo를 clone한 뒤, android/assignment_2/Assignment2Skeleton 폴더를 복사하여 진행한다.
과제를 완료한 후 git add ., git commit, git push origin assignment2를 통해 github에 업로드한 뒤, main(master) branch로 Pull Request를 만든다.
생성된 Pull Request에 @veldic을 Reviewers로 등록한다.

waffle-android-assign
├── Assignment0
├── (Assignment1)  // 있어도 되고 없어도 됨
├── Assignment2
    ├── app
    .
    .
    .

위와 같은 폴더 구조가 만들어지면 된다.