Android開發11：SQLite數據庫

黎老師的視頻網上沒有了，不能看教學視頻了，找了個參加這個培訓的學員的博客看，學學。
參照http://www.blogjava.net/changcheng/archive/2010/03/01/314214.html

一、SQLite簡介

在Android平臺上，集成了一個嵌入式關係型數據庫—SQLite，SQLite3支持 NULL、INTEGER、REAL（浮點數字）、TEXT(字符串文本)和BLOB(二進制對象)數據類型，雖然它支持的類型雖然只有五種，但實際上sqlite3也接受varchar(n)、char(n)、decimal(p,s) 等數據類型，只不過在運算或保存時會轉成對應的五種數據類型。 SQLite最大的特點是你可以保存任何類型的數據到任何字段中，無論這列聲明的數據類型是什麼。例如：可以在Integer字段中存放字符串，或者在布爾型字段中存放浮點數，或者在字符型字段中存放日期型值。 但有一種情況例外：定義爲INTEGER PRIMARY KEY的字段只能存儲64位整數， 當向這種字段中保存除整數以外的數據時，將會產生錯誤。另外， SQLite 在解析CREATE TABLE 語句時，會忽略 CREATE TABLE 語句中跟在字段名後面的數據類型信息。

二、SQLite的CURD

Android提供了一個名爲SQLiteDatabase的類，該類封裝了一些操作數據庫的API，使用該類可以完成對數據進行添加(Create)、查詢(Retrieve)、更新(Update)和刪除(Delete)操作（這些操作簡稱爲CRUD）。對SQLiteDatabase的學習，我們應該重點掌握execSQL()和rawQuery()方法。 execSQL()方法可以執行insert、delete、update和CREATE TABLE之類有更改行爲的SQL語句； rawQuery()方法可以執行select語句。SQLiteDatabase還專門提供了對應於添加、刪除、更新、查詢的操作方法： insert()、delete()、update()和query() 。這些方法實際上是給那些不太瞭解SQL語法的菜鳥使用的，對於熟悉SQL語法的程序員而言，直接使用execSQL()和rawQuery()方法執行SQL語句就能完成數據的添加、刪除、更新、查詢操作。

三、SQLite的事務管理

使用SQLiteDatabase的beginTransaction()方法可以開啓一個事務，程序執行到endTransaction() 方法時會檢查事務的標誌是否爲成功，如果爲成功則提交事務，否則回滾事務。當應用需要提交事務，必須在程序執行到endTransaction()方法之前使用setTransactionSuccessful() 方法設置事務的標誌爲成功，如果不調用setTransactionSuccessful() 方法，默認會回滾事務。

三、SQLite創建、更新數據表

如果應用使用到了SQLite數據庫，在用戶初次使用軟件時，需要創建應用使用到的數據庫表結構及添加一些初始化記錄，另外在軟件升級的時候，也需要對數據表結構進行更新。在Android系統，爲我們提供了一個名爲SQLiteOpenHelper的類，該類用於對數據庫版本進行管理，該類是一個抽象類，必須繼承它才能使用。爲了實現對數據庫版本進行管理，SQLiteOpenHelper類有兩種重要的方法，分別是onCreate(SQLiteDatabase db)和onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)

當調用SQLiteOpenHelper的getWritableDatabase()或者getReadableDatabase()方法獲取用於操作數據庫的SQLiteDatabase實例的時候，如果數據庫不存在，Android系統會自動生成一個數據庫，接着調用onCreate()方法，onCreate()方法在初次生成數據庫時纔會被調用，在onCreate()方法裏可以生成數據庫表結構及添加一些應用使用到的初始化數據。onUpgrade()方法在數據庫的版本發生變化時會被調用，數據庫的版本是由程序員控制的，假設數據庫現在的版本是1，由於業務的需要，修改了數據庫表的結構，這時候就需要升級軟件，升級軟件時希望更新用戶手機裏的數據庫表結構，爲了實現這一目的，可以把原來的數據庫版本設置爲2(或其他數值)，並且在onUpgrade()方法裏面實現表結構的更新。當軟件的版本升級次數比較多，這時在onUpgrade()方法裏面可以根據原版號和目標版本號進行判斷，然後作出相應的表結構及數據更新。

getWritableDatabase()和getReadableDatabase()方法都可以獲取一個用於操作數據庫的SQLiteDatabase實例。但getWritableDatabase() 方法以讀寫方式打開數據庫，一旦數據庫的磁盤空間滿了，數據庫就只能讀而不能寫，倘若使用的是getWritableDatabase() 方法就會出錯。getReadableDatabase()方法先以讀寫方式打開數據庫，如果數據庫的磁盤空間滿了，就會打開失敗，當打開失敗後會繼續嘗試以只讀方式打開數據庫。

示例程序

Contact.java

package com.wuhuiwen.sqlite.entity; /** * 實體類Contact * * @author wuhuiwen * */ public class Contact { private Integer _id; private String name; private String phone; /** * */ public Contact() { super(); } /** * @param name * @param phone */ public Contact(String name, String phone) { super(); this.name = name; this.phone = phone; } public Contact(Integer id, String name, String phone) { super(); _id = id; this.name = name; this.phone = phone; } /** * @return */ public Integer get_id() { return _id; } /** * @param id */ public void set_id(Integer id) { _id = id; } /** * @return */ public String getName() { return name; } /** * @param name */ public void setName(String name) { this.name = name; } /** * @return */ public String getPhone() { return phone; } /** * @param phone */ public void setPhone(String phone) { this.phone = phone; } /* (non-Javadoc) * @see java.lang.Object#toString() */ @Override public String toString() { return "Contants [id=" + _id + ", name=" + name + ", phone=" + phone + "]"; } }

MySQLiteOpenHelper.java

package com.wuhuiwen.sqlite; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteOpenHelper; public class MySQLiteOpenHelper extends SQLiteOpenHelper { private static final String name = "contacts"; // 數據庫名稱 private static final int version = 1; // 數據庫版本 public MySQLiteOpenHelper(Context context) { /* * CursorFactory指定在執行查詢時獲得一個遊標實例的工廠類。 設置爲null，則使用系統默認的工廠類。 */ super(context, name, null, version); } @Override public void onCreate(SQLiteDatabase sqldb) { // 創建contacts表，SQL表達式時提供的字段類型和長度僅爲提高代碼的可讀性。 sqldb.execSQL("CREATE TABLE IF NOT EXISTS contacts(" + "_id integer primary key autoincrement," + "name varchar(20)," + "phone varchar(50))"); } @Override public void onUpgrade(SQLiteDatabase sqldb, int arg1, int arg2) { sqldb.execSQL("DROP TABLE IF EXISTS contacts"); this.onCreate(sqldb); } }

ContactsService

package com.wuhuiwen.sqlite.service; import java.util.ArrayList; import java.util.List; import android.content.Context; import android.database.Cursor; import com.wuhuiwen.sqlite.MySQLiteOpenHelper; import com.wuhuiwen.sqlite.entity.Contact; public class ContactsService { private MySQLiteOpenHelper openHelper; /** * @param context */ public ContactsService(Context context) { this.openHelper = new MySQLiteOpenHelper(context); } /** * 保存 * * @param contact */ public void save(Contact contact) { String sql = "INSERT INTO contacts (name, phone) VALUES (?, ?)"; Object[] bindArgs = { contact.getName(), contact.getPhone() }; this.openHelper.getWritableDatabase().execSQL(sql, bindArgs); } /** * 查找 * * @param id * @return */ public Contact find(Integer id) { String sql = "SELECT _id,name, phone FROM contacts WHERE _id=?"; String[] selectionArgs = { id + "" }; Cursor cursor = this.openHelper.getReadableDatabase().rawQuery(sql, selectionArgs); if (cursor.moveToFirst()) return new Contact(cursor.getInt(0), cursor.getString(1), cursor .getString(2)); return null; } /** * 更新 * * @param contact */ public void update(Contact contact) { String sql = "UPDATE contacts SET name=?, phone=? WHERE _id=?"; Object[] bindArgs = { contact.getName(), contact.getPhone(), contact.get_id() }; this.openHelper.getWritableDatabase().execSQL(sql, bindArgs); } /** * 刪除 * * @param id */ public void delete(Integer id) { String sql = "DELETE FROM contacts WHERE _id=?"; Object[] bindArgs = { id }; this.openHelper.getReadableDatabase().execSQL(sql, bindArgs); } /** * 獲取記錄數量 * * @return */ public long getCount() { String sql = "SELECT count(*) FROM contacts"; Cursor cursor = this.openHelper.getReadableDatabase().rawQuery(sql, null); cursor.moveToFirst(); return cursor.getLong(0); } /** * 獲取分頁數據 * * @param startIndex * @param maxCount * @return */ public List<Contact> getScrollData(long startIndex, long maxCount) { String sql = "SELECT _id,name,phone FROM contacts LIMIT ?,?"; String[] selectionArgs = { String.valueOf(startIndex), String.valueOf(maxCount) }; Cursor cursor = this.openHelper.getReadableDatabase().rawQuery(sql, selectionArgs); List<Contact> contacts = new ArrayList<Contact>(); while (cursor.moveToNext()) { Contact contact = new Contact(cursor.getInt(0), cursor.getString(1), cursor.getString(2)); contacts.add(contact); } return contacts; } /** * 獲取分頁數據，提供給SimpleCursorAdapter使用。 * * @param startIndex * @param maxCount * @return */ public Cursor getScrollDataCursor(long startIndex, long maxCount) { String sql = "SELECT _id,name,phone FROM contacts LIMIT ?,?"; String[] selectionArgs = { String.valueOf(startIndex), String.valueOf(maxCount) }; Cursor cursor = this.openHelper.getReadableDatabase().rawQuery(sql, selectionArgs); return cursor; } }

ContactsServiceTest

package com.wuhuiwen.sqlite.test; import java.util.List; import android.database.Cursor; import android.test.AndroidTestCase; import android.util.Log; import com.wuhuiwen.sqlite.MySQLiteOpenHelper; import com.wuhuiwen.sqlite.entity.Contact; import com.wuhuiwen.sqlite.service.ContactsService; public class ContactsServiceTest extends AndroidTestCase { private static final String TAG = "ContactsServiceTest"; // 測試創建表 public void testCreateTable() throws Throwable { MySQLiteOpenHelper openHelper = new MySQLiteOpenHelper(this .getContext()); openHelper.getWritableDatabase(); } // 測試save public void testSave() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); Contact contact1 = new Contact(null, "zhangfei", "110"); Contact contact2 = new Contact(null, "guanyu", "111"); Contact contact3 = new Contact(null, "zhaoyun", "112"); Contact contact4 = new Contact(null, "liubei", "113"); contactsService.save(contact1); contactsService.save(contact2); contactsService.save(contact3); contactsService.save(contact4); } // 測試find public void testFind() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); Contact contact = contactsService.find(1); Log.i(TAG, contact.toString()); } // 測試update public void testUpdate() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); Contact contact = contactsService.find(1); contact.setPhone("116"); contactsService.update(contact); } // 測試getCount public void testGetCount() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); Log.i(TAG, contactsService.getCount() + ""); } // 測試getScrollData public void testGetScrollData() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); List<Contact> contacts = contactsService.getScrollData(0, 3); Log.i(TAG, contacts.toString()); } // 測試getScrollDataCursor public void testGetScrollDataCursor() throws Throwable { ContactsService contactsService = new ContactsService(this.getContext()); Cursor cursor = contactsService.getScrollDataCursor(0, 3); while (cursor.moveToNext()) { Contact contact = new Contact(cursor.getInt(0), cursor.getString(1), cursor.getString(2)); Log.i(TAG, contact.toString()); } } }

main.xml

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" > <ListView android:id="@+id/lv_listview" android:layout_width="fill_parent" android:layout_height="fill_parent" /> </LinearLayout>

contactitem.xml

<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="wrap_content" android:layout_height="wrap_content"> <TextView android:id="@+id/tv_id" android:layout_width="30dip" android:layout_height="wrap_content" /> <TextView android:id="@+id/tv_name" android:layout_width="150dip" android:layout_height="wrap_content" android:layout_toRightOf="@id/tv_id" android:layout_marginTop="@id/tv_id" /> <TextView android:id="@+id/tv_phone" android:layout_width="150dip" android:layout_height="wrap_content" android:layout_toRightOf="@id/tv_name" android:layout_marginTop="@id/tv_name" /> </RelativeLayout >

SQLiteActivity.java

package com.wuhuiwen.sqlite; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import android.app.Activity; import android.os.Bundle; import android.view.View; import android.widget.AdapterView; import android.widget.ListView; import android.widget.SimpleAdapter; import android.widget.Toast; import android.widget.AdapterView.OnItemClickListener; import com.wuhuiwen.sqlite.entity.Contact; import com.wuhuiwen.sqlite.service.ContactsService; public class SQLiteActivity extends Activity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // 獲取分頁數據 ContactsService contactsService = new ContactsService(this); List<Contact> contacts = contactsService.getScrollData(0, 3); // 獲取ListView ListView lv = (ListView) this.findViewById(R.id.lv_listview); // 生成List<? extends Map<String, ?>>數據 List<HashMap<String, Object>> data = new ArrayList<HashMap<String, Object>>(); for (Contact contact : contacts) { HashMap<String, Object> item = new HashMap<String, Object>(); item.put("_id", contact.get_id()); item.put("name", contact.getName()); item.put("phone", contact.getPhone()); data.add(item); } // 生成Adapter SimpleAdapter adapter = new SimpleAdapter(this, data, R.layout.contactitem, new String[] { "_id", "name", "phone" }, new int[] { R.id.tv_id, R.id.tv_name, R.id.tv_phone }); // 設置ListView適配器 lv.setAdapter(adapter); // 爲ListView添加事件 lv.setOnItemClickListener(new OnItemClickListener() { @SuppressWarnings("unchecked") @Override public void onItemClick(AdapterView<?> parent, View view, int position, long id) { HashMap<String, Object> item = (HashMap<String, Object>) parent .getItemAtPosition((int) id); Toast.makeText(SQLiteActivity.this, item.get("name").toString(), 1).show(); } }); } }

package com.wuhuiwen.sqlite; import android.app.Activity; import android.database.Cursor; import android.os.Bundle; import android.view.View; import android.widget.AdapterView; import android.widget.ListView; import android.widget.SimpleCursorAdapter; import android.widget.Toast; import android.widget.AdapterView.OnItemClickListener; import com.wuhuiwen.sqlite.service.ContactsService; public class SQLiteActivity extends Activity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // 獲取分頁數據 ContactsService contactsService = new ContactsService(this); Cursor cursor = contactsService.getScrollDataCursor(0, 3); // 獲取ListView ListView lv = (ListView) this.findViewById(R.id.lv_listview); // 創建Adapter SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, R.layout.contactitem, cursor, new String[] { "_id", "name", "phone" }, new int[] { R.id.tv_id, R.id.tv_name, R.id.tv_phone }); // 設置ListView適配器 lv.setAdapter(adapter); // 爲ListView添加事件 lv.setOnItemClickListener(new OnItemClickListener() { @Override public void onItemClick(AdapterView<?> parent, View view, int position, long id) { Cursor cursor = (Cursor) parent .getItemAtPosition((int) position); Toast.makeText(SQLiteActivity.this, cursor.getString(1), 1) .show(); } }); } }

運行有錯，沒解決