自强不息    厚德载物

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的按钮被按下");

    }

效果如下