程序博客网 > whenyoubelieve知乎

XUtils 源码分析（三）--数据库操作模块

来源：互联网 发布：whenyoubelieve知乎 编辑：程序博客网 时间：2024/06/05 08:20

一 数据库创建


1.客户端程序：

  1.  DbUtils.DaoConfig config = new DbUtils.DaoConfig(context);
  2.         config.setDbName("user.db");
  3.         mUserInforDbUtils = DbUtils.create(config);

2.DbUtils的创建函数：

  1.  public static DbUtils create(DaoConfig daoConfig) {
  2.         return getInstance(daoConfig);
  3.     }

3.私有静态方法获取DbUtils实例：先检查缓存，没有就去创建。

  1. /**
  2.      * 获取一个DbUtils，首先检查Map是否有缓存，没有新建添加到Map中
  3.      */
  4.     private synchronized static DbUtils getInstance(DaoConfig daoConfig) {
  5.         DbUtils dao = daoMap.get(daoConfig.getDbName());
  6.         if (dao == null) {
  7.             dao = new DbUtils(daoConfig);//生成数据库操作对象，新建数据库
  8.             daoMap.put(daoConfig.getDbName(), dao);//存放数据库操作对象
  9.         } else {
  10.             dao.daoConfig = daoConfig;//更新配置
  11.         }
  12.         //处理数据库更新问题
  13.         SQLiteDatabase database = dao.database;
  14.         int oldVersion = database.getVersion();
  15.         int newVersion = daoConfig.getDbVersion();
  16.         if (oldVersion != newVersion) {//版本不一致
  17.             if (oldVersion != 0) {
  18.                 DbUpgradeListener upgradeListener = daoConfig.getDbUpgradeListener();
  19.                 if (upgradeListener != null) {
  20.                     upgradeListener.onUpgrade(dao, oldVersion, newVersion);//用户自定义更新
  21.                 } else {//清空旧的数据库
  22.                     try {
  23.                         dao.dropDb();
  24.                     } catch (DbException e) {
  25.                         LogUtils.e(e.getMessage(), e);
  26.                     }
  27.                 }
  28.             }
  29.             database.setVersion(newVersion);
  30.         }        return dao;
  31.     }

3.1 私有构造方法：

  1. private DbUtils(DaoConfig config) {
  2.         if (config == null) {
  3.             throw new IllegalArgumentException("daoConfig may not be null");
  4.         }
  5.         this.database = createDatabase(config);
  6.         this.daoConfig = config;
  7.     }

3.1.1 构造方法生成的数据库createDatabase(config)：


  1.   /*
  2.      * 新建数据库
  3.      */
  4.     private SQLiteDatabase createDatabase(DaoConfig config) {
  5.         SQLiteDatabase result = null;
  6.         String dbDir = config.getDbDir();
  7.         if (!TextUtils.isEmpty(dbDir)) {//数据库路径不为空
  8.             File dir = new File(dbDir);
  9.             if (dir.exists() || dir.mkdirs()) {
  10.                 File dbFile = new File(dbDir, config.getDbName());
  11.                 result = SQLiteDatabase.openOrCreateDatabase(dbFile, null);//生成数据库文件
  12.             }
  13.         } else {//生成数据库对象
  14.             result = config.getContext().openOrCreateDatabase(config.getDbName(), 0, null);
  15.         }
  16.         return result;
  17.     }

3.2清空数据库：

  1.   /**
  2.      * 清空数据库
  3.      */
  4.     public void dropDb() throws DbException {
  5.         Cursor cursor = execQuery("SELECT name FROM sqlite_master WHERE type='table' AND name<>'sqlite_sequence'");
  6. //获得数据库中的所有表
  7.         if (cursor != null) {
  8.             try {
  9.                 while (cursor.moveToNext()) {
  10.                     try {
  11.                         String tableName = cursor.getString(0);
  12.                         execNonQuery("DROP TABLE " + tableName);//清空
  13.                         Table.remove(this, tableName);
  14.                     } catch (Throwable e) {
  15.                         LogUtils.e(e.getMessage(), e);
  16.                     }
  17.                 }
  19.             } catch (Throwable e) {
  20.                 throw new DbException(e);
  21.             } finally {
  22.                 IOUtils.closeQuietly(cursor);
  23.             }
  24.         }
  25.     }


4.客户端存储数据：

  1.    try {
  2.             mUserInforDbUtils.save(user); // 使用saveBindingId保存实体时会为实体的id赋值
  3.         } catch (DbException e) {
  4.             e.printStackTrace();
  5.         }

4.1 save函数 mUserInforDbUtils.save(user);

  1.     /**
  2.      * 数据库存储记录
  3.      */
  4.     public void save(Object entity) throws DbException {
  5.         try {
  6.             beginTransaction();//开启事务
  7.             createTableIfNotExist(entity.getClass());//检测表是否存在,不存在就新建
  8.             execNonQuery(SqlInfoBuilder.buildInsertSqlInfo(this, entity));
  9.             setTransactionSuccessful();
  10.         } finally {
  11.             endTransaction();
  12.         }
  13.     }
4.1.1 开启数据库事物管理 beginTransaction(); 
  1.  /**
  2.      * 开启事务管理
  3.      */
  4.     private void beginTransaction() {
  5.         if (allowTransaction) {//允许开启
  6.             database.beginTransaction();
  7.         } else {//不允许锁定
  8.             writeLock.lock();
  9.             writeLocked = true;
  10.         }
  11.     }

4.1.2 表不存在就创建 createTableIfNotExist(entity.getClass());

  1.   /**
  2.      * 不存在表就新建
  3.      */
  4.     public void createTableIfNotExist(Class<?> entityType) throws DbException {
  5.         if (!tableIsExist(entityType)) {//表不存在，注意表对象已存在
  6.             SqlInfo sqlInfo = SqlInfoBuilder.buildCreateTableSqlInfo(this, entityType);//生成SQL语句对象
  7.             execNonQuery(sqlInfo);//执行语句，建表
  8.             String execAfterTableCreated = TableUtils.getExecAfterTableCreated(entityType);
  9.             if (!TextUtils.isEmpty(execAfterTableCreated)) {
  10.                 execNonQuery(execAfterTableCreated);//设置表默认值
  11.             }
  12.         }
  13.     }
4.1.2.1判断表是否存在 tableIsExist(entityType)；
  1.     /**
  2.      * 判断表是否存在
  3.      */
  4.     public boolean tableIsExist(Class<?> entityType) throws DbException {
  5.         Table table = Table.get(this, entityType);//根据类对象获取表
  6.         if (table.isCheckedDatabase()) {
  7.             return true;
  8.         }
  9.         Cursor cursor = execQuery("SELECT COUNT(*) AS c FROM sqlite_master WHERE type='table' AND name='" + table.tableName + "'");//查找制定表
  10.         if (cursor != null) {
  11.             try {
  12.                 if (cursor.moveToNext()) {
  13.                     int count = cursor.getInt(0);
  14.                     if (count > 0) {//存在指定的表
  15.                         table.setCheckedDatabase(true);
  16.                         return true;
  17.                     }
  18.                 }
  19.             } catch (Throwable e) {
  20.                 throw new DbException(e);
  21.             } finally {
  22.                 IOUtils.closeQuietly(cursor);
  23.             }
  24.         }
  25.         return false;
  26.     }

4.1.2.1.1 获取表对象Table.get(this, entityType);缓存中去找没有去新建

  1.  /**
  2.      * 获取表
  3.      */
  4.     public static synchronized Table get(DbUtils db, Class<?> entityType) {
  5.         String tableKey = db.getDaoConfig().getDbName() + "#" + entityType.getName();
                Table table = tableMap.get(tableKey);
  1.         if (table == null) {//没有缓存
  2.             table = new Table(db, entityType);
  3.             tableMap.put(tableKey, table);
  4.         }
  5.         return table;
  6.     }

4.1.2.1.1.1 Table私有构造方法：

  1.  private Table(DbUtils db, Class<?> entityType) {
  2.         this.db = db;
  3.         this.tableName = TableUtils.getTableName(entityType);//获取表名
  4.         this.id = TableUtils.getId(entityType);
  5.         this.columnMap = TableUtils.getColumnMap(entityType);//获取列MAP
  7.         finderMap = new HashMap<String, Finder>();
  8.         for (Column column : columnMap.values()) {//得到主表列对象
  9.             column.setTable(this);
  10.             if (column instanceof Finder) {
  11.                 finderMap.put(column.getColumnName(), (Finder) column);
  12.             }
  13.         }
  14.     }

4.1.2.1.1.1.1 获取表名 TableUtils.getTableName(entityType);

  1. public static String getTableName(Class<?> entityType) {
  2.         Table table = entityType.getAnnotation(Table.class);
  3.         if (table == null || TextUtils.isEmpty(table.name())) {//没有注解字段Table
  4.             return entityType.getName().replace('.', '_');
  5.         }
  6.         return table.name();
  7.     }

4.1.2.1.1.1.2 获取表的列对象 TableUtils.getColumnMap(entityType);

  1.  /**
  2.      * 根据类对象获取列对象的MAP
  3.      */
  4.     static synchronized HashMap<String, Column> getColumnMap(Class<?> entityType) {
  5.         if (entityColumnsMap.containsKey(entityType.getName())) {//这个类已经存储过了数据库列对象
  6.             return entityColumnsMap.get(entityType.getName());
  7.         }
  8.         HashMap<String, Column> columnMap = new HashMap<String, Column>();
  9.         String primaryKeyFieldName = getPrimaryKeyFieldName(entityType);
  10.         addColumns2Map(entityType, primaryKeyFieldName, columnMap);//缓存类对象的属性指为Columns对象
  11.         entityColumnsMap.put(entityType.getName(), columnMap);//缓存这个数据表的Columns对象MAP集
  12.         return columnMap;
  13.     }

4.1.2.1.1.1.2.1 缓存列对象addColumns2Map(entityType, primaryKeyFieldName, columnMap);

  1. /**
  2.      * 缓存类对象的属性指为Columns对象
  3.      */
  4.     private static void addColumns2Map(Class<?> entityType, String primaryKeyFieldName, HashMap<String, Column> columnMap) {
  5.         if (Object.class.equals(entityType)) return;
  6.         try {
  7.             Field[] fields = entityType.getDeclaredFields();
  8.             for (Field field : fields) {
  9.                 if (ColumnUtils.isTransient(field) || Modifier.isStatic(field.getModifiers())) {//忽略static及注解Transient的属性
  10.                     continue;
  11.                 }
  12.                 if (ColumnConverterFactory.isSupportColumnConverter(field.getType())) {//属性字段支持列对象转换
  13.                     if (!field.getName().equals(primaryKeyFieldName)) {//不是ID字段
  14.                         Column column = new Column(entityType, field);
  15.                         if (!columnMap.containsKey(column.getColumnName())) {//缓存列对象
  16.                             columnMap.put(column.getColumnName(), column);
  17.                         }
  18.                     }
  19.                 } else if (ColumnUtils.isForeign(field)) {// 属性字段是Foreign注解，从表注解
  20.                     Foreign column = new Foreign(entityType, field);
  21.                     if (!columnMap.containsKey(column.getColumnName())) {
  22.                         columnMap.put(column.getColumnName(), column);
  23.                     }
  24.                 } else if (ColumnUtils.isFinder(field)) {//属性字段是Finder，主表注解
  25.                     Finder column = new Finder(entityType, field);
  26.                     if (!columnMap.containsKey(column.getColumnName())) {
  27.                         columnMap.put(column.getColumnName(), column);
  28.                     }
  29.                 }
  30.             }
  31.             if (!Object.class.equals(entityType.getSuperclass())) {//继续将父类属性字段缓存
  32.                 addColumns2Map(entityType.getSuperclass(), primaryKeyFieldName, columnMap);
  33.             }
  34.         } catch (Throwable e) {
  35.             LogUtils.e(e.getMessage(), e);
  36.         }
  37.     }

4.1.2.1.1.1.2.1.1 判断属性字段时候支持列对象转换

  2.     /**
  3.      * 检查是否支持Column对象转换
  4.      */
  5.     public static boolean isSupportColumnConverter(Class columnType) {
  6.         if (columnType_columnConverter_map.containsKey(columnType.getName())) {
  7.             return true;
  8.         } else if (ColumnConverter.class.isAssignableFrom(columnType)) {//isAssignableFrom如果调用这个方法的class或接口 与 参数cls表示的类或接口相同，或者是参数cls表示的类或接口的父类，则返回true。
  9.             try {
  10.                 ColumnConverter columnConverter = (ColumnConverter) columnType.newInstance();
  11.                 if (columnConverter != null) {
  12.                     columnType_columnConverter_map.put(columnType.getName(), columnConverter);
  13.                 }
  14.                 return columnConverter == null;
  15.             } catch (Throwable e) {
  16.             }
  17.         }
  18.         return false;
  19.     }

4.1.2.1.1.1.2.1.1.1 标准列对象columnType_columnConverter_map内容，上述判断的依据：

  1.    private static final ConcurrentHashMap<String, ColumnConverter> columnType_columnConverter_map;
  3.     static {
  4.         columnType_columnConverter_map = new ConcurrentHashMap<String, ColumnConverter>();
  6.         BooleanColumnConverter booleanColumnConverter = new BooleanColumnConverter();
  7.         columnType_columnConverter_map.put(boolean.class.getName(), booleanColumnConverter);
  8.         columnType_columnConverter_map.put(Boolean.class.getName(), booleanColumnConverter);
  10.         ByteArrayColumnConverter byteArrayColumnConverter = new ByteArrayColumnConverter();
  11.         columnType_columnConverter_map.put(byte[].class.getName(), byteArrayColumnConverter);
  13.         ByteColumnConverter byteColumnConverter = new ByteColumnConverter();
  14.         columnType_columnConverter_map.put(byte.class.getName(), byteColumnConverter);
  15.         columnType_columnConverter_map.put(Byte.class.getName(), byteColumnConverter);
  17.         CharColumnConverter charColumnConverter = new CharColumnConverter();
  18.         columnType_columnConverter_map.put(char.class.getName(), charColumnConverter);
  19.         columnType_columnConverter_map.put(Character.class.getName(), charColumnConverter);
  21.         DateColumnConverter dateColumnConverter = new DateColumnConverter();
  22.         columnType_columnConverter_map.put(Date.class.getName(), dateColumnConverter);
  24.         DoubleColumnConverter doubleColumnConverter = new DoubleColumnConverter();
  25.         columnType_columnConverter_map.put(double.class.getName(), doubleColumnConverter);
  26.         columnType_columnConverter_map.put(Double.class.getName(), doubleColumnConverter);
  28.         FloatColumnConverter floatColumnConverter = new FloatColumnConverter();
  29.         columnType_columnConverter_map.put(float.class.getName(), floatColumnConverter);
  30.         columnType_columnConverter_map.put(Float.class.getName(), floatColumnConverter);
  32.         IntegerColumnConverter integerColumnConverter = new IntegerColumnConverter();
  33.         columnType_columnConverter_map.put(int.class.getName(), integerColumnConverter);
  34.         columnType_columnConverter_map.put(Integer.class.getName(), integerColumnConverter);
  36.         LongColumnConverter longColumnConverter = new LongColumnConverter();
  37.         columnType_columnConverter_map.put(long.class.getName(), longColumnConverter);
  38.         columnType_columnConverter_map.put(Long.class.getName(), longColumnConverter);
  40.         ShortColumnConverter shortColumnConverter = new ShortColumnConverter();
  41.         columnType_columnConverter_map.put(short.class.getName(), shortColumnConverter);
  42.         columnType_columnConverter_map.put(Short.class.getName(), shortColumnConverter);
  44.         SqlDateColumnConverter sqlDateColumnConverter = new SqlDateColumnConverter();
  45.         columnType_columnConverter_map.put(java.sql.Date.class.getName(), sqlDateColumnConverter);
  47.         StringColumnConverter stringColumnConverter = new StringColumnConverter();
  48.         columnType_columnConverter_map.put(String.class.getName(), stringColumnConverter);
  49.     }


4.1.2.1.1.1.3 获取表的ID属性TableUtils.getId(entityType);


  2.     /**
  3.      * 获得对象的ID属性
  4.      */
  5.     static synchronized com.lidroid.xutils.db.table.Id getId(Class<?> entityType) {
  6.         if (Object.class.equals(entityType)) {
  7.             throw new RuntimeException("field 'id' not found");
  8.         }
  9.         if (entityIdMap.containsKey(entityType.getName())) {
  10.             return entityIdMap.get(entityType.getName());
  11.         }
  13.         Field primaryKeyField = null;
  14.         Field[] fields = entityType.getDeclaredFields();//获取声明字段
  15.         if (fields != null) {
  16.             for (Field field : fields) {
  17.                 if (field.getAnnotation(Id.class) != null) {//获取注解ID属性
  18.                     primaryKeyField = field;
  19.                     break;
  20.                 }
  21.             }
  23.             if (primaryKeyField == null) {//没有发现注解ID，根据字段生成ID
  24.                 for (Field field : fields) {
  25.                     if ("id".equals(field.getName()) || "_id".equals(field.getName())) {
  26.                         primaryKeyField = field;
  27.                         break;
  28.                     }
  29.                 }
  30.             }
  31.         }
  33.         if (primaryKeyField == null) {
  34.             return getId(entityType.getSuperclass());//没有iD属性再去他的父类去找
  35.         }
  37.         com.lidroid.xutils.db.table.Id id = new com.lidroid.xutils.db.table.Id(entityType, primaryKeyField);//生成数据ID对象
  38.         entityIdMap.put(entityType.getName(), id);//存储这个ID对象
  39.         return id;
  40.     }


4.1.2.1.1.1.3.1 ID构造函数：com.lidroid.xutils.db.table.Id id = new com.lidroid.xutils.db.table.Id(entityType, primaryKeyField);


  1.    Id(Class<?> entityType, Field field) {
  2.         super(entityType, field);
  3.         columnFieldClassName = columnField.getType().getName();//id属性类型名
  4.     }

4.1.2.1.1.1.3.1.1 父类构造函数super(entityType, field);

  1. Column(Class<?> entityType, Field field) {
  2.         this.columnField = field;
  3.         this.columnConverter = ColumnConverterFactory.getColumnConverter(field.getType());//获取ID属性的ColumnConverter对象
  4.         this.columnName = ColumnUtils.getColumnNameByField(field);
  5.         if (this.columnConverter != null) {
  6.             this.defaultValue = this.columnConverter.getFieldValue(ColumnUtils.getColumnDefaultValue(field));
  7.         } else {
  8.             this.defaultValue = null;
  9.         }
  10.         this.getMethod = ColumnUtils.getColumnGetMethod(entityType, field);
  11.         this.setMethod = ColumnUtils.getColumnSetMethod(entityType, field);
  12.     }

至此Table对象构造完成。接下来如果数据库中的表不存在就去创建。


4.1.2.2 去构建创建表的SQL语句 SqlInfoBuilder.buildCreateTableSqlInfo(this, entityType);

  1. public static SqlInfo buildCreateTableSqlInfo(DbUtils db, Class<?> entityType) throws DbException {
  2.         Table table = Table.get(db, entityType);
  3.         Id id = table.id;
  5.         StringBuffer sqlBuffer = new StringBuffer();//构造新建数据库SQL语句
  6.         sqlBuffer.append("CREATE TABLE IF NOT EXISTS ");
  7.         sqlBuffer.append(table.tableName);
  8.         sqlBuffer.append(" ( ");
  10.         if (id.isAutoIncrement()) {//id自增
  11.             sqlBuffer.append(""").append(id.getColumnName()).append(""  ").append("INTEGER PRIMARY KEY AUTOINCREMENT,");
  12.         } else {
  13.             sqlBuffer.append(""").append(id.getColumnName()).append(""  ").append(id.getColumnDbType()).append(" PRIMARY KEY,");
  14.         }
  16.         Collection<Column> columns = table.columnMap.values();//获取表的列对象集合
  17.         for (Column column : columns) {//组合列名
  18.             if (column instanceof Finder) {//主表
  19.                 continue;
  20.             }
  21.             sqlBuffer.append(""").append(column.getColumnName()).append(""  ");//列名
  22.             sqlBuffer.append(column.getColumnDbType());//类型
  23.             if (ColumnUtils.isUnique(column.getColumnField())) {//属性
  24.                 sqlBuffer.append(" UNIQUE");
  25.             }
  26.             if (ColumnUtils.isNotNull(column.getColumnField())) {
  27.                 sqlBuffer.append(" NOT NULL");
  28.             }
  29.             String check = ColumnUtils.getCheck(column.getColumnField());
  30.             if (check != null) {
  31.                 sqlBuffer.append(" CHECK(").append(check).append(")");
  32.             }
  33.             sqlBuffer.append(",");
  34.         }
  36.         sqlBuffer.deleteCharAt(sqlBuffer.length() - 1);//删除
  37.         sqlBuffer.append(" )");
  38.         return new SqlInfo(sqlBuffer.toString());
  39.     }

4.1.2.3执行构建数据表的语句 execNonQuery(sqlInfo);

  1.   public void execNonQuery(SqlInfo sqlInfo) throws DbException {
  2.         debugSql(sqlInfo.getSql());
  3.         try {
  4.             if (sqlInfo.getBindArgs() != null) {
  5.                 database.execSQL(sqlInfo.getSql(), sqlInfo.getBindArgsAsArray());//有占位符的执行
  6.             } else {
  7.                 database.execSQL(sqlInfo.getSql());
  8.             }
  9.         } catch (Throwable e) {
  10.             throw new DbException(e);
  11.         }
  12.     }
4.1.2.4 表构建完成时如果有注解去设置表的默认值String execAfterTableCreated = TableUtils.getExecAfterTableCreated(entityType);
  1. /**
  2.      * 获取表注解默认值
  3.      */
  4.     public static String getExecAfterTableCreated(Class<?> entityType) {
  5.         Table table = entityType.getAnnotation(Table.class);
  6.         if (table != null) {
  7.             return table.execAfterTableCreated();
  8.         }
  9.         return null;
  10.     }

4.1.2.5 如果这个默认值语句不为空去执行，设置默认值execNonQuery(execAfterTableCreated);即调用4.1.2.3函数。


至此，对于数据表如果不存在就去创建操作完成。


4.1.3 去构造插入的SQL语句SqlInfoBuilder.buildInsertSqlInfo(this, entity)；

  2.     public static SqlInfo buildInsertSqlInfo(DbUtils db, Object entity) throws DbException {
  3.         List<KeyValue> keyValueList = entity2KeyValueList(db, entity);
  4.         if (keyValueList.size() == 0) return null;
  5.         SqlInfo result = new SqlInfo();
  6.         StringBuffer sqlBuffer = new StringBuffer();
  7.         sqlBuffer.append("INSERT INTO ");
  8.         sqlBuffer.append(TableUtils.getTableName(entity.getClass()));//表名
  9.         sqlBuffer.append(" (");
  10.         for (KeyValue kv : keyValueList) {//封装插入的实体键值对
  11.             sqlBuffer.append(kv.key).append(",");
  12.             result.addBindArgWithoutConverter(kv.value);//添加到属性链表中
  13.         }
  14.         sqlBuffer.deleteCharAt(sqlBuffer.length() - 1);
  15.         sqlBuffer.append(") VALUES (");
  17.         int length = keyValueList.size();
  18.         for (int i = 0; i < length; i++) {
  19.             sqlBuffer.append("?,");
  20.         }
  21.         sqlBuffer.deleteCharAt(sqlBuffer.length() - 1);
  22.         sqlBuffer.append(")");
  23.         result.setSql(sqlBuffer.toString());
  24.         return result;
  25.     }

4.1.4 执行SQL语句执行插入数据操作 execNonQuery(SqlInfoBuilder.buildInsertSqlInfo(this, entity));即调用4.1.2.3函数。

4.1.5 设置数据库事务提交成功setTransactionSuccessful();

  1.  private void setTransactionSuccessful() {
  2.         if (allowTransaction) {
  3.             database.setTransactionSuccessful();
  4.         }
  5.     }

至此，数据库插入一条记录完成。

  


5.客户端存储List数据

  1. try {
  2.             mUserFriendDbUtils.saveAll(friends);
  3.         } catch (DbException e) {
  4.             e.printStackTrace();
  5.         }

5.1 存储List数据saveAll

  1. public void saveAll(List<?> entities) throws DbException {
  2.         if (entities == null || entities.size() == 0) return;
  3.         try {
  4.             beginTransaction();//开启事务
  5.             createTableIfNotExist(entities.get(0).getClass());
  6.             for (Object entity : entities) {
  7.                 execNonQuery(SqlInfoBuilder.buildInsertSqlInfo(this, entity));
  8.             }
  9.             setTransactionSuccessful();
  10.         } finally {
  11.             endTransaction();
  12.         }
  13.     }
5.1.1 构造插入语句调用4.1.2.3函数SqlInfoBuilder.buildInsertSqlInfo(this, entity)


后续与上述单项插入相同。



删除数据操作。deleteAll；

6 客户端删除操作

  1. try {
  2.             mUserCircleDbUtils.deleteAll(Circle.class);
  4.         } catch (DbException e) {
  5.             e.printStackTrace();
  6.         }

6.1 执行删除mUserCircleDbUtils.deleteAll(Circle.class);


  1.  public void deleteAll(Class<?> entityType) throws DbException {
  2.         delete(entityType, null);
  3.     }

6.1.1 调用delete(entityType, null);先判断表是否存在，在开启事务管理，执行SQL语句，提交事务成功，关闭事务。


  1.   public void delete(Class<?> entityType, WhereBuilder whereBuilder) throws DbException {
  2.         if (!tableIsExist(entityType)) return;
  3.         try {
  4.             beginTransaction();
  6.             execNonQuery(SqlInfoBuilder.buildDeleteSqlInfo(this, entityType, whereBuilder));
  8.             setTransactionSuccessful();
  9.         } finally {
  10.             endTransaction();
  11.         }
  12.     }

6.1.1.1 构造删除的SQL语句SqlInfoBuilder.buildDeleteSqlInfo(this, entityType, whereBuilder)；

  1. public static SqlInfo buildDeleteSqlInfo(DbUtils db, Class<?> entityType, WhereBuilder whereBuilder) throws DbException {
  2.         Table table = Table.get(db, entityType);//获取表对象
  3.         StringBuilder sb = new StringBuilder(buildDeleteSqlByTableName(table.tableName));
  4.         if (whereBuilder != null && whereBuilder.getWhereItemSize() > 0) {
  5.             sb.append(" WHERE ").append(whereBuilder.toString());
  6.         }
  7.         return new SqlInfo(sb.toString());
  8.     }

6.1.1.1.1根据表名构造删除SQL语句buildDeleteSqlByTableName(table.tableName)

  1.    private static String buildDeleteSqlByTableName(String tableName) {
  2.         return "DELETE FROM " + tableName;
  3.     }

接下来执行与前面相同。

至此deleteAll操作完成。


查找findAll操作：


7 客户端findAll操作：

  1.    try {
  2.             userList = mUserInforDbUtils.findAll(User.class);
  3.         } catch (DbException e) {
  4.             e.printStackTrace();
  5.         }

7.1查找操作；

  1.  public <T> List<T> findAll(Class<T> entityType) throws DbException {
  2.         return findAll(Selector.from(entityType));
  3.     }
7.1.1 调用findAll操作；
  1. public <T> List<T> findAll(Selector selector) throws DbException {
  2.         if (!tableIsExist(selector.getEntityType())) return null;
  3.         String sql = selector.toString();//构造选择语句
  4.         long seq = CursorUtils.FindCacheSequence.getSeq();
  5.         findTempCache.setSeq(seq);//
  6.         Object obj = findTempCache.get(sql);
  7.         if (obj != null) {//存在缓存
  8.             return (List<T>) obj;
  9.         }
  10.         List<T> result = new ArrayList<T>();
  12.         Cursor cursor = execQuery(sql);//不存在缓存去执行查询吧
  13.         if (cursor != null) {
  14.             try {
  15.                 while (cursor.moveToNext()) {//存储
  16.                     T entity = (T) CursorUtils.getEntity(this, cursor, selector.getEntityType(), seq);//////////
  17.                     result.add(entity);
  18.                 }
  19.                 findTempCache.put(sql, result);
  20.             } catch (Throwable e) {
  21.                 throw new DbException(e);
  22.             } finally {
  23.                 IOUtils.closeQuietly(cursor);
  24.             }
  25.         }
  26.         return result;
  27.     }
7.1.1.1生产Selector语句selector.toString();
  1.  @Override
  2.     public String toString() {
  3.         StringBuilder result = new StringBuilder();
  4.         result.append("SELECT ");
  5.         result.append("*");
  6.         result.append(" FROM ").append(tableName);
  7.         if (whereBuilder != null && whereBuilder.getWhereItemSize() > 0) {
  8.             result.append(" WHERE ").append(whereBuilder.toString());
  9.         }
  10.         if (orderByList != null) {
  11.             for (int i = 0; i < orderByList.size(); i++) {
  12.                 result.append(" ORDER BY ").append(orderByList.get(i).toString());
  13.             }
  14.         }
  15.         if (limit > 0) {
  16.             result.append(" LIMIT ").append(limit);
  17.             result.append(" OFFSET ").append(offset);
  18.         }
  19.         return result.toString();
  20.     }

7.1.1.1.1执行查找语句获得查找的数据CursorUtils.getEntity(this, cursor, selector.getEntityType(), seq);

  1.   public static <T> T getEntity(final DbUtils db, final Cursor cursor, Class<T> entityType, long findCacheSequence) {
  2.         if (db == null || cursor == null) return null;
  3.         EntityTempCache.setSeq(findCacheSequence);
  4.         try {
  5.             Table table = Table.get(db, entityType);
  6.             Id id = table.id;
  7.             String idColumnName = id.getColumnName();
  8.             int idIndex = id.getIndex();
  9.             if (idIndex < 0) {
  10.                 idIndex = cursor.getColumnIndex(idColumnName);
  11.             }
  12.             Object idValue = id.getColumnConverter().getFieldValue(cursor, idIndex);
  13.             T entity = EntityTempCache.get(entityType, idValue);
  14.             if (entity == null) {
  15.                 entity = entityType.newInstance();
  16.                 id.setValue2Entity(entity, cursor, idIndex);
  17.                 EntityTempCache.put(entityType, idValue, entity);
  18.             } else {
  19.                 return entity;
  20.             }
  21.             int columnCount = cursor.getColumnCount();
  22.             for (int i = 0; i < columnCount; i++) {
  23.                 String columnName = cursor.getColumnName(i);
  24.                 Column column = table.columnMap.get(columnName);
  25.                 if (column != null) {
  26.                     column.setValue2Entity(entity, cursor, i);
  27.                 }
  28.             }
  30.             // init finder
  31.             for (Finder finder : table.finderMap.values()) {
  32.                 finder.setValue2Entity(entity, null, 0);
  33.             }
  34.             return entity;
  35.         } catch (Throwable e) {
  36.             LogUtils.e(e.getMessage(), e);
  37.         }
  39.         return null;
  40.     }

执行完查询之后缓存并返回结果。


更新操作

8 客户端调用更新

  1.  try {
  2.             mArticleDbUtils.update(acceptArticle, "zanCount");
  3.         } catch (DbException e) {
  4.             e.printStackTrace();
  5.         }

8.1 函数update

  1. public void update(Object entity, String... updateColumnNames) throws DbException {
  2.         if (!tableIsExist(entity.getClass())) return;
  3.         try {
  4.             beginTransaction();
  6.             execNonQuery(SqlInfoBuilder.buildUpdateSqlInfo(this, entity, updateColumnNames));
  8.             setTransactionSuccessful();
  9.         } finally {
  10.             endTransaction();
  11.         }
  12.     }

8.1.1构造更新SQL语句SqlInfoBuilder.buildUpdateSqlInfo(this, entity, updateColumnNames)

  1. public static SqlInfo buildUpdateSqlInfo(DbUtils db, Object entity, String... updateColumnNames) throws DbException {
  3.         List<KeyValue> keyValueList = entity2KeyValueList(db, entity);
  4.         if (keyValueList.size() == 0) return null;
  6.         HashSet<String> updateColumnNameSet = null;
  7.         if (updateColumnNames != null && updateColumnNames.length > 0) {
  8.             updateColumnNameSet = new HashSet<String>(updateColumnNames.length);
  9.             Collections.addAll(updateColumnNameSet, updateColumnNames);
  10.         }
  12.         Class<?> entityType = entity.getClass();
  13.         Table table = Table.get(db, entityType);
  14.         Id id = table.id;
  15.         Object idValue = id.getColumnValue(entity);
  17.         if (null == idValue) {
  18.             throw new DbException("this entity[" + entity.getClass() + "]'s id value is null");
  19.         }
  21.         SqlInfo result = new SqlInfo();
  22.         StringBuffer sqlBuffer = new StringBuffer("UPDATE ");
  23.         sqlBuffer.append(table.tableName);
  24.         sqlBuffer.append(" SET ");
  25.         for (KeyValue kv : keyValueList) {
  26.             if (updateColumnNameSet == null || updateColumnNameSet.contains(kv.key)) {
  27.                 sqlBuffer.append(kv.key).append("=?,");
  28.                 result.addBindArgWithoutConverter(kv.value);
  29.             }
  30.         }
  31.         sqlBuffer.deleteCharAt(sqlBuffer.length() - 1);
  32.         sqlBuffer.append(" WHERE ").append(WhereBuilder.b(id.getColumnName(), "=", idValue));
  34.         result.setSql(sqlBuffer.toString());
  35.         return result;
  36.     }

后续操作与前面相同，支持更新操作完成。

二 致敬原作者，谢谢作者辛苦付出，代码受益匪浅。

传送门

三 其他讲解：

架构讲解：传送门

四 源码注释

源码详细注释：传送门



0 0
whenyoubelieve知乎 whenyoubelieve知乎
原创粉丝点击
热门IT博客
ubuntu guest切换用户ubuntu guest切换用户
如何恢复mac系统如何恢复mac系统
阿里云国际版服务器
c语言中被调用函数
iptv安装第三方软件
mac怎么看系统文件
域名注销icp备案
怎样修改淘宝店铺名称
windows10不能下载软件
日本的交友软件
vscode c语言自动补全
软件许可使用授权书
linux arp命令的使用
mac关闭当前窗口快捷键
天宇全站仪传输软件
linux设置用户只能ftp
ubuntu 无grub引导
网络大v最有名的有哪些
php 00截断
mac类似sai绘画软件
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 美的太阳能热水器 美的midea空调 美的收购库卡 美的空调安装电话 美的空调客服电话 美的洗衣机旗舰店 美的空调怎么清洗 空气净化器美的 美的校园招聘 美的空调怎么安装 美的安装空调 美的冰箱和美菱冰箱 000527 meidi midea 美空调 midea是什么牌子 美丽的图片 美缝的价格 对美 美丽啊 啊美丽 她以为她很美丽 类似于美丽说的网站 聚美优品的网站 美盛 美盾益生菌 美盾 纽盾美缝剂怎么样 舞儿美眉 草美眉 美眉影院 美眉app 草美眉影院 干美眉 爱上美眉 色美眉 漂亮美眉 插美眉 舞儿美眉app 太平洋美眉

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里