前言
- 在
Android
開發中,主要的資料儲存有5種,具體如下
其中,SQLite
資料庫的儲存方式 非常常用
- 今天我將帶大家全面瞭解關於
Android
SQLite
資料庫的操作(增、刪、查、改)
目錄
1. SQLlite資料庫 簡介
2. SQLiteOpenHelper類
2.1 簡介
2.2 SQLiteOpenHelper類 常用方法
/**
* 建立資料庫
*/
// 1. 建立 or 開啟 可讀/寫的資料庫(通過 返回的SQLiteDatabase物件 進行操作)
getWritableDatabase()
// 2. 建立 or 開啟 可讀的資料庫(通過 返回的SQLiteDatabase物件 進行操作)
getReadableDatabase()
// 3. 資料庫第1次建立時 則會呼叫,即 第1次呼叫 getWritableDatabase() / getReadableDatabase()時呼叫
// 在繼承SQLiteOpenHelper類的子類中複寫
onCreate(SQLiteDatabase db)
// 4. 資料庫升級時自動呼叫
// 在繼承SQLiteOpenHelper類的子類中複寫
onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
// 5. 關閉資料庫
close()
/**
* 資料庫操作(增、刪、減、查)
*/
// 1. 查詢資料
(Cursor) query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit)
// 查詢指定的資料表返回一個帶遊標的資料集。
// 各引數說明:
// table:表名稱
// colums:列名稱陣列
// selection:條件子句,相當於where
// selectionArgs:條件語句的引數陣列
// groupBy:分組
// having:分組條件
// orderBy:排序類
// limit:分頁查詢的限制
// Cursor:返回值,相當於結果集ResultSet
(Cursor) rawQuery(String sql, String[] selectionArgs)
//執行一個預置的SQL語句,返回帶遊標的資料集(與上面的語句最大的區別 = 防止SQL隱碼攻擊)
// 2. 刪除資料行
(int) delete(String table,String whereClause,String[] whereArgs)
// 3. 新增資料行
(long) insert(String table,String nullColumnHack,ContentValues values)
// 4. 更新資料行
(int) update(String table, ContentValues values, String whereClause, String[] whereArgs)
// 5. 執行一個SQL語句,可以是一個select or 其他sql語句
// 即 直接使用String型別傳入sql語句 & 執行
(void) execSQL(String sql)
複製程式碼
3. 具體使用
- 使用步驟 = 自定義資料庫子類(繼承
SQLiteOpenHelper
類)、建立資料庫 & 運算元據庫(增、刪、查、改) - 下面,我將逐一介紹每個步驟
3.1 自定義資料庫子類(繼承 SQLiteOpenHelper 類)
/**
* 建立資料庫子類,繼承自SQLiteOpenHelper類
* 需 複寫 onCreat()、onUpgrade()
*/
public class DatabaseHelper extends SQLiteOpenHelper {
// 資料庫版本號
private static Integer Version = 1;
/**
* 建構函式
* 在SQLiteOpenHelper的子類中,必須有該建構函式
*/
public DatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory,
int version) {
// 引數說明
// context:上下文物件
// name:資料庫名稱
// param:一個可選的遊標工廠(通常是 Null)
// version:當前資料庫的版本,值必須是整數並且是遞增的狀態
// 必須通過super呼叫父類的建構函式
super(context, name, factory, version);
}
/**
* 複寫onCreate()
* 呼叫時刻:當資料庫第1次建立時呼叫
* 作用:建立資料庫 表 & 初始化資料
* SQLite資料庫建立支援的資料型別: 整型資料、字串型別、日期型別、二進位制
*/
@Override
public void onCreate(SQLiteDatabase db) {
// 建立資料庫1張表
// 通過execSQL()執行SQL語句(此處建立了1個名為person的表)
String sql = "create table person(id integer primary key autoincrement,name varchar(64),address varchar(64))";
db.execSQL(sql);
// 注:資料庫實際上是沒被建立 / 開啟的(因該方法還沒呼叫)
// 直到getWritableDatabase() / getReadableDatabase() 第一次被呼叫時才會進行建立 / 開啟
}
/**
* 複寫onUpgrade()
* 呼叫時刻:當資料庫升級時則自動呼叫(即 資料庫版本 發生變化時)
* 作用:更新資料庫表結構
* 注:建立SQLiteOpenHelper子類物件時,必須傳入一個version引數,該引數 = 當前資料庫版本, 若該版本高於之前版本, 就呼叫onUpgrade()
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 引數說明:
// db : 資料庫
// oldVersion : 舊版本資料庫
// newVersion : 新版本資料庫
// 使用 SQL的ALTER語句
String sql = "alter table person add sex varchar(8)";
db.execSQL(sql);
}
}
複製程式碼
3.2 建立資料庫:getWritableDatabase()、getReadableDatabase()
// 步驟1:建立DatabaseHelper物件
// 注:此時還未建立資料庫
SQLiteOpenHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,"test_carson");
// 步驟2:真正建立 / 開啟資料庫
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase(); // 建立 or 開啟 可讀/寫的資料庫
SQLiteDatabase sqliteDatabase = dbHelper.getReadableDatabase(); // 建立 or 開啟 可讀的資料庫
複製程式碼
注:當需運算元據庫時,都必須先建立資料庫物件 & 建立 / 開啟資料庫。
- 對於操作 = “增、刪、改(更新)”,需獲得 可"讀 / 寫"的許可權:
getWritableDatabase()
- 對於操作 = “查詢”,需獲得 可"讀 "的許可權
getReadableDatabase()
3.3 運算元據庫(增、刪、查、改)
/**
* 1. 建立 & 開啟資料庫
*/
// a. 建立DatabaseHelper物件
// 注:一定要傳入最新的資料庫版本號
SQLiteOpenHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,"test_carson",2);
// b.建立 or 開啟 可讀/寫的資料庫
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase();
/**
* 操作1:插入資料 = insert()
*/
// a. 建立ContentValues物件
ContentValues values = new ContentValues();
// b. 向該物件中插入鍵值對
values.put("id", 1);
values.put("name", "carson");
//其中,key = 列名,value = 插入的值
//注:ContentValues內部實現 = HashMap,區別在於:ContenValues Key只能是String型別,Value可儲存基本型別資料 & String型別
// c. 插入資料到資料庫當中:insert()
sqliteDatabase.insert("user", null, values);
// 引數1:要操作的表名稱
// 引數2:SQl不允許一個空列,若ContentValues是空,那麼這一列被明確的指明為NULL值
// 引數3:ContentValues物件
// 注:也可採用SQL語句插入
String sql = "insert into user (id,name) values (1,'carson')";
db.execSQL(sql) ;
/**
* 操作2:修改資料 = update()
*/
// a. 建立一個ContentValues物件
ContentValues values = new ContentValues();
values.put("name", "zhangsan");
// b. 呼叫update方法修改資料庫:將id=1 修改成 name = zhangsan
sqliteDatabase.update("user", values, "id=?", new String[] { "1" });
// 引數1:表名(String)
// 引數2:需修改的ContentValues物件
// 引數3:WHERE表示式(String),需資料更新的行; 若該引數為 null, 就會修改所有行;?號是佔位符
// 引數4:WHERE選擇語句的引數(String[]), 逐個替換 WHERE表示式中 的“?”佔位符;
// 注:呼叫完upgrate()後,則會回撥 資料庫子類的onUpgrade()
// 注:也可採用SQL語句修改
String sql = "update [user] set name = 'zhangsan' where id="1";
db.execSQL(sql);
/**
* 操作3:刪除資料 = delete()
*/
// 刪除 id = 1的資料
sqliteDatabase.delete("user", "id=?", new String[]{"1"});
// 引數1:表名(String)
// 引數2:WHERE表示式(String),需刪除資料的行; 若該引數為 null, 就會刪除所有行;?號是佔位符
// 引數3:WHERE選擇語句的引數(String[]), 逐個替換 WHERE表示式中 的“?”佔位符;
// 注:也可採用SQL語句修改
String sql = "delete from user where id="1";
db.execSQL(sql);
/**
* 操作4:查詢資料1 = rawQuery()
* 直接呼叫 SELECT 語句
*/
Cursor c = db.rawQuery("select * from user where id=?",new Stirng[]{"1"});
// 返回值一個 cursor 物件
// 通過遊標的方法可迭代查詢結果
if(cursor.moveToFirst()) {
String password = c.getString(c.getColumnIndex("password"));
}
//Cursor物件常用方法如下:
c.move(int offset); //以當前位置為參考,移動到指定行
c.moveToFirst(); //移動到第一行
c.moveToLast(); //移動到最後一行
c.moveToPosition(int position); //移動到指定行
c.moveToPrevious(); //移動到前一行
c.moveToNext(); //移動到下一行
c.isFirst(); //是否指向第一條
c.isLast(); //是否指向最後一條
c.isBeforeFirst(); //是否指向第一條之前
c.isAfterLast(); //是否指向最後一條之後
c.isNull(int columnIndex); //指定列是否為空(列基數為0)
c.isClosed(); //遊標是否已關閉
c.getCount(); //總資料項數
c.getPosition(); //返回當前遊標所指向的行數
c.getColumnIndex(String columnName);//返回某列名對應的列索引值
c.getString(int columnIndex); //返回當前行指定列的值
// 通過遊標遍歷1個名為user的表
Cursor result=db.rawQuery("SELECT _id, username, password FROM user");
result.moveToFirst();
while (!result.isAfterLast()) {
int id=result.getInt(0);
String name=result.getString(1);
String password =result.getString(2);
// do something useful with these
result.moveToNext();
}
result.close();
// 若查詢是動態的,使用該方法會複雜。此時使用 query() 會方便很多
// 注:無法使用SQL語句,即db.execSQL(sql);
/**
* 操作4:查詢資料2 = query()
* 直接呼叫 SELECT 語句
*/
// 方法說明
db.query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy);
db.query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit);
db.query(String distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit);
// 引數說明
// table:要操作的表
// columns:查詢的列所有名稱集
// selection:WHERE之後的條件語句,可以使用佔位符
// groupBy:指定分組的列名
// having指定分組條件,配合groupBy使用
// orderBy指定排序的列名
// limit指定分頁引數
// distinct可以指定“true”或“false”表示要不要過濾重複值
// 所有方法將返回一個Cursor物件,代表資料集的遊標
// 具體使用
Cursor cursor = sqliteDatabase.query("user", new String[] { "id","name" }, "id=?", new String[] { "1" }, null, null, null);
// 引數1:(String)表名
// 引數2:(String[])要查詢的列名
// 引數3:(String)查詢條件
// 引數4:(String[])查詢條件的引數
// 引數5:(String)對查詢的結果進行分組
// 引數6:(String)對分組的結果進行限制
// 引數7:(String)對查詢的結果進行排序
// 注:無法使用SQL語句,即db.execSQL(sql);
/**
* 操作5:關閉資料庫 = close()
* 注:完成資料庫操作後,記得呼叫close()關閉資料庫,從而釋放資料庫的連線
*/
sqliteDatabase.close();
/**
* 操作6:刪除資料庫 = deleteDatabase()
*/
// 刪除 名為person的資料庫
deleteDatabase("test.db");
複製程式碼
3.4 特別注意
- 除了“查詢”,所有的資料庫操作都可使用
SQL
語句,即使用下列方法代替:
db.executeSQL(String sql);
db.executeSQL(String sql, Object[] bindArgs);
// sql語句中使用佔位符,引數2 = 實際的引數集
複製程式碼
- 使用建議:都使用SQL語句,因為:
SQL
語句 通用 & 簡單
原生的方法
insert()
、delete()
等方法具備多個引數,使用複雜
4. 例項Demo
- Demo描述:建立資料庫 & 對資料庫進行操作(增、刪、查、改)
- 實現步驟:
- 實現子類繼承
SQLiteOpenHelper
類(複寫onCreat()
、onUpgrade()
) - 對資料庫進行各種操作(增、刪、查、改)
- 實現子類繼承
4.1 具體程式碼如下:
建議先下載Demo再進行閱讀:Carson的Github:DataBase_Demo
步驟1:實現子類繼承SQLiteOpenHelper類(複寫onCreat()、onUpgrade())
MySQLiteOpenHelper.java
package scut.carson_ho.database_demo;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
/**
* Created by Carson_Ho on 16/11/18.
*/
public class MySQLiteOpenHelper extends SQLiteOpenHelper {
//資料庫版本號
private static Integer Version = 1;
//在SQLiteOpenHelper的子類當中,必須有該建構函式
public MySQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory,
int version) {
//必須通過super呼叫父類當中的建構函式
super(context, name, factory, version);
}
//引數說明
//context:上下文物件
//name:資料庫名稱
//param:factory
//version:當前資料庫的版本,值必須是整數並且是遞增的狀態
public MySQLiteOpenHelper(Context context,String name,int version)
{
this(context,name,null,version);
}
public MySQLiteOpenHelper(Context context,String name)
{
this(context, name, Version);
}
//當資料庫建立的時候被呼叫
@Override
public void onCreate(SQLiteDatabase db) {
System.out.println("建立資料庫和表");
//建立了資料庫並建立一個叫records的表
//SQLite資料建立支援的資料型別: 整型資料,字串型別,日期型別,二進位制的資料型別
String sql = "create table user(id int primary key,name varchar(200))";
//execSQL用於執行SQL語句
//完成資料庫的建立
db.execSQL(sql);
//資料庫實際上是沒有被建立或者開啟的,直到getWritableDatabase() 或者 getReadableDatabase() 方法中的一個被呼叫時才會進行建立或者開啟
}
//資料庫升級時呼叫
//如果DATABASE_VERSION值被改為2,系統發現現有資料庫版本不同,即會呼叫onUpgrade()方法
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
System.out.println("更新資料庫版本為:"+newVersion);
}
}
複製程式碼
步驟2:在MainActivity裡實現需要進行的資料庫操作(增、刪、查、改)
MainActivity.java
package scut.carson_ho.database_demo;
import android.content.ContentValues;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
private Button instablish;
private Button insert;
private Button upgrade;
private Button modify;
private Button delete;
private Button query;
private Button delete_database;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//繫結按鈕
instablish = (Button) findViewById(R.id.instablish);
insert = (Button) findViewById(R.id.insert);
upgrade = (Button) findViewById(R.id.upgrade);
modify = (Button) findViewById(R.id.modify);
delete = (Button) findViewById(R.id.delete);
query = (Button) findViewById(R.id.query);
delete_database = (Button) findViewById(R.id.delete_database);
//設定監聽器
instablish.setOnClickListener(this);
insert.setOnClickListener(this);
upgrade.setOnClickListener(this);
modify.setOnClickListener(this);
delete.setOnClickListener(this);
query.setOnClickListener(this);
delete_database.setOnClickListener(this);
}
//設定每個按鈕對資料庫的操作進行控制
@Override
public void onClick(View v) {
switch (v.getId()) {
//點選建立資料庫庫
case R.id.instablish:
// 建立SQLiteOpenHelper子類物件
MySQLiteOpenHelper dbHelper = new MySQLiteOpenHelper(this,"test_carson");
//資料庫實際上是沒有被建立或者開啟的,直到getWritableDatabase() 或者 getReadableDatabase() 方法中的一個被呼叫時才會進行建立或者開啟
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase();
// SQLiteDatabase sqliteDatabase = dbHelper.getReadbleDatabase();
break;
//點選更新資料
case R.id.upgrade:
// 建立SQLiteOpenHelper子類物件
MySQLiteOpenHelper dbHelper_upgrade = new MySQLiteOpenHelper(this,"test_carson",2);
// 呼叫getWritableDatabase()方法建立或開啟一個可以讀的資料庫
SQLiteDatabase sqliteDatabase_upgrade = dbHelper_upgrade.getWritableDatabase();
// SQLiteDatabase sqliteDatabase = dbHelper.getReadbleDatabase();
break;
//點選插入資料到資料庫
case R.id.insert:
System.out.println("插入資料");
// 建立SQLiteOpenHelper子類物件
////注意,一定要傳入最新的資料庫版本號
MySQLiteOpenHelper dbHelper1 = new MySQLiteOpenHelper(this,"test_carson",2);
// 呼叫getWritableDatabase()方法建立或開啟一個可以讀的資料庫
SQLiteDatabase sqliteDatabase1 = dbHelper1.getWritableDatabase();
// 建立ContentValues物件
ContentValues values1 = new ContentValues();
// 向該物件中插入鍵值對
values1.put("id", 1);
values1.put("name", "carson");
// 呼叫insert()方法將資料插入到資料庫當中
sqliteDatabase1.insert("user", null, values1);
// sqliteDatabase.execSQL("insert into user (id,name) values (1,'carson')");
//關閉資料庫
sqliteDatabase1.close();
break;
//點選查詢資料庫
case R.id.query:
System.out.println("查詢資料");
// 建立DatabaseHelper物件
MySQLiteOpenHelper dbHelper4 = new MySQLiteOpenHelper(MainActivity.this,"test_carson",2);
// 呼叫getWritableDatabase()方法建立或開啟一個可以讀的資料庫
SQLiteDatabase sqliteDatabase4 = dbHelper4.getReadableDatabase();
// 呼叫SQLiteDatabase物件的query方法進行查詢
// 返回一個Cursor物件:由資料庫查詢返回的結果集物件
Cursor cursor = sqliteDatabase4.query("user", new String[] { "id",
"name" }, "id=?", new String[] { "1" }, null, null, null);
String id = null;
String name = null;
//將游標移動到下一行,從而判斷該結果集是否還有下一條資料
//如果有則返回true,沒有則返回false
while (cursor.moveToNext()) {
id = cursor.getString(cursor.getColumnIndex("id"));
name = cursor.getString(cursor.getColumnIndex("name"));
//輸出查詢結果
System.out.println("查詢到的資料是:"+"id: "+id+" "+"name: "+name);
}
//關閉資料庫
sqliteDatabase4.close();
break;
//點選修改資料
case R.id.modify:
System.out.println("修改資料");
// 建立一個DatabaseHelper物件
// 將資料庫的版本升級為2
// 傳入版本號為2,大於舊版本(1),所以會呼叫onUpgrade()升級資料庫
MySQLiteOpenHelper dbHelper2 = new MySQLiteOpenHelper(MainActivity.this,"test_carson", 2);
// 呼叫getWritableDatabase()得到一個可寫的SQLiteDatabase物件
SQLiteDatabase sqliteDatabase2 = dbHelper2.getWritableDatabase();
// 建立一個ContentValues物件
ContentValues values2 = new ContentValues();
values2.put("name", "zhangsan");
// 呼叫update方法修改資料庫
sqliteDatabase2.update("user", values2, "id=?", new String[]{"1"});
//關閉資料庫
sqliteDatabase2.close();
break;
//點選刪除資料
case R.id.delete:
System.out.println("刪除資料");
// 建立DatabaseHelper物件
MySQLiteOpenHelper dbHelper3 = new MySQLiteOpenHelper(MainActivity.this,"test_carson",2);
// 呼叫getWritableDatabase()方法建立或開啟一個可以讀的資料庫
SQLiteDatabase sqliteDatabase3 = dbHelper3.getWritableDatabase();
//刪除資料
sqliteDatabase3.delete("user", "id=?", new String[]{"1"});
//關閉資料庫
sqliteDatabase3.close();
break;
//點選刪除資料庫
case R.id.delete_database:
System.out.println("刪除資料庫");
MySQLiteOpenHelper dbHelper5 = new MySQLiteOpenHelper(MainActivity.this,
"test_carson",2);
// 呼叫getReadableDatabase()方法建立或開啟一個可以讀的資料庫
SQLiteDatabase sqliteDatabase5 = dbHelper5.getReadableDatabase();
//刪除名為test.db資料庫
deleteDatabase("test_carson");
break;
default:
break;
}
}
}
複製程式碼
步驟3:在主佈局檔案設定按鈕控制資料庫的操作 activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="scut.carson_ho.database_demo.MainActivity">
<Button
android:id="@+id/instablish"
android:layout_centerHorizontal="true"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="建立資料庫"/>
<Button
android:id="@+id/upgrade"
android:layout_below="@+id/instablish"
android:layout_centerHorizontal="true"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="更新資料庫"/>
<Button
android:id="@+id/insert"
android:layout_below="@+id/upgrade"
android:layout_centerHorizontal="true"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="插入資料"/>
<Button
android:id="@+id/modify"
android:layout_centerHorizontal="true"
android:layout_below="@+id/insert"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="修改資料"/>
<Button
android:id="@+id/query"
android:layout_centerHorizontal="true"
android:layout_below="@+id/modify"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="查詢資料"/>
<Button
android:id="@+id/delete"
android:layout_centerHorizontal="true"
android:layout_below="@+id/query"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="刪除資料"/>
<Button
android:id="@+id/delete_database"
android:layout_centerHorizontal="true"
android:layout_below="@+id/delete"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="刪除資料庫"/>
</RelativeLayout>
複製程式碼
4.2 測試結果
-
介面顯示
-
按順序點選:建立 - 更新 - 插入 - 查詢 - 修改 - 查詢 - 刪除資料
4.3 Demo地址
5. 總結
- 本文全面介紹了
Android SQLite
資料庫中所有知識 - 接下來,我會繼續介紹
Android
中的常用資料庫 的庫,如Realm
、GreenDao3.0
和 騰訊剛開源的WCDB
,有興趣可以繼續關注Carson_Ho的安卓開發筆記