专栏首页世界第一语言是javaAndroid全能开源项目xUtils3开发教程、简单封装

Android全能开源项目xUtils3开发教程、简单封装

Android全能开源项目xUtils3开发教程、简单封装

一、简介

xUtils是一个比较全能的开源项目了, 包含了orm, http(s), image, view注解, 但依然很轻量级(246K), 并且特性强大, 方便扩展。这是xUtils3 的 github地址https://github.com/wyouflf/xUtils3

xUtils3 的一些特性

  • xUtils支持超大文件(超过2G)上传,更全面的http请求协议支持(11种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响;
  • xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本: (1)HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略; (2)支持标准的Cookie策略, 区分domain, path; (3)事件注解去除不常用的功能, 提高性能; (4)数据库api简化提高性能, 达到和greenDao一致的性能; (5)图片绑定支持gif(受系统兼容性影响, 部分gif文件只能静态显示), webp; 支持圆角, 圆形, 方形等裁剪, 支持自动旋转。

二、环境搭建

在build.gradle中加入如下依赖,编写文章时,最新版本为3.5.0,可以到github或者maven仓库查询最新版本。

//gradle4.4之前
compile 'org.xutils:xutils:3.5.0'
//gradle4.4之后
implementation 'org.xutils:xutils:3.5.0'

需要的权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

配置

public class TRApplicaction extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        x.Ext.init(this);
        x.Ext.setDebug(BuildConfig.DEBUG); // 是否输出debug日志, 开启debug会影响性能.
    }
}

在AndroidManifest文件中注册TRApplicaction

 <application
        android:name=".TRApplicaction"
        .../>
 </application>       

三、注解模块的使用

xUtils3自动注入注解 @ViewInject 真的是很好用,这样就不用一个个findById去注入组件了。

  • Activity中注解的使用
@ContentView(R.layout.activity_main)
public class MainActivity extends AppCompatActivity {
    cc(R.id.viewpager)
    ViewPager viewPager;  //自动注入,不需要findById了
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //setContentView(R.layout.activity_main); //使用@ContentView注解就不需要了
        x.view().inject(MainActivity.this); //这里尽量吧类名加上
        ...
    }
}
  • Fragment中注解的使用
@ContentView(R.layout.fragment_home)
public class HomeFragment 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);
    }
}
  • 绑定事件
/**
 * 1. 方法必须私有限定,
 * 2. 方法参数形式必须和type对应的Listener接口一致.
 * 3. 注解参数value支持数组: value={id1, id2, id3}
 * 4. 其它参数说明见{@link org.xutils.event.annotation.Event}类的说明.
 **/
@Event({R.id.new_model_btn,...})
private void onClick(View v){
    ....
}

四、网络请求

由于Android6.0版本之后将HttpClient替换为UrlConnection,所以修改老项目的时候一定要注意。 这里我们简单封装一下, 请求参数通过map传过来,然后通过回调返回请求结果。

/**
 * @author nelson
 */
public class c {
    private static  final String BASE_URL = "http://10.168.11.11/";
    
    public static void get(String url, Map<String, Object> parms, final GetDataCallback callback) {
        RequestParams params = new RequestParams(GetDataTask.BASE_URL + url);
        if(parms!=null){
            for (String key : parms.keySet()) {
                params.addParameter(key, parms.get(key));
            }
        }
        x.http().get(params, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                callback.success(result);
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                callback.failed();
            }
            @Override
            public void onCancelled(CancelledException cex) {}
            @Override
            public void onFinished() {}
        });
    }

    public static void post(String url, Map<String, Object> parms, final GetDataCallback callback) {
        RequestParams params = new RequestParams(GetDataTask.BASE_URL + url);
        if(parms!=null){
            for (String key : parms.keySet()) {
                params.addParameter(key, parms.get(key));
            }
        }
        x.http().post(params, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                if(callback!=null){
                    callback.success(result);
                }
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                if(callback!=null){
                    callback.failed();
                }
            }
            @Override
            public void onCancelled(CancelledException cex) {}
            @Override
            public void onFinished() {}
        });
    }
    /**上传文件*/
    public static void uplodFile(List<String> path, Map<String, Object> map, final GetDataCallback callback) {
        RequestParams params = new RequestParams(GetDataTask.BASE_URL+"upload");
        params.setMultipart(true);
        for (String key : map.keySet()) {
            params.addBodyParameter(key, map.get(key).toString());
        }
        for (int i = 0; i < path.size(); i++) {
            params.addBodyParameter("uploadfile" + i, new File(path.get(i)));
        }
        x.http().post(params, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                callback.success(result);
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                callback.failed();
            }
            @Override
            public void onCancelled(CancelledException cex) {}
            @Override
            public void onFinished() {}
        });
    }
    /**回调接口*/
    public interface GetDataCallback {
        void success(String result);
        void failed(String... args);
    }
}

发起网络请求

Map<String,Object> map = new HashMap<>();
map.put("pageNumber",page);
map.put("typeid",typeid);
//如果请求不需要参数,传null
// GetDataTask.post("app/types", null, new GetDataTask.GetDataCallback(){}
GetDataTask.post("app/types", map, new GetDataTask.GetDataCallback() {
   @Override
   public void success(String response) {
       Gson gson = new Gson(); //后台返回来的json格式,其他格式自己处理
       Result result = gson.fromJson(response, Result.class);
   }
   @Override
   public void failed(String... args) {
   }
});

五、绑定图片

//通过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) //设置拐角弧度
    .setUseMemCache(true) //设置使用MemCache,默认true

x.image().bind(imageView, url, imageOptions);
// assets file
x.image().bind(imageView, "assets://test.gif", imageOptions);
// local file
x.image().bind(imageView, new File("/sdcard/test.gif").toURI().toString(), imageOptions);
x.image().bind(imageView, "/sdcard/test.gif", imageOptions);
x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);
x.image().bind(imageView, "file:/sdcard/test.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, 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().loadDrawable(url, imageOptions, new Callback.CommonCallback<Drawable>() {...});
// 用来获取缓存文件
x.image().loadFile(url, imageOptions, new Callback.CommonCallback<File>() {...});

六、异步执行任务

x.task().run(new Runnable() {
    @Override
    public void run() {
        //异步任务
    }
});
x.task().post(new Runnable() { 
    @Override
    public void run() {
        //同步代码
    }
});

七、ORM 数据库操作

Application中进行初始化配置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());
            }
        });

操作数据库

// User类在最底下
DbManager db = x.getDb(daoConfig);
db.dropDb(); // 删除数据库
db.dropTable(User.class); // 删除表
db.save(new User("nelson")); //新增数据
db.delete(User.class); //mtb_user表中数据将被全部删除
//条件删除:
WhereBuilder b = WhereBuilder.b();
b.and("id",">",2); //构造修改的条件
b.and("id","<",4);
db.delete(User.class, b);

修改数据

//第一种写法:
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);

条件查询

Parent test = db.selector(Parent.class).where("id", "in", new int[]{1, 3, 6}).findFirst();
long count = db.selector(Parent.class).where("name", "LIKE", "w%").and("age", ">", 32).count();
List<Parent> testList = db.selector(Parent.class).where("id", "between", new String[]{"1", "5"}).findAll();
@Table(name = "mtb_user",onCreated = "")
public class User {
    /**
     * name = "id":数据库表中的一个字段
     * isId = true:是否是主键
     * autoGen = true:是否自动增长
     * property = "NOT NULL":添加约束
     */
    @Column(name = "id",isId = true,autoGen = true,property = "NOT NULL")
    private int id;
    @Column(name = "username")
    private String username;
    ......
}

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • android点击全屏预览照片第三方库使用

    移动端我们经常会遇到放大预览照片,如果是一张照片,那就全屏展示图片就好了,但是如果是一个列表,滑动查看,我们一般会借助viewpager进行实现,但是每次自己弄...

    用户2235302
  • 网站调用支付宝进行支付-Java后台调用支付宝支付

    用户2235302
  • 微信扫码支付、网站接入微信支付-java

    用户2235302
  • Android利用Andserver搭建服务器的详细教程

      在手机上有一个功能,但是需要使用电脑控制什么时候开始这个功能,然后上网搜索,找到了AndServer可以满足要求,我只是实现了简单的功能,如果感兴趣的话,可...

    砸漏
  • 再忆RxJava---线程切换

    RxJava已经陆陆续续看了将近两年多了,觉得很有必要重新认识一下。而且最新github上都出了3.0了。重新看一下,一来作为回顾,二来也算是学习一下3.0 ...

    提莫队长
  • Android全能开源项目xUtils3开发教程、简单封装

    码农笔录
  • tomcat源码解读三(1) tomcat的jmx管理

        JMX即Java 管理扩展(Java Management Extensions,JMX)用来管理检测 Java 程序(同时 JMX 也在 J2EE 1...

    cfs
  • P1-Android基于MVP实现号码归属地查询

    张风捷特烈
  • Android中网络框架简单封装的实例方法

    Android作为一款主要应用在移动终端的操作系统,访问网络是必不可少的功能。访问网络,最基本的接口有:HttpUrlConnection,HttpClient...

    砸漏
  • 设计模式之设计原则

    单一职责原则:类的职责单一,不能将太多的职责放在一个类中,该原则是实现高内聚、低耦合的指导方针

    路行的亚洲

扫码关注云+社区

领取腾讯云代金券