[Kotlin] 도서 검색 앱 만들기２

ViewBinding과 Room, Retrofit2를 이용하기 위한 라이브러리를 추가해 줍니다.

그리고 책의 이미지는 url로 들어오는데 이 url에서 이미지를 가져오려면 Glide라는 라이브러리를 사용해야 합니다.

 

build.gradle (Module)

plugins {
    ...
    id 'kotlin-kapt'
}

android {
    ...

    buildFeatures {
        viewBinding = true
    }
}

dependencies {

    ...

    // Retrofit2
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

    // Glide
    implementation 'com.github.bumptech.glide:glide:4.12.0'

    // Room
    def roomVersion = "2.4.2"

    implementation "androidx.room:room-ktx:$roomVersion"
    kapt "androidx.room:room-compiler:$roomVersion"
}

 

Retrofit2를 사용하려면 인터넷 권한을 허용해줘야 한다.

 

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.ta2gi.searchbook">

    <!-- 인터넷 권한 -->
    <uses-permission android:name="android.permission.INTERNET"/>

    <application
        ...
    </application>

</manifest>

 

MainActivity.kt

package com.ta2gi.searchbook

import android.app.Activity
import android.content.Context
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import android.view.View
import android.view.inputmethod.InputMethodManager
import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentTransaction
import com.google.android.material.snackbar.Snackbar
import com.ta2gi.searchbook.adapter.HistoryAdapter
import com.ta2gi.searchbook.adapter.SearchAdapter
import com.ta2gi.searchbook.databinding.ActivityMainBinding
import com.ta2gi.searchbook.fragment.HomeFragment
import com.ta2gi.searchbook.fragment.SearchFragment
import com.ta2gi.searchbook.retrofit2.BookDto
import com.ta2gi.searchbook.retrofit2.KakaoData
import com.ta2gi.searchbook.retrofit2.KakaoInfo.Companion.API_KEY
import com.ta2gi.searchbook.retrofit2.RetrofitService.kakaoService
import com.ta2gi.searchbook.room.HistoryDatabase
import com.ta2gi.searchbook.room.HistoryEntity
import retrofit2.Call
import retrofit2.Callback
import retrofit2.Response

class MainActivity : AppCompatActivity() {

    // 뷰바인딩
    lateinit var mainBinding : ActivityMainBinding

    // 프래그먼트를 담을 변수
    lateinit var currentFragment : Fragment

    // 검색어 저장 용도
    var searchWord = ""

    // 검색 기록, 검색 리스트
    var historyList = mutableListOf<HistoryEntity>()
    var searchList = mutableListOf<BookDto>()

    // 어뎁터
    val searchAdapter = SearchAdapter(this, searchList)

    // 데이터베이스
    lateinit var historyDatabase : HistoryDatabase

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // 뷰바인딩 초기화
        mainBinding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(mainBinding.root)

        // 데이터베이스 초기화
        historyDatabase = HistoryDatabase.getInstance(this)!!

        // 실행 시 첫 화면 HomeFragment
        fragmentController("home", false)
    }

    // 프래그먼트
    fun fragmentController(view: String, add: Boolean) {
        // 들어오는 view 값에 따라 프래그먼트 변경
        when (view) {
            "home" -> currentFragment = HomeFragment(this)
            "search" -> currentFragment = SearchFragment(this)
        }

        // 프래그먼트 교체 해주기
        val fragmentTransaction = supportFragmentManager.beginTransaction()
        fragmentTransaction.replace(R.id.act_main_screen, currentFragment)

        // 백스텍에 추가
        if (add) fragmentTransaction.addToBackStack(view)

        // 애니메이션 효과 넣기
        fragmentTransaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN)

        // 프래그먼트 실행
        fragmentTransaction.commit()
    }

    // 자판 내리기
    fun hideKeyboard(act : Activity){
        val imm = act.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
        imm.hideSoftInputFromWindow(act.currentFocus?.windowToken, 0)
    }

    // 레트로핏
    fun searchResults(searchWord : String, fragment : SearchFragment) {
        val book = kakaoService.getSearchBook(API_KEY, searchWord)

        book.enqueue(object: Callback<KakaoData> {
            override fun onResponse(call: Call<KakaoData>, response: Response<KakaoData>) {
                // 통신에 성공 시 리스트에 책들 담고 어뎁터에 변경사항 알려주기
                searchList.clear()
                searchList.addAll(response.body()!!.documents)
                searchAdapter.notifyDataSetChanged()

                // 리스트가 비어 있으면 empty 보여주기
                if(searchList.isEmpty()) {
                    fragment.searchBinding.fraSeaEmptySearchList.visibility = View.VISIBLE
                    fragment.searchBinding.fraSeaSearchList.visibility = View.GONE
                } else { // 리스트가 있으면 보여주기
                    fragment.searchBinding.fraSeaSearchList.visibility = View.VISIBLE
                    fragment.searchBinding.fraSeaEmptySearchList.visibility = View.GONE
                }
            }

            override fun onFailure(call: Call<KakaoData>, t: Throwable) {
                Log.d("로그", "통신 실패 : ${t.message}")
            }
        })
    }
}

HomeFragment.kt

package com.ta2gi.searchbook.fragment

import android.os.Bundle
import androidx.fragment.app.Fragment
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import com.google.android.material.snackbar.Snackbar
import com.ta2gi.searchbook.MainActivity
import com.ta2gi.searchbook.R
import com.ta2gi.searchbook.adapter.HistoryAdapter
import com.ta2gi.searchbook.databinding.FragmentHomeBinding
import com.ta2gi.searchbook.room.HistoryEntity
import kotlin.concurrent.thread

class HomeFragment(val mainActivity : MainActivity) : Fragment(), View.OnClickListener {

    // 뷰바인딩
    lateinit var homeBinding : FragmentHomeBinding

    // 어뎁터
    val historyAdapter = HistoryAdapter(mainActivity, mainActivity.historyList, this)

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }

    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        // 뷰바인딩 초기화
        homeBinding = FragmentHomeBinding.inflate(inflater)

        // 실행 시 자판 올라오는 현상 막기
        homeBinding.fraHomSearchText.clearFocus()
        mainActivity.hideKeyboard(mainActivity)

        // 검색 기록 띄우기
        thread {
            homeBinding.fraHomHistoryList.adapter = historyAdapter

            mainActivity.historyList.clear()
            mainActivity.historyList.addAll(mainActivity.historyDatabase.historyDao().getHistory())
            historyAdapter.notifyDataSetChanged()

            // 리스트가 비어 있으면 empty 보여주기
            if(mainActivity.historyList.isEmpty()) {
                mainActivity.runOnUiThread {
                    homeBinding.fraHomEmptyHistory.visibility = View.VISIBLE
                    homeBinding.fraHomHistory.visibility = View.GONE
                }
            } else { // 리스트가 있으면 보여주기
                mainActivity.runOnUiThread {
                    homeBinding.fraHomHistory.visibility = View.VISIBLE
                    homeBinding.fraHomEmptyHistory.visibility = View.GONE
                }
            }
        }

        homeBinding.fraHomSearchButton.setOnClickListener(this)
        homeBinding.fraHomHistoryDeleteAll.setOnClickListener(this)

        return homeBinding.root
    }

    override fun onClick(view : View?) {
        when(view) {
            // 검색 버튼
            homeBinding.fraHomSearchButton -> {
                // 검색어 변수에 담기
                val searchText = homeBinding.fraHomSearchText.text.toString().trim()

                // 공백 입력 시 리턴
                if(searchText.isEmpty()) {
                    Snackbar.make(homeBinding.root, "❗검색어를 입력해주세요", Snackbar.LENGTH_SHORT).show()
                    return
                }

                // 메인에 검색어 담아두기
                mainActivity.searchWord = searchText

                // 돌아왔을 경우 검색어 비워두기
                homeBinding.fraHomSearchText.setText("")

                // 자판 내리기
                mainActivity.hideKeyboard(mainActivity)

                thread {
                    val historyEntity = HistoryEntity(null, searchText)
                    mainActivity.historyDatabase.historyDao().insertHistory(historyEntity)

                    // 프래그먼트 전환
                    mainActivity.fragmentController("search", true)
                }
            }

            // 검색 기록 비우기
            homeBinding.fraHomHistoryDeleteAll -> {
                thread {
                    mainActivity.historyDatabase.historyDao().deleteAllHistory()

                    mainActivity.runOnUiThread {
                        mainActivity.historyList.clear()
                        historyAdapter.notifyDataSetChanged()

                        homeBinding.fraHomEmptyHistory.visibility = View.VISIBLE
                        homeBinding.fraHomHistory.visibility = View.GONE
                    }

                    Snackbar.make(homeBinding.root, "❗검색 기록이 비워졌습니다", Snackbar.LENGTH_SHORT).show()
                }
            }
        }
    }
}

 

SearchFragment.kt

package com.ta2gi.searchbook.fragment

import android.os.Bundle
import androidx.fragment.app.Fragment
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import com.google.android.material.snackbar.Snackbar
import com.ta2gi.searchbook.MainActivity
import com.ta2gi.searchbook.R
import com.ta2gi.searchbook.databinding.FragmentSearchBinding
import com.ta2gi.searchbook.room.HistoryEntity
import kotlin.concurrent.thread

class SearchFragment(val mainActivity : MainActivity) : Fragment(), View.OnClickListener {

    lateinit var searchBinding : FragmentSearchBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }

    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        searchBinding = FragmentSearchBinding.inflate(inflater)

        // 검색어 삽입
        searchBinding.fraSeaSearchText.setText(mainActivity.searchWord)

        // 어뎁터 장착
        searchBinding.fraSeaSearchList.adapter = mainActivity.searchAdapter

        // 삽입된 검색어로 검색
        mainActivity.searchResults(mainActivity.searchWord, this)

        // 클릭 리스너
        searchBinding.fraSeaBack.setOnClickListener(this)
        searchBinding.fraSeaSearchButton.setOnClickListener(this)

        return searchBinding.root
    }

    override fun onClick(view : View?) {
        when(view) {
            // 돌아가기
            searchBinding.fraSeaBack -> mainActivity.supportFragmentManager.popBackStack()

            // 검색
            searchBinding.fraSeaSearchButton -> {
                mainActivity.hideKeyboard(mainActivity)

                val searchText = searchBinding.fraSeaSearchText.text.toString().trim()

                // 공백 입력 시 리턴
                if(searchText.isEmpty()) {
                    Snackbar.make(searchBinding.root, "❗검색어를 입력해주세요", Snackbar.LENGTH_SHORT).show()
                    return
                }

                // 검색 기록에 추가
                thread {
                    val historyEntity = HistoryEntity(null, searchText)
                    mainActivity.historyDatabase.historyDao().insertHistory(historyEntity)
                }

                // 자판 내리고 검색 결과 띄우기
                mainActivity.searchResults(searchText, this)
            }
        }
    }
}

 

HistoryAdapter.kt

package com.ta2gi.searchbook.adapter

import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.TextView
import androidx.recyclerview.widget.RecyclerView
import com.google.android.material.snackbar.Snackbar
import com.ta2gi.searchbook.MainActivity
import com.ta2gi.searchbook.R
import com.ta2gi.searchbook.fragment.HomeFragment
import com.ta2gi.searchbook.room.HistoryEntity
import kotlin.concurrent.thread

class HistoryAdapter(val mainActivity: MainActivity, val historyList : MutableList<HistoryEntity>, val fragment : HomeFragment) : RecyclerView.Adapter<HistoryAdapter.ViewHolderClass>() {
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): HistoryAdapter.ViewHolderClass {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.history_list_item, parent, false)
        return ViewHolderClass(view)
    }

    override fun onBindViewHolder(holder: ViewHolderClass, position: Int) {
        holder.searchWord.text = historyList[position].searchWord

        // 검색 기록 삭제
        holder.searchWordDelete.setOnClickListener {
            thread {
                val historyEntity = HistoryEntity(historyList[position].bookUid, holder.searchWord.text.toString())
                mainActivity.historyDatabase.historyDao().deleteHistory(historyEntity)

                mainActivity.historyList.clear()
                mainActivity.historyList.addAll(mainActivity.historyDatabase.historyDao().getHistory())

                mainActivity.runOnUiThread {
                    notifyDataSetChanged()

                    // 리스트가 비어 있으면 empty 보여주기
                    if(mainActivity.historyList.isEmpty()) {
                        mainActivity.runOnUiThread {
                            fragment.homeBinding.fraHomEmptyHistory.visibility = View.VISIBLE
                            fragment.homeBinding.fraHomHistory.visibility = View.GONE
                        }
                    }
                }

                Snackbar.make(mainActivity.mainBinding.root, "❗검색 기록을 지웠습니다", Snackbar.LENGTH_SHORT).show()
            }
        }
    }

    override fun getItemCount(): Int {
        return historyList.size
    }

    inner class ViewHolderClass(view : View) : RecyclerView.ViewHolder(view) {
        val searchWord = view.findViewById<TextView>(R.id.history_list_item_search_word)
        val searchWordDelete = view.findViewById<ImageView>(R.id.history_list_item_delete)
    }
}

 

SearchAdapter.kt

package com.ta2gi.searchbook.adapter

import android.content.Intent
import android.net.Uri
import android.text.method.ScrollingMovementMethod
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.TextView
import androidx.recyclerview.widget.RecyclerView
import com.bumptech.glide.Glide
import com.google.android.material.snackbar.Snackbar
import com.ta2gi.searchbook.MainActivity
import com.ta2gi.searchbook.R
import com.ta2gi.searchbook.retrofit2.BookDto
import kotlin.concurrent.thread

class SearchAdapter(val mainActivity: MainActivity, val searchList : MutableList<BookDto>) : RecyclerView.Adapter<SearchAdapter.ViewHolderClass>() {
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SearchAdapter.ViewHolderClass {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.search_list_item, parent, false)
        return ViewHolderClass(view)
    }

    override fun onBindViewHolder(holder: SearchAdapter.ViewHolderClass, position: Int) {
        // 이미지, 제목, 저자, 줄거리, 정가, 판매여부, 링크
        Glide.with(mainActivity).load(searchList[position].thumbnail).into(holder.thumbnail)
        holder.title.text = searchList[position].title
        holder.authors.text = searchList[position].authors.toString()
        holder.contents.text = searchList[position].contents
        holder.price.text = "${searchList[position].price}원"
        holder.status.text = searchList[position].status
        holder.url.setOnClickListener {
            val intent = Intent(Intent.ACTION_VIEW, Uri.parse(searchList[position].url))
            mainActivity.startActivity(intent)
        }
    }

    override fun getItemCount(): Int {
        return searchList.size
    }

    inner class ViewHolderClass(view : View) : RecyclerView.ViewHolder(view) {
        val thumbnail = view.findViewById<ImageView>(R.id.search_list_item_thumbnail)
        val title = view.findViewById<TextView>(R.id.search_list_item_title)
        val authors = view.findViewById<TextView>(R.id.search_list_item_authors)
        val contents = view.findViewById<TextView>(R.id.search_list_item_contents)
        val price = view.findViewById<TextView>(R.id.search_list_item_price)
        val status = view.findViewById<TextView>(R.id.search_list_item_status)
        val url = view.findViewById<TextView>(R.id.search_list_item_url)
    }
}

 

이제 Room에 관련된 파일들입니다.

 

HistoryEntity.kt

package com.ta2gi.searchbook.room

import androidx.room.ColumnInfo
import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "HistoryTable")
data class HistoryEntity(
    @PrimaryKey(autoGenerate = true)
    val bookUid : Int?,
    @ColumnInfo
    val searchWord : String
)

 

HistoryDao.kt

package com.ta2gi.searchbook.room

import androidx.room.Dao
import androidx.room.Delete
import androidx.room.Insert
import androidx.room.Query

@Dao
interface HistoryDao {
    // 찜 목록 가져오기
    @Query("SELECT * FROM HistoryTable")
    fun getHistory() : MutableList<HistoryEntity>

    // 찜 목록에 삽입
    @Insert
    fun insertHistory(book : HistoryEntity)

    // 찜 목록에서 제거
    @Delete
    fun deleteHistory(book : HistoryEntity)

    @Query("DELETE from HistoryTable")
    fun deleteAllHistory()

}

 

HistoryDatabase.kt

package com.ta2gi.searchbook.room

import android.content.Context
import androidx.room.Database
import androidx.room.Room
import androidx.room.RoomDatabase

@Database(entities = [HistoryEntity::class], version = 1)
abstract class HistoryDatabase : RoomDatabase() {
    abstract fun historyDao() : HistoryDao

    companion object {
        private var instance : HistoryDatabase? = null

        @Synchronized
        fun getInstance(context: Context): HistoryDatabase? {
            if (instance == null) {
                synchronized(HistoryDatabase::class) {
                    instance = Room.databaseBuilder(
                        context.applicationContext,
                        HistoryDatabase::class.java,
                        "history.db"
                    ).build()
                }
            }
            return instance
        }
    }
}

 

다음으로 Retrofit2를 쓰기 위한 방법과 파일들입니다.

 

https://developers.kakao.com/

Kakao Developers

 

링크로 이동해 카카오에 로그인을 해주고 시작하기를 눌러줍니다.

애플리케이션 추가하기를 클릭 후 앱 이름과 사업자명(아무렇게나 입력 가능)을 입력하고 저장을 누르면 추가가 되고

해당 애플리케이션을 눌러보면 각종 키가 발급이 됩니다.

 

우리에게 필요한 API는 책 검색 API입니다.

아래 링크로 이동 후 우측에 책 검색을 클릭해 보면 우리에게 필요한 정보들이 잘 적혀있습니다.

 

https://developers.kakao.com/docs/latest/ko/daum-search/dev-guide

Kakao Developers

 

Response를 보면 데이터가 어떤 형식으로 들어오는지 알 수 있습니다.

저는 이미지, 제목, 저자, 가격, 판매 상태, 도서 소개, 상세주소만 필요하므로 이것들만 가져와 보겠습니다.

 

책의 정보를 담을 Data Class입니다.

 

BookDto.kt

package com.ta2gi.searchbook.retrofit2

import com.google.gson.annotations.SerializedName

data class BookDto(
    @SerializedName("thumbnail") val thumbnail : String, // 이미지
    @SerializedName("title") val title : String, // 제목
    @SerializedName("authors") val authors : ArrayList<String>, // 저자
    @SerializedName("price") val price : Int, // 정가
    @SerializedName("contents") val contents : String, // 소개
    @SerializedName("status") val status : String, // 판매 상태
    @SerializedName("url") val url : String // 상세주소
)

 

@SerializedName은 Response에서 넘어온 데이터 중 똑같은 이름을 찾아 정보를 빼줍니다.

단, 변수명이 Response에서 넘어온 이름과 같다면 @SerializedName를 써주지 않아도 됩니다.

 

다음으로 BookDto에 넘어온 책들을 넘겨받을 Data Class를 만들어줍니다.

 

KakaoData.kt

package com.ta2gi.searchbook.retrofit2

import com.google.gson.annotations.SerializedName

data class KakaoData(
    @SerializedName("documents")
    var documents : List<BookDto>
)

 

문서를 보면 Response에는 meta와 documents로 데이터들이 들어오는데 저는 documents만 있으면 됩니다.

 

 

KakaoInfo.kt

package com.ta2gi.searchbook.retrofit2

class KakaoInfo {
    companion object {
        const val BASE_URL = "https://dapi.kakao.com"
        const val API_KEY = "KakaoAK 390b0ab961f1097083f1ef99093867a7"
    }
}

 

공통적으로 쓰이는 친구들은 companion object에 선언해 줬습니다.

요청 시 Host 주소는 BASE_URL에 담았고

API_KEY는 사이트에서 추가했던 애플리케이션을 클릭해 들어가서 Rest API 키를 복붙 해주면 됩니다.

반드시 맨 앞에 "KakaoAK "를 붙여줘야 합니다!

 

KakaoService.kt

package com.ta2gi.searchbook.retrofit2

import retrofit2.Call
import retrofit2.http.GET
import retrofit2.http.Header
import retrofit2.http.Query

interface KakaoService {
    @GET("/v3/search/book")
    fun getSearchBook(
        @Header("Authorization")
        key : String,
        @Query("query")
        query : String
    ): Call<KakaoData>
}

 

@GET("/v3/search/book")은 기본 정보를 보면 GET방식으로 가져와야 한다고 명시되어 있으며

괄고 안의 주소는 BASE_URL의 뒤로 이어지는 부분이기 때문에 "/"를 잘 맞게 적어줘야 합니다.

 

@Header("Authorization")에는 본인의 Rest API 키를 적어놓은 API_KEY를 넣어줄 것입니다.

 

@Query("query")는 문서를 보면 혼자서만 필수로 넣어줘야 하는 친구이니 잘 넣어줍니다.

"query"에는 검색어가 들어갈 겁니다.

 

 

이제 마지막으로 Kakao API URL과 통신하는 Retrofit2를 사용하겠다는 파일입니다.

object로 만들면 singleton형식으로 불러오기 때문에 인스턴스가 중복으로 생성되지 않습니다.

 

RetrofitService.kt

package com.ta2gi.searchbook.retrofit2

import com.ta2gi.searchbook.retrofit2.KakaoInfo.Companion.BASE_URL
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory

object RetrofitService {
    val retrofit = Retrofit.Builder()
        .baseUrl(BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build()

    val kakaoService = retrofit.create(KakaoService::class.java)
}

 

위 파일을 대충 설명하자면 기본 url은 BASE_URL로 쓰고 내용을 GSON으로 바꿔준다는 의미로 해석합시다!

 

여기까지 파일들을 작성 후 실행 해보면 원하는 책 검색 시 잘 뜨는 걸 볼 수 있습니다.

 

The End..😵