android OrmLite 入门

android ormlite

---

大家在开发中经常会用到数据库，但是数据库的操作其实挺繁琐的，为了方便我们的使用，所以我们来使用当下流行的orm框架进行数据库的操作，下面来简单的介绍一下怎么使用OrmLite框架.

1.下载jar包

可以到官网去下载ormlite的jar包 下载地址 
我这里使用的是ormlite-core-5.0.jar 和 ormlite-android-5.0.jar 
将下载的jar包放到我们项目的libs文件夹下

2.创建我们的实体类

每一个实体类对应一张表，在我们项目中的bean目录下创建一个Student类

@DatabaseTable(tableName = Student.TABLE_NAME)public class Student {    public static final String TABLE_NAME = "t_student";    @DatabaseField(generatedId = true)    private int id;    @DatabaseField(columnName = "name")    private String name;    //空的构造方法一定要有，否则数据库会创建失败    public Student() {    }    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;    }    @Override    public String toString() {        return "Student{" +                "id=" + id +                ", name='" + name + '\'' +                '}';    }}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

类中使用了 @DatabaseTable和@DatabaseField 两个注解来分别确定了表名称和表字段

注解说明

1.@DatabaseTable

DatabaseTable是一个类注解，一般用在实体类的上面，被添加该注解的类会创建一张表,表名称默认为类名称的小写，我们也可以通过 tableName 来指定表名称

2.@DatabaseField

DatabaseField是一个属性注解，使用在被添加DatabaseTable注解的类中的属性字段上，被添加该注解的类字段，在表中也会有一个相对应的表字段 
常用参数:

generatedId = treu 
主键，自动生成id 该注解下的字段必须是整形(int ,long)

id = true 
主键

unique = true 
唯一约束 默认false

columnName = “name” 
表字段名，默认为变量名称

canBeNull = false 
非空约束，默认为true，可以为null,设为false就是不能为null

foreign = true 
外键引用，字段不能是一个原始类型，应该定义一个对象当做外键引用，在外键对象的类中，必须要有一个ID字段（ID， generatedId，generatedIdSequence）

foreignAutoRefresh = true 
在使用外键引用时，由于ormlite的外键引用使用的是对象，所以添加这个字段的话在查询时，会吧外键的对象数据都查询回来，否者外键数据就只有那个对象的主键有值，其余的值都是null

defaultValue = “老王” 
默认值

index = true 
建立索引 默认为false

uniqueIndex = true 
唯一索引 默认为false

---

3.编写我们的数据操作类 helper类

这里我们进行数据库和表的创建

public class DatabaseHelper extends OrmLiteSqliteOpenHelper {    private static final String DB_NAME = "db_myorm";    private static final int DB_VERSION = 1;    private static DatabaseHelper instance;    private DatabaseHelper(Context context) {        super(context, DB_NAME, null, DB_VERSION);    }    public static DatabaseHelper getInstance(Context context){        if(instance == null){            synchronized (DatabaseHelper.class){                if(instance == null){                    instance = new DatabaseHelper(context.getApplicationContext());                }            }        }        return instance;    }    @Override    public void onCreate(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource) {        try {            TableUtils.createTable(connectionSource, Student.class);        } catch (SQLException e) {            e.printStackTrace();        }    }    @Override    public void onUpgrade(SQLiteDatabase sqLiteDatabase, ConnectionSource connectionSource, int i, int i1) {        try {            TableUtils.dropTable(connectionSource,Student.class,true);            onCreate(sqLiteDatabase,connectionSource);        } catch (SQLException e) {            e.printStackTrace();        }    }    public Dao getDao(Class clazz) throws SQLException {        return super.getDao(clazz);    }}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

我们的Helper类要继承自OrmLiteSqliteOpenHelper，需要重写onCreate和onUpgrage方法 
在onCreate里只需要一句话就可以创建我们的表。 
当数据库版本发生变化时会走onUpgrade，我们这里暂时先删除原来的表，在重新创建

4.编写我们的Dao类进行crud操作

其实crud操作OrmLite已经帮我们做好了，我们这里在封装一层， 
我们的dao类是从helper类中获取的,我们来看一下代码:

public class StudentDao {    //两个泛型约束 一个是对应的实体类类型，一个是主键类型    private Dao<Student,Integer> dao;    public StudentDao(Context context) {        try {            dao = DatabaseHelper.getInstance(context).getDao(Student.class);        } catch (SQLException e) {            e.printStackTrace();        }    }    public int add(Student student){        try {            return dao.create(student);        } catch (SQLException e) {            e.printStackTrace();        }        return -1;    }    public Student query(int id){        try {            return dao.queryForId(id);        } catch (SQLException e) {            e.printStackTrace();        }        return null;    }    public int updata(Student student){        try {            return dao.update(student);        } catch (SQLException e) {            e.printStackTrace();        }        return -1;    }    public int delete(int id){        try {            return dao.deleteById(id);        } catch (SQLException e) {            e.printStackTrace();        }        return -1;    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

5.总结

到这里基本上是已经完成了我们的OrmLite的使用。后面我还会在写一篇关于ormLite的实际应用，包括外键的引用，数据库升级时，onUpgrade方法中正确的做法，而不是简单的删表了事。