android sqllite.doc

前两篇日志我已经总结了本地数据存储的前两种：文件和配置项。还剩下最后一种数据库存储SQLite。一、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的CURDAndroid提供了一个名为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()方法先以读写方式打开数据库，如果数据库的磁盘空间满了，就会打开失败，当打开失败后会继续尝试以只读方式打开数据库。四、SQLite示例程序我们编写一个对表(Contacts)进行的操作来演示SQLite的应用。1.创建Android工程Project name:AndroidSQLiteBuildTarget:Android2.1Application name:SQLite嵌入式数据库Package name:com.changcheng.sqliteCreate Activity:AndroidSQLiteMin SDK Version:72. Contact实体packagecom.changcheng.sqlite.entity;publicclassContact privateInteger_id;privateStringname;privateStringphone;publicContact() super();publicContact(String name, String phone) = name;this.phone= phone;publicInteger get_id() return_id;publicvoidset_id(Integer id) _id= id;publicString getName() returnname;publicvoidsetName(String name) = name;publicString getPhone() returnphone;publicvoidsetPhone(String phone) this.phone= phone;OverridepublicString toString() returnContants id=+_id+, name=+name+, phone=+phone+;3.编写MyOpenHelper类MyOpenHelper继承自SQLiteOpenHelper类。我们需要创建数据表，必须重写onCreate（更新时重写onUpgrade方法）方法，在这个方法中创建数据表。packagecom.changcheng.sqlite;importandroid.content.Context;importandroid.database.sqlite.SQLiteDatabase;importandroid.database.sqlite.SQLiteOpenHelper;publicclassMyOpenHelperextendsSQLiteOpenHelper privatestaticfinalStringname=contants;/数据库名称privatestaticfinalintversion= 1;/数据库版本publicMyOpenHelper(Context context) /* CursorFactory指定在执行查询时获得一个游标实例的工厂类。 设置为null，则使用系统默认的工厂类。*/super(context,name,null,version);OverridepublicvoidonCreate(SQLiteDatabase db) /创建contacts表，SQL表达式时提供的字段类型和长度仅为提高代码的可读性。db.execSQL(CREATE TABLE IF NOT EXISTS contacts(+_id integer primary key autoincrement,+name varchar(20),+phone varchar(50);OverridepublicvoidonUpgrade(SQLiteDatabase db,intoldVersion,intnewVersion) /仅演示用，所以先删除表然后再创建。db.execSQL(DROP TABLE IF EXISTS contacts);this.onCreate(db);4.编写ContactsService类ContactsService类主要实现对业务逻辑和数据库的操作。packagecom.changcheng.sqlite.service;importjava.util.ArrayList;importjava.util.List;importandroid.content.Context;importandroid.database.Cursor;importcom.changcheng.sqlite.MyOpenHelper;importcom.changcheng.sqlite.entity.Contact;publicclassContactsService privateMyOpenHelperopenHelper;publicContactsService(Context context) this.openHelper=newMyOpenHelper(context);/*保存*paramcontact*/publicvoidsave(Contact contact) String sql =INSERT INTO contacts (name, phone) VALUES (?, ?);Object bindArgs = contact.getName(), contact.getPhone() ;this.openHelper.getWritableDatabase().execSQL(sql, bindArgs);/*查找*paramid*return*/publicContact 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()returnnewContact(cursor.getInt(0), cursor.getString(1), cursor.getString(2);returnnull;/*更新*paramcontact*/publicvoidupdate(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);/*删除*paramid*/publicvoiddelete(Integer id) String sql =DELETE FROM contacts WHERE _id=?;Object bindArgs = id ;this.openHelper.getReadableDatabase().execSQL(sql, bindArgs);/*获取记录数量*return*/publiclonggetCount() String sql =SELECT count(*) FROM contacts;Cursor cursor =this.openHelper.getReadableDatabase().rawQuery(sql,null);cursor.moveToFirst();returncursor.getLong(0);/*获取分页数据*paramstartIndex*parammaxCount*return*/publicListgetScrollData(longstartIndex,longmaxCount) 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 contacts =newArrayList();while(cursor.moveToNext() Contact contact =newContact(cursor.getInt(0),cursor.getString(1), cursor.getString(2);contacts.add(contact);returncontacts;/*获取分页数据，提供给SimpleCursorAdapter使用。*paramstartIndex*parammaxCount*return*/publicCursor getScrollDataCursor(longstartIndex,longmaxCount) 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);returncursor;5.编写测试类编写一个针对ContactsService的测试类，测试ContactsService类中的各个方法是否正确。packagecom.changcheng.sqlite.test;importjava.util.List;importcom.changcheng.sqlite.MyOpenHelper;importcom.changcheng.sqlite.entity.Contact;importcom.changcheng.sqlite.service.ContactsService;importandroid.database.Cursor;importandroid.test.AndroidTestCase;importandroid.util.Log;publicclassContactsServiceTestextendsAndroidTestCase privatestaticfinalStringTAG=ContactsServiceTest;/测试创建表publicvoidtestCreateTable()throwsThrowable MyOpenHelper openHelper =newMyOpenHelper(this.getContext();openHelper.getWritableDatabase();/测试savepublicvoidtestSave()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();Contact contact1 =newContact(null,tom;Contact contact2 =newContact(null,lili;Contact contact3 =newContact(null,jack;Contact contact4 =newContact(null,heary,1335789789);contactsService.save(contact1);contactsService.save(contact2);contactsService.save(contact3);contactsService.save(contact4);/测试findpublicvoidtestFind()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();Contact contact = contactsService.find(1);Log.i(TAG, contact.toString();/测试updatepublicvoidtestUpdate()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();Contact contact = contactsService.find(1);contact.setPhone(1399889955);contactsService.update(contact);/测试getCountpublicvoidtestGetCount()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();Log.i(TAG, contactsService.getCount() +);/测试getScrollDatapublicvoidtestGetScrollData()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();List contacts = contactsService.getScrollData(0, 3);Log.i(TAG, contacts.toString();/测试getScrollDataCursorpublicvoidtestGetScrollDataCursor()throwsThrowable ContactsService contactsService =newContactsService(this.getContext();Cursor cursor = contactsService.getScrollDataCursor(0, 3);while(cursor.moveToNext() Contact contact =newContact(cursor.getInt(0),cursor.getString(1), cursor.getString(2);Log.i(TAG, contact.toString();启用测试功能，不要忘记在AndroidManifest.xml文件中加入测试环境。为application元素添加一个子元素：，为application元素添加一个兄弟元素：。SQLite数据库以单个文件存储，就像微软的Access数据库。有一个查看SQLite数据库文件的工具SQLite Developer，我们可以使用它来查看数据库。Android将创建的数据库存放在”/data/data/ com.changcheng.sqlite/databases/contacts”，我们将它导出然后使用SQLite Developer打开。6.分页显示数据我们在ContactsService类中，提供了一个获取分页数据的方法。我们将调用它获取的数据，使用ListView组件显示出来。编辑mail.xml：在mail.xml所在目录里添加一个contactitem.xml：编辑AndroidSQLite类：packagecom.changcheng.sqlite;importjava.util.ArrayList;importjava.util.HashMap;importjava.util.List;importcom.changcheng.sqlite.R;importcom.changcheng.sqlite.entity.Contact;importcom.changcheng.sqlite.service.ContactsService;importandroid.app.Activity;importandroid.database.Cursor;importandroid.os.Bundle;importandroid.view.View;importandroid.widget.AdapterView;importandroid.widget.ListView;importandroid.widget.SimpleAdapter;importandroid.widget.Toast;importandroid.widget.AdapterView.OnItemClickListener;publicclassAndroidSQLiteextendsActivity /* Called when the activity is first created. */OverridepublicvoidonCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState);setContentView(R.layout.main);/获取分页数据ContactsService contactsService =newContactsService(this);List contacts = contactsService.getScrollData(0, 3);/获取ListViewListView lv = (ListView)this.findViewById(R.id.listView);/生成List? extends Map数据ListHashMap data =newArrayListHashMap();for(Contact contact : contacts) HashMap item =newHashMap();item.put(_id, contact.get_id();item.put(name, contact.getName();item.put(phone, contact.getPhone();data.add(item);/生成AdapterSimpleAdapter adapter =newSimpleAdapter(this, data,R.layout.contactitem,newString _id,name,phone,newint R.id.tv_id, R.id.tv_name, R.id.tv_phone);/设置ListView适配器lv.setAdapter(adapter);/为ListView添加事件lv.setOnItemClickListener(newOnItemClickListener() OverridepublicvoidonItemClick(AdapterView parent, View view,intposition,longid) HashMap item = (HashMap) parent.getItemAtPosition(int) id);Toast.makeText(AndroidSQLite.this, item.get(name).toString(),1).show(););上面编写的分页显示数据比较麻烦，Android为我们提供了一个SimpleCursorAdapter类。使用它可以方便的显示分页数据。