利用SQLiteOpenHelper来管理SQLite数据库

to use to open or create the database of the database file,or null for an in-memory database to use for creating cursor objects,or null for the default number of the database (starting at 1); if the database is older, will be used to upgrade the database; if the database is newer,onDowngrade(SQLiteDatabase,int) will be used to downgrade the database

参数简述：

name————表示数据库文件名（不包括文件路径），SQLiteOpenHelper类会根据这个文件名来创建数据库文件。

version————表示数据库的版本号。如果当前传入的数据库版本号比上一次创建的版本高，SQLiteOpenHelper就会调用onUpgrade()方法。

[java] view plain copy print ?

1. publicDbHelper(Contextcontext,
2. intversion){
3. super(context,version);
4. //TODOAuto-generatedconstructorstub
5. }

public DbHelper(Context context,version); // TODO Auto-generated constructor stub }
以上是SQLiteOpenHelper 的构造函数，当数据库不存在时， 就会创建数据库，然后打开数据库（过程已经被封装起来了），再调用onCreate (SQLiteDatabase db)方法来执行创建表之类的操作。当数据库存在时，SQLiteOpenHelper 就不会调用onCreate (SQLiteDatabase db)方法了，它会检测版本号，若传入的版本号高于当前的，就会执行onUpgrade()方法来更新数据库和版本号。

3、??SQLiteOpenHelper的两个主要方法

3.1、onCreate方法

[java] view plain copy print ?

1. publicabstractvoidonCreate(SQLiteDatabasedb)<spanclass="normal"></span>

public abstract void onCreate (SQLiteDatabase db)<span class="normal"></span>

Since: API Level 1

Called when the database is created for the first time. This is where the creation of tables and the initial population of the tables should happen.

Parameters

The database. [java] view plain copy print ?

1. //这样就创建一个一个table
2. @Override
3. publicvoidonCreate(SQLiteDatabasedb){
4. //TODOAuto-generatedmethodstub
6. Stringsql="CREATETABLEtable_name(_idINTEGERPRIMARYKEY,filenameVARCHAR,dataTEXT)";
7. db.execSQL(sql);
9. }

//这样就创建一个一个table @Override public void onCreate(SQLiteDatabase db) { // TODO Auto-generated method stub String sql = "CREATE TABLE table_name(_id INTEGER PRIMARY KEY,filename VARCHAR,data TEXT)"; db.execSQL(sql); }

3.2、onUpgrade方法

[java] view plain copy print ?

1. publicabstractvoidonUpgrade(SQLiteDatabasedb,intnewVersion)

public abstract void onUpgrade (SQLiteDatabase db,int newVersion)

Since: API Level 1

Called when the database needs to be upgraded. The implementation should use this method to drop tables,add tables,or do anything else it needs to upgrade to the new schema version.

The SQLite ALTER TABLE documentation can be found here. If you add new columns you can use ALTER TABLE to insert them into a live table. If you rename or remove columns you can use ALTER TABLE to rename the old table,then create the new table and then populate the new table with the contents of the old table.

Parameters

The database. The old database version. The new database version.

更新数据库，包括删除表，添加表等各种操作。若版本是第一版，也就是刚刚建立数据库，onUpgrade()方法里面就不用写东西，因为第一版数据库何来更新之说，以后发布的版本，数据库更新的话，可以在onUpgrade()方法添加各种更新的操作。

4、注意事项

创建完SQLiteOpenHelper 类之后，在主activity里面就可以通过SQLiteOpenHelper.getWritableDatabase()或者getReadableDatabase()方法来获取在SQLiteOpenHelper 类里面创建的数据库实例。（也就是说只有调用这两种方法才真正地实例化数据库）

getWritableDatabase() 方法————以读写方式打开数据库，如果数据库所在磁盘空间满了，而使用的又是getWritableDatabase() 方法就会出错。

因为此时数据库就只能读而不能写，

getReadableDatabase()方法————则是先以读写方式打开数据库，如果数据库的磁盘空间满了，就会打开失败，但是当打开失败后会继续尝试以只读

方式打开数据库。而不会报错

=========================================================================================================

下面演示一个以SQLite的数据库为adapter的listview例子（也可以当做通讯录小工具）

效果图如下

[java] view plain copy print ?

1. /*主activity
2. *@author:conowen
3. *@date:12.3.1
4. */
5. packagecom.conowen.sqlite;
7. importandroid.app.Activity;
8. importandroid.content.ContentValues;
9. importandroid.database.Cursor;
10. importandroid.database.sqlite.SQLiteDatabase;
11. importandroid.os.Bundle;
12. importandroid.view.View;
13. importandroid.view.View.OnClickListener;
14. importandroid.widget.Button;
15. importandroid.widget.EditText;
16. importandroid.widget.ListAdapter;
17. importandroid.widget.ListView;
18. importandroid.widget.SimpleCursorAdapter;
19. importandroid.widget.Toast;
21. publicclassSqliteActivityextendsActivity{
22. SQLiteDatabasesqldb;
23. publicStringDB_NAME="sql.db";
24. publicStringDB_TABLE="num";
25. publicintDB_VERSION=1;
26. finalDbHelperhelper=newDbHelper(this,DB_NAME,null,DB_VERSION);
28. //DbHelper类在DbHelper.java文件里面创建的
30. /**Calledwhentheactivityisfirstcreated.*/
31. @Override
32. publicvoidonCreate(BundlesavedInstanceState){
33. super.onCreate(savedInstanceState);
34. setContentView(R.layout.main);
35. sqldb=helper.getWritableDatabase();
36. //通过helper的getWritableDatabase()得到SQLiteOpenHelper所创建的数据库
37. Buttoninsert=(Button)findViewById(R.id.insert);
38. Buttondelete=(Button)findViewById(R.id.delete);
39. Buttonupdate=(Button)findViewById(R.id.update);
40. Buttonquery=(Button)findViewById(R.id.query);
41. finalContentValuescv=newContentValues();
42. //ContentValues是“添加”和“更新”两个操作的数据载体
43. updatelistview();//更新listview
44. //添加insert
45. insert.setOnClickListener(newOnClickListener(){
47. @Override
48. publicvoidonClick(Viewv){
49. //TODOAuto-generatedmethodstub
50. EditTextet_name=(EditText)findViewById(R.id.name);
51. EditTextet_phone=(EditText)findViewById(R.id.phone);
52. cv.put("name",et_name.getText().toString());
53. cv.put("phone",et_phone.getText().toString());
54. //name和phone为列名
55. longres=sqldb.insert("addressbook",cv);//插入数据
56. if(res==-1){
57. Toast.makeText(SqliteActivity.this,"添加失败",
58. Toast.LENGTH_SHORT).show();
59. }else{
60. Toast.makeText(SqliteActivity.this,"添加成功",
61. Toast.LENGTH_SHORT).show();
62. }
63. updatelistview();//更新listview
64. }
65. });
66. //删除
67. delete.setOnClickListener(newOnClickListener(){
69. @Override
70. publicvoidonClick(Viewv){
71. //TODOAuto-generatedmethodstub
72. intres=sqldb.delete("addressbook","name='大钟'",null);
73. //删除列名name，行名为“大钟”的，这一行的所有数据，null表示这一行的所有数据
74. //若第二个参数为null，则删除表中所有列对应的所有行的数据，也就是把table清空了。
75. //name='大钟'，大钟要单引号的
76. //返回值为删除的行数
77. if(res==0){
78. Toast.makeText(SqliteActivity.this,"删除失败",
79. Toast.LENGTH_SHORT).show();
80. }else{
81. Toast.makeText(SqliteActivity.this,"成删除了"+res+"行的数据",
82. Toast.LENGTH_SHORT).show();
83. }
84. updatelistview();//更新listview
86. }
87. });
88. //更改
89. update.setOnClickListener(newOnClickListener(){
91. @Override
92. publicvoidonClick(Viewv){
93. //TODOAuto-generatedmethodstub
94. cv.put("name","大钟");
95. cv.put("phone","1361234567");
96. intres=sqldb.update("addressbook",cv,"name='张三'",null);
97. //把name=张三所在行的数据，全部更新为ContentValues所对应的数据
98. //返回时为成功更新的行数
99. Toast.makeText(SqliteActivity.this,"成功更新了"+res+"行的数据",
100. Toast.LENGTH_SHORT).show();
102. updatelistview();//更新listview
103. }
104. });
105. //查询
106. query.setOnClickListener(newOnClickListener(){
108. @Override
109. publicvoidonClick(Viewv){
110. //TODOAuto-generatedmethodstub
111. Cursorcr=sqldb.query("addressbook",
112. null,null);
113. //返回名为addressbook的表的所有数据
114. Toast.makeText(SqliteActivity.this,
115. "一共有"+cr.getCount()+"条记录",Toast.LENGTH_SHORT)
116. .show();
118. updatelistview();//更新listview
119. }
120. });
122. }
124. //更新listview
125. publicvoidupdatelistview(){
126. ListViewlv=(ListView)findViewById(R.id.lv);
128. finalCursorcr=sqldb.query("addressbook",
129. null,null);
130. String[]ColumnNames=cr.getColumnNames();
131. //ColumnNames为数据库的表的列名，getColumnNames()为得到指定table的所有列名
133. ListAdapteradapter=newSimpleCursorAdapter(this,R.layout.layout,
134. cr,ColumnNames,newint[]{R.id.tv1,R.id.tv2,R.id.tv3});
135. //layout为listView的布局文件，包括三个TextView，用来显示三个列名所对应的值
136. //ColumnNames为数据库的表的列名
137. //最后一个参数是int[]类型的，为view类型的id，用来显示ColumnNames列名所对应的值。view的类型为TextView
138. lv.setAdapter(adapter);
139. }
140. }

/*主activity * @author:conowen * @date:12.3.1 */ package com.conowen.sqlite; import android.app.Activity; import android.content.ContentValues; import android.database.Cursor; import android.database.sqlite.SQLiteDatabase; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.EditText; import android.widget.ListAdapter; import android.widget.ListView; import android.widget.SimpleCursorAdapter; import android.widget.Toast; public class SqliteActivity extends Activity { SQLiteDatabase sqldb; public String DB_NAME = "sql.db"; public String DB_TABLE = "num"; public int DB_VERSION = 1; final DbHelper helper = new DbHelper(this,null,DB_VERSION); // DbHelper类在DbHelper.java文件里面创建的 /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); sqldb = helper.getWritableDatabase(); // 通过helper的getWritableDatabase()得到SQLiteOpenHelper所创建的数据库 Button insert = (Button) findViewById(R.id.insert); Button delete = (Button) findViewById(R.id.delete); Button update = (Button) findViewById(R.id.update); Button query = (Button) findViewById(R.id.query); final ContentValues cv = new ContentValues(); // ContentValues是“添加”和“更新”两个操作的数据载体 updatelistview();// 更新listview // 添加insert insert.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub EditText et_name = (EditText) findViewById(R.id.name); EditText et_phone = (EditText) findViewById(R.id.phone); cv.put("name",et_name.getText().toString()); cv.put("phone",et_phone.getText().toString()); // name和phone为列名 long res = sqldb.insert("addressbook",cv);// 插入数据 if (res == -1) { Toast.makeText(SqliteActivity.this,"添加失败",Toast.LENGTH_SHORT).show(); } else { Toast.makeText(SqliteActivity.this,"添加成功",Toast.LENGTH_SHORT).show(); } updatelistview();// 更新listview } }); // 删除 delete.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub int res = sqldb.delete("addressbook","name='大钟'",null); // 删除列名name，行名为“大钟”的，这一行的所有数据，null表示这一行的所有数据 // 若第二个参数为null，则删除表中所有列对应的所有行的数据，也就是把table清空了。 // name='大钟'，大钟要单引号的 // 返回值为删除的行数 if (res == 0) { Toast.makeText(SqliteActivity.this,"删除失败","成删除了" + res + "行的数据",Toast.LENGTH_SHORT).show(); } updatelistview();// 更新listview } }); // 更改 update.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub cv.put("name","大钟"); cv.put("phone","1361234567"); int res = sqldb.update("addressbook","name='张三'",null); // 把name=张三所在行的数据，全部更新为ContentValues所对应的数据 // 返回时为成功更新的行数 Toast.makeText(SqliteActivity.this,"成功更新了" + res + "行的数据",Toast.LENGTH_SHORT).show(); updatelistview();// 更新listview } }); // 查询 query.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub Cursor cr = sqldb.query("addressbook",null); // 返回名为addressbook的表的所有数据 Toast.makeText(SqliteActivity.this,"一共有" + cr.getCount() + "条记录",Toast.LENGTH_SHORT) .show(); updatelistview();// 更新listview } }); } // 更新listview public void updatelistview() { ListView lv = (ListView) findViewById(R.id.lv); final Cursor cr = sqldb.query("addressbook",null); String[] ColumnNames = cr.getColumnNames(); // ColumnNames为数据库的表的列名，getColumnNames()为得到指定table的所有列名 ListAdapter adapter = new SimpleCursorAdapter(this,cr,new int[] { R.id.tv1,R.id.tv3 }); // layout为listView的布局文件，包括三个TextView，用来显示三个列名所对应的值 // ColumnNames为数据库的表的列名 // 最后一个参数是int[]类型的，为view类型的id，用来显示ColumnNames列名所对应的值。view的类型为TextView lv.setAdapter(adapter); } }
[java] view plain copy print ?

1. /*??SQLiteOpenHelper类
2. *@author:conowen
3. *@date:12.3.1
4. */
5. packagecom.conowen.sqlite;
7. importandroid.content.Context;
8. importandroid.database.sqlite.SQLiteDatabase;
9. importandroid.database.sqlite.SQLiteDatabase.CursorFactory;
10. importandroid.database.sqlite.SQLiteOpenHelper;
12. publicclassDbHelperextendsSQLiteOpenHelper{
14. publicDbHelper(Contextcontext,
15. intversion){
16. super(context,version);
17. //TODOAuto-generatedconstructorstub
19. }
21. @Override
22. publicvoidonCreate(SQLiteDatabasedb){
23. //TODOAuto-generatedmethodstub
25. Stringsql="CREATETABLEaddressbook(_idINTEGERPRIMARYKEY,nameVARCHAR,phoneVARCHAR)";
26. db.execSQL(sql);
28. }
30. @Override
31. publicvoidonUpgrade(SQLiteDatabasedb,intnewVersion){
32. //TODOAuto-generatedmethodstub
34. }
36. }

/*??SQLiteOpenHelper类 * @author:conowen * @date:12.3.1 */ package com.conowen.sqlite; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.database.sqlite.SQLiteOpenHelper; public class DbHelper extends SQLiteOpenHelper { public DbHelper(Context context,version); // TODO Auto-generated constructor stub } @Override public void onCreate(SQLiteDatabase db) { // TODO Auto-generated method stub String sql = "CREATE TABLE addressbook (_id INTEGER PRIMARY KEY,name VARCHAR,phone VARCHAR)"; db.execSQL(sql); } @Override public void onUpgrade(SQLiteDatabase db,int newVersion) { // TODO Auto-generated method stub } }

main.xml

[html] view plain copy print ?

1. <?xmlversion="1.0"encoding="utf-8"?>
2. <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="fill_parent"
4. android:layout_height="fill_parent"
5. android:orientation="vertical">
7. <EditText
8. android:id="@+id/name"
9. android:layout_width="fill_parent"
10. android:layout_height="wrap_content"/>
12. <EditText
13. android:id="@+id/phone"
14. android:layout_width="fill_parent"
15. android:layout_height="wrap_content"/>
17. <LinearLayout
18. android:id="@+id/linearLayout1"
19. android:layout_width="fill_parent"
20. android:layout_height="wrap_content">
22. <Button
23. android:id="@+id/insert"
24. android:layout_width="wrap_content"
25. android:layout_height="wrap_content"
26. android:text="增加"/>
28. <Button
29. android:id="@+id/delete"
30. android:layout_width="wrap_content"
31. android:layout_height="wrap_content"
32. android:text="删除"/>
34. <Button
35. android:id="@+id/update"
36. android:layout_width="wrap_content"
37. android:layout_height="wrap_content"
38. android:text="更改"/>
40. <Button
41. android:id="@+id/query"
42. android:layout_width="wrap_content"
43. android:layout_height="wrap_content"
44. android:text="查询"/>
45. </LinearLayout>
47. <ListView
48. android:id="@+id/lv"
49. android:layout_width="fill_parent"
50. android:layout_height="wrap_content">
51. </ListView>
53. </LinearLayout>

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <EditText android:id="@+id/name" android:layout_width="fill_parent" android:layout_height="wrap_content" /> <EditText android:id="@+id/phone" android:layout_width="fill_parent" android:layout_height="wrap_content" /> <LinearLayout android:id="@+id/linearLayout1" android:layout_width="fill_parent" android:layout_height="wrap_content" > <Button android:id="@+id/insert" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="增加" /> <Button android:id="@+id/delete" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="删除" /> <Button android:id="@+id/update" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="更改" /> <Button android:id="@+id/query" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="查询" /> </LinearLayout> <ListView android:id="@+id/lv" android:layout_width="fill_parent" android:layout_height="wrap_content" > </ListView> </LinearLayout>

ListView的布局文件layout.xml

[html] view plain copy print ?

1. <?xmlversion="1.0"encoding="utf-8"?>
2. <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="fill_parent"
4. android:layout_height="fill_parent"
5. android:orientation="horizontal">
6. <TextView
7. android:id="@+id/tv1"
8. android:layout_width="wrap_content"
9. android:layout_height="wrap_content"
10. android:textSize="20sp"
11. android:width="50px"/>
12. <TextView
13. android:id="@+id/tv2"
14. android:layout_width="wrap_content"
15. android:layout_height="wrap_content"
16. android:textSize="20sp"
17. android:width="50px"
18. />
19. <TextView
20. android:id="@+id/tv3"
21. android:layout_width="wrap_content"
22. android:layout_height="wrap_content"
23. android:textSize="20sp"
24. android:width="150px"/>
26. </LinearLayout>

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="horizontal" > <TextView android:id="@+id/tv1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="20sp" android:width="50px" /> <TextView android:id="@+id/tv2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="20sp" android:width="50px" /> <TextView android:id="@+id/tv3" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="20sp" android:width="150px" /> </LinearLayout>

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!

原文出自：author：conowen * E-mail：conowen@hotmail.com * http://blog.csdn.net/conowen 1、SQLiteOpenHelper介绍 通过上篇博文，http://www.52php.cn/article/p-hzhgfvjf-gp.html，了解了SQLite数据库的相关操作方法，但是一般在实际开发中，为了更加方便地管理、维护、升级数据库，需要通过继承SQLiteOpenHelper类来管理SQLite数据库。 关于SQLiteOpenHelper的官方说明如下： A helper class to manage database creation and version management. You create a subclass implementing onCreate(SQLiteDatabase),onUpgrade(SQLiteDatabase,int,int) and optionallyonOpen(SQLiteDatabase),and this class takes care of opening the database if it exists,creating it if it does not,and upgrading it as necessary. Transactions are used to make sure the database is always in a sensible state. This class makes it easy for ContentProvider implementations to defer opening and upgrading the database until first use,to avoid blocking application startup with long-running database upgrades. For an example,see the NotePadProvider class in the NotePad sample application,in thesamples/ directory of the SDK. 简单翻译：SQLiteOpenHelper可以创建数据库，和管理数据库的版本。 在继承SQLiteOpenHelper的类（extends SQLiteOpenHelper）里面，通过复写onCreate(SQLiteDatabase),int) 和onOpen(SQLiteDatabase)（可选）来操作数据库。 2、SQLiteOpenHelper()的具体用法 创建一个新的class如下所示，onCreate(SQLiteDatabase db)和onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion)方法会被自动添加。 [java] view plain copy print ? /* *@author:conowen *@date:12.2.29 */ packagecom.conowen.sqlite; importandroid.content.Context; importandroid.database.sqlite.SQLiteDatabase; importandroid.database.sqlite.SQLiteDatabase.CursorFactory; importandroid.database.sqlite.SQLiteOpenHelper; publicclassDbHelperextendsSQLiteOpenHelper{ publicDbHelper(Contextcontext,Stringname,CursorFactoryfactory, intversion){ super(context,name,factory,version); //TODOAuto-generatedconstructorstub } @Override publicvoidonCreate(SQLiteDatabasedb){ //TODOAuto-generatedmethodstub } @Override publicvoidonUpgrade(SQLiteDatabasedb,intoldVersion,intnewVersion){ //TODOAuto-generatedmethodstub } } /* * @author:conowen * @date:12.2.29 */ package com.conowen.sqlite; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.database.sqlite.SQLiteOpenHelper; public class DbHelper extends SQLiteOpenHelper{ public DbHelper(Context context,String name,CursorFactory factory,int version) { super(context,version); // TODO Auto-generated constructor stub } @Override public void onCreate(SQLiteDatabase db) { // TODO Auto-generated method stub } @Override public void onUpgrade(SQLiteDatabase db,int newVersion) { // TODO Auto-generated method stub } } 方法详解 [java] view plain copy print ? publicSQLiteOpenHelper(Contextcontext,SQLiteDatabase.CursorFactoryfactory,intversion) public SQLiteOpenHelper (Context context,SQLiteDatabase.CursorFactory factory,int version) Since: API Level 1 Create a helper object to create,open,and/or manage a database. This method always returns very quickly. The database is not actually created or opened until one ofgetWritableDatabase() orgetReadableDatabase() is called. Parameters
context	name	factory	version
db
db	oldVersion	newVersion