Android开源库——xUtils框架

云无心鸟知还

已于 2022-10-19 19:40:17 修改

阅读量4.1k

点赞数

分类专栏：安卓文章标签： android 开源 java

于 2019-05-19 18:25:35 首次发布

本文链接：https://blog.csdn.net/nishigesb123/article/details/90344837

版权

安卓专栏收录该内容

98 篇文章 51 订阅

订阅专栏

xUtils框架

概述

主要是用于快速开发，相当于一个工具集？

终于有一个国人开发的了！！！

简介终于是中文的了，大部分介绍内容都是来自于项目地址上的介绍，可以跳过这部分

项目地址（旧版）：GitHub - qxbl/xUtils: android orm, bitmap, http, view inject...

项目地址（新版）：GitHub - wyouflf/xUtils3: Android orm, bitmap, http, view inject...

xUtils2.x介绍

xUtils 2.x对Android 6.0兼容不是很好, 请尽快升级至xUtils3.
xUtils 包含了很多实用的android工具。
xUtils 支持大文件上传，更全面的http请求协议支持(10种谓词)，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响...
xUitls 最低兼容android 2.2 (api level 8)

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的支持.

四大模块

DbUtils模块：
- android中的orm框架，一行代码就可以进行增删改查；
- 支持事务，默认关闭；
- 可通过注解自定义表名，列名，外键，唯一性约束，NOT NULL约束，CHECK约束等（需要混淆的时候请注解表名和列名）；
- 支持绑定外键，保存实体时外键关联实体自动保存或更新；
- 自动加载外键关联实体，支持延时加载；
- 支持链式表达查询，更直观的查询语义，参考下面的介绍或sample中的例子。
ViewUtils模块：
- android中的ioc框架，完全注解方式就可以进行UI，资源和事件绑定；
- 新的事件绑定方式，使用混淆工具混淆后仍可正常工作；
- 目前支持常用的20种事件绑定，参见ViewCommonEventListener类和包com.lidroid.xutils.view.annotation.event。
HttpUtils模块：
- 支持同步，异步方式的请求；
- 支持大文件上传，上传大文件不会oom；
- 支持GET，POST，PUT，MOVE，COPY，DELETE，HEAD，OPTIONS，TRACE，CONNECT请求；
- 下载支持301/302重定向，支持设置是否根据Content-Disposition重命名下载的文件；
- 返回文本内容的请求(默认只启用了GET请求)支持缓存，可设置默认过期时间和针对当前请求的过期时间。
BitmapUtils模块：
- 加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象；
- 支持加载网络图片和本地图片；
- 内存管理使用lru算法，更好的管理bitmap内存；
- 可配置线程加载线程数量，缓存大小，缓存路径，加载显示动画等...

案例

导入

导入的方式还是之前那几种

Android开源库——Universal Image Loader_旧日灯塔的博客-CSDN博客_universalimageloader

不过本文的案例都是基于2.x的案例，新版本的话读者可以自行去项目地址上学习如何使用

3.0已经可以通过Gradle构建（2.x真的不行吗？不清楚...反正介绍上没看到）

compile 'org.xutils:xutils:3.5.1'

新版As可能会提示用implementation替换compile，照做即可

权限

无论是哪个版本权限都是这两个

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

DbUtils模块

（数据库相关）

创建实体类User.java，生成构造方法，get、set、toString方法

package com.example.a5_18xutils;

public class User {
    private int id;
    private String name;
    private String email;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public User(String email, String name) {
        this.email = email;
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public User() {
    }

    @Override
    public String toString() {
        return "User{" +
                "email='" + email + '\'' +
                ", id=" + id +
                ", name='" + name + '\'' +
                '}';
    }
}

布局

既然是数据库操作，离不开增删改查，那就添加五个按钮绑定五个方法即可（查询两个，一个查询全部，一个条件查询）

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/add"
        android:onClick="add"
        android:text="增加"
        app:layout_constraintTop_toTopOf="parent"
        />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/delete"
        android:onClick="delete"
        android:text="删除"
        app:layout_constraintTop_toBottomOf="@+id/add"
        />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/update"
        android:onClick="update"
        android:text="修改"
        app:layout_constraintTop_toBottomOf="@+id/delete"
        />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/query"
        android:onClick="query"
        android:text="条件查询"
        app:layout_constraintTop_toBottomOf="@+id/update"
        />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/query_all"
        android:onClick="query_all"
        android:text="查询全部"
        app:layout_constraintTop_toBottomOf="@+id/query"
        />
</android.support.constraint.ConstraintLayout>

完整代码

package com.example.a5_18xutils;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Toast;

import com.lidroid.xutils.DbUtils;
import com.lidroid.xutils.db.sqlite.Selector;
import com.lidroid.xutils.db.sqlite.WhereBuilder;
import com.lidroid.xutils.exception.DbException;


import java.util.List;

public class MainActivity extends AppCompatActivity {
    DbUtils dbUtils;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //第二个参数为数据库名，是可以改的
        dbUtils = DbUtils.create(this, "mydb");
    }

    //增加
    public void add(View v) {
        User user = new User("test@qq.com", "被添加的姓名");
        try {
            dbUtils.save(user);
            Toast.makeText(this, "save success", Toast.LENGTH_SHORT).show();
            Log.i("tag", "save success");
        } catch (com.lidroid.xutils.exception.DbException e) {
            e.printStackTrace();
        }
    }

    //查询全部
    public void query_all(View v) {
        try {
            List<User> list = dbUtils.findAll(User.class);
            for (User u : list) {
                Log.i("tag", String.valueOf(u));
            }
        } catch (com.lidroid.xutils.exception.DbException e) {
            e.printStackTrace();
        }
    }

    //条件查找
    public void query(View view) {
        try {
            User user = dbUtils.findFirst(Selector.from(User.class).where("name", "=", "被添加的姓名"));
            Toast.makeText(this, user.toString(), Toast.LENGTH_SHORT).show();
            Log.i("tag", String.valueOf(user));
        } catch (com.lidroid.xutils.exception.DbException e) {
            e.printStackTrace();
        }
    }

    //修改
    public void update(View view) {
        User user = new User();
        user.setId(1);
        user.setEmail("test@qq.com");
        user.setName("添加的姓名被修改了");
        try {
            dbUtils.update(user, "email", "name");
            Toast.makeText(this, "更新成功", Toast.LENGTH_SHORT).show();
            
            Log.i("tag", "更新成功");
        } catch (com.lidroid.xutils.exception.DbException e) {
            e.printStackTrace();
        }
    }

    ///删除
    public void delete(View view) {
        try {
            dbUtils.delete(User.class, WhereBuilder.b("id", "=", "1"));
            Toast.makeText(this, "删除成功", Toast.LENGTH_SHORT).show();
            Log.i("tag", "删除成功");
        } catch (DbException e) {
            e.printStackTrace();
        }
    }
}

效果（以下测试为按顺序执行）

增加

条件查询

修改

查询全部（为了方便区分，在这个操作前再次点击了增加）

删除

查询全部

ViewUtils

用注解的形式对一些绑定的代码进行优化（只对于代码长短而言，实际性能可能反而还会有所降低）

首先是布局

我们加一个按钮和一个文本框

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/ViewUtils"
        android:text="ViewUtils"
        app:layout_constraintTop_toBottomOf="@+id/query_all"
        />
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/ViewUtils_text"
        android:text="ViewUtils的文本"
        android:gravity="center"
        app:layout_constraintTop_toBottomOf="@+id/ViewUtils"
        />

然后是代码部分

对于组件的绑定，主要是图示圈起来的两个部分

对于事件，类似的就可以绑定按钮，还可以用“，”隔开若干个id，即可同时绑定多个按钮

    @OnClick(R.id.ViewUtils)
    public void show(View view){
        textView .setText("ViewUtils的按钮被按下");
    }

效果如下

点击后

云无心鸟知还

关注

0
点赞
踩
10

收藏

觉得还不错? 一键收藏
打赏
1
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

专栏目录