android数据库框架ormlite的使用

开篇：相信大家在android开发过程中大多数项目都需要使用android的数据库sqllite，但是每次直接利用android提供的api来增删改查数据表有点繁琐，做javaweb的都知道有一款数据库框架叫Hibernate ，android端同样有类似这样的框架，下面就给大家介绍这款框架ormlite的使用。orm就是对象关系映射的意思，就是讲关系性质的数据表转化成java的的对象来操作，极大的符合我们java开发人员的思维模式，也免去了不少重复性的代码编写。

1.下载所需jar包

到http://ormlite.com/releases/ 该网站下载所需jar包，android端使用需要下载以下两个jar包（红框圈出来的），一个是ormlite-core-5.0.jar（该包是ormlite的核心代码包），一个是ormlite-android-5.0.jar（该包是在android工程中所需的jar包，如果在普通java工程或者javaweb工程中则使用核心包和另一个jar包ormlite-jdbc-5.0.jar）。

2.新建android工程，考入jar包

新建工程，在libs目录下考入刚下载的两个jar包，如下图所示：

3.接下来编写一个简单的存储并读取用户信息的代码。

  （1）先编写userbean类，该类的字段和表字段一一对应，代码如下：

package com.example.androidormlitedemo;

import com.j256.ormlite.field.DatabaseField;
import com.j256.ormlite.table.DatabaseTable;
//用注解标示该类和表user来映射，如果不写tableName则会默认用该类的类名来当做表名。
@DatabaseTable(tableName="user")
public class UserBean {
	//用注解标示字段和表中的字段来对应，id=true表示该字段为主键。
	@DatabaseField(id=true)
	private int uid;
	//普通字段则不用写括号
	@DatabaseField
	private String uname;
	@DatabaseField
	private int age;
	public int getUid() {
		return uid;
	}
	public void setUid(int uid) {
		this.uid = uid;
	}
	public String getUname() {
		return uname;
	}
	public void setUname(String uname) {
		this.uname = uname;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	
}

（2）编写DatabaseHelper类继承OrmLiteSqliteOpenHelper：

package com.example.androidormlitedemo;

import java.sql.SQLException;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;

import com.j256.ormlite.android.apptools.OrmLiteSqliteOpenHelper;
import com.j256.ormlite.support.ConnectionSource;
import com.j256.ormlite.table.TableUtils;

public class DatabaseHelper extends OrmLiteSqliteOpenHelper {
	// 数据库名称，会在程序的目录中生成test_db.db数据库文件
	public static String DATABASE_NAME = "test_db";
	// 数据库version
	private static final int DATABASE_VERSION = 1;

	public DatabaseHelper(Context context) {
		super(context, DATABASE_NAME, null, DATABASE_VERSION);
	}

	public DatabaseHelper(Context context, String databaseName, CursorFactory factory, int databaseVersion) {
		super(context, databaseName, factory, databaseVersion);

	}
	// 初次运行程序会执行该onCreate方法,如果不是初次运行程序则不会执行该方法,防止重复建表。
	@Override
	public void onCreate(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource) {
		try {
			//建立User表
			TableUtils.createTable(connectionSource, UserBean.class);
		} catch (SQLException e) {
			e.printStackTrace();
		}

	}
	//如果不是初次运行并且DATABASE_VERSION数值增加的时候，则会执行该方法，可以在该方法中删除原来的表并建立新表，在要修改数据表结构的时候使用。
	@Override
	public void onUpgrade(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource, int oldVersion, int newVersion) {
		try {
			TableUtils.dropTable(connectionSource, UserBean.class, true);
			onCreate(sqLiteDatabase, connectionSource);
		} catch (SQLException e) {
			e.printStackTrace();
		}
	}

	/**
	 * 释放 DAO
	 */
	@Override
	public void close() {
		super.close();
	}

}

（3）编写dao类，先简单的写一个存储方法和一个查询方法。

package com.example.androidormlitedemo;

import java.sql.SQLException;

import android.content.Context;

import com.j256.ormlite.android.apptools.OpenHelperManager;
import com.j256.ormlite.dao.Dao;

public class UserDao {
	private Dao<UserBean, Integer> dao;

	public UserDao(Context context) {
		DatabaseHelper dbHelper = OpenHelperManager.getHelper(context, DatabaseHelper.class);
		try {
			dao = dbHelper.getDao(UserBean.class);
		} catch (SQLException e) {
			e.printStackTrace();
		}
	}

	// 保存一条用户信息
	public void savaUser(UserBean bean) {
		try {
			// 如果表中没有该用户则保存，根据主键是否相同来标示是否是同一用户
			dao.createIfNotExists(bean);
		} catch (SQLException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
	//根据id获取用户信息
	public UserBean getUserById(int id) {
		try {
			return dao.queryForId(id);
		} catch (SQLException e) {
			e.printStackTrace();
			return null;
		}

	}

}

（4）使用上面创建的dao来保存一个用户并读取改用户信息，示例代码如下：

package com.example.androidormlitedemo;

import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;

public class MainActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		TextView textView = (TextView) findViewById(R.id.text);
		
		//模拟创建一个用户信息
		UserBean userBean = new UserBean();
		userBean.setUid(1);
		userBean.setUname("张全蛋");
		userBean.setAge(25);
		
		//创建dao 初次使用的时候表会自动创建，根据UserBean的字段映射成表
		UserDao userDao = new UserDao(this);
		//保存用户到表中
		userDao.savaUser(userBean);
		
		//从表中查询信息
		UserBean userByfind = userDao.getUserById(1);
		//显示查询的用户名
		textView.setText(userByfind.getUname());
		
	}
}

（5）完成，运行程序即可。

4.总结，这是ormlite的简单使用，还有更多功能，详细查看官方api，可以下载doc包，或者源码包，如下图：

5.完整Demo下载地址：http://pan.baidu.com/s/1pL3xGaJ