1. /*
2. Android提供了一個名為SQLiteDatabase的類,該類封裝了一些操作資料庫的API,使用該類可以完成對資料進行添加(Create)、查詢(Retrieve)、更新(Update)和删除(Delete) 操作(這些操作簡稱為CRUD)。對SQLiteDatabase的學習,我們應該重點掌握execSQL()和rawQuery()方法。 execSQL()方法可以執行insert、delete、update和CREATE TABLE之類有更改行為的SQL語句; rawQuery()方法用于執行select語句。
3. execSQL()方法的使用例子:
4. SQLiteDatabase db = ....;
5. db.execSQL("insert into person(name, age) values(' 測試資料', 4)");
6. db.close();
7. 執行上面SQL語句會往person表中添加進一條記錄,在實際應用中, 語句中的“測試資料”這些參數值會由使用者輸入界面提供,如果把使用者輸入的内容原樣組拼到上面的insert語句, 當使用者輸入的内容含有單引号時,組拼出來的SQL語句就會存在文法錯誤。要解決這個問題需要對單引号進行轉義,也就是把單引号轉換成兩個單引号。有些時候使用者往往還會輸入像 “ & ”這些特殊SQL符号,為保證組拼好的SQL語句文法正确,必須對SQL語句中的這些特殊SQL符号都進行轉義,顯然,對每條SQL語句都做這樣的處理工作是比較煩瑣的。 SQLiteDatabase類提供了一個重載後的 execSQL(String sql, Object[] bindArgs)方法,使用這個方法可以解決前面提到的問題,因為這個方法支援使用占位符參數(?)。使用例子如下:
8. SQLiteDatabase db = ....;
9. db.execSQL("insert into person(name, age) values(?,?)", new Object[] {"測試資料", 4});
10. db.close();
11. execSQL(String sql, Object[] bindArgs)方法的第一個參數為SQL語句,第二個參數為SQL語句中占位符參數的值,參數值在數組中的順序要和占位符的位置對應。
12. */
1. public class DatabaseHelper extends SQLiteOpenHelper {
2. //類沒有執行個體化,是不能用作父類構造器的參數,必須聲明為靜态
3. private static final String name = "itcast"; //資料庫名稱
4. private static final int version = 1; //資料庫版本
5. public DatabaseHelper(Context context) {
6. //第三個參數CursorFactory指定在執行查詢時獲得一個遊标執行個體的工廠類,設定為null,代表使用系統預設的工廠類
7. super(context, name, null, version);
8. }
9. @Override public void onCreate(SQLiteDatabase db) {
10. db.execSQL("CREATE TABLE IF NOT EXISTS person (personid integer primary key autoincrement, name varchar(20), age INTEGER)");
11. }
12. @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
13. db.execSQL(" ALTER TABLE person ADD phone VARCHAR(12) NULL "); //往表中增加一列
14. // DROP TABLE IF EXISTS person 删除表
15. }
16. }
17. //在實際項目開發中,當資料庫表結構發生更新時,應該避免使用者存放于數//據庫中的資料丢失。
1. /*
2. SQLiteDatabase的rawQuery() 用于執行 select語句,使用例子如下: SQLiteDatabase db = ....;
3. Cursor cursor = db.rawQuery(“select * from person”, null);
4. while (cursor.moveToNext()) {
5. int personid = cursor.getInt(0); // 擷取第一列的值,第一列的索引從0開始
6. String name = cursor.getString(1);//擷取第二列的值
7. int age = cursor.getInt(2); //擷取第三列的值
8. }
9. cursor.close();
10. db.close();
11. rawQuery()方法的第一個參數為select語句;第二個參數為select語句中占位符參數的值,如果select語句沒有使用占位符,該參數可以設定為null。帶占位符參數的select語句使用例子如下:
12. Cursor cursor = db.rawQuery("select * from person where name like ? and age=?", new String[] {"%傳智%", "4"});
13. Cursor是結果集遊标,用于對結果集進行随機通路,如果大家熟悉jdbc, 其實Cursor與JDBC中的 ResultSet作用很相似。使用moveToNext()方法可以将遊标從目前行移動到下一行,如果已經移過了結果集的最後一行,傳回結果為 false,否則為true。另外Cursor 還有常用的moveToPrevious()方法(用于将遊标從目前行移動到上一行,如果已經移過了結果集的第一行,傳回值為false,否則為true )、moveToFirst()方法(用于将遊标移動到結果集的第一行,如果結果集為空,傳回值為 false,否則為true )和moveToLast()方法(用于将遊标移動到結果集的最後一行,如果結果集為空,傳回值為false,否則為 true ) 。
14.
15. */
2. 除了前面給大家介紹的execSQL()和rawQuery()方法, SQLiteDatabase還專門提供了對應于添加、删除、更新、查詢的操作方法: insert()、delete()、update()和 query() 。這些方法實際上是給那些不太了解SQL文法的菜鳥使用的,對于熟悉SQL文法的程式員而言,直接使用execSQL()和 rawQuery()方法執行SQL語句就能完成資料的添加、删除、更新、查詢操作。
3. Insert()方法用于添加資料,各個字段的資料使用 ContentValues進行存放。 ContentValues類似于MAP,相對于MAP,它提供了存取資料對應的 put(String key, Xxx value)和getAsXxx(String key)方法, key為字段名稱,value為字段值,Xxx指的是各種常用的資料類型,如:String、Integer等。
4. SQLiteDatabase db = databaseHelper.getWritableDatabase();
5. ContentValues values = new ContentValues();
6. values.put("name", "測試資料");
7. values.put("age", 4);
8. long rowid = db.insert(“person”, null, values); //傳回新添記錄的行号,與主鍵id無關
9. 不管第三個參數是否包含資料,執行Insert()方法必然會添加一條記錄,如果第三個參數為空,會添加一條除主鍵之外其他字段值為Null的記錄。Insert()方法内部實際上通過構造insert SQL語句完成資料的添加,Insert()方法的第二個參數用于指定空值字段的名稱,相信大家對該參數會感到疑惑,該參數的作用是什麼?是這樣的:如果第三個參數values 為Null或者元素個數為0, 由于 Insert()方法要求必須添加一條除了主鍵之外其它字段為Null值的記錄,為了滿足SQL文法的需要, insert語句必須給定一個字段名,如:insert into person(name) values(NULL),倘若不給定字段名 , insert語句就成了這樣: insert into person() values(),顯然這不滿足标準SQL的文法。對于字段名,建議使用主鍵之外的字段,如果使用了 INTEGER類型的主鍵字段,執行類似insert into person(personid) values(NULL)的insert語句後,該主鍵字段值也不會為NULL。如果第三個參數values 不為Null并且元素的個數大于0 ,可以把第二個參數設定為null。
10. */
2. delete()方法的使用:
3. SQLiteDatabase db = databaseHelper.getWritableDatabase();
4. db.delete("person", "personid<?", new String[]{"2"});
5. db.close();
6. 上面代碼用于從person表中删除personid小于2的記錄。
7. update()方法的使用:
8. SQLiteDatabase db = databaseHelper.getWritableDatabase();
9. ContentValues values = new ContentValues();
10. values.put(“name”, “測試資料”);//key為字段名,value為值
11. db.update("person", values, "personid=?", new String[]{"1"});
12. db.close();
13. 上面代碼用于把person表中personid等于1的記錄的 name字段的值改為“測試資料”。
2. query()方法實際上是把select語句拆分成了若幹個組成部分,然後作為方法的輸入參數:
4. Cursor cursor = db.query("person", new String[] {"personid,name,age"}, "name like ?", new String[]{"%傳智 %"}, null, null, "personid desc", "1,2");
5. while (cursor.moveToNext()) {
6. int personid = cursor.getInt(0); // 擷取第一列的值,第一列的索引從0開始
7. String name = cursor.getString(1);//擷取第二列的值
8. int age = cursor.getInt(2); //擷取第三列的值
9. }
10. cursor.close();
11. db.close();
12. 上面代碼用于從person表中查找name字段含有“傳智”的記錄,比對的記錄按personid降序排序,對排序後的結果略過第一條記錄,隻擷取2條記錄。
13. query(table, columns, selection, selectionArgs, groupBy, having, orderBy, limit) 方法各參數的含義:
14. table:表名。相當于select語句from關鍵字後面的部分。如果是多表聯合查詢,可以用逗号将兩個表名分開。
15. columns:要查詢出來的列名。相當于select語句 select關鍵字後面的部分。
16. selection:查詢條件子句,相當于select語句where關鍵字後面的部分,在條件子句允許使用占位符 “?”
17. selectionArgs:對應于selection語句中占位符的值,值在數組中的位置與占位符在語句中的位置必須一緻,否則就會有異常。
18. groupBy:相當于select語句group by關鍵字後面的部分
19. having:相當于select語句having關鍵字後面的部分
20. orderBy:相當于select語句order by關鍵字後面的部分,如:personid desc, age asc;
21. limit:指定偏移量和擷取的記錄數,相當于select語句limit關鍵字後面的部分。
22. */
1. package com.zyq.db;
2. import android.app.Activity;
3. import android.os.Bundle;
4. public class MainActivity extends Activity
5. {
6. @Override
7. public void onCreate(Bundle savedInstanceState)
8. {
9. super.onCreate(savedInstanceState);
10. setContentView(R.layout.main);
11. }
12. }
2. import java.util.List;
3. import android.test.AndroidTestCase;
4. import android.util.Log;
5. import com.zyq.service.DBOpenHelper;
6. import com.zyq.service.PersonService;
7. import com.zyq.voo.Person;
8.
9. /**
10. * 測試方法 通過Junit 單元測試
11. * 1.>執行個體化測試類
12. * 2.>把與應用有關的上下文資訊傳入到測試類執行個體
13. * 3.>運作測試方法
14. * @author Administrator
15. *
16. */
17. public class PersonServiceTest extends AndroidTestCase
18. {
19. private final static String TAG="PersonServiceTest";
20.
21. /**
22. * 測試建立資料庫
23. * @throws Throwable
24. */
25. public void testCreateDB() throws Throwable
26. {
27. DBOpenHelper dbOpenHelper=new DBOpenHelper(this.getContext());
28. dbOpenHelper.getReadableDatabase(); //Create and/or open a database.
29. }
30. /**
31. * 測試新增一條記錄
32. * @throws Throwable
33. */
34. public void testSave() throws Throwable
35. {
36. PersonService personService=new PersonService(this.getContext());
37. personService.save(new Person("zhangsan","1360215320"));
38. personService.save(new Person("lisi","1123"));
39. personService.save(new Person("lili","232"));
40. personService.save(new Person("wangda","123123"));
41. personService.save(new Person("laozhu","234532"));
42. }
43. /**
44. * 查找一條記錄
45. * @throws Throwable
46. */
47. public void testFind() throws Throwable
48. {
49. PersonService personService=new PersonService(this.getContext());
50. Person person=personService.find(1);
51. Log.i(TAG,person.toString());
52. }
53. /**
54. * 測試更新一條記錄
55. * @throws Throwable
56. */
57. public void testUpdate() throws Throwable
58. {
59. PersonService personService=new PersonService(this.getContext());
60. Person person=personService.find(1);
61. person.setName("lisi");
62. personService.update(person);
63. }
64. /**
65. * 測試得到所有記錄數
66. * @throws Throwable
67. */
68. public void testGetCount() throws Throwable
69. {
70. PersonService personService=new PersonService(this.getContext());
71. Log.i(TAG, personService.getCount()+"********");
72. }
73. /**
74. * 測試分頁
75. * @throws Throwable
76. */
77. public void testScroll() throws Throwable
78. {
79. PersonService personService=new PersonService(this.getContext());
80. List<Person> persons=personService.getScrollData(3, 3);
81. for(Person person:persons)
82. {
83. Log.i(TAG, person.toString());
84. }
85. }
86. /**
87. * 測試删除一條記錄
88. * @throws Throwable
89. */
90. public void testDelete() throws Throwable
91. {
92. PersonService personService=new PersonService(this.getContext());
93. personService.delete(5);
94. }
95. }
1. package com.zyq.service;
2. import android.content.Context;
3. import android.database.sqlite.SQLiteDatabase;
4. import android.database.sqlite.SQLiteOpenHelper;
5. public class DBOpenHelper extends SQLiteOpenHelper
6. {
7. /**
8. * 如果想額外的增加一個字段(需求)
9. * 可以把版本号更改掉 但必須 >=1
10. * 更改版本号之後 會根據版本号判斷是不是上次建立的時候 (目前的版本号和傳入的版本号是否一緻 )
11. * 如果不是會執行 onUpgrade() 方法
12. * @param context
13. */
14. public DBOpenHelper(Context context)
15. {
16. super(context, "zyq.db", null, 2);
17. }
18. /**
19. * 在資料庫建立的時候第一個調用的方法
20. * 适合建立表結構
21. */
22. @Override
23. public void onCreate(SQLiteDatabase db)
24. {
25. db.execSQL("CREATE TABLE person (personid integer primary key autoincrement, name varchar(20))");//建立表
26. }
27. /**
28. * 更新表結構 在資料庫版本号發生改變的時候調用
29. * 應用更新
30. */
31. @Override
32. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
33. {
34. db.execSQL("ALTER TABLE person ADD phone VARCHAR(12) NULL "); //往表中增加一列
35. }
36. }
1. <?xml version="1.0" encoding="utf-8"?>
2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
3. package="com.zyq.db"
4. android:versionCode="1"
5. android:versionName="1.0">
6. <application android:icon="@drawable/icon" android:label="@string/app_name">
7. <uses-library android:name="android.test.runner" />
8. <activity android:name=".MainActivity"
9. android:label="@string/app_name">
10. <intent-filter>
11. <action android:name="android.intent.action.MAIN" />
12. <category android:name="android.intent.category.LAUNCHER" />
13. </intent-filter>
14. </activity>
15. </application>
16. <uses-sdk android:minSdkVersion="8" />
17. <instrumentation android:name="android.test.InstrumentationTestRunner"
18. android:targetPackage="com.zyq.db" android:label="Tests for My App" />
19. </manifest>
2. import java.util.ArrayList;
3. import java.util.List;
4. import android.content.Context;
5. import android.database.Cursor;
6. import android.database.sqlite.SQLiteDatabase;
8. public class PersonService
9. {
10. private DBOpenHelper helper;
11. public PersonService(Context context)
12. {
13. helper=new DBOpenHelper(context);
14. }
15. /**
16. * 新增一條記錄
17. * @param person
18. */
19. public void save(Person person)
20. {
21. SQLiteDatabase db=helper.getWritableDatabase();//Create and/or open a database that will be used for reading and writing
22. db.execSQL("INSERT INTO person(name,phone) values(?,?)",new Object[]{person.getName().trim(),person.getPhone().trim()});//使用占位符進行轉譯
23. // db.close(); 不關資料庫連接配接 。可以提高性能 因為建立資料庫的時候的操作模式是私有的。
24. // 代表此資料庫,隻能被本應用所通路 單使用者的,可以維持長久的連結
25. }
26. /**
27. * 更新某一條記錄
28. * @param person
29. */
30. public void update(Person person)
31. {
32. SQLiteDatabase db=helper.getWritableDatabase();
33. db.execSQL("update person set phone=?,name=? where personid=?",
34. new Object[]{person.getPhone().trim(),person.getName().trim(),person.getId()});
36. /**
37. * 根據ID查詢某條記錄
38. * @param id
39. * @return
40. */
41. public Person find(Integer id)
42. {
43. SQLiteDatabase db=helper.getReadableDatabase();
44. Cursor cursor=db.rawQuery("select * from person where personid=?", new String[]{id.toString()});//Cursor 遊标和 ResultSet 很像
45. if(cursor.moveToFirst())//Move the cursor to the first row. This method will return false if the cursor is empty.
46. {
47. int personid=cursor.getInt(cursor.getColumnIndex("personid"));
48. String name=cursor.getString(cursor.getColumnIndex("name"));
49. String phone=cursor.getString(cursor.getColumnIndex("phone"));
50.
51. return new Person(personid,name,phone);
52. }
53. return null;
54. }
55. /**
56. * 删除某一條記錄
57. * @param id
58. */
59. public void delete(Integer id)
60. {
61. SQLiteDatabase db=helper.getWritableDatabase();
62. db.execSQL("delete from person where personid=?",
63. new Object[]{id});
64. }
65.
66. /**
67. * 得到記錄數
68. * @return
69. */
70. public long getCount()
71. {
72. SQLiteDatabase db=helper.getReadableDatabase();
73. Cursor cursor=db.rawQuery("select count(*) from person", null);
74. cursor.moveToFirst();
75. return cursor.getLong(0);
76. }
77. /**
78. * 分頁查詢方法 SQL語句跟MySQL的文法一樣
79. * @return
80. */
81. public List<Person> getScrollData(int offset,int maxResult)
82. {
83. List<Person> persons=new ArrayList<Person>();
84. SQLiteDatabase db=helper.getReadableDatabase();
85. Cursor cursor=db.rawQuery("select * from person limit ?,?",
86. new String[]{String.valueOf(offset),String.valueOf(maxResult)});
87. while (cursor.moveToNext())
88. {
89. int personid=cursor.getInt(cursor.getColumnIndex("personid"));
90. String name=cursor.getString(cursor.getColumnIndex("name"));
91. String phone=cursor.getString(cursor.getColumnIndex("phone"));
92.
93. persons.add(new Person(personid,name,phone));
94. }
95.
96. return persons;
97. }
98. }
1. package com.zyq.voo;
2. public class Person
3. {
4. private Integer id;
5. private String name;
6. private String phone;
7.
8. public Person(int personid, String name, String phone)
9. {
10. this.id=personid;
11. this.name=name;
12. this.phone=phone;
13. }
14.
15. public Person(String name, String phone)
16. {
17. this.name = name;
18. this.phone = phone;
19. }
20. public String toString()
21. {
22. return "Person [id=" + id + ", name=" + name + ", phone=" + phone + "]";
23. }
24. public Integer getId()
25. {
26. return id;
27. }
28. public void setId(Integer id)
29. {
30. this.id = id;
31. }
32. public String getName()
34. return name;
36. public void setName(String name)
37. {
38. this.name = name;
39. }
40. public String getPhone()
41. {
42. return phone;
43. }
44. public void setPhone(String phone)
45. {
46. this.phone = phone;
47. }
48.
49.
50.
51. }
apk中建立的資料庫外部的程序是沒有權限去讀/寫的。這就需要把資料庫檔案建立到sdcard上。
File dbfile = new File(DATABASE_NAME );
db = SQLiteDatabase.openOrCreateDatabase(dbfile, null);