《第一行代码》学习笔记：SQLite数据库存储

SQLite是一款轻量级的关系型数据库，它的运算速度非常快，占用资源很少，因而特别适合在移动设备上使用。SQLite不仅支持标准的SQL语法，还遵循了数据库的ACID事务。而SQLite又比一般的数据库要简单得多，它甚至不用设置用户名和密码就可以使用。

一、创建数据库

Android为了让我们能够更加方便地管理数据库，专门提供了一个SQLiteOpenHelper帮助类，借助这个类就可以非常简单地对数据库进行创建和升级。SQLiteOpenHelper是一个抽象类，这意味着如果我们想要使用它的话，就需要创建一个自己的帮助类去继承它。SQLiteOpenHelper中有两个抽象方法，分别是onCreate() 和onUpgrade() ，我们必须在自己的帮助类里面重写这两个方法，然后分别在这两个方法中去实现创建、升级数据库的逻辑。

SQLiteOpenHelper中有两个非常重要的实例方法：getReadableDatabase() 和getWritableDatabase() 。这两个方法都可以创建或打开一个现有数据库（如果数据库已存在则直接打开，否则创建一个新的数据库），并返回一个可对数据库进行读写操作的对象。不同的是，当数据库不可写入的时候（如磁盘空间满），getReadableDatabase()方法返回的对象将以只读的方式去打开数据库，而getWritableDatabase() 方法则将出现异常。

SQLiteOpenHelper中有两个构造方法可供重写，一般使用参数少一点的那个构造方法即可。这个构造方法中接收4个参数，第一个参数是Context，必须要有它才能对数据库进行操作。第二个参数是数据库名，创建数据库时使用的就是这里指定的名称。第三个参数允许在查询数据的时候返回一个自定义的Cursor，一般都是传入null 。第四个参数表示当前数据库的版本号，可用于对数据库进行升级操作。构建出SQLiteOpenHelper的实例之后，再调用它的getReadableDatabase() 或getWritableDatabase() 方法就能够创建数据库了，数据库文件会存放在/data/data//databases/目录下。此时，重写的onCreate() 方法也会得到执行，所以通常会在这里去处理一些创建表的逻辑。

创建一个名为BookStore.db的数据库，然后在这个数据库中新建一张Book表：

create table Book (
	id integer primary key autoincrement,
	author text,
	price real,
	pages integer,
	name text)

integer 表示整型，real 表示浮点型，text 表示文本类型，blob 表示二进制类型。另外，上述建表语句中我们还使用了primary key 将id 列设为主键，并用autoincrement 关键字表示id 列是自增长的。然后需要在代码中去执行这条SQL语句，才能完成创建表的操作。

新建MyDatabaseHelper 类继承自SQLiteOpenHelper：

public class MyDatabaseHelper extends SQLiteOpenHelper {
	public static final String CREATE_BOOK = "create table Book ("
		+ "id integer primary key autoincrement, "
		+ "author text, "
		+ "price real, "
		+ "pages integer, "
		+ "name text)";
	private Context mContext;
	public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
		super(context, name, factory, version);
		mContext = context;
	}
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL(CREATE_BOOK);
		Toast.makeText(mContext, "Create succeeded", Toast.LENGTH_SHORT).show();
	}
	@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
	}
}

可以看到，把建表语句定义成了一个字符串常量，然后在onCreate() 方法中又调用了
SQLiteDatabase的execSQL() 方法去执行这条建表语句，并弹出一个Toast提示创建成功，这样
就可以保证在数据库创建完成的同时还能成功创建Book表。

在布局文件中加入一个按钮用于创建数据库。最后修改MainActivity中的代码：

public class MainActivity extends AppCompatActivity {
	private MyDatabaseHelper dbHelper;
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 1);
		Button createDatabase = (Button) findViewById(R.id.create_database);
		createDatabase.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				dbHelper.getWritableDatabase();
			}
		});
	}
}

这里在onCreate() 方法中构建了一个MyDatabaseHelper 对象，并且通过构造函数的参数将数据库名指定为BookStore.db，版本号指定为1，然后在Create database按钮的点击事件里调用了getWritableDatabase() 方法。这样当第一次点击Create database按钮时，就会检测到当前程序中并没有BookStore.db这个数据库，于是会创建该数据库并调用MyDatabaseHelper中的onCreate() 方法，这样Book表也就得到了创建，然后会弹出一个Toast提示创建成功。再次点击Create database按钮时，会发现此时已经存在BookStore.db数据库了，因此不会再创建一
次。

二、查看数据库

adb是Android SDK中自带的一个调试工具，使用这个工具可以直接对连接在电脑上的手机或模拟器进行调试操作。它存放在sdk的platform-tools目录下，如果想要在命令行中使用这个工具，就需要先把它的路径配置到环境变量里。

1. 打开命令行界面，输入adb shell ，就会进入到设备的控制台
2. 使用cd 命令进入到/data/data/com.example.databasetest/databases/目录下，并使用ls 命令查看到该目录里的文件
3. 键入sqlite3，后面加上数据库名打开数据库
4. 看目前数据库中有哪些表，键入.table 命令
5. .schema 命令来查看建表语句
6. 键入.exit 或.quit 命令可以退出数据库的编辑，再键入exit 命令就可以退出设备控制台
7. SQL查询语句select * from Book;

三、升级数据库

如果想再添加一张Category表用于记录图书的分类，该怎么做呢？比如Category表中有id （主键）、分类名和分类代码这几个列，那么建表语句就可以写成：

create table Category (
	id integer primary key autoincrement,
	category_name text,
	category_code integer)

接下来将这条建表语句添加到MyDatabaseHelper中：

public class MyDatabaseHelper extends SQLiteOpenHelper {
	public static final String CREATE_BOOK = "create table Book ("
		+ "id integer primary key autoincrement, "
		+ "author text, "
		+ "price real, "
		+ "pages integer, "
		+ "name text)";
	public static final String CREATE_CATEGORY = "create table Category ("
		+ "id integer primary key autoincrement, "
		+ "category_name text, "
		+ "category_code integer)";
	private Context mContext;
	public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
		super(context, name, factory, version);
		mContext = context;
	}
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL(CREATE_BOOK);
		db.execSQL(CREATE_CATEGORY);
		Toast.makeText(mContext, "Create succeeded", Toast.LENGTH_SHORT).show();
	}
	@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
	}
}

此时重新运行程序，并点击Create database按钮，但Category表没有创建成功！因为此时BookStore.db数据库已经存在了，之后不管怎样点击Create database按钮，MyDatabaseHelper中的onCreate() 方法都不会再次执行，因此新添加的表也就无法得到创建了。而通过SQLiteOpenHelper的升级功能就可以很轻松地解决这个问题。
修改MyDatabaseHelper中的代码，如下所示：

public class MyDatabaseHelper extends SQLiteOpenHelper {
	...
	@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
		db.execSQL("drop table if exists Book");
		db.execSQL("drop table if exists Category");
		onCreate(db);
	}
}

如果发现数据库中已经存在Book表或Category表了，就将这两张表删除掉，然后再调用onCreate() 方法重新创建。这里先将已经存在的表删除掉，因为如果在创建表时发现这张表已经存在了，就会直接报错。接下来的问题就是如何让onUpgrade() 方法能够执行了。SQLiteOpenHelper的构造方法里接收的第四个参数表示当前数据库的版本号，之前传入的是1，现在只要传入一个比1大的数（例如2），就可以让onUpgrade() 方法得到执行了.

四、添加数据

对数据进行的操作无非有4种，即CRUD。其中C代表添加（Create），R代表查询（Retrieve），U代表更新（Update），D代表删除（Delete），每一种操作又各自对应了一种SQL命令。Android提供了一系列的辅助
性方法，使得在Android中即使不去编写SQL语句，也能轻松完成所有的CRUD操作。

前面已经知道，调用SQLiteOpenHelper的getReadableDatabase()或getWritableDatabase() 方法是可以用于创建和升级数据库的，不仅如此，这两个方法还都会返回一个SQLiteDatabase 对象，借助这个对象就可以对数据进行CRUD操作了。

SQLiteDatabase 中提供了一个insert() 方法，这个方法就是专门用于添加数据的。它接收3个参数，第一个参数是表名。第二个参数用于在未指定添加数据的情况下给某些可为空的列自动赋值NULL ，一般用不到这个功能，直接传入null 即可。第三个参数是一个ContentValues 对象，它提供了一系列的put() 方法重载，用于向ContentValues 中添加数据，只需要将表中的每个列名以及相应的待添加数据传入即可。

在布局文件添加一个按钮，接着在MainActivity中添加代码：

Button addData = (Button) findViewById(R.id.add_data);
	addData.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		SQLiteDatabase db = dbHelper.getWritableDatabase();
		ContentValues values = new ContentValues();
		// 开始组装第一条数据
		values.put("name", "The Da Vinci Code");
		values.put("author", "Dan Brown");
		values.put("pages", 454);
		values.put("price", 16.96);
		db.insert("Book", null, values); // 插入第一条数据
		values.clear();
		// 开始组装第二条数据
		values.put("name", "The Lost Symbol");
		values.put("author", "Dan Brown");
		values.put("pages", 510);
		values.put("price", 19.95);
		db.insert("Book", null, values); // 插入第二条数据
	}
});

在添加数据按钮的点击事件里面，先获取到了SQLiteDatabase 对象，然后使用ContentValues 来对要添加的数据进行组装。不过，这里只对Book表里其中四列的数据进行了组装，id那一列并没给它赋值。这是因为在前面创建表的时候，就将id 列设置为自增长了，它的值会在入库的时候自动生成，所以不需要手动给它赋值了。接下来调用了insert() 方法将数据添加到表当中，注意这里实际上添加了两条数据，上述代码中使用ContentValues 分别组装了两次不同的内容，并调用了两次insert()方法。

五、更新数据

SQLiteDatabase 中也提供了一个非常好用的update() 方法，用于对数据进行更新，这个方法接收4个参数，第一个参数和insert() 方法一样，也是表名，在这里指定去更新哪张表里的数据。第二个参数是ContentValues 对象，要把更新数据在这里组装进去。第三、第四个参数用于约束更新某一行或某几行中的数据，不指定的话默认就是更新所有行。

在布局文件添加一个按钮，接着在MainActivity中添加代码：

Button updateData = (Button) findViewById(R.id.update_data);
	updateData.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		SQLiteDatabase db = dbHelper.getWritableDatabase();
		ContentValues values = new ContentValues();
		values.put("price", 10.99);
		db.update("Book", values, "name = ?", new String[] { "The Da Vinci Code" });
	}
});

这里在更新数据按钮的点击事件里面构建了一个ContentValues 对象，并且只给它指定了一组数据，说明我们只是想把价格这一列的数据更新成10.99。然后调用了SQLiteDatabase 的update() 方法去执行具体的更新操作，可以看到，这里使用了第三、第四个参数来指定具体更新哪几行。第三个参数对应的是SQL语句的where 部分，表示更新所有name 等于? 的行，而? 是一个占位符，可以通过第四个参数提供的一个字符串数组为第三个参数中的每个占位符指定相应的内容。因此上述代码想表达的意图是将名字是The Da Vinci Code的这本书的价格改成10.99。

六、删除数据

SQLiteDatabase 中提供了一个delete() 方法，专门用于删除数据，这个方法接收3个参数，第一个参数仍然是表名，第二、第三个参数又是用于约束删除某一行或某几行的数据，不指定的话默认就是删除所有行。

在布局文件添加一个按钮，接着在MainActivity中添加代码：

Button deleteButton = (Button) findViewById(R.id.delete_data);
deleteButton.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		SQLiteDatabase db = dbHelper.getWritableDatabase();
		db.delete("Book", "pages > ?", new String[] { "500" });
	}
});

在删除按钮的点击事件里指明去删除Book表中的数据，并且通过第二、第三个参数来指定仅删除那些页数超过500页的书。

七、查询数据

SQLiteDatabase中还提供了一个query() 方法用于对数据进行查询。这个方法的参数非常复杂，最短的一个方法重载也需要传入7个参数。第一个参数还是表名，表示希望从哪张表中查询数据。第二个参数用于指定去查询哪几列，如果不指定则默认查询所有列。第三、第四个参数用于约束查询某一行或某几行的数据，不指定则默认查询所有行的数据。第五个参数用于指定需要去group by的列，不指定则表示不对查询结果进行group by操作。第六个参数用于对group by之后的数据进行进一步的过滤，不指定则表示不进行过滤。第七个参数用于指定查询结果的排序方式，不指定则表示使用默认的排序方式。

调用query() 方法后会返回一个Cursor 对象，查询到的所有数据都将从这个对象中取出。

在布局文件添加一个按钮，接着在MainActivity中添加代码：

Button queryButton = (Button) findViewById(R.id.query_data);
queryButton.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		SQLiteDatabase db = dbHelper.getWritableDatabase();
		// 查询Book表中所有的数据
		Cursor cursor = db.query("Book", null, null, null, null, null, null);
		if (cursor.moveToFirst()) {
			do {
				// 遍历Cursor对象，取出数据并打印
				String name = cursor.getString(cursor.getColumnIndex("name"));
				String author = cursor.getString(cursor.getColumnIndex("author"));
				int pages = cursor.getInt(cursor.getColumnIndex("pages"));
				double price = cursor.getDouble(cursor.getColumnIndex("price"));
				Log.d("MainActivity", "book name is " + name);
				Log.d("MainActivity", "book author is " + author);
				Log.d("MainActivity", "book pages is " + pages);
				Log.d("MainActivity", "book price is " + price);
			} while (cursor.moveToNext());
		}
		cursor.close();
	}
});

首先在查询按钮的点击事件里面调用了SQLiteDatabase的query() 方法去查询数据。这里的query() 方法非常简单，只是使用了第一个参数指明去查询Book表，后面的参数全部为null 。这就表示希望查询这张表中的所有数据。查询完之后就得到了一个Cursor 对象，接着调用它的moveToFirst() 方法将数据的指针移动到第一行的位置，然后进入了一个循环当中，去遍历查询到的每一行数据。在这个循环中可以通过Cursor 的getColumnIndex() 方法获取到某一列在表中对应的位置索引，然后将这个索引传入到相应的取值方法中，就可以得到从数据库中读取到的数据了。接着使用Log的方式将取出的数据打印出来，借此来检查一下读取工作有没有成功完成。最后别忘了调用close() 方法来关闭Cursor 。

八、使用SQL操作数据库

Android提供了一系列的方法，使得可以直接通过SQL来操作数据库。

• 添加数据的方法如下：
  db.execSQL(“insert into Book (name, author, pages, price) values(?, ?, ?, ?)”,
  new String[] { “The Da Vinci Code”, “Dan Brown”, “454”, “16.96” });
  db.execSQL(“insert into Book (name, author, pages, price) values(?, ?, ?, ?)”,
  new String[] { “The Lost Symbol”, “Dan Brown”, “510”, “19.95” });
• 更新数据的方法如下：
  db.execSQL(“update Book set price = ? where name = ?”, new String[] { “10.99”, "The Da V
• 删除数据的方法如下：
  db.execSQL(“delete from Book where pages > ?”, new String[] { “500” });
• 查询数据的方法如下：
  db.rawQuery(“select * from Book”, null);

可以看到，除了查询数据的时候调用的是SQLiteDatabase的rawQuery() 方法，其他的操作都是调用的execSQL() 方法。以上演示的几种方式，执行结果会和前面CRUD操作的结果完全相同。