Retrofit2. 2.사용방법 (Retrofit 2로 HTTP 호출하기)

[Android] - 개념/Retrofit2 2017. 3. 12. 23:55

[ Retrofit2. 2.사용방법 (Retrofit 2로 HTTP 호출하기) ]

1. 정의

- Retrofit은 안드로이드와 Java 애플리케이션을 위한 라이브러리로, 안전한 타입(type-safe) 방식의 HTTP 클라이언트 이다. 이번 글에서는 Retrofit 2 HTTP 클라이언트의 사용 복잡성과 앱 적용 시의 유용성을 살펴볼 예정이다.

1. 네트워크 사용을 위해서 AndroidManifest.xml 에서 Internet Permission 을 허용해야 됨

2. Retrofit을 사용하기 위해서 build.gradle 파일에 라이브러리 추가

- Retrofit2만 적용시

dependencies {
compile 'com.squareup.retrofit2:retrofit:2.1.0'

}

- Retrofit2 + gson 적용시

dependencies {
    compile 'com.google.code.gson:gson:2.7'
    compile 'com.squareup.retrofit2:retrofit:2.1.0'
    compile 'com.squareup.retrofit2:converter-gson:2.1.0'
}

3. 모델 클래스 만들기(데이터 그릇)

public class Contributor {

String login;
String html_url;

int contributions;

@Override
public String toString() {
return login + "(" + contributions + ")";
}
}

4. HTTP 통신을 하기 위한 서비스 인터페이스를 생성

public interface GitHubService {

@GET("repos/{owner}/{repo}/contributors")
Call<List<Contributor>> repoContributors(
@Path("owner") String owner
, @Path("repo") String repo);
}

5. Retrofit 객체를 GitHubService 에 생성

기본적인 Retrofit 객체 생성 형태는 아래와 같지만,

public static final Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.github.com/")
.build();

.addConverterFactory(GsonConverterFactory.create());

는 받아오는 Json 형식의 데이터를 Java 객체 형태로 변환 또는 반대 형식으로 변환시켜주는 Gson 라이브러리를 사용해야하기 때문에 수정해야 됨.

public interface GitHubService {

@GET("repos/{owner}/{repo}/contributors")
Call<List<Contributor>> repoContributors(
      @Path("owner") String owner
      , @Path("repo") String repo);

public static final Retrofit retrofit = new Retrofit.Builder()
      .baseUrl("https://api.github.com/")
      .addConverterFactory(GsonConverterFactory.create())
      .build();
}

6. HTTP 호출

동기적으로 HTTP 를 호출하기 위해서 인터페이스를 구현하고

Call 호출하기 위한 형태는 아래와 같다.

GitHubService gitHubService = GitHubService.retrofit.create(GitHubService.class);
Call<List<Contributor>> call = gitHubService.repoContributors(“square”, “retrofit”);
List<Contributor> result = call.execute().body();

그러나 Android 에서는 MainThread(UI Thread) 에서 네트워크 통신을 할 수 없도록 되어 있다.
위의 형태로 돌릴 경우 아래와 같은 에러 메세지가 떨어지게 된다.

02-04 19:32:55.190 1678-1678/com.example.jihoonryu.retrofit2_test E/AndroidRuntime:
FATAL EXCEPTION: main
Process: com.example.jihoonryu.retrofit2_test, PID: 1678
android.os.NetworkOnMainThreadException

그렇기 때문에 AsyncTask 를 통해서 백그라운드 스레드에서 작동을 시켜야 한다.

- 동기(Synchronous)

new AsyncTask<Void, Void, String>() {

    @Override
    protected String doInBackground(Void... params) {
      GitHubService gitHubService = GitHubService.retrofit.create(GitHubService.class);
      Call<List<Contributor>> call = gitHubService.repoContributors("square", "retrofit");

    try {
        return call.execute().body().toString();
      } catch (IOException e) {
        e.printStackTrace();
      }

      return null;
    }

    @Override
    protected void onPostExecute(String s) {
      super.onPostExecute(s);
      TextView textView = (TextView) findViewById(R.id.textView);
      textView.setText(s);
    }
}.execute();

Retrofit2 의 장점은 동기적이던 비동기적이던 구현하기 쉬움에 있다.
비동기적(Asynchronously) 으로 구현할 경우는 자체적으로 백그라운드 스레드를 타기 때문에 그냥 구현해주면 된다.

-비동기(Asynchronous)

GitHubService gitHubService = GitHubService.retrofit.create(GitHubService.class);
    Call<List<Contributor>> call = gitHubService.repoContributors("square", "retrofit");
    call.enqueue(new Callback<List<Contributor>>() {
      @Override
      public void onResponse(Call<List<Contributor>> call,
          Response<List<Contributor>> response) {

        TextView textView = (TextView) findViewById(R.id.textView);
        textView.setText(response.body().toString());
      }

      @Override
      public void onFailure(Call<List<Contributor>> call, Throwable t) {

      }
});