谨以文章记录学习历程，如有错误还请指明。

前言

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开发笔记
不定期分享Android开发相关的技术干货，期待与你的交流，共勉。

Android SQLite的使用

前言

SQlite的特点

SQLite的使用

总结

猜你喜欢