xutils3简单使用方法
一、对于xutils3框架用的比较多使用方面功能也比较全面，xUtils3主要包含，网络模块、图片模块和数据库模块，最后源码附上仅供参考
1、在Acticty中的使用
public class Activity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
x.view().inject(this);
}
2、Xutils3网络模块中，xUtils3网络模块在实际开发中方便了开发者的使用，xUtils3网络模块大约包含GET请求、POST请求、其他请求方式、上传、下载文件、使用缓存等许多的功能
（1）get请求方式
RequestParams params = new RequestParams(url);
params.addQueryStringParameter("user","ABC");
params.addQueryStringParameter("password","666666");//请求参数
x.http().get(params, new Callback.CommonCallback() {
@Override
public void onSuccess(String result) {
//解析result，返回请求的data
}
//出现异常后会执行下面的方法
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
//取消的回调方法
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
}); 3、get请求，接收数据缓存
//get请求，缓存
RequestParams params = new RequestParams(url);
params.addQueryStringParameter("user","abc");
params.addQueryStringParameter("password","666666");
params.setCacheMaxAge(1000 * 60);// 默认缓存存活时间, 单位:毫秒
x.http().get(params, new Callback.CacheCallback() {
private boolean hasError = false;
private String result = null;
@Override
public boolean onCache(String result) { //得到缓存数据, 缓存过期后不会进入
this.result = result;
return true; //true: 信任缓存数据, 不再发起网络请求; false不信任缓存数据
}
@Override
public void onSuccess(String result) {
//如果服务返回304或onCache选择了信任缓存,这时result为null
Log.i("JAVA", "开始请求");
if (result != null) {
this.result = result;
}
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
hasError = true;
Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();
if (ex instanceof HttpException) { //网络错误
HttpException httpEx = (HttpException) ex;
int responseCode = httpEx.getCode();
String responseMsg = httpEx.getMessage();
String errorResult = httpEx.getResult();
//...
} else { //其他错误
//...
}
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
if (!hasError && result != null) {
//成功获取数据
Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
}
}
});
4、post方式请求
RequestParams params = new RequestParams(“请求地址”);
params.addBodyParameter("user","abc");
params.addParameter("password","666666");
params.addHeader("head","android"); //请求头
x.http().post(params, new Callback.CommonCallback() {
@Override
public void onSuccess(String result) {
//解析返回result data
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
});
5、下面为其他的网络请求方式
//其他请求方式
RequestParams params = new RequestParams(“请求地址”);
params.addParameter("username","abc");请求参数
x.http().request(HttpMethod.PUT, params, new Callback.CommonCallback() {
@Override
public void onSuccess(String result) {
//解析返回result data
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
}); 6、文件进行上传
//文件上传
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() {
@Override
public void onSuccess(String result) {
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
}); 7、文件进行下载（以APK为实例）
//文件下载
url = "http://192.168.0.0/server/apk123.apk";
RequestParams params = new RequestParams(url);
//自定义保存路径，Environment.getExternalStorageDirectory()：SD卡的根目录
params.setSaveFilePath(Environment.getExternalStorageDirectory()+"/myapp/");
//自动为文件命名
params.setAutoRename(true);
x.http().post(params, new Callback.ProgressCallback() {
@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);
}
}); 二、Xutils3图片模块,主要是加载图片的4个bind方法，loadDrawable与loadFIle用法和ImageOptions用法
1、xUtils3 ImageOptions用法
//xUtils3 ImageOptions
//通过ImageOptions.Builder().set方法设置图片的属性
ImageOptions imageOptions= 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) //设置拐角弧度
2、xUtils3 bind方法
x.image().bind(imageView, "assets://test1.gif", imageOptions);
x.image().bind(imageView, new File("/sdcard/test1.gif").toURI().toString(), imageOptions);
x.image().bind(imageView, "/sdcard/test1.gif", imageOptions);
x.image().bind(imageView, "file:///sdcard/test1.gif", imageOptions);
x.image().bind(imageView, "file:/sdcard/test1.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback() {
@Override
public void onSuccess(Drawable result) {
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
3、xUtils3 loadDrawable方法
x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback() {
@Override
public void onSuccess(Drawable result) {
imageView.setImageDrawable(result);
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
}); 4、xUtils3 loadFile方法
x.image().loadFile(url,imageOptions,new Callback.CacheCallback(){
@Override
public boolean onCache(File result) {
//在这里可以做图片另存为等操作
Log.i("ABC","file："+result.getPath()+result.getName());
return true; //相信本地缓存返回true
}
@Override
public void onSuccess(File result) {
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
}
@Override
public void onCancelled(CancelledException cex) {
}
@Override
public void onFinished() {
}
}); 三、Xutils3数据库的使用
1、创建数据库实体类
/**
* 初始化DaoConfig配置
*/
DbManager.DaoConfig daoConfig = new DbManager.DaoConfig()
//设置数据库名，默认xutils.db
.setDbName("myapp.db")
//设置数据库路径，默认存储在app的私有目录
.setDbDir(new File("/mnt/sdcard/"))
//设置数据库的版本号
.setDbVersion(2)
//设置数据库打开的监听
.setDbOpenListener(new DbManager.DbOpenListener() {
@Override
public void onDbOpened(DbManager db) {
//开启数据库支持多线程操作，提升性能，对写入加速提升巨大
db.getDatabase().enableWriteAheadLogging();
}
})
//设置数据库更新的监听
.setDbUpgradeListener(new DbManager.DbUpgradeListener() {
@Override
public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
}
})
//设置表创建的监听
.setTableCreateListener(new DbManager.TableCreateListener() {
@Override
public void onTableCreated(DbManager db, TableEntity table){
Log.i("JAVA", "onTableCreated：" + table.getName());
}
});
//设置是否允许事务，默认true
//.setAllowTransaction(true)
DbManager db = x.getDb(daoConfig);
2、然后创建数据库表ChildInfo的实体类
/**
* 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+'\''+'}';
}
}
3、创建数据库
ArrayList childInfos = new ArrayList<>();
childInfos.add(new ChildInfo("熊大"));
childInfos.add(new ChildInfo("熊二"));
childInfos.add(new ChildInfo("光头强"));
childInfos.add(new ChildInfo("李老板"));
childInfos.add(new ChildInfo("涂涂"));
childInfos.add(new ChildInfo(“文宇”));
//db.save()方法不仅可以插入单个对象，还能插入集合
4、删除表数据
db.delete(ChildInfo.class); //child_info表中数据将被全部删除
//第二种写法，添加删除条件：
WhereBuilder b = WhereBuilder.b();
b.and("id",">",2); //构造修改的条件
b.and("id","<",4);
db.delete(ChildInfo.class, b);
5、修改表中数据
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);
6、查询数据（查询第一条数据）
ChildInfo first = db.findFirst(ChildInfo.class);
Log.i("JAVA",first.toString());
//添加查询条件进行查询
List all = db.selector(ChildInfo.class).where("id",">",2).and("id","<",4).findAll();
for(ChildInfo childInfo :all){
Log.i("JAVA",childInfo.toString());
这是部分Xutils3框架中的功能使用
四、Demo下载