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;...@Overrideprotected 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的处理方法和官方的差不多) -------------------------------------- ...
随机推荐
- No archetypes currently available. The archetype list will refresh when the indexes finish updating
配置方法: 1. 在卡住的而画面点击"config" 2. 点击"Add remote catalog", 然后设置华为云的maven仓库地址, 然后点击&qu ...
- Shell 脚本中 '$' 符号的多种用法
通常情况下,在工作中用的最多的有如下几项: $0:Shell 的命令本身 $1 到 $9:表示 Shell 的第几个参数 $? :显示最后命令的执行情况 $#:传递到脚本的参数个数 $$:脚本运行的当 ...
- (day44)前端、HTTP、HTML
目录 一.什么是前端 二.web服务 (一)流程 (二)请求方式 (1)get请求 (2)post请求 三.HTTP协议 (一)什么是HTTP协议 (二)四大特性 (三)数据格式 (1)请求格式 (2 ...
- requests--发送请求
前戏 使用python做接口自动化,必须用到requests这个库,功能非常的强大,能满足我们大部分的需求. 官网:https://2.python-requests.org//zh_CN/lates ...
- 【洛谷1829】 [国家集训队] Crash的数字表格(重拾莫比乌斯反演)
点此看题面 大致题意: 求\(\sum_{i=1}^n\sum_{j=1}^mlcm(i,j)\). 推式子 不会莫比乌斯反演的可以先去看这篇博客:初学莫比乌斯反演. 反演题显然就是推式子啊~~~ 考 ...
- Django-Debug-Toolbar插件
目录 django配置插件: 介绍: 安装及配置: 优化ORM: django配置插件: ---配置Django-Debug-Toolbar 介绍: Django-Debug-Toolbar是项目开发 ...
- KMP 串的模式匹配 (25分)
给定两个由英文字母组成的字符串 String 和 Pattern,要求找到 Pattern 在 String 中第一次出现的位置,并将此位置后的 String 的子串输出.如果找不到,则输出“Not ...
- 修改Windows中文用户名为英文(更全面的方法)
网上方法很多,但是大多不全面. 我的建议是 1,新建/切换管理员账号 net user administrator /active:yes 然后点击桌面,使用Alt+F4组合键 注销中文用户名账号,并 ...
- Java 性能调优小技巧
1.在知道必要之前不要优化系统 这可能是最重要的性能调整技巧之一.你应该遵循常见的最佳实践做法并尝试高效地实现用例.但是,这并不意味着在你证明必要之前,你应该更换任何标准库或构建复杂的优化. 在大多数 ...
- OSG :三维无序离散点构建Delaunay三角网
利用OSG的osgUtil库里面的DelaunayTriangulator类. points是需要构建三角网的点 osgUtil::DelaunayTriangulator* trig = new o ...