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)在我们的项目中快速配置xUtils3xUtils3的配置十分的简单:
使用Gradle构建时添加一下依赖即可
compile 'org.xutils:xutils:3.5.0'
如果使用eclipse可以 点击这里下载aar文件, 然后用zip解压, 取出jar文件.
(3)使用前要添加权限
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
(4)初始化
// 在application的onCreate中初始化 @Override public void onCreate() { super.onCreate(); x.Ext.init(this); x.Ext.setDebug(BuildConfig.DEBUG); // 是否输出debug日志, 开启debug会影响性能. ... }
xUtils3主要包含注解模块、网络模块、图片模块和数据库模块,下面将做一一说明。
2.xUtils3注解模块的使用
(由于现在的主流android开发环境是android studio,而studio又有相应的插件,所以这部分功能是完全可以不用的)
xUtils3注解模块在实际开发中的使用如下:
(1)Activity的注解的使用如下:
@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); } }
(2)Fragment的注解的使用如下:
@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);
}
}
(3)为按钮设置点击事件
@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; }
说明:下面演示都将使用@Event事件注解。
3.xUtils3网络模块的使用
xUtils3网络模块大大方便了在实际开发中网络模块的开发,xUtils3网络模块大致包括GET请求、POST请求、如何使用其他请求方式、上传文件、下载文件、使用缓存等功能,下面将做一一说明:
(1)GET请求
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(); }
(2)POST请求
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() { } }); }
(3)其他网络请求方式
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() { } }); }
(4)上传文件
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() { } }); }
(5)下载文件
这里以下载apk为例进行说明,apk下载完成后,自动调用系统的安装方法。
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); } }); }
(6)使用缓存
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; } }); }
4.xUtils3图片模块的使用
xUtils3图片模块,重点在于加载图片的4个bind方法,loadDrawable与loadFIle用法和ImageOptions用法,需多加练习。
(1)首先获取ImageView控件
@ViewInject(R.id.image01) ImageView image01; @ViewInject(R.id.image02) ImageView image02; @ViewInject(R.id.image03) ImageView image03;
(2)得到网络图片地址
String[] urls = { "http://img.android.com/a.jpg", "http://img.android.com/b.jpg", "http://img.android.com/c.jpg" };(3)xUtils3显示图片方法setPic()如下:
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() { } }); }
4.xUtils3数据库模块的使用
(1)创建数据库和删除数据库
首先进行配置DaoConfig:
//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);
然后创建数据库表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 + '\'' + '}'; } }
之后就能进行创建和删除数据库的操作了:
//创建数据库 @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(); }
(2)删除表
//删除表 @Event(R.id.del_table) private void delTable (View v) throws DbException { db.dropTable(ChildInfo.class); }
(3)查询表中的数据
//查询表中的数据 @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()); } }
(4)修改表中的数据
//修改表中的一条数据 @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); }
(5)删除表中的数据
@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); }参考文章:https://github.com/wyouflf/xUtils3