一、LitePal简介
1、(新建项目LitePalTest)
正式接触第一个开源库---LitePalLitePal是一款开源的Android 数据库框架，它采用了对象关系映射（ORM）的模式。
2、配置LitePal，编辑app/build.gradle文件，在dependencies闭包中添加如下内容：
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:26.1.0'
implementation 'com.android.support.constraint:constraint-layout:1.0.2'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.1'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
compile 'org.litepal.android:core:1.4.1'
}
这样我们就成功把LitePal成功引入当前项目中了，接下来需要配置litepal.xml文件。右击app/src/main目录,new一个
Directory，命名为assets，然后在assets目录下，新建一个litepal.xml。编辑，添加代码，如下：
<?xml version="1.0" encoding="utf-8" ?>
<litepal>
<dbname value = "BookStore222">
</dbname>
<version value = "1">
</version>
<list>
</list>
</litepal>
其中，<daname>标签用于指定数据库名，<version>标签用于指定数据库版本号，<list>标签用于指定所有的映射模型。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.litepaltest">
<application
android:name="org.litepal.LitePalApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
我们项目的application配置为org.litepal.LitePalApplication，只有这样才能让LitePal的所有功能都可以正常
工作，关于application的作用，我们再行介绍。
二、创建和升级数据库
LitPal采取的是对象关系映射(ORM)的模式，简单说就是我们使用的编程语言是面向对象语言，而使用的数据库是
关系型数据库，那么将面向对象的语言和面向关系的数据库之间建立一种映射关系，这就是对象关系映射。
使用LitePal,可以用面向对象的思维来实现功能，定义一个Book类，代码如下：
package com.example.litepaltest;
/**
* Created by ZHJ on 2018/3/4.
*/
public class Book {
private int id;
private String author;
private double price;
private int pages;
private String name;
public int getId() {
return id;
}
public String getAuthor() {
return author;
}
public double getPrice() {
return price;
}
public int getPages() {
return pages;
}
public String getName() {
return name;
}
public void setId(int id) {
this.id = id;
}
public void setAuthor(String author) {
this.author = author;
}
public void setPrice(double price) {
this.price = price;
}
public void setPages(int pages) {
this.pages = pages;
}
public void setName(String name) {
this.name = name;
}
}
这是一个典型的Java bean，在Book中我们定义了id,author,price,pages,name 这几个字段，并生成相应的getter和setter
方法（先将类中的字段定义好，按下Alt+Insert，在弹出的对话框中选择Getter和Setter，接着使用Shift将所有字段选中。就会自动生成相应的getter和setter方法。）
相信你已经猜到了，Book类就会对应数据库中的Book表，而类中的每个字段分别对应了，表中的每个列。
接下来将Book类添加到映射模型列表中，修改litepal.xml中的代码，如下：
<?xml version="1.0" encoding="utf-8" ?>
<litepal>
<dbname value = "BookStore222">
</dbname>
<version value = "1">
</version>
<list>
<mapping class = "com.example.litepaltest.Book"></mapping>
</list>
</litepal>
这里通过<mapping>标签来声明我们要配置的映射模型类，注意是使用完整的类名。不管多少模型类需要映射，
都使用同样的方式配置在<list>标签下。
所有工作已经完成了，进行任意的一次数据库操作，BookStore222.db数据库就会被自动创建出来。
修改MainActivity中的代码，如下：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
}
}
调用 LitePal.getDatabase()方法就是一次简单的数据库操作，只要点击一下按钮，数据就自动创建完成了。运行一下程序，
然后点击Create database按钮，接着通过adb shell （主要在启动相应模拟器的情况下，在命令行输入adb shell）查看一下数据库创建情况。
注意：
activity_main.xml的布局代码如下：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<Button
android:id="@+id/create_database"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text = "Create database"/>
<Button
android:id="@+id/add_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text = "Add data"/>
<Button
android:id="@+id/update_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text = "Updata data"/>
<Button
android:id="@+id/delete_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text = "Delete data"/>
<Button
android:id="@+id/query_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text = "Query data"/>
</LinearLayout>
运行程序后：
通过adb shell 查看一下数据库创建情况，(使用android 6 模拟器，android 7 似乎不可以进入超级管理员状态，也就不可以操作数据库)
adb shell 进入；
cd data/data/com.example.项目名(listpaltest)
cd databases
ls
如下：（具体参考《第一行代码》第二版P234）
可以看到，这里有3张表，其中android_metadata表仍然不用管，table_schema是LitePal内部使用的，我么也可以直接忽视，
book表是我们根据定义的Book类以及勒种的字段来自动生成的。
使用LitePal来升级数据库非常容易，只需要将你想改的地方，直接将版本号加1就行了。
我们要向Book表中添加一个Press(出版社)列，直接修改Book类中的代码，添加一个press字段即可。如下：
package com.example.litepaltest;
/**
* Created by ZHJ on 2018/3/4.
*/
public class Book {
.....
private String press;
.....
public String getPress() {
return press;
}
....
public void setPress(String press) {
this.press = press;
}
....
}如此同时，我们还想添加一张Category表，那么只需要新建一个Category类就可以了，代码如下：
package com.example.litepaltest;
/**
* Created by ZHJ on 2018/3/4.
*/
public class Category {
private int id;
private String categoryName;
private int categoryCode;
public void setId(int id) {
this.id = id;
}
public void setCategoryName(String categoryName) {
this.categoryName = categoryName;
}
public void setCategoryCode(int categoryCode) {
this.categoryCode = categoryCode;
}
}改完了我们想改的东西，只需要记得将版本号加1就行了。
这里还需要添加一个新的模型类，因此也需要将它添加到映射模型列表中，修改litepal.xm中的代码，如下：
<?xml version="1.0" encoding="utf-8" ?>
<litepal>
<dbname value = "BookStore222">
</dbname>
<version value = "2">//原来是1修改之后变为2
</version>
<list>
<mapping class = "com.example.litepaltest.Book"
<mapping clss = "com.example.litepaltest.Category"></mapping>//来声明沃我们要配置的模型类，一定要使用完整的类名。不管有多少模型类需要映射，都要以同样的方式配置在<lise>标签下。
</list>
</litepal>现在重新运行一下程序，点击Create database按钮，查看一下最新的建表语句，
C:\Users\ZHJ>adb shell
root@generic_x86:/ # cd data/data/com.example.litepaltest
root@generic_x86:/data/data/com.example.litepaltest # cd databases
127|root@generic_x86:/data/data/com.example.litepaltest/databases # ls
BookStore222.db
BookStore222.db-journal
qlite3 BookStore222.db <
sqlite> .table
如下：
我们可以看到，book表中新增了一个press列，category表也创建成功了。当然，LitePal还自动帮我们做了一项非常重要的工作，就是保留之前表中的所有数据，这样就不用担心数据丢失的问题了。
三、使用LitePal添加数据
使用LitePal来添加数据。
1、创建出模型类的实例。
2、再将所有要存储的数据设置好。
3、最后调用一下save()方法，就可以了。
开始动手实现，观察现有的模型类，你会发现没有继承结构的。因为LiePal进行表管理操作时不需要模型类有任何的继承结构，
但是进行CRUD操作时，就不行了。必须要继承自DataSupport类才行。因此我们需要把继承结构加上。修改Book类，代码如下：
package com.example.litepaltest;
import org.litepal.crud.DataSupport;
/**
* Created by ZHJ on 2018/3/4.
*/
public class Book extends DataSupport{
private int id;
private String author;
private double price;
private int pages;
......
}接着我们向Book表中添加数据，修改MainActivity中的代码，如下：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
}
}我们首先创建出一个Book的实例，然后调用Book类中的各种set方法对数据进行设置，最后再调用book.save()方法就能完成数据添加操作。这个save()方法是从DataSupport类中继承来的，除了save()方法外，DataSupport类还给我们提供了丰富的CRUD方法。
现在运行程序，点击Add data按钮，此时数据应该已经添加成功了。我们打开数据库看一下。
我们点了4次Add Data 按钮，添加了4个。
四、使用LitePal更新数据库
更新数据库比添加数据稍微复杂一些，因为它的API接口比较多。
最简单的一种更新方式，就是对已经存储的对象重新设值，然后重新调用save()方法即可。
什么是已经存储的对象？
对于LitePal来说，对象是否已经存储就是根据调用model.isSaved()方法的结果来判断的，返回true表示已经存储，返回false就表示未存储，那么什么情况下，会返回true，什么情况下，会返回false?实际上，只有两种情况下model会被认为是已经存储的对象。
一种情况是已经调用过model.save()方法去添加数据了。此时model会被认为是已存储的对象。
另一种情况是model对象是通过LitePal提供的查询API查出来的，由于是从数据库中查到的对象，因此也会被认为是已已经存储的对象。
我们先通过第一种情况来进行验证。
首先修改MainActivity中的代码，如下：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
Button updataData = (Button)findViewById(R.id.update_data);
updataData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Lost Symbol");
book.setAuthor("Dan Brown");
book.setPages(510);
book.setPrice(19.95);
book.setPress("Unkown");
book.save();
book.setPrice(10.99);
book.save();
}
});
}
}在更新数据按钮的点击事件里面，我先是们通过上一小节学习的知识添加了一条Book数据，然后调用setPrice()方法将这本的价格进行了修改，之后再次使用了save()方法。此时LitePal会发现当前的Book对象是存储的，因此不会再向数据库中添加一条新数据，而是直接会更新当前数据。
运行程序，点击Update data 按钮。输入 select * from Book;
我们点了两次Update data 按钮，所有会更新两个数据。
但是这种更新方式只能对已存储的对象进行操作，限制比较大，我们学习另一种更新方式，修改MainActivity中的代码，如下所示：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
Button updataData = (Button)findViewById(R.id.update_data);
updataData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setPrice(14.95);
book.setPress("Anchor");
book.updateAll("name = ? and author = ?","The Lost Symbol","Dan Brown");
}
});
}
}在这里，我们首先new出了一个Book的实例，然后直接调用setPrice()和setPress()方法来设置要更新的数据，最后再调用updataAll()方法去执行更新操作。注意：updataAll()方法中可以指定一个条件约束，和SQLiteDatabase中的update()方法的where参数部分有点类似，但更加简洁，如果不指定条件语句，就表示更新所有数据。这里我们指定将所有书名是The Lost Symbol 并且作者是Dan Brown 书价格更新为14.95，出版社更新为Anchor。
点击Update data按钮，再次查询表中的数据情况：
可见第二本书的几个被更新成了14.95，出版社被更新成了Anchor。
在使用updateAll()方法时，还有一个非常重要的知识点，就是当你想把一个字段的值更新为默认值时，是不可以使用上面的方式来set数据的。JAVA中任何一种数据类型都会有默认值。对于所有想要将数据更新为默认值的操作，LitePal统一提供了一个setToDefault()方法，然后传入相应的列名就可以了，比如：
Book book = new Book();
book.setToDefault("pages");
book.updateAll("name =? and author","The Lost Symbol","Dan Brown");
这段代码意思是将书名是The Lost Symbol，并且做作者是Dan Brown的页数设置为默认值(就是0)。
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
Button updataData = (Button)findViewById(R.id.update_data);
updataData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setToDefault("pages");
book.updateAll("name = ? and author = ?","The Lost Symbol","Dan Brown");
}
});
}
}
下面来检验一下：
如上观看；
因为updateAll()方法中制定了约束条件，若没有约束条件，此次更新操作会对所有的数据生效。
五、使用LitePal删除数据
使用LitePal删除数据的方式主要有两种，第一种比较简单，就是直接调用已存储对象的delete()方法就可以。所谓已存储的对象的含义我们再说一遍，就是调用过save(）方法的对象，或者是通过LitePal提供的查询API查询出来的对象，都是可以直接使用delete()方法来删除对数据的。这种方式我们就不演示了。
我们来看另一种删除数据的方式。
修改MainActivity中的代码，如下：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
import org.litepal.crud.DataSupport;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
Button updataData = (Button)findViewById(R.id.update_data);
updataData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setToDefault("pages");
book.updateAll("name = ? and author = ?","The Lost Symbol","Dan Brown");
}
});
Button deleteButton = (Button)findViewById(R.id.delete_data);
deleteButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
DataSupport.deleteAll(Book.class,"price<?","15");
}
});
}
}这里调用了DataSupport.deleteAll()方法来删除数据，其中deleteAll()方法的第一个参数用来指定删除哪一张表中的数据，Book.class意味着删除Book表中的数据。后面的语句用于指定约束条件。这行代码的意思就是删除price小于15的书。
运行程序，点击按钮，查询表中数据，如下：
可以看到低于15的书的数据已经被删除了。
另外，deleteAll()方法，如果不指定约束条件，就意味着要删除表中所有的数据和updateAll()方法相似。
六、使用LitePal查询数据
使用LitePal来查询数据一点都不复杂，LitePal在查询API方面的设计及其人性化，基本上可以满足绝大多数场景的查询需求，并且代码十分整洁。比如我们打算查询表中的所有数据，使用LitePal如何完成同样的功能呢？
只需这样写：
List<Book> books = DataSupport.findAll(Book.class);
只需要调用一下findAll()方法的返回值是一个Book类型的List集合，LitePal已经自动帮我们完成了赋值操作。
修改MainActivity中的代码，如下：
package com.example.litepaltest;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import org.litepal.LitePal;
import org.litepal.crud.DataSupport;
import java.util.List;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button) findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
LitePal.getDatabase();
}
});
Button addData = (Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknown");
book.save();
}
});
Button updataData = (Button)findViewById(R.id.update_data);
updataData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Book book = new Book();
book.setToDefault("pages");
book.updateAll("name = ? and author = ?","The Lost Symbol","Dan Brown");
}
});
Button deleteButton = (Button)findViewById(R.id.delete_data);
deleteButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
DataSupport.deleteAll(Book.class,"price<?","15");
}
});
Button queryButton = (Button)findViewById(R.id.query_data);
queryButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
List<Book> books = DataSupport.findAll(Book.class);
for(Book book: books){
Log.d("MainActivity","book name is "+"book.getName");
Log.d("MainActivity","book author is "+"book.getAuthor");
Log.d("MainActivity","book pages is "+"book.getPages");
Log.d("MainActivity","book price is "+"book.getPrice");
Log.d("MainActivity","book press is "+"book.getPress");
}
}
});
}
}遍历List集合中的Book对象，并将其中的信息全部打印出来。现在运行一下程序，点击Query data按钮。查看logcat的打印内容。
这样，我们就已经将这条数据查询出了。
注意事项：
以上，我们是基于大牛郭霖的《第一行代码》系列书籍中的数据库内容，进行的解释。再一次从内心中迸发出的自由而不尴尬的崇高敬意。
此外，我们还可以通过操作把输入框中输入的数据，通过按钮传入到SQLite数据库，以后，我们会进行详细解释。
430
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
