码上快乐

相关内容   简体   繁体

Android Xutils3 完全解析

本文转载自  查看原文  2019-07-25 11:31  425 

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
<code class = "hljs java" >String url = "http://www.android.com" ;
@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
<code class = "hljs java" >String url = "http://www.android.com" ;
@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
<code class = "hljs java" >String url = "http://www.android.com" ;
@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
<code class = "hljs java" >String url = "http://www.android.com" ;
@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
<code class = "hljs java" >String url = "http://www.android.com" ;
@Event (R.id.download)
private void download(View v){
     url = "http://127.0.0.1/server/ABC.apk" ;
     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
<code class = "hljs java" >String url = "http://www.android.com" ;
@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={
     "http://img.android.com/a.jpg" ，
     "http://img.android.com/b.jpg"
     "http://img.android.com/c.jpg"
     ...
};</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>


免责声明！

本站转载的文章为个人学习借鉴使用，本站对版权不负任何法律责任。如果侵犯了您的隐私权益，请联系本站邮箱yoyou2525@163.com删除。



猜您在找 android使用开源项目xutils3完成下载 初次使用xUtils3 XUtils3 的 环境搭建与简单使用 Android Service完全解析(上) Android - CollapsingToolbarLayout 完全解析 XUtils3的使用(Get,Post,断点下载,上传文件,数据库,bitmap的下载与缓存) Google Android 6.0 权限完全解析 Android Fragment 真正的完全解析（下） Android RecyclerView （一） 使用完全解析 Android View 布局流程(Layout)完全解析
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM