簡(jiǎn)介:
litepal是郭霖的一款開源的android數(shù)據(jù)庫(kù)框架,采用關(guān)系映射(ORM)的模式,這是github
地址,最新版本已經(jīng)更新到1.6,支持eclipse,gridle使用如下:
compile 'org.litepal.android:core:1.6.0'
配置:
創(chuàng)建assets
目錄,新建litepal.xml
文件:
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<!--數(shù)據(jù)庫(kù)名字 -->
<dbname value="demo" />
<!--數(shù)據(jù)庫(kù)版本 -->
<version value="1" />
<!--數(shù)據(jù)庫(kù)實(shí)體類,用于映射-->
<list>
<mapping class="com.test.model.Reader" />
<mapping class="com.test.model.Magazine" />
</list>
</litepal>
litepal初始化有兩種方式:
1.將你清單文件的Application
換成LitePalApplication
<manifest>
<application
android:name="org.litepal.LitePalApplication"
...
>
...
</application>
</manifest>
2.將你的Application
繼承自Application
,然后在onCreat(),進(jìn)行litepal
的初始化
public class MyOwnApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
LitePal.initialize(this);
}
...
}
使用litepal
創(chuàng)建實(shí)體類
litepal
需要用于映射的實(shí)體類需要繼承DataSupport
,并生成get和set方法,關(guān)于這兩個(gè)方法,推薦一個(gè)庫(kù):
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;
}
實(shí)體類支持注解約束:
@Column(unique = true) //是否唯一
@Column(defaultValue = "unknown") //指定字段默認(rèn)值
@Column(nullable = false) //是否可以為空
@Column(ignore = true) //是否可以忽略
修改litepal.xml
當(dāng)你添加表或修改表結(jié)構(gòu),都要修改litepal.xml,首先版本號(hào)要+1,如果添加表,還要添加
<list>
<mapping class="com.example.alguojian.bean.Man"></mapping>
</list>
添加數(shù)據(jù)
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();
更新數(shù)據(jù)
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.多個(gè)條件用and連接
Album album= new Album();
album.setTitle("第3次更新");
album.updateAll("title = ? and age> ?", "第2次更新", "12");
4.更新全部數(shù)據(jù),將表所有數(shù)據(jù)名字修改:
Man values = new Man();
values.put("Name", "小化工");
DataSupport.updateAll(Man.class, values);
5.異步更新數(shù)據(jù)
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) {
}
});
刪除數(shù)據(jù)
1.指定ID
DataSupport.delete(Man.class, id);
2.條件刪除,多個(gè)條件用and連接
DataSupport.deleteAll(Man.class, "age > ?" , "15");
3.刪除全表數(shù)據(jù)
DataSupport.deleteAll(Man.class);
查詢數(shù)據(jù)
1.查詢第一條以及最后一條
News firstNews = DataSupport.findFirst(News.class);
News lastNews = DataSupport.findLast(News.class);
2.指定id
Song song = DataSupport.find(Song.class, id);
//指定多個(gè)id如下
//方式一:
List<News> newsList = DataSupport.findAll(News.class, 1, 3, 5, 7);
//方式二:
long[] ids = new long[] { 1, 3, 5, 7 };
List<News> newsList = DataSupport.findAll(News.class, ids);
3.查詢所有
List<Song> allSongs = DataSupport.findAll(Song.class);
4.條件查詢
查詢 Man表 中 年齡大于12 的 第5到20條 數(shù)據(jù),以插入時(shí)間倒序 排序方式呈現(xiàn),只取 “名字”和“性別”和“身高” 三列內(nèi)容。
List<Man> list = DataSupport.select("name", "sex","height")//需要的條目
.where("age> ?", "12")//條件
.order("inputTime desc")//倒序字段
.offset(5)//開始查詢位置
.limit(15)//數(shù)據(jù)長(zhǎng)度
.find(Man.class);//查詢表
5.異步查詢,用于代替findAll
DataSupport.findAllAsync(Song.class).listen(new FindMultiCallback() {
@Override
public <T> void onFinish(List<T> t) {
List<Song> allSongs = (List<Song>) t;
}
});
刪除數(shù)據(jù)庫(kù)
LitePal.deleteDatabase("數(shù)據(jù)庫(kù)名");
完結(jié)
關(guān)于litepal更多用法可以查看源碼
github地址:https://github.com/LitePalFramework/LitePal