Quem sou eu? Rafael Toledo Dev Java / Android www.rafaeltoledo.net

Integração REST ●  Praticamente nenhum app funciona

isoladamente ●  Integração com APIs é essencial ●  Eficiência é um requisito, sempre!

Material Necessário

Material Necessário

Material Necessário

Material Necessário Tesoura Sem Ponta (para não se machucar)

REST de Referência https://api.example.com GET - /product /product/1 /product?name=? POST - /product (json no corpo) PUT - /product/1 (json no corpo) DELETE - /product/1

Product JSON { "id": 55041 "name": "Biscoito (ou bolacha?) Recheado", "categories-array": [ "doce", "biscoito", "bolacha" ], "description": "...", "permalink": "http://example.com/product/55041", }

Método 1 - Apache HttpClient final String ENDPOINT = "https://api.example.com"; HttpClient client = DefaultHttpClient.getInstance(); HttpGet get = new HttpGet(ENDPOINT + "/product"); HttpResponse response = client.execute(get); if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) { String raw = EntityUtils.toString(response.getEntity(), "UTF-8"); JSONArray json = new JSONArray(raw); for (int i = 0; i < json.length(); i++) { Product product = new Product(); product.setName(json.getJSONObject(i).getString("name")); product.setId(json.getJSONObject(i).getLong("id")); ...

Agravante Uso de AsyncTasks, Services ou WorkerThreads Gerenciar a request em uma thread separada / atualizar a UI na main thread

OkHttp http://square.github.io/okhttp SPDY/HTTP GZIP transparente Gerenciamento de Cache Recover automático em caso de falhas de rede

Método 1A - OkHttp Apache Wrapper HttpClient client = new OkApacheClient(); HttpGet get = new HttpGet(ENDPOINT + "/product"); HttpResponse response = client.execute(get); if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) { String raw = EntityUtils.toString(response.getEntity(), "UTF-8"); JSONArray json = new JSONArray(raw); for (int i = 0; i < json.length(); i++) { Product product = new Product(); product.setName(json.getJSONArray(i).getString("name")); ... }

Dependências // build.gradle do módulo do app ... dependencies { ... compile 'com.squareup.okhttp:okhttp-apache:2.0.+' }

Método 2 - OkHttp OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url(ENDPOINT + "/product").build(); Response response = client.newCall(request).execute(); String raw = response.body().string(); JSONArray json = new JSONArray(raw); ...

Dependências // build.gradle do módulo do app ... dependencies { ... compile 'com.squareup.okhttp:okhttp:2.0.+' }

Método 2A - OkHttp + Gson public class Product { private String name; @SerializedName("categories-array") private List<String> categoriesArray; ... }

Método 2A - OkHttp + Gson OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url(ENDPOINT + "/product").build(); Response response = client.newCall(request).execute(); String raw = response.body().string(); JSONArray json = new JSONArray(raw); Gson gson = new Gson(); for (int i = 0; i < json.length(); i++) { Product product = gson .fromJson(json.getJSONObject(i).toString(), Product.class); ... }

Método 2A - OkHttp + Gson OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url(ENDPOINT + "/product").build(); Response response = client.newCall(request).execute(); String raw = response.body().string(); Type listType = new TypeToken<List<Product>>{}.getType(); List<Product> products = new Gson().fromJson(raw, listType);

Dependências // build.gradle do módulo do app ... dependencies { ... compile 'com.squareup.okhttp:okhttp:2.0.+' compile 'com.google.code.gson:gson:2.3' }

Retrofit http://square.github.io/retrofit Transforma o seu REST em uma interface! Integração com o OkHttp (classpath)

Método 3 - Retrofit public interface ExampleService { @GET("/product") List<Product> getProducts(); @POST("/product") void saveProduct(@Body Product product); @PUT("/product/{id}") void updateProduct(@Path("id") long id, @Body Product product); @DELETE("/product/{id}") void deleteProduct(@Path("id") long id); }

Método 3 - Retrofit public interface ExampleService { @GET("/product/{id}") Product getProduct(@Path("id") long id); @GET("/product") Product getProductByName(@Query("name") String name); }

Método 3 - Retrofit public class ExampleApi { private static ExampleService instance; public static ExampleService getInstance() { if (instance == null) { RestAdapter adapter = new RestAdapter.Builder() .setEndpoint("https://api.example.com") .build(); instance = adapter.create(ExampleService.class); } return instance; } }

Método 3 - Retrofit E pronto! Product product = ExampleApi.getInstance().getProduct(1);

Porém Ainda depende do uso de AsyncTasks, Services ou WorkerThreads

Método 3A - Retrofit com Callbacks public interface ExampleService { @GET("/product") List<Product> getProducts(); // ...modificamos para... @GET("/product") void getProducts(Callback<List<Product>> callback);

Método 3A - Retrofit com Callbacks E pronto! ExampleApi.getInstance().getProduct(1, new Callback<Product>() { @Override public void success(Product product, Response response) {} @Override public void failure(RetrofitError error) {} });

Vantagens Gerenciado automaticamente para os callbacks serem executados na UI Dispensa o tratamento de exceptions na request (método failure)

Dependências // build.gradle do módulo do app ... dependencies { ... compile 'com.squareup.okhttp:okhttp:2.0.+' compile 'com.squareup.retrofit:retrofit:1.7.+' }

Calma!!! ainda pode melhorar...

Por que melhorar mais ainda? ●  Verbosidade ●  Código macarrônico ●  Bagunça de código com chamadas

encadeadas ●  Muitas classes anônimas

RxJava Programação Funcional Reativa no Java É uma das grandes febres no Open Source Android hoje Ganhou mais fama ainda por causa do port Android feito pela Netflix

RxJava http://github.com/ReactiveX/RxJava Retrofit é compatível com RxJava! http://blog.danlew.net/ - Blog do GDE Dan Lew, com uma série de 4 tutoriais sobre RxJava

Método 4 - Retrofit e RxJava public interface ExampleService { @GET("/product/{id}") void getProduct(@Path("id") long id, Callback<Product> callback); // ...modificamos para... @GET("/product/{id}") Observable<Product> getProduct(@Path("id") long id);

Método 4 - Retrofit e RxJava ExampleApi.getInstance().getProduct(1).subscribe(onSuccess, onError); protected Action1<Product> onSuccess = new Action1<Product>() { @Override public void call(Product product) {} }; protected Action1<Throwable> onError = new Action1<Throwable>() { @Override public void call(Throwable error) {} };

Dependências // build.gradle do módulo do app ... dependencies { ... compile 'com.squareup.okhttp:okhttp:2.0.+' compile 'com.squareup.retrofit:retrofit:1.7.+' compile 'com.netflix.rxjava:rxjava-android:0.20.+' }

Qual a necessidade disso? ●  Chamada mais limpa e clara ●  Maior coesão no tratamento de erro /

sucesso ●  Se o tratamento for comum a todas as

Activities / Fragments, você pode criar a implementação comum e estender :)

Calma aí!!! E como fica o controle na thread de UI?

Já testei e deu pau!

Método 4 - Retrofit e RxJava ExampleApi.getInstance().getProduct(1) .observeOn(AndroidSchedulers.mainThread()) .subscribe(onSuccess, onError);

Apesar de bacana... Ainda temos o problema da

"verbosidade" do Java

Retrolambda Porque o Java 5/6/7 não poderia ficar de fora! https://github.com/orfjackal/retrolambda Traz ao Java 5/6/7 uma das mais poderosas características do Java 8: o uso de lambdas!

Retrolambda Como o Java do Android é o 6 e 7 (full, a partir do Kitkat), precisávamos disso! https://github.com/evant/gradle-retrolambda

Retrolambda - Como Usar // no build.gradle principal buildscript { dependencies { classpath 'com.android.tools.build:gradle:0.13.3' classpath 'me.tatarka:gradle-retrolambda:2.4.0' } }

Retrolambda - Como Usar // no build.gradle do projeto apply plugin: 'com.android.application' apply plugin: 'retrolambda' android { ... compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } }

Método 4 - Sem Retrolambda ExampleApi.getInstance().getProduct(1).subscribe(onSuccess, onError); protected Action1<Product> onSuccess = new Action1<Product>() { @Override public void call(Product product) {} }; protected Action1<Throwable> onError = new Action1<Throwable>() { @Override public void call(Throwable error) {} };

Método 5 - Com Retrolambda ExampleApi.getInstance().getProduct(1).subscribe(onSuccess, onError); protected Action1<Product> onSuccess = product -> { }; protected Action1<Throwable> onError = error -> { };

Método 5 - Com Retrolambda protected Action1<Throwable> onError = error -> { dialog.dismiss(); }; protected Action1<Throwable> onError = error -> dialog.dismiss();

Obrigado! www.rafaeltoledo.net