Android RxJava и модернизация
В этом руководстве мы будем реализовывать RxJava в приложении для Android. Мы будем создавать приложение, которое заполняет RecyclerView, используя Retrofit и RxJava. Мы будем использовать CryptoCurrency API.
Чему вы научитесь?
- Выполнение вызова Retrofit с помощью RxJava.
- Выполнение нескольких вызовов модификации с использованием RxJava
- Преобразование ответа Retrofit POJO с помощью RxJava
Мы будем использовать Java 8 в нашем приложении для Android, чтобы реализовать лямбда-выражения.
Обзор
Retrofit — это клиент REST, который использует OkHttp в качестве HttpClient и синтаксических анализаторов JSON для анализа ответа. Здесь мы будем использовать gson в качестве парсера JSON. Вот как создается экземпляр Retrofit:
HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor();
interceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient client = new OkHttpClient.Builder().addInterceptor(interceptor).build();
Gson gson = new GsonBuilder()
.setLenient()
.create();
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.client(client)
.addConverterFactory(GsonConverterFactory.create(gson))
.build();
HttpLoggingInterceptor используется для регистрации данных во время сетевого вызова. RxJava — это библиотека, которая используется для асинхронного и реактивного программирования в виде потоков. Мы используем разные потоки в RxJava. Фоновый поток для сетевого вызова и основной поток для обновления пользовательского интерфейса. Планировщики в RxJava отвечают за выполнение операций с использованием разных потоков. RxAndroid является расширением RxJava и содержит потоки Android, которые будут использоваться в среде Android. Чтобы использовать RxJava в модифицированной среде, нам нужно сделать всего два основных изменения:
- Добавьте RxJava в Retrofit Builder.
- Используйте в интерфейсе тип
Observable
вместоCall
Чтобы выполнить несколько вызовов или преобразовать ответ, мы используем операторы RxJava. Давайте посмотрим, как это делается на примере нашего приложения ниже.
Структура проекта
implementation 'com.android.support:cardview-v7:27.1.0'
implementation 'com.android.support:design:27.1.0'
implementation('com.squareup.retrofit2:retrofit:2.3.0')
{
exclude module: 'okhttp'
}
implementation 'com.squareup.retrofit2:converter-gson:2.3.0'
implementation 'io.reactivex.rxjava2:rxjava:2.1.9'
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.3.0'
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'
implementation 'com.squareup.okhttp3:logging-interceptor:3.9.1'
Код
Код макета activity_main.xml приведен ниже.
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<android.support.v7.widget.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</android.support.constraint.ConstraintLayout>
Код класса CryptocurrencyService.java
приведен ниже.
package com.journaldev.rxjavaretrofit;
import com.journaldev.rxjavaretrofit.pojo.Crypto;
import io.reactivex.Observable;
import retrofit2.http.GET;
import retrofit2.http.Path;
public interface CryptocurrencyService {
String BASE_URL = "https://api.cryptonator.com/api/full/";
@GET("{coin}-usd")
Observable<Crypto> getCoinData(@Path("coin") String coin);
}
@ПОЛУЧАТЬ. Класс POJO Crypto.java
приведен ниже:
package com.journaldev.rxjavaretrofit.pojo;
import com.google.gson.annotations.SerializedName;
import java.util.List;
public class Crypto {
@SerializedName("ticker")
public Ticker ticker;
@SerializedName("timestamp")
public Integer timestamp;
@SerializedName("success")
public Boolean success;
@SerializedName("error")
public String error;
public class Market {
@SerializedName("market")
public String market;
@SerializedName("price")
public String price;
@SerializedName("volume")
public Float volume;
public String coinName;
}
public class Ticker {
@SerializedName("base")
public String base;
@SerializedName("target")
public String target;
@SerializedName("price")
public String price;
@SerializedName("volume")
public String volume;
@SerializedName("change")
public String change;
@SerializedName("markets")
public List<Market> markets = null;
}
}
coinName
— это поле, которое мы установили. Используя магию RxJava, мы установим значение в этом поле, чтобы преобразовать ответ.
Создание одного вызова с использованием RxJava
CryptocurrencyService cryptocurrencyService = retrofit.create(CryptocurrencyService.class);
Observable<Crypto> cryptoObservable = cryptocurrencyService.getCoinData("btc");
cryptoObservable.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.map(result -> result.ticker)
.subscribe(this::handleResults, this::handleError);
subscribeOn()
создает поток планировщика, через который мы делаем сетевой вызов. Мы можем передать в него любой из следующих планировщиков.
- trampoline(): запускает задачи в текущем потоке. Таким образом, он запустит ваш код после завершения текущей задачи в потоке. Полезно для операций с очередями.
- newThread(): создает и возвращает планировщик, который создает новый поток для каждой единицы работы. Это затратно, так как каждый раз создается отдельный поток.
- computation(): создает и возвращает планировщик, предназначенный для вычислительной работы. Это следует использовать для параллельной работы, поскольку пул потоков связан. Здесь не следует выполнять операции ввода-вывода.
- io(): создает и возвращает планировщик, предназначенный для работы, связанной с вводом-выводом. Опять же, это ограничено, как вычисление. Обычно это используется для сетевых вызовов.
подписаться на() против наблюдать на()
- subscribeOn работает как в нисходящем, так и в восходящем направлении. Все задачи выше и ниже будут использовать один и тот же поток.
- observeOn работает только в нисходящем направлении.
- последовательные методы subscribeOn не изменят поток. Будет использоваться только первый поток subscribeOn.
- последовательные методы наблюдения за изменением потока.
- После наблюдения за() добавление подписки на() не изменит поток. Следовательно,ObservOn обычно должен следовать после subscribeOn.
AndroidSchedulers.mainThread()
является частью RxAndroid и используется для наблюдения за данными только в основном потоке. Метод subscribe запускает вызов модификации и получает данные в методе handleResults
, который мы скоро увидим.
Несколько вызовов
Мы используем оператор RxJava merge
для выполнения двух вызовов модификации один за другим.
Observable<List<Crypto.Market>> btcObservable = cryptocurrencyService.getCoinData("btc");
Observable<List<Crypto.Market>> ethObservable = cryptocurrencyService.getCoinData("eth");
Observable.merge(btcObservable, ethObservable)
.subscribeOn(Schedulers.computation())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(this::handleResults, this::handleError);
Преобразование ответа
Чтобы преобразовать ответ POJO, мы можем сделать следующее:
Observable<List<Crypto.Market>> btcObservable = cryptocurrencyService.getCoinData("btc")
.map(result -> Observable.fromIterable(result.ticker.markets))
.flatMap(x -> x).filter(y -> {
y.coinName = "btc";
return true;
}).toList().toObservable();
Observable<List<Crypto.Market>> ethObservable = cryptocurrencyService.getCoinData("eth")
.map(result -> Observable.fromIterable(result.ticker.markets))
.flatMap(x -> x).filter(y -> {
y.coinName = "eth";
return true;
}).toList().toObservable();
Observable.merge(btcObservable, ethObservable)
.subscribeOn(Schedulers.computation())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(this::handleResults, this::handleError);
Мы используем Observable.fromIterable
для преобразования результата карты в потоки Observable. flatMap
работает с элементами один за другим. Таким образом, преобразование ArrayList в отдельные элементы. В методе filter
мы меняем ответ. toList()
используется для преобразования результатов flatMap обратно в список. toObservable()
оборачивает их как потоки Observable.
MainActivity.java
Код для класса MainActivity.java приведен ниже:
package com.journaldev.rxjavaretrofit;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.util.Log;
import android.widget.Toast;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.journaldev.rxjavaretrofit.pojo.Crypto;
import java.util.List;
import io.reactivex.Observable;
import io.reactivex.android.schedulers.AndroidSchedulers;
import io.reactivex.schedulers.Schedulers;
import okhttp3.OkHttpClient;
import okhttp3.logging.HttpLoggingInterceptor;
import retrofit2.Retrofit;
import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory;
import retrofit2.converter.gson.GsonConverterFactory;
import static com.journaldev.rxjavaretrofit.CryptocurrencyService.BASE_URL;
public class MainActivity extends AppCompatActivity {
RecyclerView recyclerView;
Retrofit retrofit;
RecyclerViewAdapter recyclerViewAdapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
recyclerView = findViewById(R.id.recyclerView);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerViewAdapter = new RecyclerViewAdapter();
recyclerView.setAdapter(recyclerViewAdapter);
HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor();
interceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient client = new OkHttpClient.Builder().addInterceptor(interceptor).build();
Gson gson = new GsonBuilder()
.setLenient()
.create();
retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.client(client)
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create(gson))
.build();
callEndpoints();
}
private void callEndpoints() {
CryptocurrencyService cryptocurrencyService = retrofit.create(CryptocurrencyService.class);
//Single call
/*Observable<Crypto> cryptoObservable = cryptocurrencyService.getCoinData("btc");
cryptoObservable.subscribeOn(Schedulers.newThread()).observeOn(AndroidSchedulers.mainThread()).map(result -> result.ticker).subscribe(this::handleResults, this::handleError);*/
Observable<List<Crypto.Market>> btcObservable = cryptocurrencyService.getCoinData("btc")
.map(result -> Observable.fromIterable(result.ticker.markets))
.flatMap(x -> x).filter(y -> {
y.coinName = "btc";
return true;
}).toList().toObservable();
Observable<List<Crypto.Market>> ethObservable = cryptocurrencyService.getCoinData("eth")
.map(result -> Observable.fromIterable(result.ticker.markets))
.flatMap(x -> x).filter(y -> {
y.coinName = "eth";
return true;
}).toList().toObservable();
Observable.merge(btcObservable, ethObservable)
.subscribeOn(Schedulers.computation())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(this::handleResults, this::handleError);
}
private void handleResults(List<Crypto.Market> marketList) {
if (marketList != null && marketList.size() != 0) {
recyclerViewAdapter.setData(marketList);
} else {
Toast.makeText(this, "NO RESULTS FOUND",
Toast.LENGTH_LONG).show();
}
}
private void handleError(Throwable t) {
Toast.makeText(this, "ERROR IN FETCHING API RESPONSE. Try again",
Toast.LENGTH_LONG).show();
}
}
handleResults
и handleError
вызываются с помощью вызова Java 8 ::
В handleResults мы устанавливаем преобразованный ответ на ReyclerViewAdapter. handleError() вызывается, если ответ содержит ошибку. Код макета recyclerview_item_layout приведен ниже.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:app="https://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<android.support.v7.widget.CardView
android:id="@+id/cardView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:layout_margin="16dp">
<android.support.constraint.ConstraintLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="8dp">
<TextView
android:id="@+id/txtCoin"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="8dp"
android:layout_marginRight="8dp"
android:layout_marginTop="8dp"
android:textAllCaps="true"
android:textColor="@android:color/black"
app:layout_constraintHorizontal_bias="0.023"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<TextView
android:id="@+id/txtMarket"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="8dp"
android:layout_marginRight="8dp"
android:layout_marginTop="8dp"
app:layout_constraintHorizontal_bias="0.025"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toBottomOf="@+id/txtCoin" />
<TextView
android:id="@+id/txtPrice"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="8dp"
android:layout_marginStart="8dp"
android:layout_marginTop="8dp"
app:layout_constraintHorizontal_bias="0.025"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toBottomOf="@+id/txtMarket" />
</android.support.constraint.ConstraintLayout>
</android.support.v7.widget.CardView>
</LinearLayout>
Код класса RecyclerViewAdapter.java приведен ниже:
package com.journaldev.rxjavaretrofit;
import android.graphics.Color;
import android.support.v4.content.ContextCompat;
import android.support.v7.widget.CardView;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import com.journaldev.rxjavaretrofit.pojo.Crypto;
import java.util.ArrayList;
import java.util.List;
public class RecyclerViewAdapter extends RecyclerView.Adapter<RecyclerViewAdapter.ViewHolder> {
private List<Crypto.Market> marketList;
public RecyclerViewAdapter() {
marketList = new ArrayList<>();
}
@Override
public RecyclerViewAdapter.ViewHolder onCreateViewHolder(ViewGroup parent,
int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.recyclerview_item_layout, parent, false);
RecyclerViewAdapter.ViewHolder viewHolder = new RecyclerViewAdapter.ViewHolder(view);
return viewHolder;
}
@Override
public void onBindViewHolder(RecyclerViewAdapter.ViewHolder holder, int position) {
Crypto.Market market = marketList.get(position);
holder.txtCoin.setText(market.coinName);
holder.txtMarket.setText(market.market);
holder.txtPrice.setText("$" + String.format("%.2f", Double.parseDouble(market.price)));
if (market.coinName.equalsIgnoreCase("eth")) {
holder.cardView.setCardBackgroundColor(Color.GRAY);
} else {
holder.cardView.setCardBackgroundColor(Color.GREEN);
}
}
@Override
public int getItemCount() {
return marketList.size();
}
public void setData(List<Crypto.Market> data) {
this.marketList.addAll(data);
notifyDataSetChanged();
}
public class ViewHolder extends RecyclerView.ViewHolder {
public TextView txtCoin;
public TextView txtMarket;
public TextView txtPrice;
public CardView cardView;
public ViewHolder(View view) {
super(view);
txtCoin = view.findViewById(R.id.txtCoin);
txtMarket = view.findViewById(R.id.txtMarket);
txtPrice = view.findViewById(R.id.txtPrice);
cardView = view.findViewById(R.id.cardView);
}
}
}
RxJavaRetrofit