android之SQLite数据库insert操作

原型:

long android.database.sqlite.SQLiteDatabase.insert(String table, String nullColumnHack, ContentValues values)

 

参数介绍:

table: 要插入数据的表的名称

nullColumnHack:当values参数为空或者里面没有内容的时候,我们insert是会失败的(底层数据库不允许插入一个空行),为了防止这种情况,我们要在这里指定一个列名,到时候如果发现将要插入的行为空行时,就会将你指定的这个列名的值设为null,然后再向数据库中插入。

values:一个ContentValues对象,类似一个map.通过键值对的形式存储值。

 

这里很多人会迷惑,nullColumnHack到底干什么用的,为什么会出现呢。当我们不设定一列的时候,不都是数据库给设为默认值吗?很多字段设置默认值也是null,这里显示的设置也是null,有什么区别吗,怎么会显示设置了之后就允许插入了呢?

其实在底层,各种insert方法最后都回去调用insertWithOnConflict方法,这里我们粘贴出该方法的部分实现

 

[java][/java] view plaincopyprint?

  1. [java][/java] view plaincopy/**
  2.     * General method for inserting a row into the database.
  3.     *
  4.     * @param table the table to insert the row into
  5.     * @param nullColumnHack SQL doesn’t allow inserting a completely empty row,
  6.     *            so if initialValues is empty this column will explicitly be
  7.     *            assigned a NULL value
  8.     * @param initialValues this map contains the initial column values for the
  9.     *            row. The keys should be the column names and the values the
  10.     *            column values
  11.     * @param conflictAlgorithm for insert conflict resolver
  12.     * @return the row ID of the newly inserted row
  13.     * OR the primary key of the existing row if the input param ‘conflictAlgorithm’ =
  14.     * {@link #CONFLICT_IGNORE}
  15.     * OR -1 if any error
  16.     */
  17.    public long insertWithOnConflict(String table, String nullColumnHack,
  18.            ContentValues initialValues, int conflictAlgorithm) {
  19.        if (!isOpen()) {
  20.            throw new IllegalStateException(“database not open”);
  21.        }
  22.        // Measurements show most sql lengths <= 152
  23.        StringBuilder sql = new StringBuilder(152);
  24.        sql.append(“INSERT”);
  25.        sql.append(CONFLICT_VALUES[conflictAlgorithm]);
  26.        sql.append(” INTO “);
  27.        sql.append(table);
  28.        // Measurements show most values lengths < 40
  29.        StringBuilder values = new StringBuilder(40);
  30.        Set<Map.Entry<String, Object>> entrySet = null;
  31.        if (initialValues != null && initialValues.size() > 0) {
  32.            entrySet = initialValues.valueSet();
  33.            Iterator<Map.Entry<String, Object>> entriesIter = entrySet.iterator();
  34.            sql.append(‘(‘);
  35.            boolean needSeparator = false;
  36.            while (entriesIter.hasNext()) {
  37.                if (needSeparator) {
  38.                    sql.append(“, “);
  39.                    values.append(“, “);
  40.                }
  41.                needSeparator = true;
  42.                Map.Entry<String, Object> entry = entriesIter.next();
  43.                sql.append(entry.getKey());
  44.                values.append(‘?’);
  45.            }
  46.            sql.append(‘)’);
  47.        } else {
  48.            sql.append(“(” + nullColumnHack + “) “);
  49.            values.append(“NULL”);
  50.        }

这里我们可以看到,当我们的ContentValues类型的数据initialValues为null,或者size<=0时,就会再sql语句中添加nullColumnHack的设置。我们可以想象一下,如果我们不添加nullColumnHack的话,那么我们的sql语句最终的结果将会类似insert into tableName()values();这显然是不允许的。而如果我们添加上nullColumnHack呢,sql将会变成这样,insert into tableName (nullColumnHack)values(null);这样很显然就是可以的。

 

下面附上插入操作的方法代码:

[java][/java] view plaincopyprint?

  1. public void insert(String name, String address, String type, String notes) {
  2.         ContentValues cv=new ContentValues();
  3.         cv.put(“name”, name);
  4.         cv.put(“address”, address);
  5.         cv.put(“type”, type);
  6.         cv.put(“notes”, notes);
  7.         getWritableDatabase().insert(“restaurants”, “name”, cv);
  8.     }

标签