android简单实例-----------------使用SQLiteOpenHelper以及SQLiteDatabase

android的一大亮点是内嵌了轻量级的数据库sqlite,这里不写sqlite的简介了。只写一下如何快速使用sqlite的简单实例。值得注意的是:你所创建的数据库文件也在/data/data/<包名>/目录下的database文件夹下面,也属于内部存储,所以程序卸载了以后,数据库内容就没有了(注意,不是android的sqlite数据库没了

-------------------------------------------------------

第一步:如何创建数据库:

代码:

public class DBHelper extends SQLiteOpenHelper {

	/**
	 * 
	 * @param context  上下文...不用多说了
	 * @param name  数据库名字  例如:school.db
	 * @param factory  游标工厂  数据库查询结果集会以一个类似List的Cursor对象返回,
	 * 				       而这传入的Cursor工厂对象用来生产对应功能的Cursor,我们一般传入null,
	 * 				      传入null代表使用系统默认自带的CursorFactory。
	 * @param version  数据库版本号,第一次一般传入1,但是注意,系统默认第一次创建的版本号为0
	 */
	public DBHelper(Context context, String name, CursorFactory factory,
			int version) {
		super(context, name, factory, version);
	}

	/**
	 * 数据库初始化的时候调用,只执行一次
	 * 一般用来创建表等语句
	 */
	@Override
	public void onCreate(SQLiteDatabase db) {
		/**
		 * 此方法会被系统回调,并返回一个SQLiteDatabase对象供我们使用,
		 * 操作此对象便可以对数据库进行操作
		 */
		db.execSQL("create table student(" +
				"id integer primary key," +
				"name text" +
				")");
		Log.i("MainActivity", "helper--onCreate---->创建表");
	}

	/**
	 * 当构造方法中version参数传入的值与上一次实例化时传入的值不一样时调用此方法
	 * 也就是数据库升级时调用此方法
	 * 数据库版本默认0
	 */
	@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
		
	}

}

1、写一个类,继承android提供的SQLiteOpenHelper类,实现里面的两个抽象方法,然后每个方法是什么作用,以及方法中的参数都是什么意思上述代码都标识清晰,请细看。

2、这时候我们还不能直接操作数据库,必须得进行如下操作:

//创建帮助类实例
		DBHelper dbHelper = new DBHelper(this, "student.db", null, 1);
		/**
		 * getWritableDatabase() :以可以读写方式获取数据库实例
		 * getReadableDatabase() ; 以只读方式获取数据库实例
		 * 只有通过调用上述两个方法之一 ,才会去真正执行DBHelper 中的onCreate()方法
		 */
		//获取数据库对象
		SQLiteDatabase db = dbHelper.getWritableDatabase();

实例化DBhelper,并且调用getWritableDatabase()可以得到一个真正的 数据库实例对象,我们操作这个对象便可以对数据库进行一系列的操作。getWritableDatabase()方法和getReadableDatabase()方法的区别上面说的很清楚,后面会从源码角度看一下的。

3、这个时候,我们DBHelper类中的onCreate()方法就会被真正的执行。我们的表也就会被创建成功(数据库存储路径)student.db ,里一个文件student..db-journal为日志文件不用关心:


导出数据库表:


使用可视化工具SQLite Expert Personal 3查看:


我们可以看到数据库与表创建成功,其实代码过程还是很简单的,贴这么多图就是为了方便有些第一次使用的童鞋各种找不到,不知道android数据库文件保存到哪了,不知道如何导出等等问题。

二:

数据库增加数据:

代码:

//执行SQL语句
		/**
		 * 不难理解,第一个参数写sql语句,将数据真实值用?占位符占位
		 * 第二个参数:依次替换占位符中的值,比如1替换第一个?,“wu”替换第二个问号
		 */
		db.execSQL("insert into student (id,name) values(?,?)",new String[]{1+"","wu"});

因为上面已经获取到SQLiteDatabase实例db。所以直接执行此语句就可以了。看一下结果:

好的,添加已经成功了,详细那会SQL的童鞋一下就知道该怎么用了。

三:

删除数据:

//删除数据:
		db.execSQL("delete from student where id = ?",new String[]{1+""});

结果:

上一条数据已经没有了。。。看到没只要会写SQL语句可以很简单的使用sqlite数据库,当然android也为我们封装很多诸如insert,delete,update等方法,说是为了方便不会sql语句的人使用。。可是参数之多让人咋舌,不会sql语句的人更不会明白这个参数为什么填这啊。。其实底层都是拼接sql,所以我们这里不对那种方法讲解了。有时间还不如去学学sql。值得说一下的是,有人发现我id是Integer类型,第二参数却是用的是String类型的数据。。说实话,SQLite是个弱类型的数据库。虽然声明了Integer,但是String数据也能插入,比如”1“。。。而且第二个参数可以传入Object类型的数据,如果不习惯了那直接new Object[]{}就行,对应数据类型写入就行了。

三:更改数据:

代码:

		//更新数据:
		db.execSQL("update student set name = ? where id = ?",new Object[]{"更改之后的",1});

结果:

可以看到,new Object[]{1}也是木有问题的噢⊙0⊙。。。。

四:查询数据:

代码:

//创建帮助类实例
		DBHelper dbHelper = new DBHelper(this, "student.db", null, 2);
		/**
		 * getWritableDatabase() :以可以读写方式获取数据库实例
		 * getReadableDatabase() ; 以只读方式获取数据库实例(内部其实也是调用了getWritableDatabase())
		 * 只有通过调用上述两个方法之一 ,才会去真正执行DBHelper 中的onCreate()方法
		 */
		//获取数据库对象
		SQLiteDatabase db = dbHelper.getWritableDatabase();
		
		//查询数据:
		/**
		 * 此处有别于其他上面的操作。因为查询操作会返回一个Cursor结果集
		 * 
		 */
		Cursor cursor = db.rawQuery("select * from student where id = ?",new String[]{1+""});
		
		while(cursor.moveToNext()){//指针后移
			//获取数据库列索引
			int index = cursor.getColumnIndex("name");
			//获取对应索引的值
			String name = cursor.getString(index);
			
			Log.i("MainActivity",name);
		}

查询操作是最常用的,值得仔细讲一讲, 除了调用方法为rawQuryt()外,其他查询sql还是一样不用说了。返回Cursor对象是结果集,操作这个结果集需要说一下,看一下这个结果集的模型:


画的不好哎。。那个箭头代表游标。。。主要是这个Cursor是一条一条的数据。索引从0开始,那么我们如何来获取数据呢。

cursor.moveToNext()放发就表示游标从-1(假设)移到0,这是就有数据了,接着通过cursor.getColumnIndex("name")获取表的列在Cursor这一条数据中的列索引,然后再通过getString(index)来获取具体数据。可以是getInt(),getBoolean()等方法。。对应不同的数据类型。。当然关于游标的控制还有其他方法

cursor.move(offset) //移动指定偏移量  ,比如现在位置索引为2,调用此方法传入2 ,则游标移到了4
cursor.moveToFirst() //将游标移动到第一条数据,就是索引为0处
cursor.moveToLast() //将游标移动到最后一条数据
cursor.moveToPosition(position) //将游标移动到指定索引处
 cursor.moveToPrevious() //将游标前移一位

好了。。。


更新数据库:

代码:

//创建帮助类实例
		//注意此处传入的最后一个参数,版本号已经变为了2,上次是1
		DBHelper dbHelper = new DBHelper(this, "student.db", null, 2);
		/**
		 * getWritableDatabase() :以可以读写方式获取数据库实例
		 * getReadableDatabase() ; 以只读方式获取数据库实例(内部其实也是调用了getWritableDatabase())
		 * 只有通过调用上述两个方法之一 ,才会去真正执行DBHelper 中的onCreate()方法
		 */
		//获取数据库对象
		//这样再次获得实例的时候,便会执行dbHelper中的onUpgrade()方法
		SQLiteDatabase db = dbHelper.getWritableDatabase();
onUpgrade()方法中的代码:

@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
		/**
		 * 执行一条修改数据库表的语句来模拟数据库升级
		 * 因为真正的数据库升级也无非是对表字段的增删改查,或者增加表等
		 * 可以看到这时execSQL()方法传入了一个参数,这是一个重载方法,有这两种形式
		 * 这种形式就是执行一条完整的sql语句,对于变更参数的sql语句,如增删改查,还是使用两个参数的方便
		 */
		db.execSQL("alter table student add age integer");
		
		Log.i("MainActivity", "onUpgrade---->执行成功");
	}


结果:

可以看出来onUpgrade()方法被调用了。这就是更新数据库,只要版本号比上一次大就会执行这个更新方法。。有人说版本号比上一次的小怎么办?我来看源码:

db.beginTransaction();
                try {
                    if (version == 0) {
                        onCreate(db);
                    } else {
                        if (version > mNewVersion) {
                            onDowngrade(db, version, mNewVersion);
                        } else {
                            onUpgrade(db, version, mNewVersion);
                        }
                    }
                    db.setVersion(mNewVersion);
                    db.setTransactionSuccessful();
                } finally {
                    db.endTransaction();
                }

可以看到这段代码的逻辑:如果当前版本号为0就执行onCreate()方法,如果当前版本号大于传进来的版本号(换句话说就是这次传入的版本号比上次传入的小),那么去执行onDowngrade()这个方法,如果如果当前版本号小于等于传进来的版本号(换句话说就是这次传入的版本号比上次传入的大),就执行onUpgrade方法。我们就来看一下这个方法的源码:

 public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        throw new SQLiteException("Can't downgrade database from version " +
                oldVersion + " to " + newVersion);
    }

哈哈哈哈哈。。。。。抛个异常。。奇葩了也是, 果然传入的版本号比原来的小是不行的。。



有人会问那等于呢?看源码:

 if (version != mNewVersion) 

哈哈执行判断大于或者小于的入口就是不等于,如果等于的话,执行的是直接打开数据库的操作。


好了,既然涉及到源码,我们在最后再来从源码角度来解析一下getReadableDatabase()放和getWritableDatabase()方法。

  public SQLiteDatabase getWritableDatabase() {
        synchronized (this) {
            return getDatabaseLocked(true);
        }
    }

 public SQLiteDatabase getReadableDatabase() {
        synchronized (this) {
            return getDatabaseLocked(false);
        }
    }

可以看到两方法竟然。。一样。。。都调用了getDatabaseLocked(boolean )方法不过传入的值不一样。那么看看这个方法:

  if (DEBUG_STRICT_READONLY && !writable) {
                        final String path = mContext.getDatabasePath(mName).getPath();
                        db = SQLiteDatabase.openDatabase(path, mFactory,
                                SQLiteDatabase.OPEN_READONLY, mErrorHandler);
                    } else {
                        db = mContext.openOrCreateDatabase(mName, mEnableWriteAheadLogging ?
                                Context.MODE_ENABLE_WRITE_AHEAD_LOGGING : 0,
                                mFactory, mErrorHandler);
                    }
由于源码比较多。。就截取一部分看一下,上面的if()判断逻辑。只有writable为false才会执行第一条分支。而false是getReadableDatabase()传入的。说明只有getReadableDatabase执行的第一分支。来看看第一分支是什么逻辑,第一分支的意思是如果数据库已满(因为库或者表示有大小限制的),那么用只读方式打开数据库。。


对了 ,这里提一点,因为数据库版本涉及对应新用户的向上兼容,所以更新操作如果只在onUpGrade方法中写了,那么如果是一个新用户下载了最新的版本客户端,那么此客户端的数据库还是老版本onCreate方法创建的,所以为了避免这个问题,如果在onUpGrage方法中进行了更新的操作,将同样的操作请放一份在onCreate()方法中。


好了。。。说是简单使用,说了这么多源码。。。 有些方法将的比较细,有的随便说了说。


-------------------------------------------------------

原创,我在这里说明一下,这里的例子都是非常简单的例子,更适合初学者,只有先学会用,才能研究更深层次的东西,初学者千万不要陷入诸如每个参数到底是什么意思,这里不这样,如果那样会怎么样,这是无穷无尽的问题,非常影响入门,只有用熟悉之后,才更容易的去纠结这些东西,所以我在这里不写这些东西了。只适合初学者看看的例子。。。

你可能感兴趣的:(android-例子,android)