XUtils3的使用(Get,Post,断点下载,上传文件,数据库,bitmap的下载与缓存)

网站:https://github.com/wyouflf/xUtils3  (里面有aar文件的下载地址)

xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:
HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略.
支持标准的Cookie策略, 区分domain, path...
事件注解去除不常用的功能, 提高性能.
数据库api简化提高性能, 达到和greenDao一致的性能.
图片绑定支持gif(受系统兼容性影响, 部分gif文件只能静态显示), webp; 支持圆角, 圆形, 方形等裁剪, 支持自动 旋转..
也正是因为安卓6.0不能使用HttpClient了,所以xUtils2就有影响了,因为内部很多都是使用的HttpClient

将xUtils3.0导入项目:

使用Gradle构建时添加一下依赖即可:

compile 'org.xutils:xutils:3.3.36'

使用Eclipse构建时操作步骤如下:  (aar文件下载地址:  http://dl.bintray.com/wyouflf/maven/org/xutils/xutils/ )

下载aar文件并使用然后用zip解压, 取出jar包和so文件.  aar文件在上面给的github网站里有说到



将xutils.jar 以及armeabi目录下的.so文件添加到工程的libs中即可。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

在application的onCreate中初始化:
  切记在清单文件加name属性 android:name=".MyApplication"

public class MyApplication extends Application {
@Override
publicvoidonCreate() {
super.onCreate();
x.Ext.init(this);//Xutils初始化,这一步之后, 我们就可以在任何地方使用x.app()来获取Application的实例了.
x.Ext.setDebug(true); // 是否输出debug日志
}
}

注解的使用可以参考: http://blog.csdn.net/qq_25508039/article/details/50902620

 利用XUtils3对数据库的操作,以及注解的使用,与Xutils2有很大的区别:

import org.xutils.db.annotation.Column;
import org.xutils.db.annotation.Table;

/**
* 数据库表的实体类
*/
@Table(name = "student") //确定表名
public class Student {

//必须要有无参构造,否则创建表不成功
public Student() {
}

@Column(name = "_id", isId = true, autoGen = true)//isId为true,代表为主键,autoGen为true代表自增
public int _id;

@Column(name = "name")//设置为列名
public String name;// 姓名

@Column(name = "age")
public int age;// 年龄

@Column(name = "sex")
public String sex;// 性别

public int get_id() {
return _id;
}

public void set_id(int _id) {
this._id = _id;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

public int getAge() {
return age;
}

public void setAge(int age) {
this.age = age;
}

public String getSex() {
return sex;
}

public void setSex(String sex) {
this.sex = sex;
}
}

具体的操作:

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;

import org.xutils.DbManager;
import org.xutils.db.sqlite.SqlInfo;
import org.xutils.db.sqlite.WhereBuilder;
import org.xutils.db.table.DbModel;
import org.xutils.db.table.TableEntity;
import org.xutils.ex.DbException;
import org.xutils.view.annotation.ContentView;
import org.xutils.view.annotation.Event;
import org.xutils.x;

import java.util.ArrayList;
import java.util.List;

/**
* XUtils3对数据库的操作
*/
@ContentView(R.layout.activity_main) //加载的xml文件
public class MainActivity extends AppCompatActivity {

/**
* 数据库的配置信息对象
*/
private DbManager.DaoConfig daoConfig;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//setContentView(R.layout.activity_main);
x.view().inject(this);//绑定注解
//初始化数据库配置信息
initDaoConfig();

}

@Event(value = {R.id.add ,R.id.query,R.id.updata,R.id.delete})
private void btnOnClick(View view){ //必须是private单击事件才有效
switch (view.getId()){
case R.id.add:
addData();
break;
case R.id.query:
onQuertyData();
break;
case R.id.updata:
onUPdataData();
break;
case R.id.delete:
deleteData();
break;
}
}

/**
* 增加数据,插入数据库操作的时候会判断是否存在这张表，如果不存在就会去创建,所以不需要手动去创建表了
*/
public void addData(){
try {
//根据配置信息获取操作数据的db对象
DbManager db = x.getDb(daoConfig);
List<Student> list = new ArrayList<Student>();
for (int i = 0; i < 10; i++) {
Student stu = new Student();
stu.setAge(10+i);
stu.setName("学生"+i);
stu.setSex(i % 2 == 0? "男":"女");
list.add(stu);
//db.save(stu);//插入一条数据
}
db.save(list);//保存实体类或实体类的List到数据库
//db.replace(list);保存或更新实体类或实体类的List到数据库, 根据id和其他唯一索引判断数据是否存在
//db.saveOrUpdate(list);保存或更新实体类或实体类的List到数据库, 根据id对应的数据是否存在.
//db.saveBindingId(list);保存实体类或实体类的List到数据库,如果该类型的id是自动生成的, 则保存完后会给id赋值.
/**
* 1.如果在你建表的时候你的主键设置成自增长，那么你在插入数据的时候直接调replace方法就可以了，
*   但是saveOrUpdate只能达到插入的效果，达不到更新原有数据的效果.
* 2.如果在你建表的时候你的主键设置成不是自增长，replace方法当然可以插入，saveOrUpdate方法既可以插入也可以达到更新的效果
*/
} catch (DbException e) {
e.printStackTrace();
}
}

/**
* 查询数据
*/
public void onQuertyData(){
try {
DbManager db = x.getDb(daoConfig);
Student student = db.findById(Student.class, 2);//根据主键来查找student表里的数据
Student first = db.findFirst(Student.class);//返回当前表的第一条数据
Log.i("tag", "第一条数据:"+first);
//查询所有数据
List<Student> all = db.findAll(Student.class);
Log.i("tag", "所有数据:"+all.toString());
//按条件查找,查询年龄大于15的
List<DbModel> dbModelAll = db.findDbModelAll(new SqlInfo("select * from student where age > 15"));
for (int i = 0; i < dbModelAll.size() ; i++) {
String name = dbModelAll.get(i).getString("name");
String age = dbModelAll.get(i).getString("age");
String sex = dbModelAll.get(i).getString("sex");
Log.i("tag", "查询的数据: name="+name+",age="+age+",sex="+sex);
}
//第二种条件查找
List<Student> all1 = db.selector(Student.class).where("age", ">", 14).and("age", "<", 16).findAll();
//第三种
List<Student> all2 = db.selector(Student.class).expr("age>14 and age<17").findAll();
Log.i("tag", "第二种:"+all1.toString());
} catch (DbException e) {
e.printStackTrace();
}
}

/**
* 更新数据
*/
public void onUPdataData(){
try {
DbManager db = x.getDb(daoConfig);
//先找到要更新的数据,再设置值,然后更新,当然你也可以使用上面查询数据的方式
Student stu3 = db.findById(Student.class, 3);//找到主键为3的值
stu3.setAge(50);
db.update(stu3,"age");//更新stu3列名为age的数据
} catch (DbException e) {
e.printStackTrace();
}
}

/**
* 删除数据
*/
public void deleteData(){
try {
//第一种,根据主键来删除
DbManager db = x.getDb(daoConfig);
db.deleteById(Student.class,5);//删除主键为5的值

//第二种方法,找到符合条件的第一条数据  .findAll()就是找所有符合条件的了
Student student = db.selector(Student.class).where("name", "=", "学生11").findFirst();
db.delete(student);//先找到,再删除 ,需要判断为不为空

//第三种,删除那name=学生9 且 sex=女 的数据
db.delete(Student.class, WhereBuilder.b("name","=" ,"学生9").and("sex","=","女"));

//第四种,删除所有数据,但是表还在
db.delete(Student.class);

//db.dropTable(Student.class);删除表
//db.dropDb();删除数据库

} catch (DbException e) {
e.printStackTrace();
}
}

/**
* 初始化获取数据库的配置信息
*/
public void initDaoConfig(){
daoConfig = new DbManager.DaoConfig()
.setDbName("my.db")  //设置数据库名称
.setDbVersion(1)  //设置数据库版本
.setDbDir(getCacheDir().getAbsoluteFile()) //设置数据库保存的路径
.setAllowTransaction(true) //设置允许开启事务
.setDbUpgradeListener(new DbManager.DbUpgradeListener() {
@Override
public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
//db.addColumn("表名","需要增加的列名");数据库更新监听
}
})
.setDbOpenListener(new DbManager.DbOpenListener() {
@Override
public void onDbOpened(DbManager db) {
//开启WAL.对写入加速提示很大
db.getDatabase().enableWriteAheadLogging();
}
})
.setTableCreateListener(new DbManager.TableCreateListener() {
@Override
public void onTableCreated(DbManager db, TableEntity<?> table) {
Log.i("tag", "onTableCreated: 创建了表:"+table.getName());
}
});
}

}

Xutils3的Get与Post请求:

/**
* Get请求,可以直接在主线程中调用该方法
*/
public void xUtils3Get(String url){
//设置网络请求的参数
RequestParams params = new RequestParams(url);
//使用的普通回调
Callback.Cancelable cancelable = x.http().get(params, new Callback.CommonCallback<String>() {
@Override
public void onSuccess(String result) {
Log.i("tag", "请求成功: "+result);
}

@Override
public void onError(Throwable ex, boolean isOnCallback) {
Log.i("tag", "请求异常");
}

@Override
public void onCancelled(CancelledException cex) {
Log.i("tag", "取消请求的回调方法");
}

@Override
public void onFinished() {
Log.i("tag", "请求完成,并不一定是请求成功,断开了连接就会执行该方法");
}
});
//cancelable.cancel();取消请求
}

/**
* Post请求,可以直接在主线程中调用该方法
*/
public void xUtils3Post(String url){
//设置网络请求的参数,以及post的字段
RequestParams params = new RequestParams("http://mrobot.pcauto.com.cn/v2/cms/channels/1?");
//post提交的字段：pageNo=1&pageSize=20&serialIds=2143,3404&v=4.0.0
params.addBodyParameter("pageNo","1");
params.addBodyParameter("pageSize","20");
params.addBodyParameter("serialIds","2143,3404");
params.addBodyParameter("v","4.0.0");
//使用的普通回调
Callback.Cancelable cancelable = x.http().post(params, new Callback.CommonCallback<String>() {
@Override
public void onSuccess(String result) {
Log.i("tag", "请求成功: "+result);
}

@Override
public void onError(Throwable ex, boolean isOnCallback) {
Log.i("tag", "请求异常");
}

@Override
public void onCancelled(CancelledException cex) {
Log.i("tag", "取消请求的回调方法");
}

@Override
public void onFinished() {
Log.i("tag", "请求完成,并不一定是请求成功,断开了连接就会执行该方法");
}
});
//cancelable.cancel();取消请求
}

使用Xutils3实现断点下载:

import android.app.ProgressDialog;
im
f7e4
port android.content.DialogInterface;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;

import org.xutils.common.Callback;
import org.xutils.common.task.PriorityExecutor;
import org.xutils.http.RequestParams;
import org.xutils.view.annotation.ContentView;
import org.xutils.view.annotation.Event;
import org.xutils.x;

import java.io.File;

/**
* XUtils3实现断点下载
*/
@ContentView(R.layout.activity_main) //加载的xml文件
public class MainActivity extends AppCompatActivity {

/**
* 可取消的任务
*/
private Callback.Cancelable cancelable;
/**
* 进度条对话框
*/
private ProgressDialog progressDialog;

private String pathApk = "http://down.72g.com/upload/app/201407/201407150923238621.apk";

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//setContentView(R.layout.activity_main);
x.view().inject(this);//绑定注解
initProgressDialog();
}

@Event(R.id.download)
private void btnOnClick(View view){
//设置请求参数
RequestParams params = new RequestParams(pathApk);
params.setAutoResume(true);//设置是否在下载是自动断点续传
params.setAutoRename(false);//设置是否根据头信息自动命名文件
params.setSaveFilePath("/sdcard/xutils/xUtils_1.avi");
params.setExecutor(new PriorityExecutor(2, true));//自定义线程池,有效的值范围[1, 3], 设置为3时, 可能阻塞图片加载.
params.setCancelFast(true);//是否可以被立即停止.
//下面的回调都是在主线程中运行的,这里设置的带进度的回调
cancelable = x.http().get(params, new Callback.ProgressCallback<File>() {
@Override
public void onCancelled(CancelledException arg0) {
Log.i("tag", "取消"+Thread.currentThread().getName());
}

@Override
public void onError(Throwable arg0, boolean arg1) {
Log.i("tag", "onError: 失败"+Thread.currentThread().getName());
progressDialog.dismiss();
}

@Override
public void onFinished() {
Log.i("tag", "完成,每次取消下载也会执行该方法"+Thread.currentThread().getName());
progressDialog.dismiss();
}

@Override
public void onSuccess(File arg0) {
Log.i("tag", "下载成功的时候执行"+Thread.currentThread().getName());
}

@Override
public void onLoading(long total, long current, boolean isDownloading) {
if (isDownloading) {
progressDialog.setProgress((int) (current*100/total));
Log.i("tag", "下载中,会不断的进行回调:"+Thread.currentThread().getName());
}
}

@Override
public void onStarted() {
Log.i("tag", "开始下载的时候执行"+Thread.currentThread().getName());
progressDialog.show();
}

@Override
public void onWaiting() {
Log.i("tag", "等待,在onStarted方法之前执行"+Thread.currentThread().getName());
}

});
}

/*初始化对话框*/
private void initProgressDialog() {
//创建进度条对话框
progressDialog = new ProgressDialog(this);
//设置标题
progressDialog.setTitle("下载文件");
//设置信息
progressDialog.setMessage("玩命下载中...");
//设置显示的格式
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
//设置按钮
progressDialog.setButton(ProgressDialog.BUTTON_NEGATIVE, "暂停",new DialogInterface.OnClickListener(){
@Override
public void onClick(DialogInterface dialog, int which) {
//点击取消正在下载的操作
cancelable.cancel();
}});
}

}

效果图:



 一些其他请求方式:

//使用缓存下载
@Event(R.id.btn)
private void btnOnClick(View view){
//设置网络请求的参数
RequestParams params = new RequestParams("http://m2.qiushibaike.com/article/list/latest?page=1");
params.setCacheMaxAge(1000 * 15);//设置缓存的时间
//使用带缓存的回调
Callback.Cancelable cancelable = x.http().get(params, new Callback.CacheCallback<String>(){

@Override
public void onSuccess(String result) {
Log.i("tag", "请求成功: "+result);
}

@Override
public void onError(Throwable ex, boolean isOnCallback) {

}

@Override
public void onCancelled(CancelledException cex) {

}

@Override
public void onFinished() {

}

@Override
public boolean onCache(String result) {
//在setCacheMaxAge设置范围（上面设置的是15秒）内，如果再次调用GET请求，
//返回true：缓存内容被返回，相信本地缓存，返回false：缓存内容被返回，不相信本地缓存，仍然会请求网络
Log.i("tag","缓存的："+result);
return true;
}
});
//cancelable.cancel();取消请求
}

/**
* 上传文件
*/
private void upload(View v){
String path="/mnt/sdcard/Download/icon.jpg";
RequestParams params = new RequestParams("地址");
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() {
}
});
}

使用XUtils3缓存bitmap图片:

//对图片的操作
public void operationImg(String url){
//设置下载的图片参数
ImageOptions.Builder builder = new ImageOptions.Builder();
builder.setFadeIn(true);//设置为淡入效果
//builder.setCircular(true);//设置图片显示为圆形
builder.setSquare(true);//设置图片显示为正方形
builder.setCrop(true);//如果ImageView的大小不是定义为wrap_content, 不要crop.
builder.setSize(200,200);//设置图片的大小
builder.setImageScaleType(ImageView.ScaleType.CENTER_CROP);//设置图片的缩放模式
//builder.setFailureDrawableId();设置加载图片失败的图片
//builder.setLoadingDrawableId();设置加载中的图片
//builder.setPlaceholderScaleType(ImageView.ScaleType.MATRIX);加载中或错误图片的ScaleType
//builder.setIgnoreGif(true);设置为忽略Gif图片
//builder.setParamsBuilder();设置参数,包括线程池,缓存文件名的设置,大小的设置,等等
builder.setRadius(50);//设置拐角的弧度(四个角的弧度)
builder.setUseMemCache(false);//设置使用缓存(优先sd卡),默认为true
ImageOptions options = builder.build();

//x.image().clearCacheFiles();清除磁盘缓存的文件夹
//x.image().clearMemCache();清除内部缓存
//加载本地图片
//x.image().bind(imageView, new File("/sdcard/test.gif").toURI().toString(), options);
//x.image().bind(imageView, "/sdcard/test.gif", options);
//x.image().bind(imageView, "file:///sdcard/test.gif", options);

//加载网络图片
//x.image().bind(imageView,url);
x.image().bind(imageView,url,options);
/* x.image().bind(imageView, url, options, new Callback.CacheCallback<Drawable>() {
@Override
public boolean onCache(Drawable result) {
return false;
}

@Override
public void onSuccess(Drawable result) {
}

@Override
public void onError(Throwable ex, boolean isOnCallback) {
}

@Override
public void onCancelled(CancelledException cex) {
}

@Override
public void onFinished() {
}
});*/
}

 

关于缓存的一些参数:

/* // 扩展参数
关于缓存的信息在 :ImageLoader类中
private final static String DISK_CACHE_DIR_NAME = "xUtils_img";  //SD卡的缓存名
private final static Executor EXECUTOR = new PriorityExecutor(10, false);//默认线程数
private final static int MEM_CACHE_MIN_SIZE = 1024 * 1024 * 4; // 4M  内存缓存最小为4兆  可以自己设置

private static final int LIMIT_COUNT = 5000; // 限制最多5000条数据
private static final long LIMIT_SIZE = 1024L * 1024L * 100L; // 限制最多100M文件

private Proxy proxy; // 代理
private boolean useCookie = true; // 是否在请求过程中启用cookie
private String cacheDirName; // 缓存文件夹名称
private long cacheSize; // 缓存文件夹大小
private long cacheMaxAge; // 默认缓存存活时间, 单位:毫秒.(如果服务没有返回有效的max-age或Expires)
private Executor executor; // 自定义线程池
private Priority priority = Priority.DEFAULT; // 请求优先级
private int connectTimeout = 1000 * 15; // 连接超时时间
private boolean autoResume = true; // 是否在下载是自动断点续传
private boolean autoRename = false; // 是否根据头信息自动命名文件
private int maxRetryCount = 2; // 最大请求错误重试次数
private String saveFilePath; // 下载文件时文件保存的路径和文件名
private boolean cancelFast = false; // 是否可以被立即停止, true: 为请求创建新的线程, 取消时请求线程被立即中断.
private int loadingUpdateMaxTimeSpan = 300; // 进度刷新最大间隔时间(ms)
private HttpRetryHandler httpRetryHandler; // 自定义HttpRetryHandler
private RedirectHandler redirectHandler; // 自定义重定向接口, 默认系统自动重定向.
private RequestTracker requestTracker; // 自定义日志记录接口.*/
//设置参数的使用
builder.setParamsBuilder(new ImageOptions.ParamsBuilder(){
@Override
public RequestParams buildParams(RequestParams params, ImageOptions options) {
params.setCacheDirName("mySDCache");//设置sd卡上的缓存文件名,默认为xUtils_img
long cacheSize = params.getCacheSize();
Log.i("tag", "缓存大小:"+cacheSize/1024);
return params;
}
});
builder.setUseMemCache(true);//设置使用缓存(优先sd卡),默认为true
options = builder.build();

文章转自：https://www.cnblogs.com/tangs/articles/5920643.html