xUtils3简介
xUtils 包含了orm, http(s), image, view注解, 但依然很轻量级(246K), 并且特性强大, 方便扩展:
- 稳定的基石: AbsTask和统一的回调接口Callback, 任何异常, 即使你的回调方法实现有异常都会进入onError, 任何情况下onFinished总会让你知道任务结束了.
- 基于高效稳定的orm工具, http模块得以更方便的实现cookie(支持domain, path, expiry等特性)和 缓存(支持Cache-Control, Last-Modified, ETag等特性)的支持.
- 有了强大的http及其下载缓存的支持, image模块的实现相当的简洁, 并且支持回收被view持有, 但被Mem Cache移除的图片, 减少页面回退时的闪烁.
- view注解模块仅仅400多行代码却灵活的支持了各种View注入和事件绑定, 包括拥有多了方法的listener的支持.
本文基于xUtils3实现从服务器下载文件(Apk)的功能,其中,xUtils3网络模块大大方便了在实际开发中网络模块的开发,xUtils3网络模块大致包括GET请求、POST请求、如何使用其他请求方式、上传文件、下载文件、使用缓存等功能,下面将对下载文件进行使用说明::
集成xUtils3,使用Gradle构建时添加一下依赖即可
compile 'org.xutils:xutils:3.5.0'
加入所需要的权限声明;
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />- 初始化创建建Application,并在AndroidManifest.xml文件中进行配置
public class MyMobileApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
x.Ext.init(this);
x.Ext.setDebug(BuildConfig.DEBUG); // 是否输出debug日志, 开启debug会影响性能.
}
}
AndroidManifest.xml文件中配置如下:
<application
android:name=".MyMobileApplication"
......
android:theme="@style/AppTheme">
<activity android:name=".activity.SplashActivity">
......
</activity>
</application>
- 下载功能的实现,这里以下载我们自己Tomcat上的Apk为例进行说明
/**
* 下载服务器端更新后最新的apk
*/
private void downloadUpdateApk() {
if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
mProgressDialog = new ProgressDialog(SplashActivity.this);
String path = Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator;
// mDownloadUrl为JSON从服务器端解析出来的下载地址
RequestParams requestParams = new RequestParams(mDownloadUrl);
// 为RequestParams设置文件下载后的保存路径
requestParams.setSaveFilePath(path);
// 下载完成后自动为文件命名
requestParams.setAutoRename(true);
x.http().get(requestParams, new Callback.ProgressCallback<File>() {
@Override
public void onSuccess(File result) {
Log.i(tag, "下载成功");
mProgressDialog.dismiss();
}
@Override
public void onError(Throwable ex, boolean isOnCallback) {
Log.i(tag, "下载失败");
mProgressDialog.dismiss();
}
@Override
public void onCancelled(CancelledException cex) {
Log.i(tag, "取消下载");
mProgressDialog.dismiss();
}
@Override
public void onFinished() {
Log.i(tag, "结束下载");
mProgressDialog.dismiss();
}
@Override
public void onWaiting() {
// 网络请求开始的时候调用
Log.i(tag, "等待下载");
}
@Override
public void onStarted() {
// 下载的时候不断回调的方法
Log.i(tag, "开始下载");
}
@Override
public void onLoading(long total, long current, boolean isDownloading) {
// 当前的下载进度和文件总大小
Log.i(tag, "正在下载中......");
mProgressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
mProgressDialog.setMessage("正在下载中......");
mProgressDialog.show();
mProgressDialog.setMax((int) total);
mProgressDialog.setProgress((int) current);
}
});
}
}
程序运行示例图如下:
参考文章: