Android ORMLite框架入门用法教程

本文主要是介绍Android ORMLite框架入门用法教程，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

大家在Android项目中或多或少的都会使用数据库，为了提高我们的开发效率，当然少不了数据库ORM框架了，尤其是某些数据库操作特别频繁的app；本篇博客将详细介绍ORMLite的简易入门用法。

下面开始介绍ORMLite的入门用法~

1、下载 ORMLite Jar

首先去ORMLite官网下载jar包，对于Android为：ormlite-android-4.48.jar 和 ormlite-core-4.48.jar ；

ps:访问不了的朋友，文章末尾会把jar、源码、doc与本篇博客例子一起打包提供给大家下载。

2、基本项目实例结构图

1）、bean包下为实体类，也就是每个实体类对应一张数据库表，如本实例的User.java类对应数据库的tb_user表，也就是说你有几张表你就要对应有几个实体类。

2）、db包下为DatabaseHelper.java类，这个类是继承于ORMLITE框架里面的OrmLiteSqliteOpenHelper类的，然后在里面实现一些必要的方法，外部在用这个继承类来操作数据库

3）、test包下为测试用例类，用来测试我们写的是否可以运行

总体流程大概这样：下载ormlite的加包，加入到你的项目工程里面去，然后你的项目需要几张表就对应的建立几个实体类，实体类的字段要跟数据库表里面的字段是一致的，然后自定义一个类去继承ORMLITE框架里面的OrmLiteSqliteOpenHelper类，复写里面的onCreate、onUpgrade方法等，然后外部在用这个类去实现对数据库的操作即可。

详情看下面代码：

User.java:

package com.example.ormlitedemo.bean;
import com.j256.ormlite.field.DatabaseField;
import com.j256.ormlite.table.DatabaseTable;
/*** 注解* @author Jerry*tableName="tb_user"表示对应的数据库表叫：tb_user表*/
@DatabaseTable(tableName="tb_user")
public class User {//generatedId=true：表示是主键@DatabaseField(generatedId=true)private int id;//columnName="name"：表示对应数据库表tb_user表里面的name字段@DatabaseField(columnName="name")private String name;//columnName="name"：表示对应数据库表tb_user表里面的age字段@DatabaseField(columnName="age")private int age;//columnName="name"：表示对应数据库表tb_user表里面的sex字段@DatabaseField(columnName="sex")private String sex;public User(){}public User( String name, int age, String sex) {//super();this.name = name;this.age = age;this.sex = sex;}public User(int id, String name, int age, String sex) {//super();this.id = id;this.name = name;this.age = age;this.sex = sex;}public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}@Override
public String toString() {return "ID:"+id+"\tNAME:"+name+"\tAGE:"+age+"\tSEX:"+sex;
}
}

DatabaseHelper.java:

package com.example.ormlitedemo.db;import java.sql.SQLException;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import com.example.ormlitedemo.bean.User;
import com.j256.ormlite.android.apptools.OrmLiteSqliteOpenHelper;
import com.j256.ormlite.dao.Dao;
import com.j256.ormlite.support.ConnectionSource;
import com.j256.ormlite.table.TableUtils;public class DatabaseHelper extends OrmLiteSqliteOpenHelper {// 数据库名字private static final String TABLE_NAME = "ormlite-test.db";// 表的Dao，每一张表对应一个Daoprivate Dao<User, Integer> userDao;// 构造函数，私有的外部不能直接访问private DatabaseHelper(Context context) {super(context, TABLE_NAME, null, 1);}@Overridepublic void onCreate(SQLiteDatabase database,ConnectionSource connectionSource) {try {// 通过TableUtils这个类新建User类对应的表TableUtils.createTable(connectionSource, User.class);} catch (SQLException e) {e.printStackTrace();}}@Overridepublic void onUpgrade(SQLiteDatabase database,ConnectionSource connectionSource, int oldVersion, int newVersion) {try {// 删除表TableUtils.dropTable(connectionSource, User.class, true);// 再建表onCreate(database, connectionSource);} catch (SQLException e) {e.printStackTrace();}}// DatabaseHelper实例private static DatabaseHelper instance;/*** 单例模式获取实例* * @param context* @return*/public static synchronized DatabaseHelper getHelper(Context context) {if (instance == null) {synchronized (DatabaseHelper.class) {if (instance == null)instance = new DatabaseHelper(context);}}return instance;}/*** 获取UserDao* * @return* @throws SQLException*/public Dao<User, Integer> getUserDao() throws SQLException {if (userDao == null) {userDao = getDao(User.class);}return userDao;}/*** 释放*/@Overridepublic void close() {super.close();userDao = null;}
}

OrmLiteDbTest.java

package com.example.ormlitedemo.test;import java.sql.SQLException;
import java.util.List;
import com.example.ormlitedemo.bean.User;
import com.example.ormlitedemo.db.DatabaseHelper;import android.test.AndroidTestCase;
/*** 测试* @author Jerry**/
public class OrmLiteDbTest extends AndroidTestCase 
{/*** 增*/public void addUserTest(){DatabaseHelper helper = DatabaseHelper.getHelper(getContext());try {User u1=new User("stb", 22, "男");helper.getUserDao().create(u1);User u2=new User("stb2", 23, "男");helper.getUserDao().create(u2);User u3=new User("stb3", 24, "男");helper.getUserDao().create(u3);} catch (SQLException e) {e.printStackTrace();}}/*** 删*/public void delUserTest(){DatabaseHelper helper=DatabaseHelper.getHelper(getContext());try {helper.getUserDao().deleteById(1);} catch (SQLException e) {e.printStackTrace();}}/*** 改*/public void updateUserTest(){DatabaseHelper helper=DatabaseHelper.getHelper(getContext());User u=new User("我爱你", 25, "女");u.setId(1);try {helper.getUserDao().update(u);} catch (SQLException e) {e.printStackTrace();}}/*** 查*/public void queryUserTest(){DatabaseHelper helper=DatabaseHelper.getHelper(getContext());List<User> list=null;try {list = helper.getUserDao().queryForAll();} catch (SQLException e) {e.printStackTrace();}if(list!=null){for(int i=0;i<list.size();i++){System.out.println(list.get(i).toString());}}}
}

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.example.ormlitedemo"android:versionCode="1"android:versionName="1.0" ><uses-sdkandroid:minSdkVersion="8"android:targetSdkVersion="19" /><applicationandroid:allowBackup="true"android:icon="@drawable/ic_launcher"android:label="@string/app_name"android:theme="@style/AppTheme" ><uses-library android:name="android.test.runner" />  <activityandroid:name="com.example.ormlitedemo.MainActivity"android:label="@string/app_name" ><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity></application><!-- 记住这个一要放在application外面，不然会出现配置错误 信息 -->  <instrumentation android:name="android.test.InstrumentationTestRunner"  android:targetPackage="com.example.ormlitedemo" android:label="Tests for My App" />  
</manifest>

注意：用AndroidTestCase测试记得要配置以下两个：

<uses-library android:name="android.test.runner" />

ps:User.java里面的空的构造方法记得要写不然会报错。

测试效果：

增加后查询结果：