长期更新 支持网络请求的ViewMode框架【ViewModel+LiveData+Retrofit】
github 地址：https://github.com/miaotaoii/RequestViewModel.git
快捷、方便地使用ViewModel 、LiveData管理数据，自动使用retrofit进行网络请求
无需关心LiveData和retroift request的创建，只要关注UI 控件更新数据的Bean对象
RequestViewMode自动对LiveData进行缓存管理，每个retrofit api接口复用一个livedata
项目根目录下 build.gradle 添加
allprojects {
repositories {
google()
maven { url 'https://jitpack.io' }
jcenter()
}
}
module的build.gradle 中添加：
dependencies {
implementation 'com.github.miaotaoii:RequestViewModel:1.0.7'
}
RequestViewModel内部使用retrofit进行网络请求，框架会根据请求的注解字和参数及返回值类型管理retrofit请求对象的创建；第一步是Retrofit的基本步骤；
public interface RetrofitDataApi {
public static final String requestOilprice = "/oilprice/index?key=3c5ee42145c852de4147264f25b858dc";
public static final String baseUrl = "http://api.tianapi.com";
//ResponseJsonBean对象是自定义的服务器返回json类型，可以是泛型类型，如 ResponseData<UserInfo>
@GET(requestOilprice)
Call<ResponseJsonBean> getOliPrice(@Query("prov") String prov);
}你需要在初始化app时，额外使用RetrofitConfig配置你自己的Retrofit实例或使用默认创建retrofit实例
使用项目已有的retrofit实例
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(RetrofitDataApi.baseUrl)
.addConverterFactory(GsonConverterFactory.create())
.client(new OkHttpClient.Builder()
.build())
.build();
RetrofitConfig.getInstance(retrofit).init();
设置baseurl，框架会帮你创建默认的retrofit实例
RetrofitConfig.getInstance(RetrofitDataApi.baseUrl).init();
你需要设置请求参数，并在RequestObj构造器中传入retrofit api接口中的的GET或POST注解字符串。参数顺序必须保持和requestObj 的api注解对应的api接口参数一致
RequestObj<T> 泛型声明api请求返回的类型，T类型支持本身为泛型类型； 你将会在你自己继承RequestLiveData的类中，对返回数据进行转化解析并post到UI中
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
... ...
//构建请求对象，设置请求api注解和参数,设置api返回对象类型和livedata数据类型
RequestObj<ResponseJsonBean> requestObj = new RequestObj<ResponseJsonBean>(RetrofitDataApi.requestOilprice) {
@Override
public Object[] getArgs() {
return new Object[]{formatInputArg()};
}
};
... ...
}在这里将服务器返回的数据类型转换为UI需要的类型，并通过LiveData post()数据到UI。第一个泛型参数是retrofit请求返回的数据类型，第二个泛型参数是LiveData持有的数据类型。
public class OliPriceLiveData extends RequestLiveData<ResponseJsonBean, PriceBean> {
@Override
public void onLoadSuccess(ResponseJsonBean data) {
if (data.getCode() == 200) {
PriceBean priceBean = data.getNewslist().get(0);
priceBean.setCode(200);
postValue(priceBean);
} else {
PriceBean priceBean = new PriceBean();
priceBean.setCode(data.getCode());
priceBean.setMsg(data.getMsg());
postValue(priceBean);
}
}
@Override
public void onLoadFailed(int code, String msg) {
PriceBean priceBean = new PriceBean();
priceBean.setCode(code);
priceBean.setMsg(msg);
postValue(priceBean);
}
}RequestViewModel由RequestViewModelProvider提供，你需要传入Retrofit api接口类型；你也可以自定义ViewModel继承自RequestViewModel来处理更多业务逻辑；每个RequestViewModel可以自动管理多个RequestLiveData，RequestObj中的retrofit api注解字符串决定了VeiwModel是否创建新的RequestLiveData或者复用旧的。
RequestLiveData将根据传入的第三个参数决定是否在首次创建时发出一次请求；如你正在使用google DataBinding框架，建议传入true，在RequestLiveData接收数据并postValue后，数据将自动更新到UI控件。
private RequestViewModel requestViewModel;
private OliPriceLiveData liveData;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
... ...
requestViewModel = RequestViewModelProvider.getInstance().get(
this,
RetrofitDataApi.class,
RequestViewModel.class
);
//构建请求对象，设置请求api注解和参数,设置api返回对象类型和livedata数据类型
RequestObj<ResponseJsonBean> requestObj = new RequestObj<ResponseJsonBean>(RetrofitDataApi.requestOilprice) {
@Override
public Object[] getArgs() {
return new Object[]{formatInputArg()};
}
};
liveData = requestViewModel.getRequestLiveData(requestObj, OliPriceLiveData.class,true);
... ...
}你也可以使用RequestLiveData 的refresh 方法主动刷新数据；并使用RequestObj setArgs()方法设置新的参数。
requestObj.setArgs(new Object[]{"arg1",1,...});
liveData.refresh();同样作为LiveData的子类，你也可以使用observe接口观察数RequestLiveData据变化
liveData.observe(this, new Observer<PriceBean>() {
@Override
public void onChanged(PriceBean priceBean) {
if (priceBean.getCode() != 200) {
Toast.makeText(MainActivity.this, "请求失败 code =" + priceBean.getCode() + " msg = " + priceBean.getMsg()
, Toast.LENGTH_SHORT).show();
} else {
//更新ui ，此处使用dataBinding 自动更新到ui
Log.i("MainActivity", "price bean onchanged " + priceBean.toString());
}
}
});默认只打印ERROR日志，INFO日志开启后将打印所有请求执行的api接口方法签名、请求参数、请求response code以及处理请求的对象hash值。
RetrofitConfig.setLogLevel(Logger.LogLevel.INFO);I/[RequestViewModel]: TypedRequest[com.ocode.requestvm.request.TypedRequestImpl@96f475c] ------>[interface com.requestVM.demo.api.RetrofitDataApi] (public abstract retrofit2.Call<com.requestVM.demo.api.ResponseJsonBean> com.requestVM.demo.api.RetrofitDataApi.getOliPrice(java.lang.String,java.lang.String)) args{上海,test,}
I/[RequestViewModel]: TypedRequest[com.ocode.requestvm.request.TypedRequestImpl@96f475c ]onResponse call return success code=200在1.0.5之前的版本中，通过 new RequestObj<ResponseJsonBean>(RetrofitDataApi.requestOilprice)构建请求对象时，传入的api 注解字符串将作为 RequestLiveData 默认的key，因此同一个RequestViewModel中的Map容器中，对于同一个retrofit api，只会缓存唯一一个LiveData；
现在，你可以使用 public RequestObj(String apiAnnotation, String requestKey) {...} 接口来创建自定义requestKey的RequestObj,这可以让你在同一个RequestViewModel中缓存使用同一个api接口的不同的LiveData对象，比如多个Fragment使用同一个api接口，但是要同时使用不同的LiveData来持有对应的页面数据；
1.框架内部处理了Activity重建的时的情况，保证LiveData对象一直存在于ViewModel声明周期中，且在Activity真正finished时不发生内存泄漏的同时，在Activity由于旋转或处于后台销毁重建时，不影响已有的请求事件，且不影响后续的事件请求。
2.处理了ViewModel生命周期,在ViewModel生命周期结束时，对request请求对象内存进行清理，避免内存泄漏。自动取消所有未完成的网络请求，清理回调，节省资源。
3.支持使用不同的request obj对象请求同一api的行为；可以在每次getLiveData时传入新的RequestObj对象，只要request key（request key默认是retrofit api的注解字符串，也可以使用自定义的key值） 是不变的，就会复用旧的LiveData，并且会刷新LiveData内部持有的RequestObj对象为最新设置的对象。