LitePal无法获取ID

这个标题起的太标题党，不过为了让遇到过相同问题的朋友们能够准确的搜到就只能这样了。

这几天遇到过一个问题，在LitePal模型中进行如下设置

然而在获取main_id的时候确不能够成功获取，原因是只要model中属性有id这个字符串，就会被默认替代成ID主键，而这个主键是自动生成的。也就是所有含有id的属性都会失效，这也就造成了虽然有set、get方法却不能够获取正确的值。

解决方法 ：如果仅仅是为了通过一个唯一的键获取数据，那就可以通过如下修改来获取

虽然这个参数依旧有id这个字符串，但是其get方法是可用的，只需要将其的返回类型设置成主键的类型，也就是int即可。要注意的是，此时set方法是不可用的，因为它是想要设置主键的，所以必然失效。

如果是为了设置一个具有唯一值的属性，那就把id从其中去掉就行。

1、传统的建表方式

其实为了方便我们对数据库表进行管理，Android本身就提供了一个帮助类：SQLiteOpenHelper。这个类集创建和升级数据库于一身，并且自动管理了数据库版本，算是一个非常好用的工具。

那我们现在就来试试SQLiteOpenHelper的用法吧。首先你要知道SQLiteOpenHelper是一个抽象类，这意味着如果我们想要使用它的话，就需要创建一个自己的帮助类去继承它。SQLiteOpenHelper中有两个抽象方法，分别是onCreate()和onUpgrade()，我们必须在自己的帮助类里面重写这两个方法，然后分别在这两个方法中去实现创建、升级数据库的逻辑。本篇文章只需要把注意力放在创建数据库这里就行了，升级数据库我们会在下一篇文章中去讨论。

新建一个MySQLiteHelper类并让它继承SQLiteOpenHelper，这样一个最基本的数据库帮助类的代码如下所示：

[java] view plain copy

public class MySQLiteHelper extends SQLiteOpenHelper {

public MySQLiteHelper(Context context, String name, CursorFactory factory,

int version) {

super(context, name, factory, version)

}

@Override

public void onCreate(SQLiteDatabase db) {

}

@Override

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

}

}

其中，当数据库创建的时候会调用onCreate()方法，在这里去执行建表 *** 作就可以了。比如说我们想新建一张news表，其中有title，content，publishdate，commentcount这几列，分别代表着新闻标题、新闻内容、发布时间和评论数，那么代码就可以这样写：

[java] view plain copy

public class MySQLiteHelper extends SQLiteOpenHelper {

public static final String CREATE_NEWS = "create table news ("

+ "id integer primary key autoincrement, "

+ "title text, "

+ "content text, "

+ "publishdate integer,"

+ "commentcount integer)"

public MySQLiteHelper(Context context, String name, CursorFactory factory,

int version) {

super(context, name, factory, version)

}

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL(CREATE_NEWS)

}

...

}

可以看到，我们把建表语句定义成了一个常量，然后在onCreate()方法中去执行了这条建表语句，news表也就创建成功了。这条建表语句虽然简单，但是里面还是包含了一些小的细节，我来解释一下。首先，根据数据库的范式要求，任何一张表都应该是有主键的，所以这里我们添加了一个自增长的id列，并把它设为主键。然后title列和content列都是字符串类型的，commentcount列是整型的，这都很好理解，但是publishdate列该怎么设计呢？由于SQLite中并不支持存储日期这种数据类型，因此我们需要将日期先转换成UTC时间(自1970年1月1号零点)的毫秒数，然后再存储到数据库中，因此publishdate列也应该是整型的。

现在，我们只需要获取到SQLiteDatabase的实例，数据库表就会自动创建了，如下所示：

[java] view plain copy

SQLiteOpenHelper dbHelper = new MySQLiteHelper(this, "demo.db", null, 1)

SQLiteDatabase db = dbHelper.getWritableDatabase()

LitePal的基本用法

虽说LitePal宣称是近乎零配置，但也只是“近乎”而已，它还是需要进行一些简单配置才可以使用的，那么我们第一步就先快速学习一下LitePal的配置方法。

快速配置

1. 引入Jar包或源码

首先我们需要将LitePal的jar包引入到项目当中，可以点击这里查看LitePal的最新版本，选择你需要的下载即可。下载好了jar包之后，把它复制到项目的libs目录中就算是引入成功了，如下图所示：

如果你不想用jar包的话，也可以把LitePal的源码下载下来，然后作为一个library库导入到Eclipse当中，再让我们的项目去引用这个library库就可以了。

2. 配置litepal.xml

接着在项目的assets目录下面新建一个litepal.xml文件，并将以下代码拷贝进去：

[java] view plain copy

<?xml version="1.0" encoding="utf-8"?>

<litepal>

<dbname value="demo" ></dbname>

<version value="1" ></version>

<list>

</list>

</litepal>

配置文件相当简单，<dbname>用于设定数据库的名字，<version>用于设定数据库的版本号，<list>用于设定所有的映射模型，我们稍后就会用到。

3. 配置LitePalApplication

由于 *** 作数据库时需要用到Context，而我们显然不希望在每个接口中都去传一遍这个参数，那样 *** 作数据库就显得太繁琐了。因此，LitePal使用了一个方法来简化掉Context这个参数，只需要在AndroidManifest.xml中配置一下LitePalApplication，所有的数据库 *** 作就都不用再传Context了，如下所示：

[java] view plain copy

<manifest>

<application

android:name="org.litepal.LitePalApplication"

...

>

...

</application>

</manifest>

当然，有些程序可能会有自己的Application，并在这里配置过了。比如说有一个MyApplication，如下所示：

[java] view plain copy

<manifest>

<application

android:name="com.example.MyApplication"

...

>

...

</application>

</manifest>

没有关系，这时只需要修改一下MyApplication的继承结构，让它不要直接继承Application类，而是继承LitePalApplication类，就可以使用一切都能正常工作了，代码如下所示：

[java] view plain copy

public class MyApplication extends LitePalApplication {

...

}

但是，有些程序可能会遇到一些更加极端的情况，比如说MyApplication需要继承另外一个AnotherApplication，并且这个AnotherApplication还是在jar包当中的，不能修改它的代码。这种情况应该算是比较少见了，但是如果你遇到了的话也不用急，仍然是有解释方案的。你可以把LitePal的源码下载下来，然后把src目录下的所有代码直接拷贝到你项目的src目录下面，接着打开LitePalApplication类，将它的继承结构改成继承自AnotherApplication，再让MyApplication继承自LitePalApplication，这样所有的Application就都可以在一起正常工作了。

仅仅三步，我们就将所有的配置工作全部完成了，并且这是一件一本万利的事情，自此以后，你就可以开心地体验LitePal提供的各种便利了，就让我们从建表开始吧。

开始建表

前面在介绍的时候已经说了，LitePal采取的是对象关系映射(ORM)的模式，那么什么是对象关系映射呢？简单点说，我们使用的编程语言是面向对象语言，而我们使用的数据库则是关系型数据库，那么将面向对象的语言和面向关系的数据库之间建立一种映射关系，这就是对象关系映射了。

但是我们为什么要使用对象关系映射模式呢？这主要是因为大多数的程序员都很擅长面向对象编程，但其中只有少部分的人才比较精通关系型数据库。而且数据库的SQL语言晦涩难懂，就算你很精通它，恐怕也不喜欢经常在代码中去写它吧？而对象关系映射模式则很好地解决了这个问题，它允许我们使用面向对象的方式来 *** 作数据库，从而可以从晦涩难懂的SQL语言中解脱出来。

那么接下来我们就看一看LitePal中是如何建表的吧。根据对象关系映射模式的理念，每一张表都应该对应一个模型(Model)，也就是说，如果我们想要建一张news表，就应该有一个对应的News模型类。新建一个News类，如下所示：

[java] view plain copy

package com.example.databasetest.model

public class News {

}

然后，表中的每一列其实就是对应了模型类中的一个字段，比如news表中有id、title、content、publishdate、commentcount这几个列，那么在News类中就也应该有这几个字段，代码如下所示：

[java] view plaincopy

[java] view plain copy

public class News {

private int id

private String title

private String content

private Date publishDate

private int commentCount

// 自动生成get、set方法

...

}

其中id这个字段可写可不写，因为即使不写这个字段，LitePal也会在表中自动生成一个id列，毕竟每张表都一定要有主键的嘛。

这里我要特别说明一下，LitePal的映射规则是非常轻量级的，不像一些其它的数据库框架，需要为每个模型类单独配置一个映射关系的XML，LitePal的所有映射都是自动完成的。根据LitePal的数据类型支持，可以进行对象关系映射的数据类型一共有8种，int、short、long、float、double、boolean、String和Date。只要是声明成这8种数据类型的字段都会被自动映射到数据库表中，并不需要进行任何额外的配置。

那么有的朋友可能会问了，既然是自动映射的话，如果News类中有一个字符串字段我并不想让它映射到数据库表中，这该怎么办呢？对此，LitePal同样采用了一种极为轻量的解决方案，只有声明成private修饰符的字段才会被映射到数据库表中，如果你有某一个字段不想映射的话，只需要将它改成public、protected或default修饰符就可以了。

现在模型类已经建好了，我们还差最后一步，就是将它配置到映射列表当中。编辑assets目录下的litepal.xml文件，在<list>标签中加入News模型类的声明：

[java] view plain copy

<?xml version="1.0" encoding="utf-8"?>

<litepal>

<dbname value="demo" ></dbname>

<version value="1" ></version>

<list>

<mapping class="com.example.databasetest.model.News"></mapping>

</list>

</litepal>

注意这里一定要填入News类的完整类名。

OK，这样所有的工作就都已经完成了，现在只要你对数据库有任何的 *** 作，news表就会被自动创建出来。比如说LitePal提供了一个便捷的方法来获取到SQLiteDatabase的实例，如下所示：

[java] view plain copy

SQLiteDatabase db = Connector.getDatabase()

好了，到目前为止你已经算是对LitePal的用法有点入门了，那么本篇文章的内容就到这里，下篇文章当中我们将学习使用LitePal进行升级表的 *** 作。感兴趣的朋友请继续阅读 Android数据库高手秘籍(三)——使用LitePal升级表 。

本系列的上一篇已经介绍了Android开源数据库框架LitePal如何引入到工程中并进行少量配置使其就绪。接下来将围绕我们平时对Sqlite的使用来介绍LitePal的具体用法。你会沉醉于它的简介，优雅。

建表

使用Android原生的数据库编程API，我们要创建数据表就必须依赖于SqliteOpenHelper,组装冗长的SQL建表语句，但是在LitePal中建表变得非常简单。

我们只需要创建每张表对应的实体类（model）即可。还是用LitePal的作者使用的歌曲（Song）和Album（专辑）来举例。

public class Song {

private String name

public String getName() {

return name

}

public void setName(String name) {

this.name = name

}

}

public class Album {

private String name

public String getName() {

return name

}

public void setName(String name) {

this.name = name

}

}

很明显，我们创建了两个实体类，并提供了getter、setter方法。那么如何让这两个实体类与LitePal关联，并创建对应的数据表呢？还记得在上一篇中提到的litepal.xml文件吗？OK，马上要用到的就是它：

<?xml version="1.0" encoding="utf-8"?>

<litepal>

<dbname value="demo" ></dbname>

<version value="1" ></version>

<list>

<mapping class = "com.oncno.litepaldemo.model.Album"></mapping>

<mapping class="com.oncno.litepaldemo.model.Song"></mapping>

</list>

</litepal>

在<list></list>标签中加入对应的class作为映射，LitePal就知道该创建哪些数据表了。完成了这些，在你下次有数据库 *** 作的时，数据表就会自动创建好了。比如调用调用数据库对象：

Connector.getDatabase()

此时Song和Album的数据库就会自动创建SQL建表语句，并创建好数据表，Like this：

CREATE TABLE album (

id INTEGER PRIMARY KEY AUTOINCREMENT,

name TEXT

)

CREATE TABLE song (

id INTEGER PRIMARY KEY AUTOINCREMENT,

name TEXT

)

在Demo程序中默认Activity中调用Connector.getDatabase()：

public class MainActivity extends Activity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState)

setContentView(R.layout.activity_main)

Connector.getDatabase()

}

@Override

protected void onResume() {

super.onResume()

Connector.getDatabase()

}

... ...

}

运行程序，并在adb shell中查看效果：

可以看到我们在litepal.xml的demo.db数据库已经创建好了。运行sqlite3 demo.db查看数据库表结构：

//Sqlite中查看数据库中所有的数据表

.table

//Sqlite中查看数据表结构

pragma table_info(TABLE_NAME)

OK，album和song两个表同样也按照我们配置的那样创建好了,并且像我们在实体类定义的那样，都包含name属性。相比于原生的方式，LitePal明显提供了简洁，优雅的建表 *** 作。

---