͸΍͍ɾ΍͍͢ɾ͏·͍ʂ
 ελʔτΞοϓͰ΋࢖͑Δ Retrofit + RxJava ͰॠؒAPIΫο ΩϯάϨγϐ @fushiroyama

About Me • Fumihiko Shiroyama • Android App Developer • https://github.com/srym

How to implement REST Client? • HTTP Client • Thread Executer • JSON Deserializer • Integration with RxJava

Retrofit

Retrofit • A type-safe HTTP client for Android and Java • http://square.github.io/retrofit/ • by Square

Install // Retrofit compile "com.squareup.retrofit2:retrofit:${retrofitVersion}" compile "com.squareup.retrofit2:adapter-rxjava2:${retrofitVersion}" compile "com.squareup.retrofit2:converter-gson:${retrofitVersion}" // RxJava compile 'io.reactivex.rxjava2:rxandroid:2.0.1' compile "io.reactivex.rxjava2:rxjava:2.1.1"

Retrofit public interface GitHubService { @GET("users/{user}/repos") Call> listRepos(@Path("user") String user); }

Retrofit Retrofit retrofit = new Retrofit.Builder() .baseUrl("https://api.github.com/") .build(); GitHubService service = retrofit.create(GitHubService.class);

Retrofit GitHubService service = retrofit.create(GitHubService.class); Call> repos = service.listRepos("srym"); // synchronous call Response> response = repos.execute(); // asynchronous call repos.enqueue( /* callback here */ );

Integration with RxJava Retrofit retrofit = new Retrofit.Builder() .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) .addConverterFactory(GsonConverterFactory.create(gson)) .baseUrl("https://api.github.com/") .build();

Change Return Type public interface GitHubService { @GET("users/{user}/repos") Single> listRepos(@Path("user") String user); }

Subscribe Single> repos = service.listRepos("srym") repos .subscribe( list -> doSomethingToList(list), throwable -> Timber.d(throwable.getMessage(), throwable), () -> Timber.d("complete") );

Link • RxJava+RetrofitͰAPI௨৴पΓΛ࣮૷͢Δ͏͑ Ͱ࠷௿ݶͷ஌ࣝΛ30෼Ͱ٧ΊࠐΉ • http://qiita.com/FumihikoSHIROYAMA/ items/201536d9b45ef21b6bc7

Link • RetrofitΛ࢖ͬͨOAuth࠶ೝূΞϓϩʔν • http://qiita.com/FumihikoSHIROYAMA/ items/ac1beaeaa9b4baaed939

Link • RetrofitΛ࢖ͬͨAPIݺͼग़͠ͰϦΧόϦՄೳ ͳHTTPΤϥʔΛͲ͏ѻ͏͔໰୊ • http://qiita.com/FumihikoSHIROYAMA/ items/65d52aea1a9f324d347e

What's Good about Retrofit + Rx • Easy to define • Easy to compose • Easy to test

Test • MockWebServer • TestSubscriber

MockWebServer • A scriptable web server for testing HTTP clients • https://github.com/square/okhttp/tree/ master/mockwebserver

MockWebServer private final MockWebServer mockWebServer = new MockWebServer();

MockWebServer Dispatcher dispatcher = new Dispatcher() { @Override public MockResponse dispatch(RecordedRequest request) throws InterruptedException { return new MockResponse().setResponseCode(404); } }; mockWebServer.setDispatcher(dispatcher); mockWebServer.start();

MockWebServer @Override public MockResponse dispatch(RecordedRequest request) { if (request == null || request.getPath() == null) { return new MockResponse().setResponseCode(400); } if (request.getPath().matches("/users/.+/repos")) { return new MockResponse().setBody( readJsonFromResources("users_repos.json") ).setResponseCode(200); } return new MockResponse().setResponseCode(404); }

MockWebServer Retrofit retrofit = new Retrofit.Builder() .baseUrl(mockWebServer.url("")) .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) .addConverterFactory(GsonConverterFactory.create()) .build(); GitHubService gitHubService = retrofit.create(GitHubService.class);

TestSubscriber • A TestSubscriber is a variety of Subscriber that you can use for unit testing, to perform assertions, inspect received events, or wrap a mocked Subscriber. • http://reactivex.io/RxJava/javadoc/rx/ observers/TestSubscriber.html

TestSubscriber restGitHubDataSource .listRepos("srym") .test();

TestSubscriber List repos = restGitHubDataSource.listRepos("srym") .test() .await() .assertNoErrors() .assertComplete() .values() .get(0); assertThat(repos).isNotNull();

TestSubscriber • https://github.com/srym/Architecture • https://github.com/srym/Architecture/blob/ master/app/src/test/java/us/shiroyama/ android/architecture/infrastructure/ repository/datasource/remote/ RestGitHubDataSourceTest.java

Easy to compose • Rx's Observable is easily & flexibly combined • Avoid callback hells

Easy to compose public class GitHubInfraRepository implements GitHubRepository { private final RemoteGitHubDataSource remoteDataSource; private final RepoMapper mapper; @Inject public GitHubInfraRepository(RemoteGitHubDataSource remoteDataSource, RepoMapper mapper) { this.remoteDataSource = remoteDataSource; this.mapper = mapper; } @Override public Single> listRepos(@NonNull String user) { return remoteDataSource .listRepos(user) .map(mapper::convert); } }

Easy to compose private final RemoteGitHubDataSource remoteDataSource; private final LocalGitHubDataSource localGitHubDataSource; private final RepoMapper mapper; @Inject public GitHubInfraRepository(RemoteGitHubDataSource remoteDataSource, LocalGitHubDataSource localGitHubDataSource, RepoMapper mapper) { this.remoteDataSource = remoteDataSource; this.localGitHubDataSource = localGitHubDataSource; this.mapper = mapper; }

Easy to compose @Override public Single> listRepos(@NonNull String user) { return remoteDataSource .listRepos(user) .map(mapper::convert);

Easy to compose public Single> listRepos(@NonNull String user) { return localGitHubDataSource .listRepos(user) .onErrorResumeNext( remoteDataSource .listRepos(user) .retry(DEFAULT_RETRY) .doOnSuccess(localGitHubDataSource::save) ) .map(mapper::convert);

Android Clean Architecture • android10/Android-CleanArchitecture • https://github.com/android10/Android- CleanArchitecture • srym/Architecture • https://github.com/srym/Architecture

No content