1、android orm之greendao

前提：最近写android项目，android自带数据库api有点复杂，于是偷懒用了greendao。greendao好处自己查，这里不赘述，但是零基础的的我用起来还是费了3天的功夫，取之于网络，特在此奉献与网络。

1、通过daoGenerator生成所需要的关键文件

步骤1、新建的java工程，起名daoGenerator

步骤2：导入两个jar包，分别是freemarker-2.3.20.jar和greendao-generator-1.3.1.jar,下载路径：http://search.maven.org，你可以在这里搜索上述两个包，自己导入到java工程中，

导入的时候记着不要有中文路径

步骤3：新建daoGenerator.java文件，文件格式如下

import de.greenrobot.daogenerator.DaoGenerator;
import de.greenrobot.daogenerator.Entity;
import de.greenrobot.daogenerator.Property;
import de.greenrobot.daogenerator.Schema;
import de.greenrobot.daogenerator.ToMany;

public class daoGenerator {

    public static void main(String[] args) throws Exception {
        Schema schema = new Schema(1,"com.example.menu");

        addMenuDetail(schema);
        addMenuTable(schema);

        new DaoGenerator().generateAll(schema, "./");
    }

    private static void addMenuTable(Schema schema)
    {
        Entity menuTable = schema.addEntity("MenuTable");
        menuTable.addStringProperty("menuName");//菜单的名称（周一早餐通用版）
        menuTable.addIntProperty("menuType");//0早餐 1午餐 2晚餐
        menuTable.addLongProperty("menuId").primaryKey().autoincrement();//菜单id
        menuTable.addStringProperty("menuCreateTime");//菜单创建时间
        menuTable.addLongProperty("storeId");//店铺的编号
    }

    private static void addMenuDetail(Schema schema) {
        Entity menuDetail = schema.addEntity("MenuDetail");
        menuDetail.addStringProperty("menuDateId");
        menuDetail.addLongProperty("menuId");//菜单id
        menuDetail.addIntProperty("widgetId");//控件id
        menuDetail.addStringProperty("type");//控件类型：textview、pic、line、verticalLine、theme、tips
        menuDetail.addStringProperty("name");//控件内容 "疙瘩汤"
        menuDetail.addDoubleProperty("x");//x
        menuDetail.addDoubleProperty("y");//y
    }

}

该工程运行完毕会在当前目录下产生一个文件夹com，进入example再进入到menu（为什么会产生这样一个文件夹，这是由我们在程序中 Schema schema = new Schema(1,"com.example.menu")， new DaoGenerator().generateAll(schema, "./")；这两行决定的，如果你运行出错，请查看你是不是路径写错），可以发现生成如下几个文件：

简要说明：menuDetail和menuTable就是我们在daoGenerator中指定生成的表，在生成的文件中每张表分别对应两个文件，举例：表menuTable对应的两个文件一个是menuTable，一个是menuTableDao。

menuTable.java文件主要是menuTable中取得和设置列中元素的方法，见下图,注意：这是自动生成的代码，如果要修改列中元素名称可以在daoGenerator中修改：

 package com.ShanFuBao.SmartCall.menu;

 // THIS CODE IS GENERATED BY greenDAO, DO NOT EDIT. Enable "keep" sections if you want to edit.
 /**
  * Entity mapped to table MENU_TABLE.
  */
 public class MenuTable {

     private String menuName;
     private Integer menuType;
     private Long menuId;
     private String menuCreateTime;
     private Long storeId;

     public MenuTable() {
     }

     public MenuTable(Long menuId) {
         this.menuId = menuId;
     }

     public MenuTable(String menuName, Integer menuType, Long menuId, String menuCreateTime, Long storeId) {
         this.menuName = menuName;
         this.menuType = menuType;
         this.menuId = menuId;
         this.menuCreateTime = menuCreateTime;
         this.storeId = storeId;
     }

     public String getMenuName() {
         return menuName;
     }

     public void setMenuName(String menuName) {
         this.menuName = menuName;
     }

     public Integer getMenuType() {
         return menuType;
     }

     public void setMenuType(Integer menuType) {
         this.menuType = menuType;
     }

     public Long getMenuId() {
         return menuId;
     }

     public void setMenuId(Long menuId) {
         this.menuId = menuId;
     }

     public String getMenuCreateTime() {
         return menuCreateTime;
     }

     public void setMenuCreateTime(String menuCreateTime) {
         this.menuCreateTime = menuCreateTime;
     }

     public Long getStoreId() {
         return storeId;
     }

     public void setStoreId(Long storeId) {
         this.storeId = storeId;
     }

 }

menuTableDao.java文件就是执行的对表进行增删改查的封装。

 package com.ShanFuBao.SmartCall.menu;

 import android.database.Cursor;
 import android.database.sqlite.SQLiteDatabase;
 import android.database.sqlite.SQLiteStatement;

 import de.greenrobot.dao.AbstractDao;
 import de.greenrobot.dao.Property;
 import de.greenrobot.dao.internal.DaoConfig;

 import com.ShanFuBao.SmartCall.menu.MenuTable;

 // THIS CODE IS GENERATED BY greenDAO, DO NOT EDIT.
 /**
  * DAO for table MENU_TABLE.
 */
 public class MenuTableDao extends AbstractDao<MenuTable, Long> {

     public static final String TABLENAME = "MENU_TABLE";

     /**
      * Properties of entity MenuTable.<br/>
      * Can be used for QueryBuilder and for referencing column names.
     */
     public static class Properties {
         public final static Property MenuName = new Property(0, String.class, "menuName", false, "MENU_NAME");
         public final static Property MenuType = new Property(1, Integer.class, "menuType", false, "MENU_TYPE");
         public final static Property MenuId = new Property(2, Long.class, "menuId", true, "MENU_ID");
         public final static Property MenuCreateTime = new Property(3, String.class, "menuCreateTime", false, "MENU_CREATE_TIME");
         public final static Property StoreId = new Property(4, Long.class, "storeId", false, "STORE_ID");
     };

     public MenuTableDao(DaoConfig config) {
         super(config);
     }

     public MenuTableDao(DaoConfig config, DaoSession daoSession) {
         super(config, daoSession);
     }

     /** Creates the underlying database table. */
     public static void createTable(SQLiteDatabase db, boolean ifNotExists) {
         String constraint = ifNotExists? "IF NOT EXISTS ": "";
         db.execSQL("CREATE TABLE " + constraint + "'MENU_TABLE' (" + //
                 "'MENU_NAME' TEXT," + // 0: menuName
                 "'MENU_TYPE' INTEGER," + // 1: menuType
                 "'MENU_ID' INTEGER PRIMARY KEY AUTOINCREMENT ," + // 2: menuId
                 "'MENU_CREATE_TIME' TEXT," + // 3: menuCreateTime
                 "'STORE_ID' INTEGER);"); // 4: storeId
     }

     /** Drops the underlying database table. */
     public static void dropTable(SQLiteDatabase db, boolean ifExists) {
         String sql = "DROP TABLE " + (ifExists ? "IF EXISTS " : "") + "'MENU_TABLE'";
         db.execSQL(sql);
     }

     /** @inheritdoc */
     @Override
     protected void bindValues(SQLiteStatement stmt, MenuTable entity) {
         stmt.clearBindings();

         String menuName = entity.getMenuName();
         if (menuName != null) {
             stmt.bindString(1, menuName);
         }

         Integer menuType = entity.getMenuType();
         if (menuType != null) {
             stmt.bindLong(2, menuType);
         }

         Long menuId = entity.getMenuId();
         if (menuId != null) {
             stmt.bindLong(3, menuId);
         }

         String menuCreateTime = entity.getMenuCreateTime();
         if (menuCreateTime != null) {
             stmt.bindString(4, menuCreateTime);
         }

         Long storeId = entity.getStoreId();
         if (storeId != null) {
             stmt.bindLong(5, storeId);
         }
     }

     /** @inheritdoc */
     @Override
     public Long readKey(Cursor cursor, int offset) {
         return cursor.isNull(offset + 2) ? null : cursor.getLong(offset + 2);
     }    

     /** @inheritdoc */
     @Override
     public MenuTable readEntity(Cursor cursor, int offset) {
         MenuTable entity = new MenuTable( //
             cursor.isNull(offset + 0) ? null : cursor.getString(offset + 0), // menuName
             cursor.isNull(offset + 1) ? null : cursor.getInt(offset + 1), // menuType
             cursor.isNull(offset + 2) ? null : cursor.getLong(offset + 2), // menuId
             cursor.isNull(offset + 3) ? null : cursor.getString(offset + 3), // menuCreateTime
             cursor.isNull(offset + 4) ? null : cursor.getLong(offset + 4) // storeId
         );
         return entity;
     }

     /** @inheritdoc */
     @Override
     public void readEntity(Cursor cursor, MenuTable entity, int offset) {
         entity.setMenuName(cursor.isNull(offset + 0) ? null : cursor.getString(offset + 0));
         entity.setMenuType(cursor.isNull(offset + 1) ? null : cursor.getInt(offset + 1));
         entity.setMenuId(cursor.isNull(offset + 2) ? null : cursor.getLong(offset + 2));
         entity.setMenuCreateTime(cursor.isNull(offset + 3) ? null : cursor.getString(offset + 3));
         entity.setStoreId(cursor.isNull(offset + 4) ? null : cursor.getLong(offset + 4));
      }

     /** @inheritdoc */
     @Override
     protected Long updateKeyAfterInsert(MenuTable entity, long rowId) {
         entity.setMenuId(rowId);
         return rowId;
     }

     /** @inheritdoc */
     @Override
     public Long getKey(MenuTable entity) {
         if(entity != null) {
             return entity.getMenuId();
         } else {
             return null;
         }
     }

     /** @inheritdoc */
     @Override
     protected boolean isEntityUpdateable() {
         return true;
     }

 }

还有两个文件没有介绍，分别是DaoMaster.java和DaoSessi.java文件，这两个文件很重要，也是daoGenerator工程自动生成的，

daoMaster文件是干嘛的，看下图：

明白了吗？他知道你创建的所有的dao对象，对，通过他，你可以得到你想要操作的表格对应的对象。

daoSession文件又是干嘛的？？通过session你可以得到和删除dao对象。

到这里应该明白了：

①我们以往通过sql去创建的表格，在这里通过daoGennerator的java工程来完成

②我们通过sql对表格的操作，可以通过daoMaser得到表格，然后通过daoSession获取到具体的对象，这样就完成了数据库到对象的映射，对应了orm的主题。

2、避开sql使用dao来执行表操作

OpenHelper helper = new DaoMaster.DevOpenHelper(context,"test_db", null);

daoMaster = new DaoMaster(helper.getWritableDatabase());

daoSession = daoMaster.newSession();

menuTableDao = daoSession.getMenuTableDao();

menuDetailDao = daoSession.getMenuDetailDao();

一些简单的使用方法如下

 //查看对应的menuTable表是否存在
             QueryBuilder qb = menuDetailDao.queryBuilder();
             qb.where(MenuDetailDao.Properties.MenuDateId.eq(CommonUtils.getNowDateString()+menu_type));
             List listResult = qb.list();

             QueryBuilder qbAll = menuDetailDao.queryBuilder();
             qbAll.orderAsc(MenuDetailDao.Properties.MenuDateId);
             List listResultAll = qbAll.list();
             for(int k =0;k<listResultAll.size();k++)
             {
                 MenuDetail menu_detail_entity = (MenuDetail) listResultAll.get(k);
                 CommonUtils.LogWuwei(tag, menu_detail_entity.getName()+"   "+
                         menu_detail_entity.getMenuDateId());
             }
             

3、自学的时候借阅了很多资料，如果恰巧你刚接触到，你会用到的：

1、http://my.oschina.net/cheneywangc/blog/196354 greendao讲义，开源中国上的好文章

2、http://www.sllbeta.com/android/3/

3、http://greendao-orm.com/ 这个是官网，最权威的网站了

4、我是从哪里听说到这个greendao的呢，这得益于github上一个开源工程，在这个开源工程中，汇聚了android开发过程中开发者都有可能用到的，见下网址：

https://github.com/Trinea/android-open-project

5、http://blog.csdn.net/lan120576664/article/details/36204833(适合新手看看)

4、赠送所有开发者一句话，多看官网文档，如果需要看官网api，推荐一个工具，就是mac下的dash，dash支持代码片段和官网api（api包括很多，绝对是你想象不到的）