Android ORM系列之ActiveAndroid

时间：2015-08-20 10:34:25 阅读：271 评论：0 收藏：0 [点我收藏+]

从Java Web转到android的同学应该都知道ssh或者ssi，用惯了hibernate或者mybatis，转到android后找不到顺手的orm是不是感觉很不自在。其实android 中的orm还是很多的。

本篇文章主要介绍一下ActiveAndroid的用法。用过LitePal的同学会发现，这两个框架的用法是如此的相似。

Active Record（活动目录）是Yii、Rails等框架中对ORM实现的典型命名方式。Active Android 帮助你以面向对象的方式来操作SQLite。

配置

首先新建一个android studio项目，加入ActiveAndroid的依赖。

repositories {
    mavenCentral()
    maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
}
dependencies {
    compile fileTree(dir: ‘libs‘, include: [‘*.jar‘])
    compile ‘com.android.support:appcompat-v7:22.2.1‘
    compile ‘com.michaelpardo:activeandroid:3.1.0-SNAPSHOT‘
}

如果你的项目中还没有自定义的Application类，那么可以直接在manifest文件中配置框架中的Application类

<manifest ...>
    <application android:name="com.activeandroid.app.Application" ...>

        ...

    </application>
</manifest>

但是如果你项目中已经有了一个自定义的Application类，那么也没有关系。在onCreate方法中完成初始化，在onTerminate方法中完成清理工作。

public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        ActiveAndroid.initialize(this);

    }

    @Override
    public void onTerminate() {
        super.onTerminate();
        ActiveAndroid.dispose();
    }
}

在初始化之前可以调用对应函数开启日志

ActiveAndroid.setLoggingEnabled(true);

当然也可以用initialize的重载方法开启。

 ActiveAndroid.initialize(this,true);

然后在清单文件中指定该Application。并在application结点下配置数据库名和数据库版本

 <meta-data
            android:name="AA_DB_NAME"
            android:value="Store.db"/>
        <meta-data
            android:name="AA_DB_VERSION"
            android:value="1"/>

当然你也可以在代码中指定，不过建议在清单文件中配置

 Configuration configuration=new Configuration.Builder(this)
                .setDatabaseName("test.db")
                .setDatabaseVersion(1)
                .create();
ActiveAndroid.initialize(configuration,true);

先生成两个实体类，让其继承Model 类，注意，如果要进行CRUD操作的话必须继承Model 类。然后通过@Table注解可以指定表名，@Column注解来指定列名。

@Table(name = "Category")
public class Category extends Model {
    @Column(name = "Name")
    private String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "Category{" +
                "name=‘" + name + ‘\‘‘ +
                ‘}‘;
    }
}
@Table(name = "Item")
public class Item extends Model {
    @Column(name = "Name")
    public String name;
    @Column(name = "Category")
    public Category category;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Category getCategory() {
        return category;
    }

    public void setCategory(Category category) {
        this.category = category;
    }

    @Override
    public String toString() {
        return "Item{" +
                "name=‘" + name + ‘\‘‘ +
                ", category=" + category +
                ‘}‘;
    }
}

ActiveAndroid默认会查找所有Model的子类，可能会花去很长的时间如果我们有很多子类。为了加快应用的启动速度，我们可以在清单文件中直接指定model类，多个用逗号分隔

 <meta-data
            android:name="AA_MODELS"
            android:value="cn.edu.zafu.activeandroiddemo.model.Item, cn.edu.zafu.activeandroiddemo.model.Category" />

当然你也可以在代码中通过Configuration类来指定，不过同样的，还是建议在清单文件中配置

Configuration configuration=new Configuration.Builder(this)
                .setDatabaseName("test.db")
                .setDatabaseVersion(1)
                .setModelClasses(Item.class, Category.class)
                .create();
ActiveAndroid.initialize(configuration,true);

我们看到Category 和 Item是一对多的关系。为了从Category方得到多的Item一方，我们在Category中增加一个方法，

 public List<Item> items() {
        return getMany(Item.class, "Category");
    }

如果你要指定某一列为索引，在对应的注解上加上index = true即可。

数据的保存和修改

接下来，我们来保存一条数据试试看。

Category category=new Category();
category.setName("book");
category.save();

用RE查看一下对应的存数据库的目录，打开对应的表，看下数据，确实已经存进去了。

技术分享
看下实体类，我们并没有id这个属性，为什么表中会有呢，其实这是自动生成的主键。

现在我们来保存几条item

Item item1=new Item();
item1.setName("head first java");
item1.setCategory(category);
item1.save();

Item item2=new Item();
item2.setName("java core");
item2.setCategory(category);
item2.save();

看下Item表，其为我们自动生成了外键，指向了之前的category

技术分享

如果要修改数据的话，对对应的类进行数据操作，调用save方法即可。

事务的支持

当你有大量的数据插入时，这时候就要用到事务，ActiveAndroid也是支持事务的。

ActiveAndroid.beginTransaction();
try {
    //do something such as insert many data
    ActiveAndroid.setTransactionSuccessful();
}finally {
    ActiveAndroid.endTransaction();
}

数据的删除

根据id删除

Item.delete(Item.class,1);

当然你也可以直接调用delete

Item item = Item.load(Item.class, 1);
item.delete();

也可以通过Delete类进行操作

new Delete().from(Item.class).where("Id = ?", 1).execute();

数据的查询

通过Select进行链式调用，更多查询的函数请读者自己体验

List<Model> execute = new Select().from(Item.class).where("Category = ?", 1).orderBy("name desc").execute();

类型序列号

ActiveAndroid 默认支持了很多类型，但是如果你想自定义处理序列化的类型，你也可以继承TypeSerializer 类，重写里面的四个方法即可。
比如我们要将Date类型转换为long类型保存，读取的时候又要转换为Date类型，则可以这样编写。

public class DateSerializer extends TypeSerializer {
    @Override
    public Class<?> getDeserializedType() {
        return Date.class;
    }

    @Override
    public Class<?> getSerializedType() {
        return Long.class;
    }

    @Override
    public Long serialize(Object data) {
        if (data == null) {
            return null;
        }

        return ((Date) data).getTime();
    }

    @Override
    public Date deserialize(Object data) {
        if (data == null) {
            return null;
        }

        return new Date((Long) data);
    }
}

当然别忘了在清单文件中注册

<meta-data
        android:name="AA_SERIALIZERS"
        android:value="cn.edu.zafu.activeandroiddemo.serializer.DateSerializer,my.package.AnotherCustomeTypeSerializer"/>

同样也可以通过代码注册

Configuration configuration=new Configuration.Builder(this)
                .setDatabaseName("test.db")
                .setDatabaseVersion(1)
                .setModelClasses(Item.class, Category.class)
                .setTypeSerializers(DateSerializer.class)
                .create();
ActiveAndroid.initialize(configuration,true);

数据库升级

如果需要升级数据库，首先需要增加数据库版本号，必须比之前的大，即增大AA_DB_VERSION 属性。如果增加了新的实体类，它会自动增加到数据库中，但是如果你想改变已经存在的表，比如增加一列，首先你要修改实体类，然后你要在assets目录下创建sql语句的文件，文件名为数据库版本号，后缀是sql，里面写着升级语句，即你增加了什么列等。比如

ALTER TABLE Item ADD COLUMN color INTEGER;

将其保持为2.sql，放到assets目录下

使用ContentProvider

ActiveAndroid支持ContentProvider，但是必须复写默认的标识列如下所示(默认标识列是ID)。

@Table(name = "Category",id = BaseColumns._ID)

复写后的值是_id

当然不要忘记在清单文件中配置，之后你就可以使用了。

 <provider android:authorities="cn.edu.zafu.activeandroiddemo" android:exported="false" android:name="com.activeandroid.content.ContentProvider" />

源码下载

http://download.csdn.net/detail/sbsujjbcy/9026793