每天学习一个Android中的常用框架——9.xUtils

浅浅的花香味﹌ 2023-03-13 05:15 0阅读 0赞

### 文章目录 ###

*  1. 简介
 *  2. 特性
 *  3. 演示
 *   *  3.1 集成
     *  3.2 配置
     *  3.3 注解模块
     *  3.4 网络模块
     *   *  3.4.1 GET请求
         *  3.4.2 POST请求
         *  3.4.3 使用缓存
         *  3.4.4 上传文件
         *  3.4.5 下载文件
     *  3.5 图片加载模块
     *  3.6 数据库模块
     *   *  3.6.1 创建数据库
         *  3.6.2 增加数据
         *  3.6.3 删除数据
         *  3.6.4 修改数据
         *  3.6.5 查询数据
 *  4. 源码地址

# 1. 简介 #

**xUtils**，是基于Afinal开发的目前功能比较完善的一个Android开源框架，GitHub官网为：[xUtils3][]。在介绍xUtils之前，我们可以简单看看Afinal的简介：

*  Afinal 是一个android的sqlite orm和 ioc 框架。同时封装了android中的http框架，使其更加简单易用；
 *  使用finalBitmap，无需考虑bitmap在android中加载的时候oom的问题和快速滑动的时候图片加载位置错位等问题。
 *  Afinal的宗旨是简洁，快速。约定大于配置的方式。尽量一行代码完成所有事情。

具有强大特性的Afinal，实现了四个主要的功能：**View注入**、**网络传输**、**数据库操作**、**图片加载**。然而，作者在搜索Afianl的相关资料时，发现了其中的一些问题。事实上，该框架的GitHub官网：[Afinal][]显示此框架最后更新的时间是五年前，也就是说**几乎不再维护了**，一些遗留问题可能还没有处理完全。在这种背景下，为了解决Afinal框架中出现的种种问题，**xUtils**应运而生。

最初学习xUtils时，作者使用的是较老版本的，那时候集成xUtils还需要导入jar包才行。但现在最新的**xUtils3**出现了，作为一个集成了大量工具方法的框架，无论是为了代码的简洁还是偷懒，我们都应该去认真地学习它。

# 2. 特性 #

xUtils 包含了orm, http(s), image, view注解, 但依然很轻量级(251K), 并且特性强大, 方便扩展：

1.  `orm`: **高效稳定的orm工具, 使得http接口实现时更方便的支持cookie和缓存**
    
     *  灵活的, 类似linq表达式的接口.
     *  和greenDao一致的性能.
2.  `http(s)`: **基于UrlConnection，Android4.4以后底层为okHttp实现**
    
     *  请求协议支持11种谓词：GET,POST,PUT,PATCH,HEAD,MOVE,COPY,DELETE,OPTIONS,TRACE,CONNECT
     *  支持超大文件(超过2G)上传
     *  支持断点下载(如果服务端支持Range参数,客户端自动处理断点下载)
     *  支持cookie(实现了domain, path, expiry等特性)
     *  支持缓存(实现了Cache-Control, Last-Modified, ETag等特性, 缓存内容过多时使用过期时间+LRU双重机制清理)
     *  支持异步和同步(可结合RxJava使用)调用
3.  `image`: **有了http(s)及其下载缓存的支持, image模块的实现相当的简洁**
    
     *  支持内存缓存, 磁盘缓存(缩略图和原图), 并且支持回收被view持有, 但被MemCache移除的图片, 减少页面回退时的闪烁.
     *  支持在ListView滑动时, 自动停止被回收复用的item对应的下载任务(再次下载时断点续传)
     *  支持webp, gif(部分比较老的系统只展示静态图)
     *  支持圆角, 圆形, 方形等裁剪, 支持自动旋转…
4.  `view注解`: **view注解模块仅仅400多行代码却灵活的支持了各种View注入和事件绑定**
    
     *  事件注解支持且不受混淆影响…(参考sample的混淆配置)
     *  支持绑定拥有多个方法的listener

总的来说，xUtils主要有4个模块：**注解模块，网络模块，图片加载模块，数据库模块**。包括我们之前学习过的ButterKnife和Dagger，xUtils算是我们接触的第三个具有**依赖注入**的框架了。

按照这个陈列出来的模块顺序，下面简单演示一下相应的功能代码。当然，如果想要了解关于xUtils更多的使用方法，在其GitHub官网上就有名为**sample**的样例工程，读者可以参考使用。

# 3. 演示 #

## 3.1 集成 ##

依旧去xUtils的GitHub官网上获取最新版本的依赖，然后添加到module下的build.gradle中，代码如下：

implementation 'org.xutils:xutils:3.8.8'

## 3.2 配置 ##

集成了xUtils后，为了方便演示，我们添加一些可能会用到的权限，修改Manifest.xml，代码如下：

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

同时，新建一个名为MyApplication的类，继承自Application，在其`onCreate()`方法中进行xUtils的初始化，代码如下：

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

最后，别放了在Manifest.xml中声明我们刚刚创建的MyApplication，即添加`android:name`属性，代码如下：

集成和配置完毕后，接下来，我们就开始逐一讲解xUtils中的四个模块：**注解模块，网络模块，图片加载模块，数据库模块**

## 3.3 注解模块 ##

该模块的功能类似于ButterKnife和Dagger，依旧是给相应字段加上特定注解，达到简化代码的目的。在该模块中，我们将使用到以下注解：

1.  `@ContentView`：加载当前的Activity布局时，将`@ContentView`加入到Activity的上方，效果等同于`setContentView(R.layout.activity_xxx);`
2.  `@ViewInject`：View注解的作用是代替我们写了`findViewById()`这行代码，一般用于敏捷开发。
3.  `@Event`：事件注解，大部分用来替代点击事件的匿名内部类。拥有`value`和`type`两个参数，使用该注解有以下的注意事项：
    
    1.  方法必须私有限定，即使用`private`
    2.  方法参数形式必须和`type`对应的Listener接口一致，`type`的默认值是`View.OnClickListener.class`
    3.  注解参数`value`支持数组，类似于`value={id1, id2, id3}`
    4.  其它参数说明见`{@link org.xutils.event.annotation.Event}`类的说明。

我们编写一个简单的Activity，来体验一下这三个注解的使用。修改布局文件activity\_main.xml，在里面添加两个按钮和一个文本控件，代码如下：

<?xml version="1.0" encoding="utf-8"?>
    <LinearLayout 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" android:orientation="vertical">
    
        <Button android:id="@+id/btn_test" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="测试按钮"/>
    
        <Button android:id="@+id/btn_test2" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="测试按钮2"/>
    
        <TextView android:id="@+id/tv_test" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="测试文本" />
    
    </LinearLayout>

之后，我们使用xUtils所提供的三个注解来在MainActivity中使用，实现一个简单的逻辑：点击两个按钮时的文本发生变化，代码如下：

package com.androidframelearn.util_xutils;
    
    import androidx.appcompat.app.AppCompatActivity;
    
    import android.os.Bundle;
    import android.view.View;
    import android.widget.Button;
    import android.widget.TextView;
    
    import org.xutils.view.annotation.ContentView;
    import org.xutils.view.annotation.Event;
    import org.xutils.view.annotation.ViewInject;
    import org.xutils.x;
    
    @ContentView(R.layout.activity_main)
    public class MainActivity extends AppCompatActivity { 
    
        @ViewInject(R.id.btn_test)
        private Button btn_test;
    
        @ViewInject(R.id.btn_test2)
        private Button btn_test2;
    
        @ViewInject(R.id.tv_test)
        private TextView tv_test;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) { 
            super.onCreate(savedInstanceState);
            x.view().inject(this);
        }
    
        @Event(value = { R.id.btn_test,R.id.btn_test2},type = View.OnClickListener.class)
        private void onClick(View view){ 
            switch (view.getId()){ 
                case R.id.btn_test:
                    tv_test.setText("修改成了测试文本");
                    break;
                case R.id.btn_test2:
                    tv_test.setText("修改成了测试文本2");
                    break;
            }
        }
    }

可以看到，这里我们使用了xUtils3所提供的三个注解进行代码的编写，代码看起来变得简洁，可读性也强了很多。  
**注意**：在使用xUtils之前，记得在Activity或者Fragment的`onCreate()`/`onCreateView()`中调用`x.view().inject(this)`来初始化一下xUtils，不然无法使用里面的功能！

## 3.4 网络模块 ##

xUtils在Android 4.4之后，底层使用的是OkHttp来实现**网络模块**。所以这里简单演示一下跟网络有关的几个主要功能，分别是**GET请求**、**POST请求**、**使用缓存**、**上传文件**、**下载文件**。下面直接贴出业务代码（这里的**GET/POST**请求的义务以常见的**登录校验/登录**为例，而使用缓存则以**GET请求**为例），具体的api数量过多，就不一一讲解了，读者一看便知是怎么使用的了。

### 3.4.1 GET请求 ###

@Event(value = { R.id.btn_get},type = View.OnClickListener.class)
    private void onTestGet(View view){ 
    	String url ="http://10.0.0.2:8080/login"
        RequestParams params = new RequestParams(url);
        //params.setSslSocketFactory(...); // 设置ssl
        params.addQueryStringParameter("username","abc");
        params.addQueryStringParameter("password","123");
        x.http().get(params, new Callback.CommonCallback<String>() { 
            public void onSuccess(String result) { 
                Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
                Log.i(TAG, "onSuccess result:" + result);
            }
            //请求异常后的回调方法
            @Override
            public void onError(Throwable ex, boolean isOnCallback) { 
            }
            //主动调用取消请求的回调方法
            @Override
            public void onCancelled(CancelledException cex) { 
            }
            @Override
            public void onFinished() { 
    
            }
        });
       
    }

### 3.4.2 POST请求 ###

@Event(R.id.btn_post)
    private void onTestPost(View v) { 
        String url = "http://10.0.0.2:8080/login";
        RequestParams params = new RequestParams(url);
        params.addParameter("username", "abc");
    	params.addParameter("password", "123");
        x.http().request(HttpMethod.PUT, params, new Callback.CommonCallback<String>() { 
            @Override
            public void onSuccess(String result) { 
    		Toast.makeText(x.app(),result,Toast.LENGTH_LONG).show();
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) { 
            }
            @Override
            public void onCancelled(CancelledException cex) { 
            }
            @Override
            public void onFinished() { 
            }
        });
    }

### 3.4.3 使用缓存 ###

@Event(R.id.btn_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<string>() { 
        @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(TAG,result);
            return true;
        }
    });

### 3.4.4 上传文件 ###

@Event(R.id.btn_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<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() { 
        }
    });

### 3.4.5 下载文件 ###

@Event(R.id.btn_download)
    private void download(View v){ 
    url = "http://10.0.0.2:8080/server/nfctest.apk";
    RequestParams params = new RequestParams(url);
    //自定义保存路径，Environment.getExternalStorageDirectory()：SD卡的根目录
    //注意，如果你的Android版本为Android X，由于其作用域存储的特性，应使用context.getExternalFilesDir()来获取关联目录
    params.setSaveFilePath(Environment.getExternalStorageDirectory()+"/myapp/");
    //自动为文件命名
    params.setAutoRename(true);
    x.http().post(params, new Callback.ProgressCallback<file>() { 
        @Override
        public void onSuccess(File result) { 
            //apk下载完成后，调用系统的安装方法
            Intent intent = new Intent(Intent.ACTION_VIEW);
            intent.setDataAndType(Uri.fromFile(result), "application/vnd.android.package-archive");
            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(TAG,"current："+ current +"，total："+total); 
        }
    });

## 3.5 图片加载模块 ##

xUtils3的图片模块，重点在于加载图片的4个`bind`方法，`loadDrawable`与`loadFIle`用法和`ImageOptions`用法，这些方法的详情如下所示：

void bind(ImageView view, String url);
    
    void bind(ImageView view, String url, ImageOptions options);
    
    void bind(ImageView view, String url, Callback.CommonCallback<Drawable> callback);
    
    void bind(ImageView view, String url, ImageOptions options, Callback.CommonCallback<Drawable> callback);
    
    Callback.Cancelable loadDrawable(String url, ImageOptions options, Callback.CommonCallback<Drawable> callback);
    
    Callback.Cancelable loadFile(String url, ImageOptions options, Callback.CacheCallback<File> callback);

使用图片加载模块共有三个步骤：

1.  使用`@ViewInject`来绑定ImageView：
    
        @ViewInject(R.id.iv1)
        ImageView image01;
        @ViewInject(R.id.iv2)
        ImageView image02;
        @ViewInject(R.id.iv3)
        ImageView image03;
2.  定义图片网络地址或本地地址：
    
        String[] urls = { 
            "http://img4.imgtn.bdimg.com/it/u=3182769660,1810895318&fm=23&gp=0.jpg",
            "http://img2.imgtn.bdimg.com/it/u=1278435851,1308167727&fm=23&gp=0.jpg",
            "http://img2.3lian.com/2014/f4/199/d/6.jpg",
            "http://pic1.win4000.com/wallpaper/4/584b9ea3a511c.jpg"
        	...
        };
3.  通过`ImageOptions.Builder().set`方法设置图片的属性 然后通过bind方法加载图片，显示图片的方法`setImg()`如下：

private void setImg() { 
        /** * 通过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<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().bind(image04, urls[3], options, 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() { 
            }
        });
    
        /** * loadDrawable()方法加载图片 */
        Callback.Cancelable cancelable = x.image().loadDrawable(urls[4], options, new Callback.CommonCallback<Drawable>() { 
            @Override
            public void onSuccess(Drawable result) { 
                image05.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<File>(){ 
            @Override
            public boolean onCache(File result) { 
                //在这里可以做图片另存为等操作
                Log.i(TAG,"file：" + result.getPath() + result.getName());
                return true; //相信本地缓存返回true
            }
            @Override
            public void onSuccess(File result) { 
                Log.i(TAG,"file");
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) { 
            }
            @Override
            public void onCancelled(CancelledException cex) { 
            }
            @Override
            public void onFinished() { 
            }
        });
    }

## 3.6 数据库模块 ##

### 3.6.1 创建数据库 ###

要使用xUtils的数据库模块，我们先要配置DaoConfig，作为数据库的配置信息，以此来获取xUtils提供的`DbManager`对象，代码如下：

DbManager.DaoConfig daoConfig = new DbManager.DaoConfig()
            //设置数据库名，默认xutils.db
            .setDbName("myapp.db")
            // 不设置dbDir时, 默认存储在app的私有目录.
            .setDbDir(new File("/sdcard")) // "sdcard"的写法并非最佳实践, 这里为了简单, 先这样写了.
            .setDbVersion(1)//数据库版本
    
            //设置是否允许事务，默认true
            //.setAllowTransaction(true)
    
            //设置表创建的监听
            .setTableCreateListener(new DbManager.TableCreateListener(){ 
    
                @Override
                public void onTableCreated(DbManager db, TableEntity<?> table) { 
                    Log.i("JAVA", "onTableCreated：" + table.getName());
                }
            })
    
            //设置数据库更新的监听
            .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);

我们创建一个名为Person的实体类，以此来创建一张数据表，代码如下：

/** * onCreated = "sql" sql：当第一次创建表需要插入数据时候在此写sql语句例：CREATE UNIQUE INDEX index_name ON person(id,name) */
    @Table(name ="person",onCreated = "")
    public class Person { 
    	/** * 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 name;
    
    	public Person(String name) { 
        	this.name = name;
    	}
    
    	//默认的构造方法必须写出，如果没有，这张表是创建不成功的
    	public Person() { 
    
    	}
    
    	public int getId() { 
        	return id;
    	}
    	public void setId(int id) { 
        	this.id = id;
    	}
    
    	public String getName() { 
        	return name;
    	}
    
    	public void setName(String name) { 
        	this.name = name;
    	}
    	@Override
    	public String toString() { 
        	return "Person{" +
                	"id=" + id +
                	", name='" + name + '\'' +
                	'}';
    	}
    }

当上面这两步都完成之后，接下来就是数据库的创建，这里需要使用到第一步所创建出来的`Dbmanger`对象来创建数据库了，代码如下：

//数据库的创建
    @Event(R.id.btn_create_db)
    private void createDB(View v) throws DbException { 
        //用集合向Person表中插入多条数据
        ArrayList<Person> person = new ArrayList<>();
        person.add(new Person("张三"));
        person.add(new Person("李四"));
        person.add(new Person("赵六"));
    
        //db.save()方法不仅可以插入单个对象，还能插入集合
        db.save(person);
    }

数据库创建完毕之后，接下来就是对数据库中的表进行常规操作——增删改查的说明了。

### 3.6.2 增加数据 ###

增加数据的操作跟创建数据库中的业务类似，代码如下：

//增加数据
    @Event(R.id.btn_add_data)
    private void addData(View v) throws DbException { 
        //用集合向Person表中插入多条数据
        ArrayList<Person> person = new ArrayList<>();
        person.add(new Person("张三"));
        person.add(new Person("李四"));
        person.add(new Person("赵六"));
    
        //db.save()方法不仅可以插入单个对象，还能插入集合
        db.save(person);
    }

### 3.6.3 删除数据 ###

删除数据的操作比较简单，下面提供两种删除数据的方式，供读者参考，代码如下：

@Event(R.id.btn_delete_data)
    private void deleteData(View v) throws DbException { 
        //第一种写法：
        db.delete(Person.class); //child_info表中数据将被全部删除
        
        //第二种写法，添加删除条件：
        WhereBuilder b = WhereBuilder.b();
        b.and("id",">",2); //构造修改的条件
        b.and("id","<",4);
        db.delete(Person.class, b);
    }

当然，除了删除数据之外，我们也可以删除数据表，代码如下：

@Event(R.id.btn_delete_table)
    private void deleteTable(View v) throws DbException { 
        db.dropTable(Person.class);
    }

甚至，我们还可以直接删除数据库，代码如下：

//删除数据库
    @Event(R.id.btn_delete_db)
    private void deleteDB(View v) throws DbException { 
        db.dropDb();
    }

### 3.6.4 修改数据 ###

修改数据的操作要稍微复杂一些，下面提供三种修改数据的方式，供读者参考，代码如下：

//修改表中数据
    @Event(R.id.btn_update_data)
    private void updateData(View v) throws DbException { 
        //第一种写法：
        Person first = db.findFirst(Person.class);
        first.setName("张三01");
        db.update(first, "c_name"); //c_name：表中的字段名
        
        //第二种写法：
        WhereBuilder b = WhereBuilder.b();
        b.and("id", "=", first.getId()); //构造修改的条件
        KeyValue name = new KeyValue("c_name", "张三02");
        db.update(Person.class, b, name);
    
        //第三种写法：
        first.setName("张三修改");
        db.saveOrUpdate(first);
    	Toast.makeText(this,"修改成功",Toast.LENGTH_LONG).show();
    }

### 3.6.5 查询数据 ###

查询数据的操作基本上是增删改查中逻辑最复杂的，这里仅列出部分查询场景，代码如下：

@Event(R.id.btn_query_data)
    private void queryData(View v) throws DbException { 
        //查询数据库表中第一条数据
        Person first = db.findFirst(Person.class);
        Log.i(TAG,first.toString());
    
        //findAll()：查询所有结果
        List<Person> personAll =db.findAll(Person.class);
        List<String > list = new ArrayList<String>();
        for(int i=0;i<personAll.size();i++){ 
            list.add(personAll.get(i).toString());
        }
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(MainActivity.this,android.R.layout.simple_list_item_1,list);
        lv1.setAdapter(adapter); 
    
    	//添加查询条件进行查询
        WhereBuilder b = WhereBuilder.b();
        b.and("id",">",2); //构造修改的条件
        b.and("id","<",4);
        List<Person> all = db.selector(Person.class).where(b).findAll();
        //第二种写法：
        List<Person> all2 = db.selector(Person.class).where("id",">",2).and("id","<",4).findAll();
        for(Person person :all){ 
            Log.i(TAG,person.toString());
        }
    }

# 4. 源码地址 #

[AFL——Android框架学习][AFL_Android]

[xUtils3]: https://github.com/wyouflf/xUtils3
[Afinal]: https://github.com/yangfuhai/afinal
[AFL_Android]: https://gitee.com/moxitao/AndoridFrameLearn