Room : DB를 편하게 쓰기 위한 것
Retrofit : HTTP 통신을 편하게 하기 위한 것

1. 권한 설정/라이브러리 추가

인터넷 권한 추가
애플리케이션이 평문(HTTP) 네트워크 트래픽을 사용할 수 있도록 설정

AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET"/>


android:usesCleartextTraffic="true"

build.gradle

implementation("com.google.code.gson:gson:2.10.1")
implementation("com.squareup.retrofit2:retrofit:2.9.0")
implementation("com.squareup.retrofit2:converter-gson:2.9.0")
implementation("com.squareup.okhttp3:okhttp:4.10.0")
implementation("com.squareup.okhttp3:logging-interceptor:4.10.0")

2. DTO 작성

DustDTO 작성

서버에서 보내주는 JSON 값의 데이터 클래스를 쉽게 작성하기 위해 플러그인 사용
File>Settings>Plugins>"JSON To Kotlin Class install"하기

res>New>Kotlin data class File from JSON 누르기

JSON 파일을 입력하고 (format을 누르고) Class Name을 입력하면 아래처럼 Data Class들이 만들어진다.

Dust

data class Dust(
    val response: DustResponse
)

DustResponse

data class DustResponse(
    @SerializedName("body")
    val dustBody: DustBody,
    @SerializedName("header")
    val dustHeader: DustHeader
)

DustBody

data class DustBody(
    val totalCount: Int,
    @SerializedName("items")
    val dustItems: MutableList<DustItem>?,
    val pageNo: Int,
    val numOfRows: Int
)

3. API Interface 정의

어느 주소로 어떤 요청 변수를 주고 어떤 값을 받는지
파싱은 Gson이 해줌

interface NetworkInterface {
    @GET("getCtprvnRltmMesureDnsty") //시도별 실시간 측정정보 조회 주소
    suspend fun getDust(@QueryMap param: HashMap<String, String>): Dust //HashMap에 요청변수들이 들어감 ex)서비스키, 페이지 번호, 시도명 ...
}

4. Retrofit 인스턴스 생성

Retrofit은 항상 같은 방식으로 사용한다.

//Retrofit Client
object NetWorkClient {
    private const val DUST_BASE_URL = "http://apis.data.go.kr/B552584/ArpltnInforInqireSvc/"

    private fun createOkHttpClient(): OkHttpClient {
        val intercepter = HttpLoggingInterceptor()

        //통신이 잘 안 될 때 디버깅을 위한 용도로 넣은 것
        if (BuildConfig.DEBUG){
            intercepter.level = HttpLoggingInterceptor.Level.BODY
        } else{
            intercepter.level = HttpLoggingInterceptor.Level.NONE
        }

        return OkHttpClient.Builder()
            .connectTimeout(20,TimeUnit.SECONDS)
            .readTimeout(20, TimeUnit.SECONDS)
            .writeTimeout(20, TimeUnit.SECONDS)
            .addNetworkInterceptor(intercepter)
            .build()
    }

    private val dustRetrofit = Retrofit.Builder()
        .baseUrl(DUST_BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .client(createOkHttpClient())
        .build()

    val dustNetWork: NetworkInterface = dustRetrofit.create(NetworkInterface::class.java)
}

5. 데이터 받아오기

5.1 API 키

5.2 요청 파라미터 생성

항목명을 그대로 적어야 한다.

private fun setUpDustParameter(sido: String): HashMap<String, String> {
        val authKey =
            "nrOGw0QURU.........."

        return hashMapOf(
            "serviceKey" to authKey,
            "returnType" to "json",
            "numOfRows" to "100",
            "pageNo" to "1",
            "sidoName" to sido,
            "ver" to "1.0"
        )
    }

5.3 네트워크 통신

데이터 통신을 해야 하기 때문에 별도의 스레드 안에서 실행

    private fun communicateNetWork(param: HashMap<String, String>) = lifecycleScope.launch {
        val responseData = NetWorkClient.dustNetWork.getDust(param)

        items = responseData.response.dustBody.dustItems!!

        val goo = ArrayList<String>()
        items.forEach {
            Log.d("add Item: ", it.stationName)
            goo.add(it.stationName)
        }

        runOnUiThread {
            binding.spinnerViewGoo.setItems(goo)
        }
    }