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>
|