LoggingInterceptor全局拦截网络请求日志,打印Request和Response,格式化json、xml数据显示,方便与后台调试接口。 全局Cookie,支持SharedPreferences和内存两种管理模式。 通用的网络请求异常监听,根据不同的状态码或异常设置相应的message。 全局的异常捕获,程序发生异常时不会崩溃,可跳入异常界面重启应用。 全局事件回调,提供RxBus、Messenger两种回调方式。 全局任意位置一行代码实现文件下载进度监听(暂不支持多文件进度监听)。 全局点击事件防抖动处理,防止点击过快。

1、准备工作

网上的很多有关MVVM的资料,在此就不再阐述什么是MVVM了,不清楚的朋友可以先去了解一下。todo-mvvm-live

1.1、启用databinding

在主工程app的build.gradle的android {}中加入:

dataBinding {

enabled true

}

1.2、依赖Library

从远程依赖:

在根目录的build.gradle中加入

allprojects {

repositories {

google()

jcenter()

maven { url ‘https://jitpack.io’ }

}

}

在主项目app的build.gradle中依赖

dependencies {

implementation ‘com.github.goldze:MVVMHabit:3.1.4’

}

下载例子程序,在主项目app的build.gradle中依赖例子程序中的mvvmhabit:

dependencies {

implementation project(‘:mvvmhabit’)

}

1.3、配置config.gradle

如果不是远程依赖,而是下载的例子程序,那么还需要将例子程序中的config.gradle放入你的主项目根目录中,然后在根目录build.gradle的第一行加入:

apply from: “config.gradle”

注意: config.gradle中的

android = [] 是你的开发相关版本配置,可自行修改

support = [] 是你的support相关配置,可自行修改

dependencies = [] 是依赖第三方库的配置,可以加新库,但不要去修改原有第三方库的版本号,不然可能会编译不过

1.4、配置AndroidManifest

添加权限:

配置Application:

继承mvvmhabit中的BaseApplication,或者调用

BaseApplication.setApplication(this);

来初始化你的Application

可以在你的自己AppApplication中配置

//是否开启日志打印

KLog.init(true);

//配置全局异常崩溃操作

CaocConfig.Builder.create()

.backgroundMode(CaocConfig.BACKGROUND_MODE_SILENT) //背景模式,开启沉浸式

.enabled(true) //是否启动全局异常捕获

.showErrorDetails(true) //是否显示错误详细信息

.showRestartButton(true) //是否显示重启按钮

.trackActivities(true) //是否跟踪Activity

.minTimeBetweenCrashesMs(2000) //崩溃的间隔时间(毫秒)

.errorDrawable(R.mipmap.ic_launcher) //错误图标

.restartActivity(LoginActivity.class) //重新启动后的activity

//.errorActivity(YourCustomErrorActivity.class) //崩溃后的错误activity

//.eventListener(new YourCustomEventListener()) //崩溃后的错误监听

.apply();

2、快速上手

2.1、第一个Activity

以大家都熟悉的登录操作为例:三个文件LoginActivty.java、LoginViewModel.java、activity_login.xml

2.1.1、关联ViewModel

在activity_login.xml中关联LoginViewModel。

type=“com.goldze.mvvmhabit.ui.login.LoginViewModel”

name=“viewModel”

/>

variable - type:类的全路径

variable - name:变量名

2.1.2、继承BaseActivity

LoginActivity继承BaseActivity

public class LoginActivity extends BaseActivity {

//ActivityLoginBinding类是databinding框架自定生成的,对activity_login.xml

@Override

public int initContentView(Bundle savedInstanceState) {

return R.layout.activity_login;

}

@Override

public int initVariableId() {

return BR.viewModel;

}

@Override

public LoginViewModel initViewModel() {

//View持有ViewModel的引用,如果没有特殊业务处理,这个方法可以不重写

return ViewModelProviders.of(this).get(LoginViewModel.class);

}

}

保存activity_login.xml后databinding会生成一个ActivityLoginBinding类。(如果没有生成,试着点击Build->Clean Project)

BaseActivity是一个抽象类,有两个泛型参数,一个是ViewDataBinding,另一个是BaseViewModel,上面的ActivityLoginBinding则是继承的ViewDataBinding作为第一个泛型约束,LoginViewModel继承BaseViewModel作为第二个泛型约束。

重写BaseActivity的二个抽象方法

initContentView() 返回界面layout的id

initVariableId() 返回变量的id,对应activity_login中name=“viewModel”,就像一个控件的id,可以使用R.id.xxx,这里的BR跟R文件一样,由系统生成,使用BR.xxx找到这个ViewModel的id。

选择性重写initViewModel()方法,返回ViewModel对象

@Override

public LoginViewModel initViewModel() {

//View持有ViewModel的引用,如果没有特殊业务处理,这个方法可以不重写

return ViewModelProviders.of(this).get(LoginViewModel.class);

}

注意: 不重写initViewModel(),默认会创建LoginActivity中第二个泛型约束的LoginViewModel,如果没有指定第二个泛型,则会创建BaseViewModel

2.1.3、继承BaseViewModel

LoginViewModel继承BaseViewModel

public class LoginViewModel extends BaseViewModel {

public LoginViewModel(@NonNull Application application) {

super(application);

}

}

BaseViewModel与BaseActivity通过LiveData来处理常用UI逻辑,即可在ViewModel中使用父类的showDialog()、startActivity()等方法。在这个LoginViewModel中就可以尽情的写你的逻辑了!

BaseFragment的使用和BaseActivity一样,详情参考Demo。

2.2、数据绑定

拥有databinding框架自带的双向绑定,也有扩展

2.2.1、传统绑定

绑定用户名:

在LoginViewModel中定义

//用户名的绑定

public ObservableField userName = new ObservableField<>(“”);

在用户名EditText标签中绑定

android:text=“@={viewModel.userName}”

这样一来,输入框中输入了什么,userName.get()的内容就是什么,userName.set(“”)设置什么,输入框中就显示什么。 注意: @符号后面需要加=号才能达到双向绑定效果;userName需要是public的,不然viewModel无法找到它。

点击事件绑定:

在LoginViewModel中定义

//登录按钮的点击事件

public View.OnClickListener loginOnClick = new View.OnClickListener() {

@Override

public void onClick(View v) {

}

};

在登录按钮标签中绑定

android:onClick=“@{viewModel.loginOnClick}”

这样一来,用户的点击事件直接被回调到ViewModel层了,更好的维护了业务逻辑

这就是强大的databinding框架双向绑定的特性,不用再给控件定义id,setText(),setOnClickListener()。

但是,光有这些,完全满足不了我们复杂业务的需求啊!MVVMHabit闪亮登场:它有一套自定义的绑定规则,可以满足大部分的场景需求,请继续往下看。

2.2.2、自定义绑定

还拿点击事件说吧,不用传统的绑定方式,使用自定义的点击事件绑定。

在LoginViewModel中定义

//登录按钮的点击事件

public BindingCommand loginOnClickCommand = new BindingCommand(new BindingAction() {

@Override

public void call() {

}

});

在activity_login中定义命名空间

xmlns:binding=“http://schemas.android.com/apk/res-auto”

在登录按钮标签中绑定

binding:onClickCommand=“@{viewModel.loginOnClickCommand}”

这和原本传统的绑定不是一样吗?不,这其实是有差别的。使用这种形式的绑定,在原本事件绑定的基础之上,带有防重复点击的功能,1秒内多次点击也只会执行一次操作。如果不需要防重复点击,可以加入这条属性

binding:isThrottleFirst=“@{Boolean.TRUE}”

那这功能是在哪里做的呢?答案在下面的代码中。

//防重复点击间隔(秒)

public static final int CLICK_INTERVAL = 1;

/**

requireAll 是意思是是否需要绑定全部参数, false为否 View的onClick事件绑定 onClickCommand 绑定的命令, isThrottleFirst 是否开启防止过快点击

*/

@BindingAdapter(value = {“onClickCommand”, “isThrottleFirst”}, requireAll = false)

public static void onClickCommand(View view, final BindingCommand clickCommand, final boolean isThrottleFirst) {

if (isThrottleFirst) {

RxView.clicks(view)

.subscribe(new Consumer() {

@Override

public void accept(Object object) throws Exception {

if (clickCommand != null) {

clickCommand.execute();

}

}

});

} else {

RxView.clicks(view)

.throttleFirst(CLICK_INTERVAL, TimeUnit.SECONDS)//1秒钟内只允许点击1次

.subscribe(new Consumer() {

@Override

public void accept(Object object) throws Exception {

if (clickCommand != null) {

clickCommand.execute();

}

}

});

}

}

onClickCommand方法是自定义的,使用@BindingAdapter注解来标明这是一个绑定方法。在方法中使用了RxView来增强view的clicks事件,.throttleFirst()限制订阅者在指定的时间内重复执行,最后通过BindingCommand将事件回调出去,就好比有一种拦截器,在点击时先做一下判断,然后再把事件沿着他原有的方向传递。

是不是觉得有点意思,好戏还在后头呢!

2.2.3、自定义ImageView图片加载

绑定图片路径:

在ViewModel中定义

public String imgUrl = “http://img0.imgtn.bdimg.com/it/u=2183314203,562241301&fm=26&gp=0.jpg”;

在ImageView标签中

binding:url=“@{viewModel.imgUrl}”

url是图片路径,这样绑定后,这个ImageView就会去显示这张图片,不限网络图片还是本地图片。

如果需要给一个默认加载中的图片,可以加这一句

binding:placeholderRes=“@{R.mipmap.ic_launcher_round}”

R文件需要在data标签中导入使用,如:

BindingAdapter中的实现

@BindingAdapter(value = {“url”, “placeholderRes”}, requireAll = false)

public static void setImageUri(ImageView imageView, String url, int placeholderRes) {

if (!TextUtils.isEmpty(url)) {

//使用Glide框架加载图片

Glide.with(imageView.getContext())

.load(url)

.placeholder(placeholderRes)

.into(imageView);

}

}

很简单就自定义了一个ImageView图片加载的绑定,学会这种方式,可自定义扩展。

如果你对这些感兴趣,可以下载源码,在binding包中可以看到各类控件的绑定实现方式

2.2.4、RecyclerView绑定

RecyclerView也是很常用的一种控件,传统的方式需要针对各种业务要写各种Adapter,如果你使用了mvvmhabit,则可大大简化这种工作量,从此告别setAdapter()。

在ViewModel中定义:

//给RecyclerView添加items

public final ObservableList observableList = new ObservableArrayList<>();

//给RecyclerView添加ItemBinding

public final ItemBinding itemBinding = ItemBinding.of(BR.viewModel, R.layout.item_network);

ObservableList<>和ItemBinding<>的泛型是Item布局所对应的ItemViewModel

在xml中绑定

android:layout_width=“match_parent”

android:layout_height=“match_parent”

binding:itemBinding=“@{viewModel.itemBinding}”

binding:items=“@{viewModel.observableList}”

binding:layoutManager=“@{LayoutManagers.linear()}”

binding:lineManager=“@{LineManagers.horizontal()}” />

layoutManager控制是线性(包含水平和垂直)排列还是网格排列,lineManager是设置分割线

网格布局的写法:binding:layoutManager="@{LayoutManagers.grid(3)}

水平布局的写法:binding:layoutManager="@{LayoutManagers.linear(LinearLayoutManager.HORIZONTAL,Boolean.FALSE)}"

使用到相关类,则需要导入该类才能使用,和导入Java类相似

这样绑定后,在ViewModel中调用ObservableList的add()方法,添加一个ItemViewModel,界面上就会实时绘制出一个Item。在Item对应的ViewModel中,同样可以以绑定的形式完成逻辑

可以在请求到数据后,循环添加observableList.add(new NetWorkItemViewModel(NetWorkViewModel.this, entity));详细可以参考例子程序中NetWorkViewModel类。

注意: 在以前的版本中,ItemViewModel是继承BaseViewModel,传入Context,新版本3.x中可继承ItemViewModel,传入当前页面的ViewModel

更多RecyclerView、ListView、ViewPager等绑定方式,请参考 https://github.com/evant/binding-collection-adapter

2.3、网络请求

网络请求一直都是一个项目的核心,现在的项目基本都离不开网络,一个好用网络请求框架可以让开发事半功倍。

2.3.1、Retrofit+Okhttp+RxJava

现今,这三个组合基本是网络请求的标配,如果你对这三个框架不了解,建议先去查阅相关资料。

square出品的框架,用起来确实非常方便。MVVMHabit中引入了

api “com.squareup.okhttp3:okhttp:3.10.0”

api “com.squareup.retrofit2:retrofit:2.4.0”

api “com.squareup.retrofit2:converter-gson:2.4.0”

api “com.squareup.retrofit2:adapter-rxjava2:2.4.0”

构建Retrofit时加入

Retrofit retrofit = new Retrofit.Builder()

.addConverterFactory(GsonConverterFactory.create())

.addCallAdapterFactory(RxJavaCallAdapterFactory.create())

.build();

或者直接使用例子程序中封装好的RetrofitClient

2.3.2、网络拦截器

LoggingInterceptor: 全局拦截请求信息,格式化打印Request、Response,可以清晰的看到与后台接口对接的数据,

LoggingInterceptor mLoggingInterceptor = new LoggingInterceptor

.Builder()//构建者模式

.loggable(true) //是否开启日志打印

.setLevel(Level.BODY) //打印的等级

.log(Platform.INFO) // 打印类型

.request(“Request”) // request的Tag

.response(“Response”)// Response的Tag

.addHeader(“version”, BuildConfig.VERSION_NAME)//打印版本

.build()

构建okhttp时加入

OkHttpClient okHttpClient = new OkHttpClient.Builder()

.addInterceptor(mLoggingInterceptor)

.build();

CacheInterceptor: 缓存拦截器,当没有网络连接的时候自动读取缓存中的数据,缓存存放时间默认为3天。

创建缓存对象

//缓存时间

int CACHE_TIMEOUT = 10 * 1024 * 1024

//缓存存放的文件

File httpCacheDirectory = new File(mContext.getCacheDir(), “goldze_cache”);

//缓存对象

Cache cache = new Cache(httpCacheDirectory, CACHE_TIMEOUT);

构建okhttp时加入

OkHttpClient okHttpClient = new OkHttpClient.Builder()

.cache(cache)

.addInterceptor(new CacheInterceptor(mContext))

.build();

2.3.3、Cookie管理

MVVMHabit提供两种CookieStore:PersistentCookieStore (SharedPreferences管理)和MemoryCookieStore (内存管理),可以根据自己的业务需求,在构建okhttp时加入相应的cookieJar

OkHttpClient okHttpClient = new OkHttpClient.Builder()

.cookieJar(new CookieJarImpl(new PersistentCookieStore(mContext)))

.build();

或者

OkHttpClient okHttpClient = new OkHttpClient.Builder()

.cookieJar(new CookieJarImpl(new MemoryCookieStore()))

.build();

2.3.4、绑定生命周期

请求在ViewModel层。默认在BaseActivity中注入了LifecycleProvider对象到ViewModel,用于绑定请求的生命周期,View与请求共存亡。

RetrofitClient.getInstance().create(DemoApiService.class)

.demoGet()

.compose(RxUtils.bindToLifecycle(getLifecycleProvider())) // 请求与View周期同步

.compose(RxUtils.schedulersTransformer()) // 线程调度

.compose(RxUtils.exceptionTransformer()) // 网络错误的异常转换

.subscribe(new Consumer() {

@Override

public void accept(BaseResponse response) throws Exception {

}

}, new Consumer() {

@Override

public void accept(ResponseThrowable throwable) throws Exception {

}

});

在请求时关键需要加入组合操作符.compose(RxUtils.bindToLifecycle(getLifecycleProvider()))

注意: 由于BaseActivity/BaseFragment都实现了LifecycleProvider接口,并且默认注入到ViewModel中,所以在调用请求方法时可以直接调用getLifecycleProvider()拿到生命周期接口。如果你没有使用 mvvmabit 里面的BaseActivity或BaseFragment,使用自己定义的Base,那么需要让你自己的Activity继承RxAppCompatActivity、Fragment继承RxFragment才能用RxUtils.bindToLifecycle(lifecycle)方法。

2.3.5、网络异常处理

网络异常在网络请求中非常常见,比如请求超时、解析错误、资源不存在、服务器内部错误等,在客户端则需要做相应的处理(当然,你可以把一部分异常甩锅给网络,比如当出现code 500时,提示:请求超时,请检查网络连接,此时偷偷将异常信息发送至后台(手动滑稽))。

在使用Retrofit请求时,加入组合操作符.compose(RxUtils.exceptionTransformer()),当发生网络异常时,回调onError(ResponseThrowable)方法,可以拿到异常的code和message,做相应处理。

mvvmhabit中自定义了一个ExceptionHandle,已为你完成了大部分网络异常的判断,也可自行根据项目的具体需求调整逻辑。

注意: 这里的网络异常code,并非是与服务端协议约定的code。网络异常可以分为两部分,一部分是协议异常,即出现code = 404、500等,属于HttpException,另一部分为请求异常,即出现:连接超时、解析错误、证书验证失等。而与服务端约定的code规则,它不属于网络异常,它是属于一种业务异常。在请求中可以使用RxJava的filter(过滤器),也可以自定义BaseSubscriber统一处理网络请求的业务逻辑异常。由于每个公司的业务协议不一样,所以具体需要你自己来处理该类异常。

3、辅助功能

一个完整的快速开发框架,当然也少不了常用的辅助类。下面来介绍一下MVVMabit中有哪些辅助功能。

3.1、事件总线

事件总线存在的优点想必大家都很清楚了,android自带的广播机制对于组件间的通信而言,使用非常繁琐,通信组件彼此之间的订阅和发布的耦合也比较严重,特别是对于事件的定义,广播机制局限于序列化的类(通过Intent传递),不够灵活。

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!

由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新

如果你觉得这些内容对你有帮助,可以添加V获取:vip204888 (备注Android)

学习分享

在当下这个信息共享的时代,很多资源都可以在网络上找到,只取决于你愿不愿意找或是找的方法对不对了

很多朋友不是没有资料,大多都是有几十上百个G,但是杂乱无章,不知道怎么看从哪看起,甚至是看后就忘

如果大家觉得自己在网上找的资料非常杂乱、不成体系的话,我也分享一套给大家,比较系统,我平常自己也会经常研读。

2021最新上万页的大厂面试真题

七大模块学习资料:如NDK模块开发、Android框架体系架构…

2021大厂面试真题:

只有系统,有方向的学习,才能在短时间内迅速提高自己的技术,只有不断地学习,不懈的努力才能拥有更好的技术,才能在互联网行业中立于不败之地。

着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!**

因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。 [外链图片转存中…(img-2xBJ0oG0-1711936831653)] [外链图片转存中…(img-LKwLuzFZ-1711936831654)] [外链图片转存中…(img-9O8IgH2g-1711936831654)] [外链图片转存中…(img-6JeQbq0h-1711936831654)] [外链图片转存中…(img-UNZ3xK8E-1711936831655)] [外链图片转存中…(img-VMBN5nRi-1711936831655)]

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!

由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新

如果你觉得这些内容对你有帮助,可以添加V获取:vip204888 (备注Android) [外链图片转存中…(img-HJpMLM1t-1711936831655)]

学习分享

在当下这个信息共享的时代,很多资源都可以在网络上找到,只取决于你愿不愿意找或是找的方法对不对了

很多朋友不是没有资料,大多都是有几十上百个G,但是杂乱无章,不知道怎么看从哪看起,甚至是看后就忘

如果大家觉得自己在网上找的资料非常杂乱、不成体系的话,我也分享一套给大家,比较系统,我平常自己也会经常研读。

2021最新上万页的大厂面试真题

[外链图片转存中…(img-XQ68i2gB-1711936831656)]

七大模块学习资料:如NDK模块开发、Android框架体系架构…

[外链图片转存中…(img-F1Y6Sut9-1711936831657)]

2021大厂面试真题:

[外链图片转存中…(img-ZbnyyuTl-1711936831658)]

只有系统,有方向的学习,才能在短时间内迅速提高自己的技术,只有不断地学习,不懈的努力才能拥有更好的技术,才能在互联网行业中立于不败之地。

本文已被CODING开源项目:《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》收录

相关文章

评论可见,请评论后查看内容,谢谢!!!
 您阅读本篇文章共花了: