xutils3的简单介绍

Sun‘刺眼的博客 Sun‘刺眼的博客     2022-08-09     705

关键词:

xUtils3的简介

xUtils是基于Afinal开发的目前功能比较完善的一个Android开源框架,最近又发布了xUtil3.0,在增加新功能的同时又提高了框架的性能。

1.xUtils包含了很多实用的android工具; xUtils支持超大文件(超过2G)上传,更全面的http请求协议支持(11种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响;
2.Utils 最低兼容Android 4.0 (api level 14);
3.xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:

  • HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略;

  • 支持标准的Cookie策略, 区分domain, path;

  • 事件注解去除不常用的功能, 提高性能;

  • 数据库api简化提高性能, 达到和greenDao一致的性能;

  • 图片绑定支持gif(受系统兼容性影响, 部分gif文件只能静态显示), webp;

  • 支持圆角, 圆形, 方形等裁剪, 支持自动旋转。

使用前的配置

1.使用Gradle构建时添加依赖即可:

compile ‘org.xutils:xutils:3.3.36‘

2.如果使用eclipse可以下载aar文件,然后用ZIP解压,取出jar包和so文件。
3.混淆配置参考示例项目sample的配置。
4.常见问题:

需要的权限


初始化

// 在application的onCreate中初始化
/**
* 初始化xUtils3
*/
public class MyApp extends Application {
 
    @Override
    public void onCreate() {
        super.onCreate();
        //对xUtils进行初始化
        x.Ext.init(this);
        //是否是开发、调试模式
        x.Ext.setDebug(BuildConfig.DEBUG);//是否输出debug日志,开启debug会影响性能
 
    }
}

在Manifest文件中注册MyApp

 

使用@Event事件注解(@ContentView,@ViewInject等)

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;
}

xUtils3网络模块的使用

xUtils3网络模块大大方便了在实际开发中网络模块的开发,xUtils3网络模块大致包括GET请求、POST请求、如何使用其他请求方式、上传文件、下载文件、使用缓存等功能。
1.GET请求

String url = "http://www.baidu.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() {
        @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.baidu.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() {
        @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.baidu.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() {
        @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.baidu.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() {
        @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.下载文件

String url = "http://www.baidu.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() {
        @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.baidu.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() {
        @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;
        }
    });
}

xUtils图片模块的使用

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() {
        @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() {
        @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() {
        @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(){
        @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() {
        }
    });
}

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 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 all = db.selector(ChildInfo.class).where(b).findAll();//findAll():查询所有结果
    for(ChildInfo childInfo :all){
        Log.i("JAVA",childInfo.toString());
    }
    //第二种写法:
    List 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);
}
   

xutils3框架的基本使用方法(代码片段)

...p://blog.csdn.NET/a1002450926/article/details/50341173今天给大家带来XUtils3的基本介绍,本文章的案例都是基于XUtils3的API语法进行的演示。相信大家对这个框架也都了解过,下面简单介绍下XUtils3的一些基本知识。XUtils3一共有4大功能... 查看详情

xutils3框架使用

目前Android开发很火的一个框架Xutils框架。它有四个模块:1、ViewUtils。2、HttpUtils。3、DbUtils。4、BitmapUtils。记得是去年的差不多这个时候,我的大学老师张老师介绍我去学习Xutils框架,当时项目有很多对数据库的操作,所以刚学... 查看详情

xutils3框架的基本用法

...p://blog.csdn.net/a1002450926/article/details/50341173今天给大家带来XUtils3的基本介绍。本文章的案例都是基于XUtils3的API语法进行的演示。相信大家对这个框架也都了解过,以下简介下XUtils3的一些基本知识。XUtils3一共同拥有4大功能:注解... 查看详情

xutils3

1.简介xUtils3是 xUtils的升级版,功能和性能都在提高,xUtils3主要有四大模块:注解模块,联网模块,图片加载模块,数据库模块;注解模块:用于在Activity 或者Fragment 中初始化布局文件,便于代码更加简洁;联网模块... 查看详情

进展xutils3框架的使用

刚刚SLP迎来了一个飞跃——成功地使用XUtils3框架从LL资源网站上拉取LIVE相关信息并显示成列表。效果如下:  查看详情

xutils3源码阅读之网络模块

关于xUtils3xUtils包含了很多实用的android工具.xUtils支持超大文件(超过2G)上传,更全面的http请求协议支持(11种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响…xUtils最低兼容Android4.0(apilevel14).(Android2.3?)xUtils3变化较... 查看详情

xutils3的使用

1.添加依赖:compile‘org.xutils:xutils:3.5.0‘2.清单文件中注册初始化 初始化:x.Ext.init(this);        x.Ext.setDebug(BuildConfig.DEBUG);//是否输出debug日志,开启debug会影响性能.//上线后参数设为fals 查看详情

使用xutils3中遇到的一些问题!!!!

1。当xml页面中有可见的,同时设置id的控件时,如果在Activity中没有使用注解进行反射该控件,app会crash,提示:  Causedby:java.lang.NullPointerException:Attempttoinvokevirtualmethod‘voidandroid.support.v4.view.ViewPager.setAdapter(androi 查看详情

xutils3-dbutils

Github源码地址:https://github.com/wyouflf/xUtils3下面是源码中sample关于Dbutils的使用代码:importandroid.view.View;importandroid.widget.TextView;importorg.xutils.DbManager;importorg.xutils.common.util.KeyValue;importorg 查看详情

xutils3基本使用(代码片段)

根目录下新建一个类继承application,调用xUtils3初始化方法publicclassAtguiguApplicationextendsApplication@OverridepublicvoidonCreate()super.onCreate();//xUtils3初始化x.Ext.init(this);//是否输出debug日志,开启debug会影响性能.x.Ext.setDeb 查看详情

xutils3文件上传下载getpost请求(代码片段)

@ContentView(R.layout.activity_xutils3_net)publicclassXUtils3NetActivityextendsActivity@ViewInject(R.id.tv_result)privateTextViewtextView;@ViewInject(R.id.progressbar)privateProgressBarprogressbar;@V 查看详情

手机影音第十三天,xutils3glide的使用获取网络图片;下拉上滑刷新;缓存网络资源

代码已经托管到码云上,感兴趣的小伙伴可以下载看看        https://git.oschina.net/joy_yuan/MobilePlayer本次的网络资源地址使用的是时光网的api接口,地址如下: http://api.m.mtime.cn/PageSubArea/TrailerList.api 查看详情

weka简单介绍与资源汇总

 简单介绍  Weka是一个开源的数据挖掘软件,里面集成了很多经典的机器学习算法,在高校和科研机构中受到了广泛的应用。具体的简单介绍和简单的使用请參考文档:《使用Weka进行数据挖掘》。学习资源:刚開始学习... 查看详情

https系列之一:https的简单介绍及ssl证书的生成

...SSL证书介绍及生成方法 CA证书介绍及申请二:https的简单介绍HTTPS(全称:HyperTextTransferProtocoloverSecureSocketLayer),是以安全为目标的HTTP通道,简单讲是HTTP的安全版。即HTTP下加入SSL层,HTTPS的安全基础是SSL(Secure 查看详情

javascript标签语句简单介绍

javascript标签语句简单介绍:由于对于标签语句的应用并不多,所以可能很多朋友都不是太了解,下面就对它做一下简单介绍,希望能够给需要的朋友带来一定的帮助。标签其实是一个标示符,关于表示符这里就不多介绍了,具体... 查看详情

javastring的简单介绍

一.String类的构造方法(先粗略介绍三种分别是s1,s2,s3)  二.String的常用判断方法   三.String类的常用获取方法  三.Sting的常用转换方法 四.String其他功能       查看详情

zookeeper简单介绍

转自:ZooKeeper学习第一期---Zookeeper简单介绍一、分布式协调技术在给大家介绍ZooKeeper之前先来给大家介绍一种技术——分布式协调技术。那么什么是分布式协调技术?那么我来告诉大家,其实分布式协调技术主要用来解决分布式... 查看详情

javascripthtmldom简单介绍

JavaScriptHTMLDOM通过HTMLDOM,可访问JavaScriptHTML文档的所有元素。HTMLDOM(文档对象模型)当网页被加载时,浏览器会创建页面的文档对象模型(DocumentObjectModel)。通过可编程的对象模型,JavaScript获得了足够的能力来创建动态的HTML。Java... 查看详情