ActiveAndroid使用详解

ActiveAndroid和OrmLite都是ORM架构的数据库，之前使用的是OrmLite，今天研究了一番ActiveAndroid，发现两者各有千秋，在代码上，ActiveAndroid要比OrmLite简洁，轻松几行代码就能实现对数据库的增删改查；但在版本更新上，ActiveAndroid就要比OrmLite复杂的多了，最头痛的是需要使用sql语句来操作。另外，在5.0之上的手机上，ActiveAndroid封装的还不算太好，但是我们可以通过代码来修复这个bug，尽管如此，ActiveAndroid还是很值得我们去学习的！下面就通过一个简单的demo来详解ActiveAndroid的使用。

此demo实现的效果如下：

一，添加依赖，把下面的代码添加到工程的build.gradle中：

repositories {
    mavenCentral()
    maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
}

compile 'com.michaelpardo:activeandroid:3.1.0-SNAPSHOT'

二，配置与初始化：

1，在清单文件中配置数据库名称和数据库版本号：

<application
        android:name=".MyApp"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        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>
        <meta-data android:name="AA_DB_NAME" android:value="user.db" />
        <meta-data android:name="AA_DB_VERSION" android:value="1" />
    </application>

通过mete-data来配置 数据库名称和数据库版本号，其中AA_DB_NAME为数据库名称，AA_DB_VERSION为数据库版本号，默认为1。

2，自定义Application，需要让你的Application对象继承自com.activeandroid.app.Application而不android.app.Application。

然后在清单文件的applicatin下通过name来引用，这样就完成了ActiveAndroid的初始化工作。

代码就是这么简单：

package com.example.administrator.activeandroid;

import com.activeandroid.ActiveAndroid;
import com.activeandroid.Configuration;
import com.activeandroid.app.Application;

/**
 * Created by ljw on 2016/11/2.
 */
public class MyApp extends Application {

    //为了兼容5.0以上的手机，需添加下面的代码
    @Override
    public void onCreate() {
        super.onCreate();
        Configuration.Builder builder = new Configuration.Builder(this);
        //手动的添加模型类
        builder.addModelClasses(User.class);
        ActiveAndroid.initialize(builder.create());
    }
}

然后在清单文件的applicatin下通过name来引用：

android:name=".MyApp"

三，创建Model类

其实ActiveAndroid创建Model类的初衷和OrmLite的Model类是一样的，都是orm架构的体现，如果对orm不了解，可以看我之前写的关于OrmLiate的一篇文章，开篇详细讲解了orm的含义，文章地址：http://blog.csdn.net/ljw124213/article/details/52818942。Model类必须继承Model，继承后就不用像OrmLite一样声明主键了，而且如何查看Model源码会发现，ActiveAndroid把所以操作数据库的方法都封装在了此类中。使用@Table定义表名。@Column用于定义列名。

package com.example.administrator.activeandroid;

import com.activeandroid.Model;
import com.activeandroid.annotation.Column;
import com.activeandroid.annotation.Table;

/**
 * Created by ljw on 2016/11/2.
 * 1，必须继承Model,继承后就不用声明主键了
 * 2，按照表名添加字段
 * 3，添加注释
 */
@Table(name = "user")
public class User extends Model{

    @Column
    private String userName;
    @Column
    private int userId;
    @Column
    private int age;
    @Column
    private String addr;

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public int getUserId() {
        return userId;
    }

    public void setUserId(int userId) {
        this.userId = userId;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getAddr() {
        return addr;
    }

    public void setAddr(String addr) {
        this.addr = addr;
    }

    @Override
    public String toString() {
        return "User{" +
                "userName='" + userName + '\'' +
                ", userId=" + userId +
                ", age=" + age +
                ", addr='" + addr + '\'' +
                '}';
    }
}

四，操作数据库的工具类

是不是感到很惊讶？还有创建数据库和操作表结构，怎么就开始操作数据库了，只能说ActiveAndroid封装的太好了，我们只需对数据库的名称和版本号进行配置，Model类写好，其他的工作都不用操心了，它会默默的在后面帮我们解决。写到这里我们肯定会深深的体会到使用ActiveAndroid代码变得是有多么的简洁。

package com.example.administrator.activeandroid;

import com.activeandroid.query.Delete;
import com.activeandroid.query.Select;
import com.activeandroid.query.Update;

import java.util.List;

/**
 * Created by ljw on 2016/11/2.
 * 操作数据库的工具类
 */
public class DbManager {

    //添加数据
    public void insertUser(User user){
        //操作数据库的对象就是实体类本身
        user.save();
    }

    //删除数据
    public void deleteUser(User user){
        user.delete();
    }

    //更新数据
    public void updateUser(User user){
        user.setUserName("关羽");
        user.setAddr("北京");
        //在activeandroid中save既可以创建，也可以修改
        user.save();
    }

    //查询所有的数据
    public List<User> queryUser(){
        List<User> execute = new Select()
                                     .from(User.class) //model类
                                     .execute();
        return execute;
    }

    //条件查询
    public List<User> query(String userName){
        List<User> queryName = new Select()
                                     .from(User.class)
                                     .where("userName = ?", userName) //查询条件
                                     .execute();
        return queryName;
    }

    //条件删除
    public void delete(String userName){
        new Delete()
                .from(User.class)
                .where("userName = ?", userName)
                .execute();
    }

    //条件更新
    public void update(String userName){
        Update update = new Update(User.class);
        update.set("addr = ?","上海")
                .where("userName=?",userName)
                .execute();
    }
}

五，在MainActivity中操作数据库，实现其增删改查功能

package com.example.administrator.activeandroid;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListAdapter;
import android.widget.ListView;

import java.util.List;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private DbManager dbManager;
    private ListView mListView;
    private List<User> users;
    private ListviewAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initView();
        //对ListView设置点击条目监听，点击某个条目后删除该条目
        mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> adapterView, View view, int i, long l) {
                dbManager.deleteUser(users.get(i));
                query();
                adapter.notifyDataSetChanged();
            }
        });
        //对ListView设置条目长按监听，长按某个条目实行修改操作
        mListView.setOnItemLongClickListener(new AdapterView.OnItemLongClickListener() {
            @Override
            public boolean onItemLongClick(AdapterView<?> adapterView, View view, int i, long l) {
                dbManager.updateUser(users.get(i));
                query();
                adapter.notifyDataSetChanged();
                return true;
            }
        });
        //给ListView设置适配器，在第一次进入页面时就查询数据库
        dbManager = new DbManager();
        adapter = new ListviewAdapter();
        adapter.setUsers(users); //把数据传递给适配器
        mListView.setAdapter(adapter);
        query();
    }

    private void initView() {
        mListView = (ListView) findViewById(R.id.listview);
        findViewById(R.id.btn1).setOnClickListener(this);
        findViewById(R.id.btn2).setOnClickListener(this);
        findViewById(R.id.btn3).setOnClickListener(this);
        findViewById(R.id.btn4).setOnClickListener(this);
    }

    //查询所有
    public void query(){
        users = dbManager.queryUser();
        adapter.setUsers(users); //给适配器重新设置数据
        adapter.notifyDataSetChanged();
    }

    @Override
    public void onClick(View view) {
        switch (view.getId()){
            case R.id.btn1: //插入数据
                //第一次使用user对应的表的时候，如果有这张表就直接使用，没有就创建表
                //user表对应的实体类继承于Model类，此类中提供了一些操作数据库的工具类
                User user = new User();
                user.setAddr("信阳");
                user.setAge(28);
                user.setUserId(1);
                user.setUserName("张飞");
                dbManager.insertUser(user);
                query();
                break;
            case R.id.btn2: //条件查询
                users = dbManager.query("张飞");
                adapter.setUsers(users);  //给适配器重新设置数据
                adapter.notifyDataSetChanged();
                break;
            case R.id.btn3: //条件删除
                dbManager.delete("张飞");
                query();
                break;
            case R.id.btn4: //条件更新
                dbManager.update("张飞");
                query();
                break;
        }
    }
}

六，ListView对应的适配器

import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

import java.util.List;

/**
 * Created by ljw on 2016/11/2.
 */
public class ListviewAdapter extends BaseAdapter {

    private List<User> users;

    public void setUsers(List<User> users) {
        this.users = users;
    }

    @Override
    public int getCount() {
        return users == null ? 0 : users.size();
    }

    @Override
    public Object getItem(int i) {
        return users.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder holder;
        if (view == null){
            view = View.inflate(viewGroup.getContext(),R.layout.item,null);
            holder = new ViewHolder();
            holder.tv = (TextView) view.findViewById(R.id.tv);
            view.setTag(holder);
        }else {
            holder = (ViewHolder) view.getTag();
        }
        holder.tv.setText(users.get(i).toString());
        return view;
    }

    private class ViewHolder{
        TextView tv;
    }
}

七，布局文件

1，activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.example.administrator.activeandroid.MainActivity">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">
        <Button
            android:id="@+id/btn1"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="插入数据" />
        <Button
            android:id="@+id/btn2"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="条件查询" />
        <Button
            android:id="@+id/btn3"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="条件删除" />
        <Button
            android:id="@+id/btn4"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="条件更新" />
    </LinearLayout>

    <ListView
        android:id="@+id/listview"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</LinearLayout>

2,listview条目布局对应的item.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">

    <TextView
        android:id="@+id/tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

八，数据库升级

上面的代码完全能够实现ActiveAndroid的功能了，但ActiveAndroid的数据库升级不像其他数据库升级那么简单，只需改变版本号就行了，下面介绍一下ActiveAndroid的版本升级的步骤：

1，先把数据库版本改为要升级到的版本，如改为2

2，在工程下新建assets/migrations，在该目录下增加一个修改过得版本号，比如我现在的版本号升级为2，则文件夹名为2.sql。

3，在2.sql文件夹下使用sql语句来编写版本升级新增的功能，如新增了一个字段：

ALTER TABLE user ADD COLUMN Count INTEGER;

OK，到这里ActiveAndroid的使用已经完成了。