xutils3 断点续传介绍

转自：http://www.cnblogs.com/tangs/articles/5920643.html

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

• xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:
  1. HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略.
  2. 支持标准的Cookie策略, 区分domain, path...
  3. 事件注解去除不常用的功能, 提高性能.
  4. 数据库api简化提高性能, 达到和greenDao一致的性能.
  5. 图片绑定支持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/ )

1. 下载aar文件并使用然后用zip解压, 取出jar包和so文件.  aar文件在上面给的github网站里有说到
   
2. 将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;import 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();