ContentProvider DB基础Dao单例类

该类主要用途为数据库访问工具类

1. ContentProvider 访问其他程序中的数据

关于内容提供器主要有两种：一是有现有的Content Provider来读取和操作响应的程序中的数据，二是创建自己的ContentProvider为程序提供外部访问接口。

如果内容提供器对外部提供了访问的接口，那么任何其他的应用程序都可以对这部分数据进行访问，其中android系统中的电话本、短信、媒体库等程序都提供了类似的访问接口。

1. 1 ContentResolver

• 若使用ContentProvider中共享数据，就需要借助ContentResolver() 方法获取到该类的实例。ContentResolver() 中提供了一系列方法对数据济宁CRUD操作，insert()、update()、delete()、delete()等方法，参数略微有差别。

• 不同于SQLiteDatabase，ContentResolver中的增删改查的方法都是不接受表名参数的，而是使用了一个Uri参数代替，这个参数被称之为内容URI。该内容的URI给ContentProvider的数据建立了唯一的标识符，主要由两部分组成：authority 和 path。

1. authority 是用于对不同的应用程序做区分的，一般为了避免冲突，都会采用程序包名来进行命名，类似com.example.app。
2. path 是用于对同一个应用程序中不同的表做区分的，通常都会添加到authority的后面，比如/table1和/table2，然后把authority 和path 进行组合
3. 该URI的内容就编程了com.example.app/table1和com.example.app/table2，在该字符串的头部加上协议声明。该字符串的标准格式为：
   content://com.example.app/table1
   content://com.example.app/table2

• 解释成该Uri对象后才可以作为参数传入，解析方法如下：
  Uri uri = Uri.parse("content://com.example.app/table1")

• 然后需要使用ContentResolver，根据上下文(若没有上下文，可以直接使用)
  this.mResolver = context.getContentResolver();

• 获取到的mResolver可以通过uri对表格进行增删改查了。其中比较麻烦的主要为查询表格。

1.2 对表格的操作

• 通过上文获取到的mResolver的来对uri中的表格进行增删改查处理，比较复杂的主要有查询和插入。可能涉及到的有ContentValues、StringBuilder、单例模式等
• 其中可以构造一个单独的工具类，*DAO.java，来维护这个ContentProvider。但首先这个工具类应该为单例类，

public class DemoDao {
    /**
     * Android ContentResolver.
     */
    private ContentResolver mResolver;
    /**
     * DemoDao静态实例
     */
    private static volatile DemoDao sInstance;
    /**
     * DemoDao构造方法
     */
    public DemoDao(Context context) {
        this.mResolver = context.getContentResolver();
    }
    /**
     * 获取DemoDao静态实例.
     */
    public static DemoDao getInstance(Context context) {
        if (sInstance == null) {
            synchronized (DemoDao.class) {
                if (sInstance == null) {
                    sInstance = new DemoDao(context.getApplicationContext());
                }
            }
        }
        return sInstance;
    }

    ...

}

• 基本的组成调用的方法主要有增删改查四种方法，可以根据自己的需要，对不同的情况进行进一步封装，其中查询、插入较为麻烦一丢丢。

public class DemoDao {
    
    ...
    // 增加
    Uri uri = mResolver.insert(Uri url, ContentValues values);
    
    // 查询
    Cursor result = mResolver.query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
    
    // 删除
    int num = mResolver.delete(Uri url, String where, String[] selectionArgs);
    
    // 修改
    int num = mResolver.update(Uri uri, ContentValues values, String where, String[] selectionArgs)
    ...
}    

1.2.1 查询数据库中表格数据

• 其中查询的语句略为复杂，主要应该是对数据库的语句进行了封装，可以通过query方法直接查询到数据库中的内容，其中参数的表格如下：

query()方法参数	对应的SQL部分	描述
uri	from table_name	指定查询某个应用程序下的某一张表
projection	select column1, column2	指定查询的列名
selection	where column = value	指定where的约束条件
selectionArgs	-	为where中的占位符提供具体的值
orderBy	order by column1, column2	指定查询结果的排序方式

参照上文的代码和表格，其中查询语句需要5个参数；
其中若只查询某一列projection的话，需要赋值第二个参数，以字符串数组的形式作为参数；
其中selectionArgs的参数形式也应该为字符串数组的形式。

• 对查询形式为select * from table1 where 列名 = "参值" and 列名 = "参值" ；的形式的查询代码demo

public class DemoDao {

    ...
    /**
     * 获取数据库表格 table1 中的所有的参值
     * @return 指定参数值的列表
     */
    public List getTableResult() {
        // 保存结果的列表
        List resultList = new ArrayList();
        // 查询DB 中的 指定列 的所有的数据，并按行转化为字符串添加到 resultList 中
        // String[] projection = {DbConstants.FIELD_PROFILE_JSON};
        // Cursor result = mResolver.query(uri, projection, null, null, null);

        // 查询DB 中的根据指定参数进行查询，构造where语句，指定where的约束条件
        StringBuffer buffer = new StringBuffer();
        buffer.append(“约束条件1“);
        buffer.append("= ? and ");
        buffer.append(“约束条件2”);
        buffer.append("= ? ");
        String selection = buffer.toString();
        // 为where中的占位符提供具体的值，为String形式则直接添加，若不是，需转String
        String[] selectionArgs = {"" + 参值1, "" + 参值2};
        // 在给定的uri中查询
        Cursor value = mResolver.query(uri, null, selection, selectionArgs, null);
        if (result == null) {
            return resultList;
        }

        // 在查询过后返回的Cursor的对象不能直接.toString()，因为里面有很多结果，
        // 可以调用moveToFirst()选取第一个或调用moveToNext()进行循环获取里面的结果
        String result;
        while (value.moveToNext()) {
            // 需要调用getString()方法，在方法内调用getColumnIndex(列名)方法来获取具体的值
            result = value.getString(value.getColumnIndex(列名));
            resultList.add(result);
        }
        // 在结束后需要通过close()方法关闭查询
        value.close();
        // 返回查询列表
        return resultList;
    }
    ...
}

• 上文中主要根据自身需求对mResovler.query()方法进行了封装，其中只查询单列的方式注释掉了，具体大致为以上的查询方式。

1.2.2 插入数据到数据库

• 其中插入数据到数据库中的表格，也可以根据需要对上文中的mResovler.insert()进行封装，插入过程中主要使用的ContentValues方法

ContentValues使用时，先对该类进行实例化，然后将待插入的数据put进去，具体使用的代码如下

public class DemoDao {

    ...
    /**
     * 插入一条设备记录
     * @param demoData:  数据对象
     * @return           true:插入成功；false：失败
     */
    public boolean insertData(DemoData demoData) {
        // 创建ContentValues对象，然后将要插入的数据以列名、值的形式put进去
        ContentValues values = new ContentValues();
        values.put(“列名1”, demoData.getName());
        values.put(“列名2”, demoData.getType());
        // 将值插入到数据库中
        Uri uri = mResolver.insert(uri, values);
        // insert()返回的是新创建的行的URL，解析该uri获取的应该是新创建的行号？所以不能等于-1
        return (ContentUris.parseId(uri) != -1);
    }
    ...
}

1.2.3 删除数据库中的数据

• 删除数据库中的数据，也可以根据需要对上下文中的mResolver.delete()方法进行封装。

public class DemoDao {

    ...
    /**
     * 删除指定的DATA.
     * @param dataName:  数据名
     * @return           true:删除设备成功；false：失败
     */
    public boolean delete(String dataName) {
        String where = "列名" + "=?";
        String[] selectionArgs = {dataName};
        int num = mResolver.delete(uri, where, selectionArgs);
        // 返回的为删除的行数
        return (num != 0);
    }    
    ...
}

1.2.4 修改数据库中的数据

• 修改数据库中的数据，也可以根据需要对上下文中的mResolver.update()方法进行封装。

public class DemoDao {

    ...
    /**
     * 更新指定设备连接状态
     * @param dataName  dataName
     * @param type      dataType
     * @return true：更新成功；false：失败
     */
    public boolean updateDataType(String dataName, int type) {
        ContentValues values = new ContentValues();
        values.put(type列名, type);
        String whereClause = dataName列名 + "=?";
        String[] whereArgs = {dataName};
        int num = mResolver.update(uri, values, whereClause, whereArgs);
        return (num != 0);
    }
    ...
}

1. 3 总结

• 主要介绍了ContentProvider 中DB相关的Dao单例类的创建，其中包括单例类的创建，对DB操作中的查询、插入、删除、修改的具体参数的分析和具体的封装demo。