版权声明：本文为博主原创文章，未经博主允许不得转载
源码:github.com/AnliaLee
大家要是看到有错误的地方或者有啥好的建议，欢迎留言评论

前言

博主这两天心血来潮准备回顾下SQLite的知识，然而网上查找资料的过程是痛苦的，因为很少有一篇博客能把SQLite的入门知识讲全的，得好几篇合着来看才行，因此我的浏览器选项卡基本上是这样的

正所谓自己动手丰衣足食，我不想以后忘了还要这样再来一次，所以决定自己重新总结一番，集众家之长来篇大杂烩。本篇博客内容很多，为了尽量涵盖到所有知识不得已写得很啰嗦，大家可以看着目录按需跳着看，如果有什么遗漏或写错的地方欢迎大家指出来~

什么是SQLite

关于SQLite的简介网上有很多很多，其中看到一篇博客总结得很好，遂直接引用啦~以下摘自Android黄金篇-SQLite数据库

SQLite介绍

SQLite是一款轻量级的关系型数据库，它的运算速度非常快，占用资源很少，通常只需要几百K的内存就足够了，因而特别适合在移动设备上使用。

SQLite特点

轻量级
使用 SQLite 只需要带一个动态库，就可以享受它的全部功能，而且那个动态库的尺寸想当小。
独立性
SQLite 数据库的核心引擎不需要依赖第三方软件，也不需要所谓的“安装”。
隔离性
SQLite 数据库中所有的信息（比如表、视图、触发器等）都包含在一个文件夹内，方便管理和维护。
跨平台
SQLite 目前支持大部分操作系统，不至电脑操作系统更在众多的手机系统也是能够运行，比如：Android和IOS。
多语言接口
SQLite 数据库支持多语言编程接口。
安全性
SQLite 数据库通过数据库级上的独占性和共享锁来实现独立事务处理。这意味着多个进程可以在同一时间从同一数据库读取数据，但只能有一个可以写入数据。
弱类型的字段
同一列中的数据可以是不同类型

SQLite数据类型

SQLite具有以下五种常用的数据类型：

存储类	存储类
NULL	值是一个 NULL 值
INTEGER	值是一个带符号的整数，根据值的大小存储在 1、2、3、4、6 或 8 字节中
REAL	值是一个浮点值，存储为 8 字节的 IEEE 浮点数字
TEXT	值是一个文本字符串，使用数据库编码（UTF-8、UTF-16BE 或 UTF-16LE）存储
BLOB	值是一个 blob 数据，完全根据它的输入存储

调试工具

调试SQLite数据库推荐使用SQLite Expert（Personal），简单易用

当然你也可以直接用adb shell查看数据库，这个就看个人喜爱了

SQLiteDatabase与SQLiteOpenHelper

在讲如何使用SQLite数据库之前，有必要介绍一下这两个重要的类：SQLiteDatabase 和 SQLiteOpenHelper，这是SQLite数据库API中最基础的两个类

SQLiteDatabase

在Android中，SQLite数据库的使用始于SQLiteDatabase这个类（SQLiteOpenHelper也是基于SQLiteDatabase来进行数据库创建和版本管理，之后会详细介绍），我们可以看下它的内部方法（未截全）

可以发现insert、query等熟悉的字眼，这些方法都是已经封装好的，我们只需要传入适当的参数即可完成诸如插入、更新、查询等操作。当然SQLiteDatabase也提供了直接执行SQL语句的方法，如

execSQL
可以执行insert、delete、update和CREATE TABLE之类有更改行为的SQL语句
rawQuery
用于执行select语句

总结来说，我们可以将SQLiteDatabase看作是一个数据库对象，通过调用其中的方法来创建、删除、执行SQL命令，以及执行其他常见的数据库管理任务。我们会在之后的章节中详细讲述如何使用SQLiteDatabase一步步搭建我们的本地数据库

SQLiteOpenHelper

SQLiteOpenHelper是SQLiteDatabase的辅助类，通过对SQLiteDatabase内部方法的封装简化了数据库创建与版本管理的操作。它是一个抽象类，一般情况下，我们需要继承并重写这两个父类方法：

onCreate
在初次生成数据库时才会被调用，我们一般重写onCreate生成数据库表结构并添加一些应用使用到的初始化数据
onUpgrade
当数据库版本有更新时会调用这个方法，我们一般会在这执行数据库更新的操作，例如字段更新、表的增加与删除等

此外父类方法中还有onConfigure、onDowngrade、onOpen，一般项目中很少用到它们，如果大家需要进一步了解可以看下这篇博客，这里就不赘述了

那么SQLiteOpenHelper和SQLiteDatabase是如何关联起来的呢？SQLiteOpenHelper中提供了getWritableDatabase和 getReadableDatabase方法，其最终都调用了getDatabaseLocked，并在第一次调用（或数据库版本更新）时执行我们之前在onCreate、onUpgrade等方法中重写的数据库操作，这两个方法的区别在于

getWritableDatabase
打开一个可 读/写 的数据库，如果数据库不存在，则会自动创建一个数据库，最终返回SQLiteDatabase对象
getReadableDatabase
打开一个可读的数据库，其他同上

创建数据库

一些实操之前要知道的东西

一般来说，创建SQLite数据库的方法有三，我们按照使用频率从高到低的顺序列出这三种方法

继承SQLiteOpenHelper，调用getWritableDatabase / getReadableDatabase打开或创建数据库（推荐初学者使用）
调用SQLiteDatabase.openOrCreateDatabase打开或创建数据库
调用Context.openOrCreateDatabase打开或创建数据库

它们最终都是要调用SQLiteDatabase.openDatabase方法，下图可以简单地概括它们的调用关系

那么我们不妨看下openDatabase干了啥

public static SQLiteDatabase openDatabase(String path, CursorFactory factory, int flags,
		DatabaseErrorHandler errorHandler) {
	SQLiteDatabase db = new SQLiteDatabase(path, flags, factory, errorHandler);
	db.open();//继续执行打开或创建数据库的操作
	return db;
}

解释一下各个参数

String path
数据库文件路径
CursorFactory factory
用于构造自定义的Cursor子类对象，在执行查询操作时返回，若传入 null 则使用默认的factory构造Cursor
int flags
用于控制数据库的访问模式，可传入的参数有
- CREATE_IF_NECESSARY：当数据库不存在时创建该数据库文件
- ENABLE_WRITE_AHEAD_LOGGING：绕过数据库的锁机制，以多线程操作数据库的方式进行读写
- NO_LOCALIZED_COLLATORS：打开数据库时，不根据本地化语言对数据库进行排序
- OPEN_READONLY：以只读方式打开数据库
- OPEN_READWRITE：以读写方式打开数据库
DatabaseErrorHandler errorHandler
当检测到数据库损坏时进行回调的接口，一般没有特殊需要传入 null 即可

我们作为初学者刚入门不必过多地深究每个参数的含义及使用场景，知道有这么些内容，日后扩展技能起个索引作用就行，因此这里就不费篇幅继续深挖了

关于创建数据库的路径

关于这点很有必要单独开个小节啰嗦一下，很多资料都忽略了这个或者讲得不是很清楚。数据库的默认路径为

/data/data/<package_name>/databases/

一般情况下我们在创建数据库时path参数只需传入“xxx.db”，系统自动会在该默认路径下创建名为“xxx.db”的数据库文件，这样做最大的好处就是安全，要想拿到这个文件我们得先root手机（据说模拟器中可以直接拿，我没亲自试验过），而且这个数据库文件也会随着App的删除而删除。但某些场景下，例如我们要取出数据库文件进行调试，在默认路径下创建数据库就显得不那么方便了。因此，我们可以在内部存储或sd卡中创建该数据库文件，例如我们要传入的path可以写成这样

Environment.getExternalStorageDirectory().getPath() + "/SQLiteTest/xxx.db"

那么数据库文件xxx.db就会放在内存的SQLiteTest目录中，需要注意的是，如果SQLiteTest目录不存在，系统会抛出异常

这是因为我们前文提到的SQLiteDatabase.openDatabase方法中db.open()后续并没有创建目录的相关代码，所以我们需要手动去创建该目录（记得配置权限）

File dir = new File(Environment.getExternalStorageDirectory().getPath() + "/SQLiteTest/");
if (!dir.exists()) {
    dir.mkdir();
}

目录创建之后我们就可以继续执行创建数据库的操作了

接下来我们以创建数据库文件test.db，建一张test表为例，按顺序讲讲这三种创建数据库的方法

一、继承SQLiteOpenHelper（推荐初学者使用）

按照之前讲的，我们需要先继承SQLiteOpenHelper，然后重写onCreate与onUpgrade方法

如何调用

创建MySQLiteOpenHelper

public class MySQLiteOpenHelper extends SQLiteOpenHelper {
    public static final String FILE_DIR = Environment.getExternalStorageDirectory().getPath() + "/SQLiteTest/";
    public static final int DATABASE_VERSION = 1;
    public static final String TABLE_NAME = "test";

    public MySQLiteOpenHelper(Context context, String name){
        this(context, name, null, DATABASE_VERSION);
    }

    public MySQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
        this(context, name, factory, version, null);
    }

    public MySQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version, DatabaseErrorHandler errorHandler) {
        super(context, name, factory, version, errorHandler);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        File dir = new File(FILE_DIR);
        if (!dir.exists()) {
            dir.mkdir();
        }
        
        try{
            db.execSQL("create table if not exists " + TABLE_NAME +
                    "(id text primary key,name text)");
        }
        catch(SQLException se){
            se.printStackTrace();
        }
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        if(newVersion > oldVersion){
            String sql = "DROP TABLE IF EXISTS " + TABLE_NAME;
            db.execSQL(sql);
            onCreate(db);
        }
    }
}

在Activity中调用getWritableDatabase / getReadableDatabase（我这里把动态申请权限的代码也贴出来，之后就省略了）

public class MainActivity extends AppCompatActivity {
    public static final String DATABASE_NAME = FILE_DIR + "test.db";
    private static final int CODE_PERMISSION_REQUEST = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            //申请写入权限
            ActivityCompat.requestPermissions(this, new String[]{
                    Manifest.permission.WRITE_EXTERNAL_STORAGE
            }, CODE_PERMISSION_REQUEST);
        } else {
            createDB();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch(requestCode) {
            case CODE_PERMISSION_REQUEST:
                if(grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    createDB();
                } else{
                }
                break;
            default:
                break;

        }
    }

    private void createDB(){
        MySQLiteOpenHelper sqLiteOpenHelper = new MySQLiteOpenHelper(this,DATABASE_NAME);
        SQLiteDatabase database = sqLiteOpenHelper.getWritableDatabase();
    }
}

用SQLite Expert看下结果

二、调用SQLiteDatabase.openOrCreateDatabase打开或创建数据库

先来看下openOrCreateDatabase方法的源码

public static SQLiteDatabase openOrCreateDatabase(File file, CursorFactory factory) {
	return openOrCreateDatabase(file.getPath(), factory);
}

public static SQLiteDatabase openOrCreateDatabase(String path, CursorFactory factory) {
	return openDatabase(path, factory, CREATE_IF_NECESSARY, null);
}

public static SQLiteDatabase openOrCreateDatabase(String path, CursorFactory factory,
		DatabaseErrorHandler errorHandler) {
	return openDatabase(path, factory, CREATE_IF_NECESSARY, errorHandler);
}

可以看到openOrCreateDatabase实际上是以CREATE_IF_NECESSARY模式打开创建数据库的

如何调用

在Activity中执行相应代码

private static final String FILE_DIR = Environment.getExternalStorageDirectory().getPath() + "/SQLiteTest/";
public static final String DATABASE_NAME = FILE_DIR + "test.db";

private void createDB(){
	File dir = new File(FILE_DIR);
	if (!dir.exists()) {
		dir.mkdir();
	}
	
	SQLiteDatabase database = SQLiteDatabase.openOrCreateDatabase(DATABASE_NAME, null);
	database.execSQL("create table if not exists " + "test" +
			"(id text primary key,name text)");
}

结果一样的我就不重复贴出来了

三、调用Context.openOrCreateDatabase打开或创建数据库

Context.openOrCreateDatabase的具体实现在ContextImpl类中（关于Context的知识大家可以自行查阅资料了解）

@Override
public SQLiteDatabase openOrCreateDatabase(String name, int mode, CursorFactory factory,
		DatabaseErrorHandler errorHandler) {
	checkMode(mode);
	File f = getDatabasePath(name);
	int flags = SQLiteDatabase.CREATE_IF_NECESSARY;
	if ((mode & MODE_ENABLE_WRITE_AHEAD_LOGGING) != 0) {
		flags |= SQLiteDatabase.ENABLE_WRITE_AHEAD_LOGGING;
	}
	if ((mode & MODE_NO_LOCALIZED_COLLATORS) != 0) {
		flags |= SQLiteDatabase.NO_LOCALIZED_COLLATORS;
	}
	SQLiteDatabase db = SQLiteDatabase.openDatabase(f.getPath(), factory, flags, errorHandler);
	setFilePermissionsFromMode(f.getPath(), mode, 0);
	return db;
}

可以看出Context.openOrCreateDatabase与SQLiteDatabase.openOrCreateDatabase本质上没有太大区别，只是多了一个mode参数用于设置操作模式，可传入的参数有

MODE_PRIVATE
默认的模式，创建的数据库文件只能通过调用该模式的应用程序访问（或所有应用程序共享相同的用户ID），我们一般设置这个参数即可
MODE_ENABLE_WRITE_AHEAD_LOGGING
功能和之前讲的设置ENABLE_WRITE_AHEAD_LOGGING一样
MODE_NO_LOCALIZED_COLLATORS
功能和之前讲的设置NO_LOCALIZED_COLLATORS一样
MODE_WORLD_READABLE
设置后当前文件可以被其他应用程序读取，官方不建议在API 17以上的版本设置该参数（Android 7.0以上会直接抛出异常:XXX no longer supported）
MODE_WORLD_WRITEABLE
设置后当前文件可以被其他应用程序写入，官方不建议在API 17以上的版本设置该参数（Android 7.0以上会直接抛出异常:XXX no longer supported）

如何调用

private static final String FILE_DIR = Environment.getExternalStorageDirectory().getPath() + "/SQLiteTest/";
public static final String DATABASE_NAME = FILE_DIR + "test.db";

private void createDB(){
	File dir = new File(FILE_DIR);
	if (!dir.exists()) {
		dir.mkdir();
	}

	SQLiteDatabase database = this.openOrCreateDatabase(DATABASE_NAME,MODE_PRIVATE,null);
	database.execSQL("create table if not exists " + "test" +
			"(id text primary key,name text)");
}

数据库的相关操作

这里只介绍简单的增删改查操作，其余的大家可以自行查阅资料了解

增

SQLiteDatabase提供了insert方法

public long insert(String table, String nullColumnHack, ContentValues values) {
	try {
		return insertWithOnConflict(table, nullColumnHack, values, CONFLICT_NONE);
	} catch (SQLException e) {
		Log.e(TAG, "Error inserting " + values, e);
		return -1;
	}
}

各参数含义如下

String table
要插入数据的表的名称
String nullColumnHack
当values参数为空或者里面没有内容的时候，执行insert是会失败（底层数据库不允许插入一个空行），为了防止这种情况，我们要在这里指定一个列名，如果发现将要插入的行为空行时，就会将指定的这个列名的值设为null，然后再向数据库中插入。若values不为null并且元素的个数大于0，则一般将nullColumnHack设为null
ContentValues values
ContentValues类似一个map.通过键值对的形式存储值

如何调用

像前文所说的，我们可以通过SQLiteDatabase.insert和SQLiteDatabase.execSQL两种方式添加数据

ContentValues values = new ContentValues();
values.put("id","1");
values.put("name","name1");
database.insert("test",null,values);

database.execSQL("insert into test(id, name) values(2, 'name2')");
database.close();

结果如图

删

同样的SQLiteDatabase提供delete方法删除数据

public int delete(String table, String whereClause, String[] whereArgs) {
	acquireReference();
	try {
		SQLiteStatement statement =  new SQLiteStatement(this, "DELETE FROM " + table +
				(!TextUtils.isEmpty(whereClause) ? " WHERE " + whereClause : ""), whereArgs);
		try {
			return statement.executeUpdateDelete();
		} finally {
			statement.close();
		}
	} finally {
		releaseReference();
	}
}

String table
表名称
String whereClause
条件语句，相当于where关键字，可以使用占位符分隔多个条件
String[] whereArgs
对应条件语句的值的数组，注意若有多个值则需与selection中的多个条件（?符号）一一对应

如何调用

我们先添加几条数据用来测试

database.execSQL("insert into test(id, name) values(3, 'name3')");
database.execSQL("insert into test(id, name) values(4, 'name4')");
database.execSQL("insert into test(id, name) values(5, 'name5')");

执行删除语句

String whereClause = "id=?";
String[] whereArgs = {"3"};
database.delete("test",whereClause,whereArgs);

database.execSQL("delete from test where name = 'name4'");
database.close();

改

SQLiteDatabase.update用于更新数据

public int update(String table, ContentValues values, String whereClause, String[] whereArgs) {
	return updateWithOnConflict(table, values, whereClause, whereArgs, CONFLICT_NONE);
}

updateWithOnConflict大家可以自行查阅资料了解，这里只简单解释一下各个参数的含义

String table
表名称
ContentValues values
ContentValues类似一个map.通过键值对的形式存储值
String whereClause
条件语句，相当于where关键字，可以使用占位符分隔多个条件
String[] whereArgs
对应条件语句的值的数组，注意若有多个值则需与selection中的多个条件（?符号）一一对应

如何调用

ContentValues values = new ContentValues();
values.put("name","update2");
String whereClause = "id=?";
String[] whereArgs={"2"};
database.update("test",values,whereClause,whereArgs);

database.execSQL("update test set name = 'update5' where id = 5");
database.close();

查

SQLiteDatabase提供query和rawQuery方法执行查询的操作，查询结束后返回一个Cursor对象。Cursor是一个游标接口，提供了遍历查询结果的方法，由于本篇博客重点不是这个，就不展开讲了。我们接着看query方法

public Cursor query(String table, String[] columns, String selection,
		String[] selectionArgs, String groupBy, String having,
		String orderBy) {

	return query(false, table, columns, selection, selectionArgs, groupBy,
			having, orderBy, null /* limit */);
}

public Cursor query(String table, String[] columns, String selection,
		String[] selectionArgs, String groupBy, String having,
		String orderBy, String limit) {

	return query(false, table, columns, selection, selectionArgs, groupBy,
			having, orderBy, limit);
}

public Cursor query(boolean distinct, String table, String[] columns,
		String selection, String[] selectionArgs, String groupBy,
		String having, String orderBy, String limit) {
	return queryWithFactory(null, distinct, table, columns, selection, selectionArgs,
			groupBy, having, orderBy, limit, null);
}

public Cursor query(boolean distinct, String table, String[] columns,
		String selection, String[] selectionArgs, String groupBy,
		String having, String orderBy, String limit, CancellationSignal cancellationSignal) {
	return queryWithFactory(null, distinct, table, columns, selection, selectionArgs,
			groupBy, having, orderBy, limit, cancellationSignal);
}

query方法的参数很多，大家简单了解下就行

boolean distinct
是否去除重复记录
String table
表名称
String[] columns
要查询的列名称数组，例如这句查询语句的加黑部分：SELECT id, name FROM test
String selection
条件语句，相当于where关键字，可以使用占位符分隔多个条件
String[] selectionArgs
对应条件语句的值的数组，注意若有多个值则需与selection中的多个条件（?符号）一一对应
String groupBy
分组语句，对查询的结果进行分组
String having
分组条件，对分组的结果进行限制
String orderBy
排序语句
String limit
分页查询限制
CancellationSignal cancellationSignal
取消操作的信号，一般用于设置查询取消时的后续操作，如果没有则设置为null。如果操作取消了，query语句运行时会抛出异常（OperationCanceledException）

如何调用

前文提到执行查询SQL语句的方法是rawQuery，同样在这里我们对照着query方法看看调用过程（如果数据量大的话查询操作是需要放在单独的线程中去执行的）

调用query方法，各个参数我就不一一试了，简单举几个例子

if(database!=null){
	Cursor cursor = database.query ("test",null,null,null,null,null,null);
	while (cursor.moveToNext()){
		String id = cursor.getString(0);
		String name=cursor.getString(1);
		Log.e("SQLiteTest query","id:"+id+" name:"+name);
	}
	database.close();
}

或者

if(database!=null){
	Cursor cursor = database.rawQuery("SELECT * FROM test", null);
	while (cursor.moveToNext()){
		String id = cursor.getString(0);
		String name=cursor.getString(1);
		Log.e("SQLiteTest query","id:"+id+" name:"+name);
	}
	database.close();
}

加上多个条件限制

if(database!=null){
	String selection = "id=? or name=?";
	String[] selectionArgs = {"1","update2"};
	Cursor cursor = database.query ("test",null,selection,selectionArgs,null,null,null);
	while (cursor.moveToNext()){
		String id = cursor.getString(0);
		String name=cursor.getString(1);
		Log.e("SQLiteTest query","id:"+id+" name:"+name);
	}
	database.close();
}

或者

if(database!=null){
	Cursor cursor = database.rawQuery("SELECT * FROM test WHERE id=? or name=?", new String[]{"1","update2"});
	while (cursor.moveToNext()){
		String id = cursor.getString(0);
		String name=cursor.getString(1);
		Log.e("SQLiteTest query","id:"+id+" name:"+name);
	}
	database.close();
}

SQLite的替代者们

随着技术的更迭，原生的SQLite早已不是唯一的选择，我们利用其打好基础后，也不妨尝试下各种热门的数据库框架，例如OrmLite、greenDAO、ObjectBox、Realm等等。各个框架都有自己的优点和不足之处，大家可以按需选择适合自己的框架使用。由于博主并没有每个框架都进行过分析和尝试，在这强行科普那就是耍流氓了，所以直接拉几篇写得很好的对比博客来做外援吧~

相关博客链接
数据库到底哪家强？
【Android 数据库框架总结，总有一个适合你！】
Android数据库框架GreenDao&Realm实战分析