目录
一、xUtils3简介
1.网络请求
http(s): 基于UrlConnection, Android4.4以后底层为okHttp实现.
- 请求协议支持11种谓词:GET,POST,PUT,PATCH,HEAD,MOVE,COPY,DELETE,OPTIONS,TRACE,CONNECT
- 支持超大文件(超过2G)上传
- 支持断点下载(如果服务端支持Range参数,客户端自动处理断点下载)
- 支持cookie(实现了domain, path, expiry等特性)
- 支持缓存(实现了Cache-Control, Last-Modified, ETag等特性, 缓存内容过多时使用过期时间+LRU双重机制清理)
- 支持异步和同步(可结合RxJava使用)调用
其他的网络框架
- Volley - google官方13 -已经停止更新了（曾经辉煌过，现在已经落寞了）
- Retrofit -目前最好用的网络请求框架（还可以帮助我们json解析）
- okHttp-严格来说不是一个完整的网路请求框架，它只是提供了很多底层的网络请求服务
2.网络图片加载
image: 有了http(s)及其下载缓存的支持, image模块的实现相当的简洁.
- 支持内存缓存, 磁盘缓存(缩略图和原图), 并且支持回收被view持有, 但被MemCache移除的图片, 减少页面回退时的闪烁.
- 支持在ListView滑动时, 自动停止被回收复用的item对应的下载任务(再次下载时断点续传)
- 支持webp, gif(部分比较老的系统只展示静态图)
- 支持圆角, 圆形, 方形等裁剪, 支持自动旋转…
3.注解
view注解模块仅仅400多行代码却灵活的支持了各种View注入和事件绑定.
- 事件注解支持且不受混淆影响…(参考混淆配置)
- 支持绑定拥有多个方法的listener
4.数据库
orm: 高效稳定的orm工具, 使得http接口实现时更方便的支持cookie和缓存.
- 灵活的, 类似linq表达式的接口.
- 和greenDao一致的性能.
二、xUtils框架使用方法
1.导入依赖
implementation 'org.xutils:xutils:3.9.0'
2.添加权限
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
application 节点里添加
android:requestLegacyExternalStorage="true"
android:usesCleartextTraffic="true"
3.在MainActivity中添加代码：
x.Ext.init(getApplication());
x.Ext.setDebug(BuildConfig.DEBUG);// 是否输出debug日志, 开启debug会影响性能.
x.view().inject(this);//没有用到view注解可以先不用
1.xUtils框架一个简单的网络请求
1.添加代码：
RequestParams params = new RequestParams("https://www.baidu.com");
x.http().get(params, new Callback.CommonCallback<String>() {
@Override
public void onSuccess(String result) {
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
});
2.打印日志，检查网络访问是否成功
Log.i("Main","onSuccess"+result);
Log.i("Main", "onError"+ex.getMessage());
xUtils3的优点:
-
框架帮助我们完成了启动子线程的操作，所以不需要我们在进行网络请求的时候自己创建启动子线程
-
拿到数据以后不需要手动切回主线程，使用框架会帮我们切回主线程
-
对于异常，框架也会帮助我们自动处理
举例一个错误
xUtils3网络请求框架比我们的原生网络请求方式方便了很多，但是虽然这是一个框架，但是实际上原生请求的那些步骤框架也都实现了，只不过这些步骤都是由框架帮我们实现的，不需要我们自己去写
2.xUitls框架注解
2.1布局文件的注解
//替代onCreate方法中的 setContentView(R.layout.activity_main);
@ContentView(R.layout.activity_main)
2.2控件的注解
@ViewInject(R.id.textView)
TextView textView;
运行结果：
2.3点击事件注解
/**
* 1. 方法必须私有限定,
* 2. 方法参数形式必须和type对应的Listener接口一致.
* 3. 注解参数value支持数组: value={id1, id2, id3}
* 4. 其它参数说明见{@link org.xutils.event.annotation.Event}类的说明.
**/
@Event(value = R.id.btn_test1,
type = View.OnClickListener.class/*可选参数, 默认是View.OnClickListener.class*/)
private void onTest1Click(View view) {
...
}
2.3.1绑定一个按钮
2.3.2绑定多个按钮
核心代码：
@Event(value = {R.id.button,R.id.button2}, //用{}把所需要的事件放在一起
type = View.OnClickListener.class/*可选参数, 默认是View.OnClickListener.class*/)
private void onTest1Click(View view) {
Log.i("Main","打印出来了");
}
那么如何区分开这两个按钮呢？这里就需要switch来选择了
核心代码：
@Event(value = {R.id.button,R.id.button2}, //用{}把所需要的事件放在一起
type = View.OnClickListener.class/*可选参数, 默认是View.OnClickListener.class*/)
private void onTest1Click(View view) {
switch (view.getId()){
case R.id.button:
Log.i("Main","button打印出来了");
break;
case R.id.button2:
Log.i("Main","button2打印出来了");
break;
}
// Log.i("Main","打印出来了");
}
3.xUitls框架-加载网络图片
3.1xUtils3 bind方法
x.image().bind(imageView, url, imageOptions);
// assets file
x.image().bind(imageView, "assets://test.gif", imageOptions);
// resources file
x.image().bind(imageView, "res://" + R.minimap.test, imageOptions);
// local file
x.image().bind(imageView, new File("/sdcard/test.gif").toURI().toString(), imageOptions);
x.image().bind(imageView, "/sdcard/test.gif", imageOptions);
x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);
x.image().bind(imageView, "file:/sdcard/test.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback<Drawable>() {...});
x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback<Drawable>() {...});
// 用来获取缓存文件
x.image().loadFile(url, imageOptions, new Callback.CommonCallback<File>() {...});
3.2xUtils3 ImageOptions
//通过ImageOptions.Builder().set方法设置图片的属性
ImageOptions imageOptions= new ImageOptions.Builder().setFadeIn(true).build(); //淡入效果
//ImageOptions.Builder()的一些其他属性：
.setCircular(true) //设置图片显示为圆形
.setSquare(true) //设置图片显示为正方形
.setCrop(true).setSize(200,200) //设置大小
.setAnimation(animation) //设置动画
.setFailureDrawable(Drawable failureDrawable) //设置加载失败的动画
.setFailureDrawableId(int failureDrawable) //以资源id设置加载失败的动画
.setLoadingDrawable(Drawable loadingDrawable) //设置加载中的动画
.setLoadingDrawableId(int loadingDrawable) //以资源id设置加载中的动画
.setIgnoreGif(false) //忽略Gif图片
.setParamsBuilder(ParamsBuilder paramsBuilder) //在网络请求中添加一些参数
.setRaduis(int raduis) //设置拐角弧度
.setUseMemCache(true) //设置使用MemCache，默认true
1.在布局文件添加imageview
<ImageView
android:id="@+id/imageView"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_marginStart="36dp"
android:layout_marginBottom="68dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintStart_toStartOf="parent"
tools:srcCompat="@tools:sample/avatars" />
2.在activity中初始化
@ViewInject(R.id.imageView)
ImageView imageView;
3.添加加载图片代码
ps：根据自身需求添加即可
ImageOptions imageOptions=new ImageOptions.Builder().setCircular(true).build();
x.image().bind(imageView, "https://img1.baidu.com/it/u=1353414575,3717902620&fm=253&fmt=auto&app=120&f=JPEG?w=1200&h=675",imageOptions);
运行结果：
本讲关于网络请求第三方框架-xUtils的知识就讲到这里啦，学会以后是不是感觉比之前的方法方便多了，谢谢您的阅读（继续加油！）