谨以文章记录学习历程，如有错误还请指明。
前言
Android中有多种方式存储数据，SQLite就是其中的一种。将数据保存到数据库是重复或结构化数据的理想方法，例如联系信息。本文也将着手介绍SQLite的基本使用。若发现阅读本文有难度，请先了解一下SQL语句的基本使用。
SQlite的特点
- 轻量级
SQLite和C/S模式的数据库软件不同，它是进程内的数据库引擎，因此不存在数据库的客户端和服务器。使用SQLite一般只需要带上它的一个动态 库，就可以享受它的全部功能 - 单一文件
所谓的“单一文件”，就是数据库中所有的信息（比如表、视图、触发器、等）都包含在一个文件内。这个文件可以copy到其它目录或其它机器上，也照用不误。 - 跨平台
支持主流操作系统，同时支持Android，WindowsMobile等系统 - 内存数据库
SQLite的API不区分当前操作的数据库是在内存还是在文件（对于存储介质是透明的）。
SQLite的使用
使用步骤
- 定义Schema和Contract
通常，我们会创建一个"契约"类Contract，来帮助我们定义数据库的Schema，而在该类中，我们为数据库的每个表创建一个匿名类，并添加成员属性存放表的属性。
示例如下：
//创建"契约"类，存放数据库各个表，及其相关属性
public class Contract {
//私有化，防止意外的实例化此类
private Contract() {
}
//为User表创建一个匿名类，声明其中属性
public static class User {
public static final String TABLE_NAME = "user";
public static final String COLUMN_ID = "id";
public static final String COLUMN_NAME = "name";
}
}
- 自定义创建SQLiteOpenHelper子类
SQLiteOpenHelper类包含用于管理数据库的一组有用的api。当使用这个类来获取对数据库的引用时，该类会执行内部自定义的操作，而这只在创建和更新数据库进行，并非在应用程序启动期间。该类的存在使得我们所需要做的就是调用getWritableDatabase()或getReadableDatabase()。
示例如下：
public class DatabaseHelper extends SQLiteOpenHelper {
private static final String TAG = "DatebaseHelper";
//数据库版本
private static final int DATABASE_VERSION = 1;
//数据库名称
private static final String DATABASE_NAME = "whd_db";
//组装创建表的SQL语句
private static final String SQL_CREATE =
"create table " + Contract.User.TABLE_NAME + " ( " +
Contract.User.COLUMN_ID + " integer primary key," +
Contract.User.COLUMN_NAME + " text)";
//组装删除表的语句，一般用于升级数据库时，删除已有的表，防止无法更新数据库
private static final String SQL_DELETE=
"DROP TABLE IF EXISTS " + Contract.User.TABLE_NAME;
//构造函数，必须有
public DatabaseHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
//context：上下文对象
//name：数据库名称
//param：factory
//version：当前数据库版本，值递增
//第一次创建数据库时调用
@Override
public void onCreate(SQLiteDatabase db) {
Log.d(TAG, "onCreate: "+ "创建数据库和表");
//执行sql语句
db.execSQL(SQL_CREATE);
}
//升级数据库时调用（数据库版本发生变化时）
//数据库版本只能递增！
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
db.execSQL(SQL_DELETE);
onCreate(db);
Log.d(TAG, "onUpgrade: "+ "更新数据库，当前版本号：" + newVersion);
}
}
- 创建数据库 & 操作数据库
创建：SQLiteOpenHelper的封装，使得我们创建数据库变得异常简单，只需要实例化SQLiteOpenHelper子类的对象，接着调用getWritableDatabase()或getReadableDatabase()即可得到数据库的引用。
操作：：数据库的操作无非就是CRID(增删改查)。
我们不再多说，示例里的注释以及很详细：
public class SQLiteActivity extends AppCompatActivity implements View.OnClickListener {
private DatabaseHelper helper;
private SQLiteDatabase database;
private static int VERSION = 1;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_sqlite);
//初始化
initViews();
//创建DatebaseHelp对象，传入context
helper = new DatabaseHelper(this);
}
//初始化按钮组件，设置监听
private void initViews(){
findViewById(R.id.createDatabase).setOnClickListener(this);
findViewById(R.id.insert).setOnClickListener(this);
findViewById(R.id.delete).setOnClickListener(this);
findViewById(R.id.update).setOnClickListener(this);
findViewById(R.id.query).setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()){
//创建数据库
case R.id.createDatabase:
helper.getWritableDatabase();
break;
//插入数据
case R.id.insert:
database = helper.getWritableDatabase();
//通过ContentValues对象，以键值对的方式存储
ContentValues values = new ContentValues();
values.put(Contract.User.COLUMN_ID,1);
values.put(Contract.User.COLUMN_NAME,"whdalive");
//插入数据到数据库
database.insert(Contract.User.TABLE_NAME,null,values);
// 参数1：要操作的表名称
// 参数2：SQl不允许一个空列，若ContentValues是空，那么这一列被明确的指明为NULL值
// 参数3：ContentValues对象
//用完关闭数据库
database.close();
//或者通过的execSQL()，再里面直接输入SQL语句
//不过缺点在于可能被恶意SQL注入
//database.execSQL("insert into user values(?,?)",new String[]{String.valueOf(2),"whdalive"});
//Android studio 3.0上会提示(?,?)部分有错误，但是实际编译没问题，不知道是什么原因
break;
//删除数据
case R.id.delete:
database = helper.getWritableDatabase();
String selection = Contract.User.COLUMN_ID + " = ?";
String[] selectionArgs = {String.valueOf(1)};
database.delete(Contract.User.TABLE_NAME,selection,selectionArgs);
// 参数1：表名(String)
// 参数2：WHERE表达式（String），需删除数据的行； 若该参数为 null, 就会删除所有行；？号是占位符
// 参数3：WHERE选择语句的参数(String[]), 逐个替换 WHERE表达式中 的“？”占位符;
//database.execSQL("delete from user where id = ?",new String[]{String.valueOf(1)});
database.close();
break;
//更新数据
case R.id.update:
database = helper.getWritableDatabase();
ContentValues values1 = new ContentValues();
values1.put(Contract.User.COLUMN_NAME,"chuang");
String selection1 = Contract.User.COLUMN_ID + " = ?";
String[] selectionArgs1 = {String.valueOf(1)};
database.update(Contract.User.TABLE_NAME,values1,selection1,selectionArgs1);
// 参数1：表名(String)
// 参数2：需修改的ContentValues对象
// 参数3：WHERE表达式（String），需数据更新的行； 若该参数为 null, 就会修改所有行；？号是占位符
// 参数4：WHERE选择语句的参数(String[]), 逐个替换 WHERE表达式中 的“？”占位符;
//database.execSQL("update user set name = ? where id = ?", new String[]{String.valueOf(1),"chuang"});
database.close();
break;
//查询数据
case R.id.query:
database = helper.getWritableDatabase();
String[] projection = {Contract.User.COLUMN_ID, Contract.User.COLUMN_NAME};
Cursor cursor = database.query(Contract.User.TABLE_NAME,projection,null,null,null,null,null);
// 参数说明
// table：要操作的表
// columns：查询的列所有名称集
// selection：WHERE之后的条件语句，可以使用占位符
// groupBy：指定分组的列名
// having指定分组条件，配合groupBy使用
// orderBy指定排序的列名
// limit指定分页参数
// distinct可以指定“true”或“false”表示要不要过滤重复值
//SQL输入方式
//Cursor cursor = database.rawQuery("select * from user",null);
while (cursor.moveToNext()){
String name = cursor.getString(cursor.getColumnIndex(Contract.User.COLUMN_NAME));
int id = cursor.getInt(cursor.getColumnIndex(Contract.User.COLUMN_ID));
Log.d("11111", "查询结果： id:"+id+" name: " + name );
}
/*Cursor对象常用方法如下：
cursor.move(int offset); //以当前位置为参考,移动到指定行
cursor.moveToFirst(); //移动到第一行
cursor.moveToLast(); //移动到最后一行
cursor.moveToPosition(int position); //移动到指定行
cursor.moveToPrevious(); //移动到前一行
cursor.moveToNext(); //移动到下一行
cursor.isFirst(); //是否指向第一条
cursor.isLast(); //是否指向最后一条
cursor.isBeforeFirst(); //是否指向第一条之前
cursor.isAfterLast(); //是否指向最后一条之后
cursor.isNull(int columnIndex); //指定列是否为空(列基数为0)
cursor.isClosed(); //游标是否已关闭
cursor.getCount(); //总数据项数
cursor.getPosition(); //返回当前游标所指向的行数
cursor.getColumnIndex(String columnName);//返回某列名对应的列索引值
cursor.getString(int columnIndex); //返回当前行指定列的值
*/
cursor.close();
database.close();
break;
}
}
}
总结
- 本文对Android中的SQLite相关使用作出了总结，后续我会介绍ROOM框架的使用。
- 笔者水平有限，如有错漏，欢迎指正。
- 接下来我也会将所学的知识分享出来，有兴趣可以继续关注whd_Alive的Android开发笔记
欢迎关注whd_Alive的简书
- 不定期分享Android开发相关的技术干货，期待与你的交流，共勉。
