xUtils是基于Afinal开发的,稳定性比Afinal提高了不少。xUtils包含四大模块:DbUtils模块, ViewUtils模块, HttpUtils模块, BitmapUtils模块。我们分别看一下四大模块的特点:
DbUtils模块:
- android中的orm框架,一行代码就可以进行增删改查;
- 支持事务,默认关闭;
- 可通过注解自定义表名,列名,外键,唯一性约束,NOT NULL约束,CHECK约束等(需要混淆的时候请注解表名和列名);
- 支持绑定外键,保存实体时外键关联实体自动保存或更新;
- 自动加载外键关联实体,支持延时加载;
- 支持链式表达查询,更直观的查询语义,参考下面的介绍或sample中的例子
ViewUtils模块:
- android中的ioc框架,完全注解方式就可以进行UI,资源和事件绑定;
- 新的事件绑定方式,使用混淆工具混淆后仍可正常工作;
- 目前支持常用的20种事件绑定,参见ViewCommonEventListener类和包com.lidroid.xutils.view.annotation.event。
HttpUtils模块:
- 支持同步,异步方式的请求;
- 支持大文件上传,上传大文件不会oom;
- 支持GET,POST,PUT,MOVE,COPY,DELETE,HEAD,OPTIONS,TRACE,CONNECT请求;
- 下载支持301/302重定向,支持设置是否根据Content-Disposition重命名下载的文件;
- 返回文本内容的请求(默认只启用了GET请求)支持缓存,可设置默认过期时间和针对当前请求的过期时间。
BitmapUtils模块:
- 加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象;
- 支持加载网络图片和本地图片;
- 内存管理使用lru算法,更好的管理bitmap内存;
- 可配置线程加载线程数量,缓存大小,缓存路径,加载显示动画等..
本节只讲解HttpUtils和DbUtils。
HttpUtils
HttpUtils向网络提交和获取方式也有两种:”GET”和“POST”。
GET
1. 首先创建 HttpUtils的对象。
HttpUtils client = new HttpUtils();
**2. 调用send方法。**send方法中传入三个参数,第一个是请求的方式“GET”or“POST”;第二个参数是请求的URL地址;第三个是请求回调的对象,重写其中的两个方法,请求成功后执行onSuccess()方法获得返回的信息ResponseInfo并对数据做相关的处理,请求失败后执行onFailure()并做相关的处理。
client.send(HttpRequest.HttpMethod.GET, "http://www.360.com", new RequestCallBack<String>() {
@Override
public void onSuccess(ResponseInfo<String> responseInfo) {
}
@Override
public void onFailure(HttpException e, String s) {
mTextViewXUtilsGetContent.setText("网络连接错误");
}
});
public class XutilsDemoActivity extends Activity implements View.OnClickListener {
//这里使用了xUtils的注解机制。
@ViewInject(R.id.button_xutils_get)
private Button mButotnXUtilsGetConnect;
@ViewInject(R.id.button_xutils_post)
private Button mButotnXUtilsPostConnect;
@ViewInject(R.id.textview_xutils_get_content)
private TextView mTextViewXUtilsGetContent;
@ViewInject(R.id.textview_xutils_post_content)
private TextView mTextViewXUtilsPostContent;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_xutils_demo);
mButotnXUtilsGetConnect.setOnClickListener(this);//点击事件
mButotnXUtilsPostConnect.setOnClickListener(this);//点击事件
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.button_xutils_get:
doGet();
break;
default:
break;
}
}
private void doGet() {
HttpUtils client = new HttpUtils();
client.send(HttpRequest.HttpMethod.GET, "http://www.360.com", new RequestCallBack<String>() {
@Override
public void onSuccess(ResponseInfo<String> responseInfo) {
mTextViewXUtilsGetContent.setText(responseInfo.result);
}
@Override
public void onFailure(HttpException e, String s) {
mTextViewXUtilsGetContent.setText("网络连接错误");
}
});
}
}
POST
1. 首先创建 HttpUtils的对象。
HttpUtils client = new HttpUtils();
2. 设置提交的数据,使用RequestParams 类
RequestParams params = new RequestParams();
params.addBodyParameter("username", "zhangsan");
**3. 调用send方法。**send方法中传入三个参数,第一个是请求的方式“GET”or“POST”;第二个参数是请求的URL地址;第三个参数是传入的数据;第四个是请求回调的对象,重写其中的两个方法,请求成功后执行onSuccess()方法获得返回的信息ResponseInfo并对数据做相关的处理,请求失败后执行onFailure()并做相关的处理。
//这里我们是向自己用Java构建的一个Web服务器提交数据,然后服务器对数据处理后返回。
client.send(HttpRequest.HttpMethod.POST, "http://192.168.0.44:8080/MyServiceTest/MyTestServlet", params, new RequestCallBack<String>() {
@Override
public void onSuccess(ResponseInfo<String> responseInfo) {
mTextViewXUtilsPostContent.setText(responseInfo.result);
}
@Override
public void onFailure(HttpException e, String s) {
mTextViewXUtilsPostContent.setText("网络连接错误");
}
});
public class XutilsDemoActivity extends Activity implements View.OnClickListener {
//这里使用了xUtils的注解机制。
@ViewInject(R.id.button_xutils_get)
private Button mButotnXUtilsGetConnect;
@ViewInject(R.id.button_xutils_post)
private Button mButotnXUtilsPostConnect;
@ViewInject(R.id.textview_xutils_get_content)
private TextView mTextViewXUtilsGetContent;
@ViewInject(R.id.textview_xutils_post_content)
private TextView mTextViewXUtilsPostContent;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_xutils_demo);
mButotnXUtilsGetConnect.setOnClickListener(this);//点击事件
mButotnXUtilsPostConnect.setOnClickListener(this);//点击事件
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.button_xutils_post:
doPost();
break;
default:
break;
}
}
private void doPost() {
HttpUtils client = new HttpUtils();
RequestParams params = new RequestParams();
params.addBodyParameter("username", "I love you");
client.send(HttpRequest.HttpMethod.POST, "http://192.168.0.44:8080/MyServiceTest/MyTestServlet", params, new RequestCallBack<String>() {
@Override
public void onSuccess(ResponseInfo<String> responseInfo) {
mTextViewXUtilsPostContent.setText(responseInfo.result);
}
@Override
public void onFailure(HttpException e, String s) {
mTextViewXUtilsPostContent.setText("网络连接错误");
}
});
}
}
DbUtils
这里对数据库的操作,我们要在《 Android中数据存储——SQLite数据库存储数据 》文章所搭建的项目的基础上进行操作。在阅读此处的过程中有不明白的可以贯穿的看一下《 Android中数据存储——SQLite数据库存储数据 》这篇文章。
DbUtils主要是对数据库的操作,它将数据库繁琐的增删改查操作简化为简单的一句代码。使用DbUtils对数据库进行操作,要使用到注解。首先注意使用过程中的易混淆事项:
- 添加Android默认混淆配置${sdk.dir}/tools/proguard/proguard-android.txt
- 不要混淆xUtils中的注解类型,添加混淆配置:-keep class * extends java.lang.annotation.Annotation { *; }
- 对使用DbUtils模块持久化的实体类不要混淆,或者注解所有表和列名称@Table(name=”xxx”),@Id(column=”xxx”),@Column(column=”xxx”),@Foreign(column=”xxx”,foreign=”xxx”);
1. 我们创建的数据库中包含id, name和passwords三个字段,我们首先创建一个User的类,其中包含id, name和passwords三个属性。
/添加注解,表明我们要将name为myuser的数据表中的每条记录提取成User对象。
@Table(name="myuser")
public class User {
@Id(column="id")
private int id;
private String name;
private String passwords;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPasswords() {
return passwords;
}
public void setPasswords(String passwords) {
this.passwords = passwords;
}
}
2. 使用DbUtils进行操作。我们这里以查找为例:创建DbUtils的对象,调用findAll()方法查找数据库中的记录,返回User的集合,集合存放的数据记录生成的User对象。
//使用数据库进行查询
DbUtils db = DbUtils.create(this,"create_db");
try {
List<User> users = db.findAll(User.class);
for(User user:users){
Log.d("data", " name=" + user.getName() + " password=" + user.getPasswords());
}
} catch (DbException e) {
e.printStackTrace();
}
对于ViewUtils和BipmapUtils的使用可以查看 GitHub上的这篇文章,点击查看>文章链接。