[Android] Retrofit MultipartBody로 POST보내기

 

API 문서를 받았는데 Request가 이렇게 되어있다면,

 

우리는 Multipart 데이터로 보내줘야 합니다.

그냥 @Body 아냐? 평소처럼 Json으로 보내야지~ 했다가는

422 Unprocessable Entity 에러만 받을 수 있습니다..

어떻게 알았냐구요? 저도 알고 싶지 않았어요…

 

---

개발 환경은 다음과 같습니다.

• Retrofit2 2.9.0
• okhttp3 4.11.0

POST로 호출하며,

Request Body는 type: String, img: String($binary)가 요구되는 상황입니다.

 

 

 

Api Interface 코드는 아래와 같이 작성하였습니다.

@Multipart
@POST("transform")
    suspend fun request(
        @Part("type") type: RequestBody,
        @Part img: MultipartBody.Part
    ): Response<ResponseBody>

 

@Multipart 어노테이션을 추가하고

필요한 body 파라미터에 각각 @Part 어노테이션도 달아줍니다.

 

둘다 multipart/form-data 인데 RequestBody랑 MultipartBody.Part 로 다르게 써준 이유는

MultipartBody.Part 는 일반적으로 이미지와 같은 파일 데이터를 보낼 때 사용되고,

RequestBody 는 일반적으로 텍스트 데이터를 보낼 때 사용되기 때문입니다.

 

MultipartBody.Part의 본문이 RequestBody이라서 그렇습니다..

 class Part private constructor(
    @get:JvmName("headers") val headers: Headers?,
    @get:JvmName("body") val body: RequestBody
    )

문자열 데이터도 MultipartBody.Part 로 보내는 게 가능은 하지만 비효율적이라고 합니다.

 

 

(이 부분이 개인적으로 이해가 되지 않아서 찾아봤는데,,

편지(Request)에 글을 쓰는것과 사진을 붙이는 걸로 생각하면 얼추 이해가 되더라구요,,?

글은 그냥 바로 쓸 수 있는데 사진은 뭐 인화하고 붙이고.. 하는 추가 작업…)

 

 

그리고 이걸 보내주는 처리부분입니다.

suspend fun request(
        type: String,
        image: Bitmap,
    ): ResultData<ByteArray?> {
        val typePart = type.toRequestBody("text/plain".toMediaTypeOrNull())
        
        val imgByteArray = image.toByteArray()
        val imgRequestBody = faceByteArray.toRequestBody("image/png".toMediaTypeOrNull())
        val imgPart =
            MultipartBody.Part.createFormData("img", "image.png", imgRequestBody)

        return apiCall {
            api.request(
                type = typePart,
                img = imgPart
            )
        }
    }

 

 

문자열인 type의 경우는 RequestBody로 만들어주면 됩니다.

저의 경우는 Bitmap 이미지를 보내야했어서

1. byteArray로 변환해주고
2. RequesetBody로 만든 다음
3. MultipartBody.Part 데이터로 포장해주는 작업을 거칩니다.

그리고 반환값이 ResultData<ByteArray?> 인 이유는 Response 데이터가 이미지 파일이라 그렇습니다 🥲

 

 

 

 

이렇게 해서 200 OK 를 받으면 끝 !

 

아무래도 multipart/form-data 가 파일 전송할 때 필요한 형식인 것 같은데 넘나 낯설고,,

결과 코드만 보면 간단한데,, 삽질 엄청 한거고,,
한끗차이가 쉽지 않네요

🥲