Android Xutils3 完全解析
1.先来认识一下xUtils3
1)xUtils3简介
xUtils是基于Afinal开发的目前功能比较完善的一个Android开源框架,最近又发布了xUtil3.0,在增加新功能的同时又提高了框架的性能,下面来看看官方(https://github.com/wyouflf/xUtils3)对xUtils3的介绍:
xUtils包含了很多实用的android工具; xUtils支持超大文件(超过2G)上传,更全面的http请求协议支持(11种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响; xUtils 最低兼容Android 4.0 (api level 14); xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:
HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略; 支持标准的Cookie策略, 区分domain, path; 事件注解去除不常用的功能, 提高性能; 数据库api简化提高性能, 达到和greenDao一致的性能; 图片绑定支持gif(受系统兼容性影响, 部分gif文件只能静态显示), webp; 支持圆角, 圆形, 方形等裁剪, 支持自动旋转。
2)在我们的项目中快速配置xUtils3
xUtils3的配置十分的简单:
2-1)使用Gradle构建时添加一下依赖即可
1
|
<code class = "hljs css" >compile ‘org.xutils:xutils: 3.3 . 36 ’</code> |
如果使用eclipse可以点击下面链接下载aar文件, 然后用zip解压,取出jar包和so文件。
Github下载:https://github.com/wyouflf/xUtils3
JCenter下载:http://jcenter.bintray.com/org/xutils/xutils/
Maven下载1:http://central.maven.org/maven2/org/xutils/xutils/
Maven下载2:http://repo1.maven.org/maven2/org/xutils/xutils/
2-2)加入权限
1
2
|
<code class = "hljs xml" ><uses-permission android:name= "android.permission.INTERNET" > <uses-permission android:name= "android.permission.WRITE_EXTERNAL_STORAGE" ></uses-permission></uses-permission></code> |
2-3)创建Application
1
2
3
4
5
6
7
8
|
<code class = "hljs java" > public class MyApp extends Application { @Override public void onCreate() { super .onCreate(); x.Ext.init( this ); x.Ext.setDebug( true ); //是否输出debug日志,开启debug会影响性能。 } }</code> |
2-4)在Manifest文件中注册MyApp
1
|
<code class = "hljs r" ></application></code> |
xUtils3主要包含注解模块、网络模块、图片模块和数据库模块,下面将做一一说明。
2.xUtils3注解模块的使用
xUtils3注解模块在实际开发中的使用如下:
1)Activity的注解的使用如下:
1
2
3
4
5
6
7
8
9
10
11
|
<code class = "hljs java" > @ContentView (R.layout.activity_main) public class MainActivity extends AppCompatActivity { @ViewInject (R.id.viewpager) ViewPager viewPager; @Override protected void onCreate(Bundle savedInstanceState) { super .onCreate(savedInstanceState); x.view().inject( this ); ... } }</code> |
2)Fragment的注解的使用如下:
1
2
3
4
5
6
7
8
9
10
11
12
|
<code class = "hljs java" > @ContentView (R.layout.fragment_http) public class HttpFragment extends Fragment { @Nullable @Override public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) { return x.view().inject( this , inflater, container); } @Override public void onViewCreated(View v, @Nullable Bundle savedInstanceState) { super .onViewCreated(v, savedInstanceState); } }</code> |
3)为按钮设置点击事件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
<code class = "hljs java" > @ViewInject (R.id.bt_main) Button bt_main; ... @Override protected void onCreate(Bundle savedInstanceState) { ... } /** * 用注解的方式为按钮添加点击事件,方法声明必须为private * type默认View.OnClickListener.class,故此处可以简化不写,@Event(R.id.bt_main) */ @Event (type = View.OnClickListener. class ,value = R.id.bt_main) private void testInjectOnClick(View v){ Snackbar.make(v, "OnClickListener" ,Snackbar.LENGTH_SHORT).show(); } /** * 长按事件 */ @Event (type = View.OnLongClickListener. class ,value = R.id.bt_main) private boolean testOnLongClickListener(View v){ Snackbar.make(v, "testOnLongClickListener" ,Snackbar.LENGTH_SHORT).show(); return true ; }</code> |
1
2
|
<code>说明:下面演示都将使用 @Event 事件注解。 </code> |
3.xUtils3网络模块的使用
xUtils3网络模块大大方便了在实际开发中网络模块的开发,xUtils3网络模块大致包括GET请求、POST请求、如何使用其他请求方式、上传文件、下载文件、使用缓存等功能,下面将做一一说明:
1)GET请求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
@Event (R.id.get) private void get(View v){ final ProgressDialog progressDialog = new ProgressDialog(getActivity()); progressDialog.setMessage( "请稍候..." ); RequestParams params = new RequestParams(url); params.addQueryStringParameter( "username" , "abc" ); params.addQueryStringParameter( "password" , "123" ); Callback.Cancelable cancelable = x.http().get(params, new Callback.CommonCallback<string>() { @Override public void onSuccess(String result) { Log.i( "JAVA" , "onSuccess result:" + result); progressDialog.cancel(); } //请求异常后的回调方法 @Override public void onError(Throwable ex, boolean isOnCallback) { } //主动调用取消请求的回调方法 @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { progressDialog.cancel(); } }); //主动调用取消请求 cancelable.cancel(); }</string></code> |
2)POST请求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
@Event (R.id.post) private void post(View v){ RequestParams params = new RequestParams(url); params.addBodyParameter( "username" , "abc" ); params.addParameter( "password" , "123" ); params.addHeader( "head" , "android" ); //为当前请求添加一个头 x.http().post(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() { } }); }</string></code> |
3)其他网络请求方式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
@Event (R.id.other) private void other(View v){ RequestParams params = new RequestParams(url); params.addParameter( "username" , "abc" ); x.http().request(HttpMethod.PUT, 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() { } }); }</string></code> |
4)上传文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
@Event (R.id.upload) private void upload(View v){ String path= "/mnt/sdcard/Download/icon.jpg" ; RequestParams params = new RequestParams(url); params.setMultipart( true ); params.addBodyParameter( "file" , new File(path)); x.http().post(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() { } }); }</string></code> |
5)下载文件
这里以下载apk为例进行说明,apk下载完成后,自动调用系统的安装方法。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
@Event (R.id.download) private void download(View v){ RequestParams params = new RequestParams(url); //自定义保存路径,Environment.getExternalStorageDirectory():SD卡的根目录 params.setSaveFilePath(Environment.getExternalStorageDirectory()+ "/myapp/" ); //自动为文件命名 params.setAutoRename( true ); x.http().post(params, new Callback.ProgressCallback<file>() { @Override public void onSuccess(File result) { //apk下载完成后,调用系统的安装方法 Intent intent = new Intent(Intent.ACTION_VIEW); intent.setDataAndType(Uri.fromFile(result), "application/vnd.android.package-archive" ); getActivity().startActivity(intent); } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } //网络请求之前回调 @Override public void onWaiting() { } //网络请求开始的时候回调 @Override public void onStarted() { } //下载的时候不断回调的方法 @Override public void onLoading( long total, long current, boolean isDownloading) { //当前进度和文件总大小 Log.i( "JAVA" , "current:" + current + ",total:" +total); } }); }</file></code> |
6)使用缓存
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
|
@Event (R.id.cache) private void cache(View v) { RequestParams params = new RequestParams(url); params.setCacheMaxAge( 1000 * 60 ); //为请求添加缓存时间 Callback.Cancelable cancelable = x.http().get(params, new Callback.CacheCallback<string>() { @Override public void onSuccess(String result) { Log.i( "JAVA" , "onSuccess:" +result); } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } //result:缓存内容 @Override public boolean onCache(String result) { //在setCacheMaxAge设置范围(上面设置的是60秒)内,如果再次调用GET请求, //返回true:缓存内容被返回,相信本地缓存,返回false:缓存内容被返回,不相信本地缓存,仍然会请求网络 Log.i( "JAVA" , "cache:" +result); return true ; } }); }</string></code> |
4.xUtils3图片模块的使用
xUtils3图片模块,重点在于加载图片的4个bind方法,loadDrawable与loadFIle用法和ImageOptions用法,需多加练习。
1)首先获取ImageView控件
1
2
3
4
5
6
7
|
<code class = "hljs r" > @ViewInject (R.id.image01) ImageView image01; @ViewInject (R.id.image02) ImageView image02; @ViewInject (R.id.image03) ImageView image03; ...</code> |
2)得到网络图片的地址
1
2
3
4
5
6
|
<code class = "hljs r" >String[] urls={ ... };</code> |
3)xUtils3显示图片方法setPic()如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
<code class = "hljs java" > private void setPic() { /** * 通过ImageOptions.Builder().set方法设置图片的属性 */ ImageOptions options = 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 /** * 加载图片的4个bind方法 */ x.image().bind(image01, urls[ 0 ]); x.image().bind(image02, urls[ 1 ], options); x.image().bind(image03, urls[ 2 ], options, new Callback.CommonCallback<drawable>() { @Override public void onSuccess(Drawable result) { } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } }); x.image().bind(image04, urls[ 3 ], options, new Callback.CommonCallback<drawable>() { @Override public void onSuccess(Drawable result) { } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } }); /** * loadDrawable()方法加载图片 */ Callback.Cancelable cancelable = x.image().loadDrawable(urls[ 0 ], options, new Callback.CommonCallback<drawable>() { @Override public void onSuccess(Drawable result) { image03.setImageDrawable(result); } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } }); //主动取消loadDrawable()方法 //cancelable.cancel(); /** * loadFile()方法 * 应用场景:当我们通过bind()或者loadDrawable()方法加载了一张图片后, * 它会保存到本地文件中,那当我需要这张图片时,就可以通过loadFile()方法进行查找。 * urls[0]:网络地址 */ x.image().loadFile(urls[ 0 ],options, new Callback.CacheCallback<file>(){ @Override public boolean onCache(File result) { //在这里可以做图片另存为等操作 Log.i( "JAVA" , "file:" +result.getPath()+result.getName()); return true ; //相信本地缓存返回true } @Override public void onSuccess(File result) { Log.i( "JAVA" , "file" ); } @Override public void onError(Throwable ex, boolean isOnCallback) { } @Override public void onCancelled(CancelledException cex) { } @Override public void onFinished() { } }); }</file></drawable></drawable></drawable></code> |
4.xUtils3数据库模块的使用
1)创建数据库和删除数据库
首先进行配置DaoConfig:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
<code class = "hljs fsharp" >/** * DaoConfig配置 * / DbManager.DaoConfig daoConfig = new DbManager.DaoConfig() //设置数据库名,默认xutils.db .setDbName( "myapp.db" ) //设置表创建的监听 .setTableCreateListener( new DbManager.TableCreateListener() { @Override public void onTableCreated(DbManager db, TableEntity<!--?--> table){ Log.i( "JAVA" , "onTableCreated:" + table.getName()); } }) //设置是否允许事务,默认true //.setAllowTransaction(true) //设置数据库路径,默认安装程序路径下 //.setDbDir(new File("/mnt/sdcard/")) //设置数据库的版本号 //.setDbVersion(1) //设置数据库更新的监听 .setDbUpgradeListener( new DbManager.DbUpgradeListener() { @Override public void onUpgrade(DbManager db, int oldVersion, int newVersion) { } }) //设置数据库打开的监听 .setDbOpenListener( new DbManager.DbOpenListener() { @Override public void onDbOpened(DbManager db) { //开启数据库支持多线程操作,提升性能 db.getDatabase().enableWriteAheadLogging(); } }); DbManager db = x.getDb(daoConfig);</code> |
然后创建数据库表ChildInfo的实体类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
<code class = "hljs java" > /** * onCreated = "sql":当第一次创建表需要插入数据时候在此写sql语句 */ @Table (name = "child_info" ,onCreated = "" ) public class ChildInfo { /** * name = "id":数据库表中的一个字段 * isId = true:是否是主键 * autoGen = true:是否自动增长 * property = "NOT NULL":添加约束 */ @Column (name = "id" ,isId = true ,autoGen = true ,property = "NOT NULL" ) private int id; @Column (name = "c_name" ) private String cName; public ChildInfo(String cName) { this .cName = cName; } //默认的构造方法必须写出,如果没有,这张表是创建不成功的 public ChildInfo() { } public int getId() { return id; } public void setId( int id) { this .id = id; } public String getcName() { return cName; } public void setcName(String cName) { this .cName = cName; } @Override public String toString() { return "ChildInfo{" + "id=" +id+ ",cName='" +cName+'\ '' + '}' ; } }</code> |
之后就能进行创建和删除数据库的操作了:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<code class = "hljs java" > //创建数据库 @Event (R.id.create_db) private void createDB(View v) throws DbException { //用集合向child_info表中插入多条数据 ArrayList<childinfo> childInfos = new ArrayList<>(); childInfos.add( new ChildInfo( "zhangsan" )); childInfos.add( new ChildInfo( "lisi" )); childInfos.add( new ChildInfo( "wangwu" )); childInfos.add( new ChildInfo( "zhaoliu" )); childInfos.add( new ChildInfo( "qianqi" )); childInfos.add( new ChildInfo( "sunba" )); //db.save()方法不仅可以插入单个对象,还能插入集合 db.save(childInfos); } //删除数据库 @Event (R.id.del_db) private void delDB(View v) throws DbException { db.dropDb(); }</childinfo></code> |
2)删除表
1
2
3
4
5
|
<code class = "hljs java" > //删除表 @Event (R.id.del_table) private void delTable(View v) throws DbException { db.dropTable(ChildInfo. class ); }</code> |
3)查询表中的数据
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<code class = "hljs lasso" > //查询表中的数据 @Event (R.id.select_table) private void selelctDB(View v) throws DbException { //查询数据库表中第一条数据 ChildInfo first = db.findFirst(ChildInfo. class ); Log.i( "JAVA" ,first.toString()); //添加查询条件进行查询 //第一种写法: WhereBuilder b = WhereBuilder.b(); b.and( "id" , ">" , 2 ); //构造修改的条件 b.and( "id" , "<" , 4 ); List<childinfo> all = db.selector(ChildInfo. class ).where(b).findAll(); //findAll():查询所有结果 for (ChildInfo childInfo :all){ Log.i( "JAVA" ,childInfo.toString()); } //第二种写法: List<childinfo> all = db.selector(ChildInfo. class ).where( "id" , ">" , 2 ).and( "id" , "<" , 4 ).findAll(); for (ChildInfo childInfo :all){ Log.i( "JAVA" ,childInfo.toString()); } }</childinfo></childinfo></code> |
4)修改表中的数据
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<code class = "hljs java" > //修改表中的一条数据 @Event (R.id.update_table) private void updateTable(View v) throws DbException { //第一种写法: ChildInfo first = db.findFirst(ChildInfo. class ); first.setcName( "zhansan2" ); db.update(first, "c_name" ); //c_name:表中的字段名 //第二种写法: WhereBuilder b = WhereBuilder.b(); b.and( "id" , "=" ,first.getId()); //构造修改的条件 KeyValue name = new KeyValue( "c_name" , "zhansan3" ); db.update(ChildInfo. class ,b,name); //第三种写法: first.setcName( "zhansan4" ); db.saveOrUpdate(first); }</code> |
5)删除表中的数据
1
2
3
4
5
6
7
8
9
10
|
<code class = "hljs d" > @Event (R.id.del_table_data) private void delTableData(View v) throws DbException { //第一种写法: db.delete(ChildInfo. class ); //child_info表中数据将被全部删除 //第二种写法,添加删除条件: WhereBuilder b = WhereBuilder.b(); b.and( "id" , ">" , 2 ); //构造修改的条件 b.and( "id" , "<" , 4 ); db.delete(ChildInfo. class , b); }</code> |
Android Xutils3 完全解析的更多相关文章
- Android xUtils3源代码解析之网络模块
本文已授权微信公众号<非著名程序猿>原创首发,转载请务必注明出处. xUtils3源代码解析系列 一. Android xUtils3源代码解析之网络模块 二. Android xUtil ...
- Android Service完全解析,关于服务你所需知道的一切(下)
转载请注册出处:http://blog.csdn.net/guolin_blog/article/details/9797169 在上一篇文章中,我们学习了Android Service相关的许多重要 ...
- Android Service完全解析,关于服务你所需知道的一切(上)
转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/11952435 相信大多数朋友对Service这个名词都不会陌生,没错,一个老练的A ...
- [转] Android Volley完全解析(一),初识Volley的基本用法
版权声明:本文出自郭霖的博客,转载必须注明出处. 目录(?)[-] Volley简介 下载Volley StringRequest的用法 JsonRequest的用法 转载请注明出处:http ...
- Android OkHttp完全解析 --zz
参考文章 https://github.com/square/okhttp http://square.github.io/okhttp/ 泡网OkHttp使用教程 Android OkHttp完全解 ...
- Android IntentService完全解析 当Service遇到Handler
一 概述 大家都清楚,在Android的开发中,凡是遇到耗时的操作尽可能的会交给Service去做,比如我们上传多张图,上传的过程用户可能将应用置于后台,然后干别的去了,我们的Activity就很可能 ...
- Android Volley完全解析
1. Volley简介 我们平时在开发Android应用的时候不可避免地都需要用到网络技术,而多数情况下应用程序都会使用HTTP协议来发送和接收网络数据.Android系统中主要提供了两种方式来进行H ...
- Android OkHttp完全解析 是时候来了解OkHttp了
Android OkHttp完全解析 是时候来了解OkHttp了 标签: AndroidOkHttp 2015-08-24 15:36 316254人阅读 评论(306) 收藏 举报 分类: [an ...
- Android Bitmap 全面解析(四)图片处理效果对比 ...
对比对象: UIL Volley 官方教程中的方法(此系列教程一里介绍的,ImageLoader的处理方法和官方的差不多) -------------------------------------- ...
随机推荐
- 201871010121-王方-《面向对象程序设计java》第十六周实验总结
项目 内容 这个作业属于哪个课程 https://www.cnblogs.com/nwnu-daizh 这个作业的要求在哪里 https://www.cnblogs.com/nwnu-daizh/p/ ...
- 基于 Docker 的 MySQL 主从复制搭建
出处:https://www.jianshu.com/p/ab20e835a73f
- Node.js到底是做什么的?这是我看到最好的解释了
作者:贾厂长链接:https://www.zhihu.com/question/33578075/answer/56951771来源:知乎著作权归作者所有.商业转载请联系作者获得授权,非商业转载请注明 ...
- 【Mybatis】CDATA
忽视内部尖括号那些东西
- isinstance 与 issubclass
isinstance与issubclass都是用于判断的,有什么区别呢? 1. isinstance字面意思:实列, 用户判断对象所属类型,包含类的继承关系. 2. issubclass字面理解:是子 ...
- Linux--部署Django项目
简单部署 1.安装虚拟环境virtualenvwrapper,创建虚拟环境目录,进入虚拟环境,我的虚拟环境目录叫venv2 [root@HH ~]# workon venv2 (venv2) [roo ...
- [LeetCode] 527. Word Abbreviation 单词缩写
Given an array of n distinct non-empty strings, you need to generate minimal possible abbreviations ...
- 团队作业第五次—项目冲刺-Day7
Day7 part1-SCRUM: 项目相关 作业相关 具体描述 所属班级 2019秋福大软件工程实践Z班 作业要求 团队作业第五次-项目冲刺 作业正文 hunter--冲刺集合 团队名称 hunte ...
- Golang(九)简单 Goroutine 池实现
0. 前言 最近使用 Golang 写一个并发执行的测试脚本 之前习惯使用 Java,习惯性想先建一个线程池.然后意识到 Golang 没有封装好的线程池 结合之前学习的 Goroutine 原理和 ...
- .NET Core:Token认证
现在是WebAPI的时代,你所需要面对的不止是浏览器了,通常会使用Web, WebApp, NativeApp等多种呈现方式.其中诸如Ember,Angular,Backbone之类的前端框架类库正随 ...