Android Academy · 강의

Retrofit과 REST API

Retrofit으로 HTTP 요청을 보냅니다. API 인터페이스를 정의하고 Gson/Moshi로 JSON을 파싱하며 응답과 오류를 처리하고 코루틴과 통합합니다.

Retrofit과 REST API은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 6개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 6개의 강의가 포함되어 있습니다.

Retrofit이란 무엇일까요?

Retrofit은 Square에서 만든 Android용 가장 인기 있는 HTTP client입니다. REST API를 Kotlin interface로 정의할 수 있으므로 반복적인 HTTP 코드를 작성할 필요가 없습니다.

@GET, @POST 등의 annotation을 메서드에 지정합니다.
JSON 응답을 Kotlin data class로 자동 변환합니다.
코루틴을 기본적으로 지원합니다(suspend fun).

의존성 추가

app/build.gradle에 Retrofit과 Gson 변환기를 추가합니다.

// app/build.gradle
dependencies {
    implementation 'com.squareup.retrofit2:retrofit:2.11.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.11.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'
}

// AndroidManifest.xml — add internet permission:
// <uses-permission android:name="android.permission.INTERNET" />

API Interface 정의

API 엔드포인트를 설명하는 Kotlin interface를 만듭니다.

import retrofit2.http.*

data class Post(val id: Int, val title: String, val body: String, val userId: Int)

interface ApiService {

    @GET("posts")
    suspend fun getPosts(): List<Post>

    @GET("posts/{id}")
    suspend fun getPost(@Path("id") id: Int): Post

    @POST("posts")
    suspend fun createPost(@Body post: Post): Post

    @GET("posts")
    suspend fun getPostsByUser(@Query("userId") userId: Int): List<Post>
}

Retrofit 인스턴스 생성

싱글턴 Retrofit 인스턴스를 만듭니다. 일반적으로 object 안에서 만들거나 Hilt를 사용합니다.

import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory

object RetrofitClient {
    private const val BASE_URL = "https://jsonplaceholder.typicode.com/"

    val api: ApiService by lazy {
        Retrofit.Builder()
            .baseUrl(BASE_URL)
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(ApiService::class.java)
    }
}

GET 요청 보내기

Kotlin 코루틴을 사용해 Repository에서 API를 호출합니다.

class PostRepository {
    private val api = RetrofitClient.api

    suspend fun getPosts(): List<Post> {
        return api.getPosts()  // Retrofit handles threading for you
    }

    suspend fun getPost(id: Int): Post {
        return api.getPost(id)
    }
}

// In ViewModel:
fun loadPosts() {
    viewModelScope.launch {
        try {
            val posts = withContext(Dispatchers.IO) {
                repository.getPosts()
            }
            _posts.value = posts
        } catch (e: Exception) {
            _error.value = "Network error: ${e.message}"
        }
    }
}

Gson JSON 매핑

Gson은 JSON을 Kotlin data class로 자동 변환합니다. 필드 이름이 JSON 키와 일치해야 하며, 일치하지 않으면 @SerializedName을 사용합니다.

import com.google.gson.annotations.SerializedName

data class User(
    val id: Int,
    val name: String,
    val email: String,
    @SerializedName("phone_number")  // JSON key is 'phone_number'
    val phoneNumber: String,
    @SerializedName("created_at")
    val createdAt: String
)

Body가 있는 POST 요청

@POST와 @Body를 사용해 서버로 데이터를 보냅니다.

// API interface:
@POST("users")
suspend fun createUser(@Body user: User): User

// In Repository:
suspend fun createUser(name: String, email: String): User {
    val newUser = User(id = 0, name = name, email = email, phoneNumber = "", createdAt = "")
    return api.createUser(newUser)
}

// In ViewModel:
fun registerUser(name: String, email: String) {
    viewModelScope.launch {
        val user = withContext(Dispatchers.IO) {
            repo.createUser(name, email)
        }
        _registeredUser.value = user
    }
}

헤더 및 인증

OkHttp 인터셉터를 사용해 모든 요청에 헤더를 추가합니다.

import okhttp3.OkHttpClient
import okhttp3.Interceptor

val authClient = OkHttpClient.Builder()
    .addInterceptor { chain ->
        val request = chain.request().newBuilder()
            .addHeader("Authorization", "Bearer $token")
            .addHeader("Accept", "application/json")
            .build()
        chain.proceed(request)
    }
    .build()

val retrofit = Retrofit.Builder()
    .baseUrl(BASE_URL)
    .client(authClient)  // use our authenticated client
    .addConverterFactory(GsonConverterFactory.create())
    .build()

HTTP 오류 처리

성공적인 HTTP 응답(200~299)은 값을 반환합니다. 오류 응답(4xx, 5xx)은 HttpException을 발생시킵니다. 두 경우를 모두 처리해야 합니다.

HttpException — 서버가 오류 상태 코드를 반환한 경우
IOException — 네트워크 연결이 없는 경우

빠른 확인

/posts/{id}와 같은 URL 경로 세그먼트에 메서드 매개변수를 매핑하는 Retrofit annotation은 무엇일까요?

복습: Retrofit 및 API

이제 어떤 REST API에서도 데이터를 가져올 수 있습니다.

Kotlin interface와 annotation(@GET, @POST, @Path, @Query)으로 API 정의
기본 URL과 Gson 변환기를 사용해 Retrofit 인스턴스 생성
ViewModel의 코루틴에서 suspend 함수 호출
JSON → Kotlin data class 자동 매핑
HttpException 및 IOException 처리

다음: Coil로 네트워크 이미지를 표시합니다.

자주 묻는 질문

“Retrofit과 REST API” 강의는 무료인가요?

네 — “Retrofit과 REST API” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 6개의 강의가 포함되어 있습니다.

“Retrofit과 REST API”에서 뭘 배우나요?

Retrofit으로 HTTP 요청을 보냅니다. API 인터페이스를 정의하고 Gson/Moshi로 JSON을 파싱하며 응답과 오류를 처리하고 코루틴과 통합합니다. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 6개 중 1번째 강의입니다.

“Retrofit과 REST API” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Android Academy(으)로 돌아가기