简介:
litepal是郭霖的一款开源的android数据库框架,采用关系映射(ORM)的模式,这是github
地址,最新版本已经更新到1.6,支持eclipse,gridle使用如下:
compile 'org.litepal.android:core:1.6.0'
配置:
创建assets目录,新建litepal.xml文件:
litepal初始化有两种方式:
1.将你清单文件的Application换成LitePalApplication
android:name="org.litepal.LitePalApplication"
...
>
...
2.将你的Application继承自Application,然后在onCreat(),进行litepal的初始化
public class MyOwnApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
LitePal.initialize(this);
}
...
}
使用litepal
创建实体类
litepal需要用于映射的实体类需要继承DataSupport,并生成get和set方法,关于这两个方法,推荐一个库:
lombok,gridle使用添加:
compile 'org.projectlombok:lombok:1.16.18'
添加之后你的get和set方法只用在类名上面添加注解@Data就可以了,如下
@Data
public class Man{
@Column(unique = true, defaultValue = "unknown")
private int age;
private String name;
}
实体类支持注解约束:
@Column(unique = true) //是否唯一
@Column(defaultValue = "unknown") //指定字段默认值
@Column(nullable = false) //是否可以为空
@Column(ignore = true) //是否可以忽略
修改litepal.xml
当你添加表或修改表结构,都要修改litepal.xml,首先版本号要+1,如果添加表,还要添加
添加数据
Album album = new Album();
album.setName("album");
album.setPrice(10.99f);
album.setCover(getCoverImageBytes());
album.save();
Song song1 = new Song();
song1.setName("song1");
song1.setDuration(320);
song1.setAlbum(album);
song1.save();
Song song2 = new Song();
song2.setName("song2");
song2.setDuration(356);
song2.setAlbum(album);
song2.save();
更新数据
1.指定id:
Album albumToUpdate = new Album();
albumToUpdate.setPrice(20.99f); // raise the price
albumToUpdate.update(2);
2.条件更新:
Album albumToUpdate = new Album();
albumToUpdate.setPrice(20.99f); // raise the price
albumToUpdate.updateAll("name = ?", "小明");
3.多个条件用and连接
Album album= new Album();
album.setTitle("第3次更新");
album.updateAll("title = ? and age> ?", "第2次更新", "12");
4.更新全部数据,将表所有数据名字修改:
Man values = new Man();
values.put("Name", "小化工");
DataSupport.updateAll(Man.class, values);
5.异步更新数据
Album album = new Album();
album.setName("album");
album.setPrice(10.99f);
album.setCover(getCoverImageBytes());
album.saveAsync().listen(new SaveCallback() {
@Override
public void onFinish(boolean success) {
}
});
删除数据
1.指定ID
DataSupport.delete(Man.class, id);
2.条件删除,多个条件用and连接
DataSupport.deleteAll(Man.class, "age > ?" , "15");
3.删除全表数据
DataSupport.deleteAll(Man.class);
查询数据
1.查询第一条以及最后一条
News firstNews = DataSupport.findFirst(News.class);
News lastNews = DataSupport.findLast(News.class);
2.指定id
Song song = DataSupport.find(Song.class, id);
//指定多个id如下
//方式一:
List newsList = DataSupport.findAll(News.class, 1, 3, 5, 7);
//方式二:
long[] ids = new long[] { 1, 3, 5, 7 };
List newsList = DataSupport.findAll(News.class, ids);
3.查询所有
List allSongs = DataSupport.findAll(Song.class);
4.条件查询
查询 Man表 中 年龄大于12 的 第5到20条 数据,以插入时间倒序 排序方式呈现,只取 “名字”和“性别”和“身高” 三列内容。
List list = DataSupport.select("name", "sex","height")//需要的条目
.where("age> ?", "12")//条件
.order("inputTime desc")//倒序字段
.offset(5)//开始查询位置
.limit(15)//数据长度
.find(Man.class);//查询表
5.异步查询,用于代替findAll
DataSupport.findAllAsync(Song.class).listen(new FindMultiCallback() {
@Override
public void onFinish(List t) {
List allSongs = (List) t;
}
});
删除数据库
LitePal.deleteDatabase("数据库名");
完结