#66 - bridge.get_ranked_posts API 연동 구현: ReadRankedPostsUseCase 클래스 추가

dorian-mobileapp (64)in kr-dev 커뮤니티 • 2 years ago (edited)

시작하며...

bridge.get_ranked_posts API로 포스트 리스트를 구하는 기능을 구현 중에 있구요. 저번 포스트에서는 Repository 패턴에 이를 구현하였습니다. Use Case 패턴에도 적용하는 작업이 남았는데요. 이번 포스트에서 이를 구현하고자 합니다.

작업 개요

ReadRankedPostsUseCase 클래스 추가
유닛 테스트를 하기 위한 ReadRankedPostsUseCaseTest 클래스 추가

ReadRankedPostsUseCase 클래스 추가

지난 포스트에서 구현한 SteemRepository 인터페이스의 readRankedPosts 메소드를 호출하여 ranked post들을 읽어 옵니다. 코드는 아래와 같습니다.

class ReadRankedPostsUseCase(val steemRepository: SteemRepository) {

    operator fun invoke(
        sort: String,
        tag: String,
        observer: String = "",
        limit: Int = 20,
        lastPostItem: PostItem? = null
    ): Single<List<PostItem>> {
        return steemRepository.readRankedPosts(
            sort,
            tag,
            observer,
            limit,
            lastPostItem
        )
    }

}

lastPostItem 파라메터

포스트 리스트 처음 읽을 때: null로 대입
이후 추가로 포스트 더 부를 때: 포스트 리스트의 마지막 포스트 대입

observer 파라메터

로그인 한 경우: 사용자 계정으로 대입
로그인 안 한 경우: 빈 문자열 대입

코드에서 추가로 발견한 문제점

limit 파라메터의 기본값을 20으로 설정했는데, 이름 있는 상수가 아니라 리터럴(literal)로 지정했습니다. GetRankedPostParamsDTO 클래스 안에 상수를 정의했지만, ReadRankedPostsUseCase 클래스는 도메인 모듈에 속해 있습니다. 반면, GetRankedPostParamsDTO 클래스는 데이터 모듈에 속해 있죠. limit 파라메터의 기본 값을 의미하는 상수를 어디에 다시 정의해야 할지 고민해봐야 하겠습니다.

유닛 테스트를 하기 위한 ReadRankedPostsUseCaseTest 클래스 추가

이 클래스가 잘 작동하는지 테스트가 필요하죠. 유닛 테스트 코드를 만들었습니다.

class ReadRankedPostsUseCaseTest {

    val readRankedPostsUseCase = ReadRankedPostsUseCase(SteemRepositoryImpl())

    private fun testPostItemList(postItemList: List<PostItem>) {
        for (postItem in postItemList) {
            Assert.assertTrue(postItem.account.isNotEmpty())
            Assert.assertTrue(postItem.permlink.isNotEmpty())
            Assert.assertTrue(postItem.title.isNotEmpty())
            Assert.assertTrue(postItem.content.isNotEmpty())
        }
    }

    // Test case 1: Read the first 20 trending posts containing "kr" tag.
    @Test
    fun invoke_case1() {
        readRankedPostsUseCase(
            GetRankedPostParamsDTO.InnerParams.SORT_TRENDING,
            "kr"
        ).subscribe { postItemList ->
            Assert.assertEquals(postItemList.size, GetRankedPostParamsDTO.InnerParams.DEFAULT_LIMIT)
            testPostItemList(postItemList)
        }
    }

    // Test case 2: Read the first 20 trending posts and the second 20 ones containing "kr" tag.
    @Test
    fun invoke_case2() {
        var lastPostItem: PostItem? = null
        val postItemList = mutableListOf<PostItem>()

        readRankedPostsUseCase(
            GetRankedPostParamsDTO.InnerParams.SORT_TRENDING,
            "kr"
        ).subscribe { readPostItemList ->
            lastPostItem = readPostItemList.last()
            postItemList.addAll(readPostItemList)
            testPostItemList(postItemList)
        }

        readRankedPostsUseCase(
            GetRankedPostParamsDTO.InnerParams.SORT_TRENDING,
            "kr",
            lastPostItem = lastPostItem
        ).subscribe { readPostItemList ->
            postItemList.addAll(readPostItemList)
            Assert.assertEquals(readPostItemList.size, GetRankedPostParamsDTO.InnerParams.DEFAULT_LIMIT)
            Assert.assertEquals(postItemList.size, 2 * GetRankedPostParamsDTO.InnerParams.DEFAULT_LIMIT)
            testPostItemList(postItemList)
        }
    }

}

invoke_case1() 메소드: 태그 kr을 가진 트렌딩 포스트 20개를 정상적으로 로딩하는지 테스트
invoke_case2() 메소드: 태그 kr을 가진 트렌딩 포스트 20개를 그리고 다시 한번 20개를 정상적으로 로딩하는지 테스트

SteemRepositoryImpl 클래스의 readRankedPosts 메소드 테스트

지난 포스트에서 SteemRepositoryImpl 클래스에 구현한 readRankedPosts 메소드가 정상적으로 실행되는지 테스트 하는 코드를 보여드리지 못 했습니다. 이번 포스트에서 추가로 보여 드립니다.

class SteemRepositoryImplTest {

    // ...

    @Test
    fun readRankedPosts() {
        steemRepository.readRankedPosts("trending", "kr").subscribe { postItemList ->
            assertEquals(postItemList.size, GetRankedPostParamsDTO.InnerParams.DEFAULT_LIMIT)
            for (postItem in postItemList) {
                assertTrue(postItem.account.isNotEmpty())
                assertTrue(postItem.permlink.isNotEmpty())
                assertTrue(postItem.title.isNotEmpty())
                assertTrue(postItem.content.isNotEmpty())
            }
        }
    }

}

readRankedPosts 메소드

SteemRepositoryImpl 클래스의 readRankedPost 메소드가 포스트 리스트를 정상적으로 불러오는지 테스트
테스트 조건
- 정렬 방식(sort): trending
- 태그: kr
- 포스트 개수: 20
테스트 대상
- 포스트의 계정이 정상적으로 로딩되었는가?
- 포스트의 permlink가 정상적으로 읽혔는가?
- 포스트 제목이 정상적인가?
- 포스트 내용에 이상 없는가?