onCreate(sqliteDatabase db) : 当数据库被首次创建时执行该方法,一般将创建表等初始化操作在该方法中执行。
nUpgrade(sqliteDatabse dv,int oldVersion,int new Version):当打开数据库时传入的版本号与当前的版本号不同时会调用该方法。
sqliteOpenHelper 类的基本用法是:当需要创建或打开一个数据库并获得数据库对象时,首先根据指定的文件名创建一个辅助对象,然后调用该对象的getWritableDatabase 或 getReadableDatabase方法获得sqliteDatabase 对象。
调用getReadableDatabase 方法返回的并不总是只读数据库对象,一般来说该方法和getWriteableDatabase方法的返回情况相同,只有在数据库仅开放只读权限或磁盘已满时才会返回一个只读的数据库对象。
Android类参考---sqliteOpenHelper
public 抽象类
sqliteOpenHelper
继承关系
java.lang.Object
|____android.database.sqlite.sqliteOpenHelper
类概要:这是一个辅助类,用来管理数据库的创建和数据库的版本。要创建一个这个类的子类来实现onCreate(sqliteDatabase),onUpgrade(sqliteDatabase,int,int)方法,以及可选的onOpen(sqliteDatabase)方法,并且这个类要管理数据库的状态,如果数据库存在,就打开数据库,否则就创建数据库,并且在需要的时候也会更新数据库。使用事务来确保数据库始终在正确的状态中。
这个类让ContentProvider的实现变的容易,它把数据库的打开和升级延迟到第一次使用,从而避免了因升级数据库的长时间运行而造成的应用程序阻塞。
注意:这个类假设用递增的版本号来升级。
public 构造器
public sqliteOpenHelper(Context context,String name,sqliteDatabase.CuresorFactory factory,int version)
创建一个辅助对象,用来创建、打开、管理数据库。这个方法始终是快速返回的。在getWriteableDatabase()或getReadableDatabase()方法被调用之前,这个数据库不会实际的被创建。
参数说明:
context:用于打开或创建数据库;
name:指定数据库的文件名,null指定一个内存中的数据库
factory:用于创建游标对象,或默认的null;
version:指定数据库的版本号(从1开始);如果数据库比较旧,onUpgrade(sqliteDatabase,int)方法将用于升级数据库。如果数据库比较新,onDowngrade(sqliteDatabase,int)方法会被用于降级数据库。
public sqliteOpenHelper(Context context,sqliteDatabase.CursorFactory factory,int version,DatabaseErrorHandler errorHandler)
创建一个辅助对象,用来创建、打开、管理数据库。这个方法始终是快速返回的。在getWriteableDatabase()或getReadableDatabase()方法被调用之前,这个数据库不会实际的被创建。
接收输入参数:一个具体的DatabaseErrorHandler示例,用于处理sqlite报告的数据库错误。
参数说明:
context:用于打开或创建数据库;
name:指定数据库的文件名,null指定一个内存中的数据库
factory:用于创建游标对象,或默认的null;
version:指定数据库的版本号(从1开始);如果数据库比较旧,onUpgrade(sqliteDatabase,int)方法会被用于降级数据库。
errorHandler:该参数被用于sqlite报告数据库错误,或者是null,使用默认错误处理器。
public 方法
public synchronized void close()
关闭打开的数据库对象。
public String getDatabaseName()
返回由构造器传递进来的,正在打开的sqlite数据的名称。
public sqliteDatabase getReadableDatabase()
创建并(或)打开一个数据库,除非因为某些问题,否则这个方法返回的对象会与getWritableDatabase()方法相同,如在磁盘空间不足的情况下,就会要求数据库以只读的方式被打开,在这种情况下,会返回一个只读的数据库。如果问题被修正,继续调用getWritableDatabase()方法也可以成功,这时只读的数据库对象会被关闭,并且会返回一个读写对象。
getWritableDatabase()方法可能需要很长时间才能返回,因此不应该在应用程序的主线程中调用它,包括ContentProvider.onCreate()方法。
返回值:返回一个数据库对象,直到getWritableDatabase()或close()方法被调用之前,这个对象都是有效的。
异常:如果数据不能够被打开,会抛出sqliteException异常。
public sqliteDatabase getWritableDatabase()
创建并(或)打开一个用于读写的数据库。如果是首次调用这个方法,那么该数据将会被打开,并且onCreate(sqliteDatabase),onUpgrade(sqliteDatabase,int)和(或)onOpen(sqliteDatabase)方法会被调用。
数据库一旦被打开,该数据库就会被缓存,因此在每次需要写数据库时,你都能够调用这个方法。(在不在需要该数据库时,要确保调用close()方法)。诸如没有授权或没有磁盘空间等错误可能会导致这个方法调用失败,但如果这些问题被修正,这个方法就会被调用成功。
注意:数据库升级可能需要很长时间,因此不要在应用程序的主线程中调用这个方法,包括ContentProvider.onCreate()。
返回值:一个读写的数据库对象,直到close()方法被调用才失效。
异常:如果该数据库不能为写入而打开,就会抛出sqliteException异常。
public void onConfigure()
在配置数据连接时会调用这个方法,确保预写日志或外键支持等功能可用。
这个方法在onCreate(sqliteDatabase),onUpgrade(sqliteDatabase,int),onDowngrade(sqliteDatabase,int)或onOpen(sqliteDatabase)方法被调用之前被调用。除了配置必要的数据库连接之外,它不应该编辑数据库。
这个方法只应该调用配置数据库连接参数的方法,如enableWriteAheadLogging(),setForeignKeyConstraintsEnabled(boolean),setLocale(Locale),setMaximumSize(long),或者执行PRAGMA语句。
参数:
db:被配置的数据库对象
public abstract void onCreate(sqliteDatabase db)
数据库被首次创建时,会调用这个方法。这时创建数据库表和表初始化的地方。
参数:
db:要创建的数据库。
public abstract void onUpgrade(sqliteDatabase db,int newVersion)
当数据库需要升级时,会调用这个方法。应该使用这个方法来实现删除表、添加表或者做一些需要升级新的策略版本的事情。
sqlite ALTER TABLE的文档可以在以下网址中找到:
http://sqlite.org/lang_altertable.html
如果要给表添加一个新列,那么使用使用ALTER TABLE能够把新列插入到表中。如果要重命名或删除列,那么你能够使用ALTER TABLE能够重命名旧表,然后,创建一个新表,并把旧表中内容复制到新表中。
这个方法是事务中执行的,如果有异常被抛出,所有的改变都会被自动的回滚。
参数:
db:指定要降级的数据库
oldVersion:旧的数据库版本
newVersion:新的数据库版本
public void onDowngrade(sqliteDatabase db,int newVersion)
当数据库需要被降级时,调用这个方法。这个方法与onUpgrade(sqliteDatabase,int)方法非常相似,但是它是在当前版本比请求的版本新的时候,才会被调用。但是这个方法不是抽象的,因此它不是强制要求客户实现它的。如果这个方法没有被重写,默认的实现会拒绝降级处理,并抛出sqliteException异常。
这个方法是在事务中执行的。如果有异常被抛出,所有的改变都会被回滚。
参数:
db:指定要降级的数据库
oldVersion:旧的数据库版本
newVersion:新的数据库版本
public void onOpen(sqliteDatabase db)
数据库被打开时,会调用这个方法。在升级数据库之前,这个方法的实现应该检查数据库是否是只读的(调用isReadOnly()方法)。
数据库连接被配置且数据库策略被创建、升级或必要的降级之后,这个方法会被调用。如果数据库连接必须在策略被创建、升级或降级前做某些设置,那么就要在onConfigure(sqliteDatabase)方法中来做这些事情。
参数:
db:被打开的数据库。
public void setWriteAheadLoggingEnabled(boolean enabled)
启用或禁用数据库的预写日志。预写日志不能被用于只读的数据库,因此如果数据是以只读的方式被打开,这个标记值会被忽略。
参数:
enabled:true:启用预写日志,false:禁用预写日志
参照:enableWriteAheadLogging()方法。
下面通过一个简单的小例子看一下sqliteOpenDatabase的用法
package com.haier.uhome.uAnalytics.dao; import android.content.Context; import android.database.sqlite.sqliteDatabase; import android.database.sqlite.sqliteOpenHelper; import java.util.concurrent.locks.Lock; import java.util.concurrent.locks.ReadWriteLock; import java.util.concurrent.locks.ReentrantReadWriteLock; public class DatabaseHelper extends sqliteOpenHelper { private static final String DB_NAME = "uAnalytics.db"; //数据库名称 private static final int version = 3; //数据库版本 private ReadWriteLock lock = new ReentrantReadWriteLock(true); private Lock readLock = lock.readLock(); private Lock writeLock = lock.writeLock(); public DatabaseHelper(Context context) { super(context,DB_NAME,null,version); } @Override public void onCreate(sqliteDatabase db) { onCreateTable(db); } public void onCreateTable(sqliteDatabase db) { String sql = "create TABLE IF NOT EXISTS uanalytics_table(item_id integer PRIMARY KEY autoincrement,session bigint,contentdata byte,uid TEXT,timedate time,cmd int)"; db.execsql(sql); } public void dropTable(sqliteDatabase db) { String sql = "drop table uanalytics_table"; db.execsql(sql); } @Override public void onUpgrade(sqliteDatabase db,int newVersion) { if (oldVersion < newVersion) { dropTable(db); onCreateTable(db); } } @Override public void onDowngrade(sqliteDatabase db,int newVersion) { if (oldVersion > newVersion) { dropTable(db); onCreateTable(db); } } @Override public sqliteDatabase getReadableDatabase() { readLock.lock(); try { return super.getReadableDatabase(); } finally { readLock.unlock(); } } @Override public sqliteDatabase getWritableDatabase() { writeLock.lock(); try { return super.getWritableDatabase(); } finally { writeLock.unlock(); } } }原文链接:https://www.f2er.com/sqlite/198954.html