안드로이드나 자바환경에서 restful웹서비스와 통신을 쉽게 할 수 있도록 도와주는 라이브러리로 웹서버와 데이터를 주고 받는 과정을 간소화한다.
특징으로는 HTTP API을 자바 인터페이스로 변환해주는데 이를통해 가독성 높은 코드로 API와 상호작용할 수 있다.
interface MyApi {
@GET("posts/1")
fun getPost1() : Call<Post>
@GET("posts/{number}")
fun getPostNumber(
@Path("number") number : Int
) : Call<Post>
}
data class Post (
val userId : Int,
val id : Int,
val title : String,
val body : String
)
object RetrofitInstance {
val BASE_URL = "https://jsonplaceholder.typicode.com/"
val client = Retrofit
.Builder()
.baseUrl(BASE_URL)
.addConverterFactory(GsonConverterFactory.create())
.build()
fun getInstance() : Retrofit {
return client
}
}
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val api = RetrofitInstance.getInstance().create(MyApi::class.java)
api.getPost1().enqueue(object : Callback<Post> {
override fun onResponse(call: Call<Post>, response: Response<Post>) {
Log.d("API1", response.body().toString())
}
override fun onFailure(call: Call<Post>, t: Throwable) {
Log.d("API1", "fail")
}
})
}
}
하지만 단점은 동기적으로 처리할때 아래와 같이 코드가 너무 복잡해진다.
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val api = RetrofitInstance.getInstance().create(MyApi::class.java)
// 1. 유저 정보를 가져와서 (userId)
api.getPost1().enqueue(object : Callback<Post> {
override fun onResponse(call: Call<Post>, response: Response<Post>) {
Log.d("API1", response.body().toString())
// 2. userId 기반으로 데이터를 가져오고 가져온 닉네임값
api.getPostNumber(2).enqueue(object : Callback<Post> {
override fun onResponse(call: Call<Post>, response: Response<Post>) {
Log.d("API2", response.body().toString())
// 3. 닉네임 기반으로 데이터를 가져오고 유저의 댓글을 가져와서
api.getPostNumber(3).enqueue(object : Callback<Post> {
override fun onResponse(call: Call<Post>, response: Response<Post>) {
Log.d("API3", response.body().toString())
// 4. 유저의 댓글 기반으로, 대댓글
api.getPostNumber(4).enqueue(object : Callback<Post> {
override fun onResponse(call: Call<Post>, response: Response<Post>) {
Log.d("API4", response.body().toString())
}
override fun onFailure(call: Call<Post>, t: Throwable) {
Log.d("API4", "fail")
}
})
}
override fun onFailure(call: Call<Post>, t: Throwable) {
Log.d("API3", "fail")
}
})
}
override fun onFailure(call: Call<Post>, t: Throwable) {
Log.d("API2", "fail")
}
})
}
override fun onFailure(call: Call<Post>, t: Throwable) {
Log.d("API1", "fail")
}
})
}
}
그래서 보통 코루틴과 함께사용한다.