Android 数据存储 之 SQLite数据库详解

作者 :万境绝尘

转载请注明出处 : http://blog.csdn.net/shulianghan/article/details/19028665

.

SQLiteDataBase示例程序下载地址 : 

-- GirHub - https://github.com/han1202012/SQLite_NewsList.git.

SQLiteOpenHelper示例程序下载地址 : 

-- GitHub : https://github.com/han1202012/NewsSearch.git .

SQLite数据库简介 : 

-- 轻量级 : SQLite数据库是一个轻量级的数据库, 适用于少量数据的CURD;

-- 文件本质 : SQLite数据库支持大部分SQL语法, 允许使用SQL语句操作数据库, 其本质是一个文件, 不需要安装启动;

-- 数据读写 : SQLite数据库打开只是打开了一个文件的读写流, 如果有大数据量读写, 需要高并发存储, 那么就不应该使用SQLite;

一. 使用SQLiteDataBase操作数据库

SQLiteDataBase简介 : SQLIteDataBase代表一个数据库, 其本质是一个数据库文件, 创建该类对象, 可以使用该对象的一系列方法操作数据库;

1. SQLiteDataBase方法介绍

(1) 打开数据库方法

使用静态方法打开文件对应的数据库, 数据库文件通常是 文件名.db 形式的;

1> 根据标志位创建数据库

打开数据库: 根据标志位flag要求打开数据库, 这个方法很强大;

[java]  view plain copy

1. public static SQLiteDatabase openDatabase (String path, SQLiteDatabase.CursorFactory factory, int flags)  

参数介绍 : 

-- 参数① path : path 要打开 或者 需要创建的 数据库文件的路径;

-- 参数② factory : 当打开的数据库执行查询语句的时候 会创建一个Cursor对象, 这时会调用Cursor工厂类 factory, 可以填写null默认值;

-- 参数③ flag : 

OPEN_READWRITE 打开一个读写数据库, 如果磁盘满了, 之前写入的也作废; 

READ_OPENONLY 打开只读数据库, 这时读取数据库的可靠方法; 

CREATE_IF_NECESSARY 打开数据库, 如果数据库不存在, 就创建这个数据库;

NO_LOCALIZED_CALLATORS 打开数据库 不根据本地语言顺序进行排序, 使用这种模式创建数据库, 排序器不会被创建, 使用这个数据库 和 创建这个数据库的时候必须都使用这个标识, 如果这个标识被使用了, 那么setLocal()方法将不会起到任何作用;

2> 根据文件打开或创建数据库

打开数据库 : 根据数据库文件 对象打开数据库, 如果数据库不存在就创建数据库;

[java]  view plain copy

1. public static SQLiteDatabase openOrCreateDatabase (File file, SQLiteDatabase.CursorFactory factory)  

相当于   openDatabase(file.getPath(), factory, CREATE_IF_NECESSARY);

3> 根据路径打开或创建数据库

打开数据库 : 根据数据库文件 路径打开数据库, 如果数据库不存在就创建数据库;

[java]  view plain copy

1. public static SQLiteDatabase openOrCreateDatabase (String path, SQLiteDatabase.CursorFactory factory)  

相当于   openDatabase(path, factory, CREATE_IF_NECESSARY);

(2) 操作数据库方法

1> 执行SQL语句动态参数

执行SQL语句, 如果需要动态传入SQL语句参数, 将动态参数放入一个Object[]数组中;

[java]  view plain copy

1. public void execSQL (String sql, Object[] bindArgs)  

注意 : 该方法 可以 进行增删改操作,  不能进行查询 操作;

该方法适用于 :修改表结构,创建和删除表 触发器 视图 索引等,重建数据库表的索引,数据库升级,事物中保存点,没有返回值的语句;

参数介绍 : 

-- 参数① sql: 要执行的SQL语句, 只能执行一条, 多条语句用分号隔开不管用, 参数使用 "?" 占位符代替;

-- 参数② bingArgs: 替换上面SQL语句中的 "?" 占位符, 按照数组中的顺序依次替换;

2> 执行固定的SQL语句

该方法执行固定的SQL语句, 没有参数, 用法与上面的 execSQL(sql, bindArgs)一致;

[java]  view plain copy

1. public void execSQL (String sql)  

3> 插入数据

插入数据 : 向数据库中的 一个表 插入 一行 数据;

[java]  view plain copy

1. public long insert (String table, String nullColumnHack, ContentValues values)  

参数介绍 : 

-- 参数① table : 数据库中的表名, 要插入数据的表;

-- 参数② nullColumnHack : 该参数是可选的, 数据库表中不允许插入一行空的数据, 插入数据至少有一列不为null才能插入, 如果后面的values是null, 并且不知道列的名称, 那么插入操作会失败, 为了避免这种情况, 就出现了本参数, 为了防止 values为null的情况;

-- 参数③ values : 相当于一个Map集合,键 是列名,值 是对应列名要插入的数据;

插入原则 : 不管 第三个 ContentValues参数 是否为null, 执行insert()方法都会添加一条记录, 如果values参数为null, 会添加一个除主键之外其它字段都为null的记录;

nullColumnHack参数作用分析SQL语句 : 在SQL语句中在表名后面必须跟着一个列名, 例如 " insert into appale_info(name) values("乔帮主") ", 这是values参数不为null的情况下,如果values参数为null, 那么导致表名 "apple_info" 后面的列名也为null, 这样SQL语句就不合法了, 因此这里必须加上一个默认的列名, 以防values参数为null;

实例 : 

[java]  view plain copy

1. //创建表数据, 键 为 列名, 值 为 对应的表数据  
2. ContentValues values = new ContentValues();  
3. values.put("name", "乔帮主");  
4. values.put("age", 54);  
5. //向表中插入数据, 如果values为null, 就会添加一个  
6. long rowsNum = db.insert("apple_info", "name", values);  

上面代码转成SQL语句 : 

[plain]  view plain copy

1. insert into apple_info (name, age) values ('乔帮主', 54)  

假如values为null转化成SQL语句 : 

[plain]  view plain copy

1. insert into apple_info (name) values ()  

4> 更新数据

更新指定表中的特定数据 : 

[java]  view plain copy

1. public int update (String table, ContentValues values, String whereClause, String[] whereArgs)  

参数介绍 : 

-- 参数① table : 数据库表名称;

-- 参数② values : 该值类似Map集合, 键 是 列名, 值 是 要更新的数据, 这个值可以为null, 如果为null 这些数据会被清空;

-- 参数③ whereClause: where选择语句, 选择那些行进行数据的更新, 如果该参数为 null, 就会修改所有行;

-- 参数④ whereArgs : where选择语句的参数, 逐个替换 whereClause 中的占位符;

返回值 : 返回修改的行数;

实例 : 

[java]  view plain copy

1. //创建表数据, 键 为 列名, 值 为 对应的表数据  
2. ContentValues values = new ContentValues();  
3. values.put("name", "乔帮主");  
4. values.put("age", 54);  
5. int result = db.update("apple_info", values, "name=?", new String[]{"乔帮主"});  

转化为SQL语句: 

[sql]  view plain copy

1. update apple_info set name='乔帮主', age=56 where name='乔帮主'  

5> 删除数据

删除指定表中特定数据 : 

[java]  view plain copy

1. public int delete (String table, String whereClause, String[] whereArgs)  

参数介绍 : 

-- 参数① table : 要操作的数据库表名;

-- 参数② whereClause : where选择语句, 选择哪些行要被删除, 如果为null, 就删除所有行;

-- 参数③ whereArgs : where语句的参数, 逐个替换where语句中的 "?" 占位符;

实例 : 

[java]  view plain copy

1. int result = db.delete("apple_info", "name=?", new String[]{"乔帮主"});  

转化为SQL : 

[sql]  view plain copy

1. delete apple_info where name='乔帮主'  

6> 最全面查询

.

[java]  view plain copy

1. public Cursor query (boolean distinct, String table, String[] columns,   
2.         String selection, String[] selectionArgs,   
3.         String groupBy, String having,   
4.         String orderBy, String limit,   
5.         CancellationSignal cancellationSignal)  

参数介绍 : 

-- 参数① distinct : 是否去重复, true 去重复;

-- 参数② table : 要查询的表名;

-- 参数③ columns : 要查询的列名, 如果为null, 就会查询所有的列;

-- 参数④ whereClause : 条件查询子句, 在这里可以使用占位符 "?";

-- 参数⑤ whereArgs : whereClause查询子句中的传入的参数值, 逐个替换 "?" 占位符;

-- 参数⑥ groupBy: 控制分组, 如果为null 将不会分组;

-- 参数⑦ having : 对分组进行过滤;

-- 参数⑧ orderBy : 对记录进行排序;

-- 参数⑨ limite : 用于分页, 如果为null, 就认为不进行分页查询;

-- 参数⑩ cancellationSignal : 进程中取消操作的信号, 如果操作被取消, 当查询命令执行时会抛出 OperationCanceledException 异常;

实例 : 

[java]  view plain copy

1. Cursor cursor = db.query(true, "apple_info", new String[]{"_id, name, age"},  
2.         "name like ?", new String[]{"乔%"},   
3.         null, null,   
4.         "_id desc", "5, 10");  
5. cursor.close();  

7> 执行SQL查询语句

通过执行SQL语句, 查询结果;

[java]  view plain copy

1. public Cursor rawQuery (String sql, String[] selectionArgs)  

参数解析 : 

-- 参数① sql : 要执行的SQL语句, 可以使用 "?" 作为占位符;

-- 参数② selectionArgs : sql语句中的参数, 按照次序依次替换占位符 "?";

(3) SQLite中的事务

开启事务 : 

[java]  view plain copy

1. public void beginTransaction ()  

结束事务 : 

[java]  view plain copy

1. public void endTransaction ()  

判断当前是否处于事务中 : 如果处于返回true, 反之返回false;

[java]  view plain copy

1. public boolean inTransaction ()  

提交事务 : 程序执行endTransaction()方法的时候提交事务 还是 回滚事务, 取决于是否调用了 setTransactionSuccessful()方法, 如果事务执行中调用了改方法, 则提交事务, 如果没有执行该方法, 就会回滚事务;

示例代码 : 

[java]  view plain copy

1. db.beginTransaction();  
2. try {  
3.       
4.     ... ...  
5.       
6.     //调用该方法设置事务成功, 如果没有调用该方法, 在调用endTransaction()方法的时候会回滚事务  
7.     db.setTransactionSuccessful();  
8. } finally {  
9.     db.endTransaction();  
10. }  

2. Cursor的相关方法

(1) 移动记录指针方法

1> 移动到指定行数

方法作用 : 将记录指针向上 或者 向下移动offset行, offset为正数就是向下,为负数 就是向上;

[java]  view plain copy

1. public abstract boolean move (int offset)  

参数介绍 : offset是移动的相对行数;

2> 移动到第一行

记录指针移动到第一行, 如果移动成功返回true;

[java]  view plain copy

1. public abstract boolean moveToFirst ()  

3> 移动到最后一行

记录指针移动到最后一行, 如果移动成功返回true;

[java]  view plain copy

1. public abstract boolean moveToLast ()  

4> 移动到上一行

移动到上一行, 成功返回true;

[java]  view plain copy

1. public abstract boolean moveToPrevious ()  

5> 移动到下一行

移动到下一行, 成功返回true;

[java]  view plain copy

1. public abstract boolean moveToNext ()  

6> 移动到指定行

移动到指定行, 成功返回true;

[java]  view plain copy

1. public abstract boolean moveToPosition (int position)  

(2) 获取记录数据方法

获取某个类型的数据 : 

[java]  view plain copy

1. public abstract float getFloat (int columnIndex);//获取浮点型数据  
2. public abstract int getInt (int columnIndex);//获取整型数据  
3. public abstract long getLong (int columnIndex);//获取长整型数据  
4. public abstract short getShort (int columnIndex);//获取短整型数据  
5. public abstract String getString (int columnIndex);//获取字符串数据  

参数介绍 : 参数是列的标号, 注意该标号从 0 开始计数;

3. sqlite3工具介绍

工具简介 : sqlite3 是一个简单的数据库管理工具, 该用于位于 SDK tools 目录下;

获取数据库文件 : 使用虚拟机运行程序在 data/data/包名 安装目录下, 数据库文件在里面可以找到;

打开数据库 : 进入cmd命令行, 使用sqlite3 数据库文件 命令打开数据库;

常用的sqlite3 工具命令: 

-- 打开数据库: sqlite3 文件路径名 ;

-- 查看当前数据库 : .database ;

-- 查看当前数据库中的表 : .tables ;

-- 查看sqlite3的帮助 : .help ;

4. SQLite的数据存储格式

支持的数据类型 : SQLite数据库 内部 只支持null,integer,real(浮点型),text(文本),blob(二进制数据) 五种数据类型;

数据类型转换 : SQLite可以接受varchar(n), char(n), decimal(p,s) 等数据类型, 不过内部的机制使将这个数据类型转换成上面的五种数据类型进行存储;

无类型限制: SQLite允许将各种类型的数据保存到各种类型的字段中, 没有严格的某个字段 必须存放某个类型的数据这样的限制, 因此创建数据库 和 插入数据的时候不用关心这个列的数据类型;

-- eg: 在SQLite中可以将字符串数据放到整型字段中, 但是主键id, 不能随便放其它数据, 只能存放64卫整数;

二. 新闻列表程序实例

1. 要点解析

(1) 数据库相关操作

使用 openOrCreateDatabase()方法创建数据库 : 传入数据库的路径 和 CursorFactory对象;

-- Context.getFilesDir()方法: 该方法返回 内存中应用安装目录中的 文件存储目录的绝对路径, 在这里是 "data/data/shuliang.han.database/files", 整个数据库的完整路径是 :"data/data/shuliang.han.database/files/news.db";

[java]  view plain copy

1. //打开或者创建数据库, 这里是创建数据库  
2. db = SQLiteDatabase.openOrCreateDatabase(this.getFilesDir().toString() + "/news.db", null);  

创建表 :   使用 execSQL()方法 执行SQL语句创建表;

[java]  view plain copy

1. db.execSQL("create table news_table (" +  
2.         "_id integer primary key autoincrement, " +  
3.         "news_tittle varchar(50), " +  
4.         "news_content varchar(5000))");  

插入数据 : 调用 execSQL()方法执行插入操作, 传入一个带参数的SQL语句;

[java]  view plain copy

1. db.execSQL("insert into news_table values(null, ?, ?)", new String[]{tittle, content});  

查询数据 : 使用  rawQuery()方法, 传入 SQL语句 和 CursorFactory对象, 返回一个Cursor对象;

[java]  view plain copy

1. Cursor cursor = db.rawQuery("select * from news_table", null);  

关闭数据库 : 检查 SQLiteDataBase对象 是否为null, 并且 是打开的, 如果符合上面的两个条件, 将db关闭, 这个方法一般是在onDestroy()方法中进行;

[java]  view plain copy

1. @Override  
2. protected void onDestroy() {  
3.     super.onDestroy();  
4.     //在Activity销毁的时候, 如果没有  
5.     if(db != null && db.isOpen())  
6.         db.close();  
7. }  

(2) ListView相关操作

创建SimpleCursorAdapter适配器 : 

参数解析 : 

-- 参数① context : 上下文对象;

-- 参数② resource : ListView条目的布局;

-- 参数③ cursor : 从数据库表中查询出来的记录;

-- 参数④ string[]: 数据库中表的字段名称;

-- 参数⑤ int[]: 将数据库中每行的字段 按照对应顺序 放入到该数组对应组件中;

[java]  view plain copy

1. SimpleCursorAdapter cursorAdapter = new SimpleCursorAdapter(  
2.         getApplicationContext(),   
3.         R.layout.item,   
4.         cursor,   
5.         new String[]{"news_tittle", "news_content"},   
6.         new int[]{R.id.tittle, R.id.content});  

将创建的适配器设置给ListView : 执行这个方法会刷新ListView的显示;

[java]  view plain copy

1. listView.setAdapter(cursorAdapter);  

2. 详细代码 

SQLiteDataBase示例程序下载地址 : 

-- GirHub - https://github.com/han1202012/SQLite_NewsList.git.

(1) MainActivity代码 

[java]  view plain copy

1. package shuliang.han.database;  
2.   
3. import android.app.Activity;  
4. import android.database.Cursor;  
5. import android.database.sqlite.SQLiteDatabase;  
6. import android.database.sqlite.SQLiteException;  
7. import android.os.Bundle;  
8. import android.view.View;  
9. import android.widget.EditText;  
10. import android.widget.ListView;  
11. import android.widget.SimpleCursorAdapter;  
12.   
13. public class MainActivity extends Activity {  
14.   
15.     private SQLiteDatabase db;  //数据库对象  
16.     private ListView listView;  //列表  
17.     private EditText et_tittle; //输入的新闻标题  
18.     private EditText et_content;    //输入的新闻内容  
19.       
20.     @Override  
21.     protected void onCreate(Bundle savedInstanceState) {  
22.         super.onCreate(savedInstanceState);  
23.         setContentView(R.layout.activity_main);  
24.           
25.         //打开或者创建数据库, 这里是创建数据库  
26.         db = SQLiteDatabase.openOrCreateDatabase(this.getFilesDir().toString() + "/news.db", null);  
27.         System.out.println(this.getFilesDir().toString() + "/news.db");  
28.   
29.         //初始化组件  
30.         listView = (ListView) findViewById(R.id.lv_news);  
31.         et_tittle = (EditText) findViewById(R.id.et_news_tittle);  
32.         et_content = (EditText) findViewById(R.id.et_news_content);  
33.           
34.           
35.     }  
36.       
37.     /* 
38.      * 插入数据到数据库中的触发点击事件 
39.      * 如果数据库存在就能正常访问数据库, 如果不存在访问数据库的时候就会出现 SQLiteException 异常 
40.      * 正常访问 : 获取输入的新闻标题 和 新闻内容, 将标题 和 内容插入到数据库, 重新获取Cursor, 使用Cursor刷新ListView内容 
41.      * 异常访问 : 如果访问出现了SQLiteException异常, 说明数据库不存在, 这时就需要先创建数据库 
42.      */  
43.     public void insertNews(View view) {  
44.         String tittle = et_tittle.getText().toString();  
45.         String content = et_content.getText().toString();  
46.           
47.         try{  
48.             insertData(db, tittle, content);  
49.             Cursor cursor = db.rawQuery("select * from news_table", null);  
50.             inflateListView(cursor);  
51.         }catch(SQLiteException exception){  
52.             db.execSQL("create table news_table (" +  
53.                     "_id integer primary key autoincrement, " +  
54.                     "news_tittle varchar(50), " +  
55.                     "news_content varchar(5000))");  
56.             insertData(db, tittle, content);  
57.             Cursor cursor = db.rawQuery("select * from news_table", null);  
58.             inflateListView(cursor);  
59.         }  
60.           
61.     }  
62.       
63.     /* 
64.      * 向数据库中插入数据 
65.      * 参数介绍 :  
66.      * -- 参数① : SQL语句, 在这个语句中使用 ? 作为占位符, 占位符中的内容在后面的字符串中按照顺序进行替换 
67.      * -- 参数② : 替换参数①中占位符中的内容 
68.      */  
69.     private void insertData(SQLiteDatabase db, String tittle, String content) {  
70.         db.execSQL("insert into news_table values(null, ?, ?)", new String[]{tittle, content});  
71.     }  
72.       
73.     /* 
74.      * 刷新数据库列表显示 
75.      * 1. 关联SimpleCursorAdapter与数据库表, 获取数据库表中的最新数据 
76.      * 2. 将最新的SimpleCursorAdapter设置给ListView 
77.      */  
78.     private void inflateListView(Cursor cursor) {  
79.         SimpleCursorAdapter cursorAdapter = new SimpleCursorAdapter(  
80.                 getApplicationContext(),   
81.                 R.layout.item,   
82.                 cursor,   
83.                 new String[]{"news_tittle", "news_content"},   
84.                 new int[]{R.id.tittle, R.id.content});  
85.           
86.         listView.setAdapter(cursorAdapter);  
87.     }  
88.       
89.     @Override  
90.     protected void onDestroy() {  
91.         super.onDestroy();  
92.         //在Activity销毁的时候, 如果没有  
93.         if(db != null && db.isOpen())  
94.             db.close();  
95.     }  
96.       
97. }  

(2) XML布局文件

主布局文件 : 

[java]  view plain copy

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
2.     xmlns:tools="http://schemas.android.com/tools"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:paddingBottom="@dimen/activity_vertical_margin"  
6.     android:paddingLeft="@dimen/activity_horizontal_margin"  
7.     android:paddingRight="@dimen/activity_horizontal_margin"  
8.     android:paddingTop="@dimen/activity_vertical_margin"  
9.     tools:context=".MainActivity"   
10.     android:orientation="vertical">  
11.   
12.     <TextView  
13.         android:layout_width="wrap_content"  
14.         android:layout_height="wrap_content"  
15.         android:text="新闻标题" />  
16.       
17.     <EditText   
18.         android:id="@+id/et_news_tittle"  
19.         android:layout_width="fill_parent"  
20.         android:layout_height="wrap_content"  
21.         android:singleLine="true"  
22.         android:hint="点击此处输入新闻标题"/>  
23.       
24.     <TextView  
25.         android:layout_width="wrap_content"  
26.         android:layout_height="wrap_content"  
27.         android:text="新闻内容" />  
28.       
29.     <EditText   
30.         android:id="@+id/et_news_content"  
31.         android:layout_width="fill_parent"  
32.         android:layout_height="wrap_content"  
33.         android:lines="2"  
34.         android:hint="点击此处输入新闻内容"/>  
35.       
36.     <Button  
37.         android:id="@+id/bt_add_news"  
38.         android:layout_width="wrap_content"  
39.         android:layout_height="wrap_content"  
40.         android:onClick="insertNews"  
41.         android:text="添加新闻" />  
42.       
43.     <ListView   
44.         android:id="@+id/lv_news"  
45.         android:layout_width="fill_parent"  
46.         android:layout_height="fill_parent"/>  
47.   
48. </LinearLayout>  

ListView条目布局文件 : 

[java]  view plain copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:orientation="vertical" >  
6.       
7.     <TextView   
8.         android:id="@+id/tittle"  
9.         android:layout_width="wrap_content"  
10.         android:layout_height="wrap_content"  
11.         android:textSize="15dp"  
12.         android:textColor="#FFFF00"/>  
13.       
14.     <TextView   
15.         android:id="@+id/content"  
16.         android:layout_width="fill_parent"  
17.         android:layout_height="wrap_content"  
18.         android:textSize="10dp"  
19.         android:textColor="#00FF00"/>  
20.   
21. </LinearLayout>  

效果图 : 

三. SQLiteOpenHelper类操作数据库

单独使用SQLiteDataBase操作数据库的弊端: 对数据库的表进行操作的时候, 我们不知道数据库中表是否存在, 首先要进行表操作, 在出现异常之后, 在异常捕获的try catch 代码块中创建表, 这样操作很繁琐;

SQLiteOpenHelper作用 : 该类用来管理数据库的创建 和版本更新, 通常使用其子类, 实现onCreate() 和 onUpgrade()方法;

1. 类中的方法介绍

(1) 读写打开数据库

以读写的方式打开数据库 :先以读写方式打开数据库, 如果磁盘满了, 就会打开失败,然后会尝试以只读的方式打开数据库;

[java]  view plain copy

1. public SQLiteDatabase getReadableDatabase ()  

(2) 写方式打开数据库

以写的方式打开数据库 :先以读写方式打开数据库, 如果磁盘满了, 就会出错,不推荐使用这种方法, 使用 getReadableDatabase()方法即可;

[java]  view plain copy

1. public SQLiteDatabase getWritableDatabase ()  

(3) 创建数据库

创建数据库 : 第一次创建数据库的时候回调该方法, 一般在该方法中 创建数据库表;

[java]  view plain copy

1. public abstract void onCreate (SQLiteDatabase db)  

方法解析 : 

-- 调用时机: 当使用getReadableDatabase()方法 获取数据库 实例 的时候, 如果数据库不存在, 就会调用这个方法;

-- 方法内容 : 重写该方法一般 将 创建数据库表的 execSQL()方法 和 初始化表数据的一些 insert()方法写在里面;

(4) 更新数据库

更新数据库 : 升级软件的时候更新数据库表结构, 在数据库版本发生变化的时候调用;

[java]  view plain copy

1. public abstract void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion)  

方法解析 : 

-- 调用时机 : 数据库版本发生变化的时候回调, newVersion是当前数据库版本号, oldVersion是旧的版本号;

-- 识别版本 : 创建SQLiteOpenHelper子类对象的时候,必须传入一个version参数, 该参数就是当前数据库版本, 只要这个版本高于之前的版本, 就会触发这个onUpgrade()方法;

(5) 关闭数据库

关闭打开的数据库 : 

[java]  view plain copy

1. public synchronized void close ()  

2. 示例程序要点解析

(1) 在onCreate()方法中创建表

创建数据库表 : 定义一个数据库SQL语句, 之后在onCreate()方法中 execSQL()执行该语句;

[java]  view plain copy

1. final String SQL_CREATE_TABLE = "create table news_table (" +  
2.         "_id integer primary key autoincrement, " +  
3.         "news_tittle varchar(50), " +  
4.         "news_content varchar(5000))";  
5. @Override  
6. public void onCreate(SQLiteDatabase db) {  
7.     db.execSQL(SQL_CREATE_TABLE);  
8. }  

(2) 插入数据

插入内容 : 打开数据库,如果存在直接插入内容, 如果不存在就创建表在插入内容;

[java]  view plain copy

1. helper.getReadableDatabase().execSQL("insert into news_table values(null, ?, ?)",   
2.         new String[]{tittle, content});  

(3) 查询数据库

查询数据 : 使用SQLiteOpenHelper子类对象打开数据库, 并且执行查询语句;

[java]  view plain copy

1. Cursor cursor = helper.getReadableDatabase().rawQuery("select * from news_table", null);  

(4) 解析Cursor记录

将Cursor中的数据转为 ArrayList<Map<String, String>> 类型数据 : 

-- 遍历条件 : Cursor的moveToNext()方法, 如果成功移到下一个记录, 就执行循环内容;

-- 获取表中数据 : Cursor的getString(1) 就是获取 这一样记录中的 第二列的数据, 第一列是 "_id" 主键;

[java]  view plain copy

1. private ArrayList<Map<String, String>> cursor2list(Cursor cursor) {  
2.     ArrayList<Map<String, String>> list = new ArrayList<Map<String,String>>();  
3.       
4.     //遍历Cursor  
5.     while(cursor.moveToNext()){  
6.         Map<String, String> map = new HashMap<String, String>();  
7.         map.put("tittle", cursor.getString(1));  
8.         map.put("content", cursor.getString(2));  
9.         list.add(map);  
10.     }  
11.     return list;  
12. }  

(5) 开启一个Activity并传递数据

流程 : 

-- ① 创建Bundle对象 : 该对象可以存放数据, 并可以放到Intent对象中, 传递给另外的组件;

-- ② Bundle存数据 : 使用putSerializable()方法, 可以存放对象, 将 ArrayList<Map<String, String>> 存入里面;

-- ③ 创建Intent对象 : 传入要跳转的Activity的Class对象;

-- ④ Bundle加入Intent对象 : 将存放好数据的Bundle对象加入到Intent对象中;

-- ⑤ 开启Activity : 使用startActivity(intent)方法跳转Activity;

[java]  view plain copy

1. Bundle bundle = new Bundle();  
2. bundle.putSerializable("news", cursor2list(cursor));  
3. Intent intent = new Intent(this, SearchResultActivity.class);  
4. intent.putExtras(bundle);  
5. startActivity(intent);  

(6) 在Activity中获取Intent传递的数据

执行流程 : 

-- 获取Intent对象: 调用 getIntent()方法, 可以获取Activity跳转到额Intent对象;

-- 获取Bundle对象 : Intent对象调用 getExtras()方法, 可以获取存放数据的Bundle对象;

-- 将数据从Bundle对象取出 : 调用getSerializable()方法, 并将返回值转换成 List<Map<String, String>> 类型;

[java]  view plain copy

1. //获取跳转到该Activity的intent对象  
2. Intent intent = getIntent();  
3. //获取Intent对象所携带的数据  
4. Bundle bundle = intent.getExtras();  
5. //从Bundle中取出List<Map<String,String>>数据  
6. @SuppressWarnings("unchecked")  
7. List<Map<String, String>> list = (List<Map<String, String>>)bundle.getSerializable("news");  

(7) 适配器转化

将 List<Map<String, String>> 类型数据转为 SimpleAdapter类型适配器 : 

参数介绍 : 

-- 参数① context : 上下文对象;

-- 参数②List<Map<String, String>> : 数据源;

-- 参数③ id : ListView元素条目布局文件;

-- 参数④ string[] : 数据源中Map对象的键;

-- 参数⑤ int[]: 数据源中Map每个键对应的值 存放的组件 id;

[java]  view plain copy

1. SimpleAdapter adapter = new SimpleAdapter(  
2.         getApplicationContext(),    //上下文对象  
3.         list,                       //数据源  
4.         R.layout.item,              //List显示布局  
5.         new String[]{"tittle", "content"}, //List中map的键值  
6.         new int[]{R.id.tittle, R.id.content});  //填充到的布局文件  

3. 实例程序源码

(1) SQLiteOpenHelper源码

[java]  view plain copy

1. package shuliang.han.newssearch;  
2.   
3. import android.content.Context;  
4. import android.database.sqlite.SQLiteDatabase;  
5. import android.database.sqlite.SQLiteOpenHelper;  
6.   
7. public class NewsSearchDatabaseHelper extends SQLiteOpenHelper {  
8.   
9.     final String SQL_CREATE_TABLE = "create table news_table (" +  
10.             "_id integer primary key autoincrement, " +  
11.             "news_tittle varchar(50), " +  
12.             "news_content varchar(5000))";  
13.       
14.     /* 
15.      * 构造方法 :  
16.      * 参数介绍 :  
17.      * 参数① : 上下文对象 
18.      * 参数② : 数据库名称 
19.      * 参数③ : 数据库版本号 
20.      */  
21.     public NewsSearchDatabaseHelper(Context context, String name, int version) {  
22.         super(context, name, null, version);  
23.     }  
24.   
25.     @Override  
26.     public void onCreate(SQLiteDatabase db) {  
27.         db.execSQL(SQL_CREATE_TABLE);  
28.     }  
29.   
30.     @Override  
31.     public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {  
32.         System.out.println("call update");  
33.     }  
34.   
35. }  

(2) MainActivity源码

[java]  view plain copy

1. package shuliang.han.newssearch;  
2.   
3. import java.util.ArrayList;  
4. import java.util.HashMap;  
5. import java.util.Map;  
6.   
7. import android.app.Activity;  
8. import android.content.Intent;  
9. import android.database.Cursor;  
10. import android.os.Bundle;  
11. import android.view.View;  
12. import android.widget.EditText;  
13. import android.widget.ListView;  
14. import android.widget.SimpleCursorAdapter;  
15.   
16. public class MainActivity extends Activity {  
17.   
18.     private NewsSearchDatabaseHelper helper;    //数据库帮助类  
19.     private EditText et_tittle;                 //输入新闻标题  
20.     private EditText et_content;                //输入新闻内容  
21.     private ListView listView;                  //显示新闻列表  
22.       
23.     @Override  
24.     protected void onCreate(Bundle savedInstanceState) {  
25.         super.onCreate(savedInstanceState);  
26.         setContentView(R.layout.activity_main);  
27.           
28.         helper = new NewsSearchDatabaseHelper(getApplicationContext(), "news", 1);  
29.           
30.         //初始化控件  
31.         et_tittle = (EditText) findViewById(R.id.et_news_tittle);  
32.         et_content = (EditText) findViewById(R.id.et_news_content);  
33.         listView = (ListView) findViewById(R.id.lv_news);  
34.           
35.     }  
36.   
37.     /* 
38.      * 按钮点击事件 
39.      * 通过判断被点击的组件, 执行不同的操作 
40.      */  
41.     public void onClick(View view) {  
42.         int id = view.getId();  
43.         switch (id) {  
44.             case R.id.bt_add_news:  
45.                 insertNews();  
46.                 break;  
47.             case R.id.bt_query_news:  
48.                 queryNews();  
49.                 break;  
50.             default:  
51.                 break;  
52.         }  
53.     }  
54.       
55.     /* 
56.      * 插入新闻数据 
57.      * 1. 从EditText组件中获取新闻的标题 和 新闻内容 
58.      * 2. 获取数据库并从将 新闻标题 和 内容 插入到数据库中 
59.      * 3. 重新查询数据库 获得Cursor对象 
60.      * 4. 根据cursor对象创建SimpleCursorAdapter对象 
61.      * 5. 将SimpleCursorAdapter设置给ListView, 显示新闻列表 
62.      */  
63.     private void insertNews() {  
64.         String tittle = et_tittle.getText().toString();  
65.         String content = et_content.getText().toString();  
66.           
67.         helper.getReadableDatabase().execSQL("insert into news_table values(null, ?, ?)",   
68.                 new String[]{tittle, content});  
69.           
70.         Cursor cursor = helper.getReadableDatabase().rawQuery("select * from news_table", null);  
71.         inflateListView(cursor);  
72.     }  
73.       
74.     /* 
75.      * 刷新数据库列表显示 
76.      * 1. 关联SimpleCursorAdapter与数据库表, 获取数据库表中的最新数据 
77.      * 2. 将最新的SimpleCursorAdapter设置给ListView 
78.      */  
79.     private void inflateListView(Cursor cursor) {  
80.         SimpleCursorAdapter cursorAdapter = new SimpleCursorAdapter(  
81.                 getApplicationContext(),   
82.                 R.layout.item,   
83.                 cursor,   
84.                 new String[]{"news_tittle", "news_content"},   
85.                 new int[]{R.id.tittle, R.id.content});  
86.           
87.         listView.setAdapter(cursorAdapter);  
88.     }  
89.       
90.     /* 
91.      * 查询新闻 
92.      * 1. 获取要查询的新闻标题 和 新闻内容 
93.      * 2. 查询数据库 获取 Cursor, 并将Cursor转化为List<Map<String, String>>类型的集合 
94.      * 3. 将集合放入bundle, Intent开启另一个Activity, 将bundle放入intent对象, 跳转Activity 
95.      *  
96.      */  
97.     private void queryNews() {  
98.         String tittle = et_tittle.getText().toString();  
99.         String content = et_content.getText().toString();  
100.           
101.         Cursor cursor = helper.getReadableDatabase().rawQuery(  
102.                 "select * from news_table where news_tittle like ? or news_content like ?",   
103.                 new String[]{"%" + tittle + "%", "%" + content + "%"});  
104.           
105.         Bundle bundle = new Bundle();  
106.         bundle.putSerializable("news", cursor2list(cursor));  
107.         Intent intent = new Intent(this, SearchResultActivity.class);  
108.         intent.putExtras(bundle);  
109.         startActivity(intent);  
110.           
111.           
112.     }  
113.       
114.     /* 
115.      * 返回一个ArrayList集合, 这个集合中每个元素是一个Map集合, 每个Map集合有两个元素 
116.      * 解析Cursor对象 :  
117.      * 1. cursor光标向下移动一格;  
118.      * 2. 创建一个HashMap对象 
119.      * 3. 使用 cursor.getString(列标号)获取该行中某列值, 将这个值放入map中 
120.      * 4. 将Map对象放入 
121.      */  
122.     private ArrayList<Map<String, String>> cursor2list(Cursor cursor) {  
123.         ArrayList<Map<String, String>> list = new ArrayList<Map<String,String>>();  
124.           
125.         //遍历Cursor  
126.         while(cursor.moveToNext()){  
127.             Map<String, String> map = new HashMap<String, String>();  
128.             map.put("tittle", cursor.getString(1));  
129.             map.put("content", cursor.getString(2));  
130.             list.add(map);  
131.         }  
132.         return list;  
133.     }  
134.       
135.     @Override  
136.     protected void onDestroy() {  
137.         super.onDestroy();  
138.         //释放数据库资源  
139.         if(helper !=null)  
140.             helper.close();  
141.     }  
142. }  

(3) SearchResultActivity源码

[java]  view plain copy

1. package shuliang.han.newssearch;  
2.   
3. import java.util.List;  
4. import java.util.Map;  
5.   
6. import android.app.Activity;  
7. import android.content.Intent;  
8. import android.os.Bundle;  
9. import android.widget.ListView;  
10. import android.widget.SimpleAdapter;  
11.   
12. public class SearchResultActivity extends Activity {  
13.   
14.     private ListView listView;  
15.       
16.     @Override  
17.     protected void onCreate(Bundle savedInstanceState) {  
18.         super.onCreate(savedInstanceState);  
19.           
20.         //设置布局文件  
21.         setContentView(R.layout.news_search_result);  
22.         //初始化组件  
23.         listView = (ListView) findViewById(R.id.lv_search_result);  
24.         //获取跳转到该Activity的intent对象  
25.         Intent intent = getIntent();  
26.         //获取Intent对象所携带的数据  
27.         Bundle bundle = intent.getExtras();  
28.         //从Bundle中取出List<Map<String,String>>数据  
29.         @SuppressWarnings("unchecked")  
30.         List<Map<String, String>> list = (List<Map<String, String>>)bundle.getSerializable("news");  
31.           
32.         SimpleAdapter adapter = new SimpleAdapter(  
33.                 getApplicationContext(),    //上下文对象  
34.                 list,                       //数据源  
35.                 R.layout.item,              //List显示布局  
36.                 new String[]{"tittle", "content"}, //List中map的键值  
37.                 new int[]{R.id.tittle, R.id.content});  //填充到的布局文件  
38.           
39.         listView.setAdapter(adapter);  
40.     }  
41.       
42. }  

(4) XML文件

主界面布局 : 

[html]  view plain copy

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
2.     xmlns:tools="http://schemas.android.com/tools"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:paddingBottom="@dimen/activity_vertical_margin"  
6.     android:paddingLeft="@dimen/activity_horizontal_margin"  
7.     android:paddingRight="@dimen/activity_horizontal_margin"  
8.     android:paddingTop="@dimen/activity_vertical_margin"  
9.     tools:context=".MainActivity"   
10.     android:orientation="vertical">  
11.   
12.     <TextView  
13.         android:layout_width="wrap_content"  
14.         android:layout_height="wrap_content"  
15.         android:text="新闻标题" />  
16.       
17.     <EditText   
18.         android:id="@+id/et_news_tittle"  
19.         android:layout_width="fill_parent"  
20.         android:layout_height="wrap_content"  
21.         android:singleLine="true"  
22.         android:hint="点击此处输入新闻标题"/>  
23.       
24.     <TextView  
25.         android:layout_width="wrap_content"  
26.         android:layout_height="wrap_content"  
27.         android:text="新闻内容" />  
28.       
29.     <EditText   
30.         android:id="@+id/et_news_content"  
31.         android:layout_width="fill_parent"  
32.         android:layout_height="wrap_content"  
33.         android:lines="2"  
34.         android:hint="点击此处输入新闻内容"/>  
35.       
36.     <LinearLayout  
37.         android:layout_width="wrap_content"  
38.         android:layout_height="wrap_content"  
39.         android:orientation="horizontal"  
40.         android:layout_gravity="center_horizontal">  
41.         <Button  
42.             android:id="@+id/bt_add_news"  
43.             android:layout_width="wrap_content"  
44.             android:layout_height="wrap_content"  
45.             android:onClick="onClick"  
46.             android:text="添加新闻" />  
47.           
48.         <Button  
49.             android:id="@+id/bt_query_news"  
50.             android:layout_width="wrap_content"  
51.             android:layout_height="wrap_content"  
52.             android:onClick="onClick"  
53.             android:text="查找新闻" />  
54.     </LinearLayout>  
55.       
56.     <ListView   
57.         android:id="@+id/lv_news"  
58.         android:layout_width="fill_parent"  
59.         android:layout_height="fill_parent"/>  
60.   
61. </LinearLayout>  

ListView条目布局 : 

[html]  view plain copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:orientation="vertical" >  
6.       
7.     <TextView   
8.         android:id="@+id/tittle"  
9.         android:layout_width="wrap_content"  
10.         android:layout_height="wrap_content"  
11.         android:textSize="15dp"  
12.         android:textColor="#FFFF00"/>  
13.       
14.     <TextView   
15.         android:id="@+id/content"  
16.         android:layout_width="fill_parent"  
17.         android:layout_height="wrap_content"  
18.         android:textSize="10dp"  
19.         android:textColor="#00FF00"/>  
20.   
21. </LinearLayout>  

跳转Activity布局 : 

[html]  view plain copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:orientation="vertical" >  
6.       
7.     <ListView   
8.         android:id="@+id/lv_search_result"  
9.         android:layout_height="wrap_content"  
10.         android:layout_width="wrap_content"/>  
11.       
12. </LinearLayout>  

SQLiteOpenHelper示例程序下载地址 : 

-- GitHub : https://github.com/han1202012/NewsSearch.git .

效果图 : 

.

作者 :万境绝尘

转载请注明出处 : http://blog.csdn.net/shulianghan/article/details/19028665