Android初体验——内容提供器

最新推荐文章于 2024-07-08 16:05:37 发布

Judicious_x

最新推荐文章于 2024-07-08 16:05:37 发布

阅读量343

点赞数 2

分类专栏： Android 文章标签： android android studio java

本文链接：https://blog.csdn.net/m0_56195064/article/details/119513450

版权

Android 专栏收录该内容

13 篇文章 1 订阅

订阅专栏

文章目录

内容提供器简介
运行时权限
- Android权限机制详解
- 在程序运行时申请权限
访问其他程序中的数据
- ContentResolver的基本用法
- 读取系统联系人
创建自己的内容提供器
- 实现跨程序数据共享

内容提供器简介

主要用于在不同的应用程序之间实现数据共享功能，不同于文件存储和SharedPreferences存储中的两种全局可读写操作模式，内容提供器可以选择只对哪一部分数据进行共享，从而保证我们程序中的隐私数据不会有泄漏的风险。

运行时权限

引用运行时权限，从而更好的保护客户的安全和隐私

Android权限机制详解

Android开发团队在6.0系统中加入了运行时权限功能，即用户不需要在安装程序时一次性授权所有权限，可以在软件运行过程中再对某一权限进行授权。
Android将所有权限分成了两大类，一类是普通权限，一类是危险权限。
普通权限是指不会直接威胁到用户的安全和隐私的权限，对于这部分权限系统会自动帮我们进行授权，危险权限表示那些可能会触及用户隐私或对设备安全造成影响的，这部分需要用户手动点击授权。
Android中所有危险权限：
在这里插入图片描述
表格中每个危险权限都属于一个权限组，我们在进行运行时权限处理时使用的是权限名，但是用户一旦同意授权了，那么该权限所对应的权限组中所有的其他权限也会同时被授权。
危险权限和作用如果要使用以上危险权限，除了需要在AndroidManifest文件中配置，还需要在代码中对这些权限进行动态申请。

在程序运行时申请权限

CALL_PHONE拨打电话需要这个权限是一个危险权限
拨打电话：

			 try {
                    //指定的action是ACTION_CALL表示直接可以拨打电话 因此必须声明权限
                    //防止程序崩溃 将所有操作都放入了异常捕获代码中
                    Intent intent = new Intent(Intent.ACTION_CALL);
                    intent.setData(Uri.parse("tel:10086"));
                    startActivity(intent);
                }catch (SecurityException e) {
                    e.printStackTrace();
                }

添加权限：

<uses-permission android:name="android.permission.CALL_PHONE"/>

如果在低于6.0的版本使用此方法编写打电话功能，是可以正常运行的，但在高于6.0的系统运行，会出错。提示我们"Permission Denial"。
因为6.0及以上系统在使用危险权限时都必须进行运行时处理。
修改MainActivity

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button makeCall = (Button) findViewById(R.id.make_call);
        makeCall.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                //判断用户是否授权某个权限ContextCompat.checkSelfPermission（）
                //第一个参数是context 第二个是具体的权限名
                //使用方法的返回名与PackageManager.PERMISSION_GRANTED比较 相同就说明已经授权
                //GRANTED同意 DENIED拒绝
                if(ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {
                    //没有授权的话调用ActivityCompat.requestPermissions（）方法向客户申请授权
                    //第一个参数是Activity实例 第二个是String数组 将需要申诉的权限名放入即可 第三个是请求码 只要是唯一值即可
                    ActivityCompat.requestPermissions(MainActivity.this, new String[] {Manifest.permission.CALL_PHONE}, 1);
                }else {
                    call();
                }

            }
        });
    }

    private void call() {
        try {
            //指定的action是ACTION_CALL表示直接可以拨打电话 因此必须声明权限
            //防止程序崩溃 将所有操作都放入了异常捕获代码中
            Intent intent = new Intent(Intent.ACTION_CALL);
            intent.setData(Uri.parse("tel:10086"));
            startActivity(intent);
        }catch (SecurityException e) {
            e.printStackTrace();
        }
    }
    //调用完requestPermissions方法后会弹出一个权限申请对话框。让用户选择是否同意权限申请
    //回调到onRequestPermissionsResult（）方法 授权的结构会封装在grantResults中
    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions,  int[] grantResults) {
        switch (requestCode) {
            case 1:
                if(grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    call();
                }else {
                    Toast.makeText(this, "You denied the permission", Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }
}

这样即可运行。

访问其他程序中的数据

内容提供器的用法一般有两种：一种是使用现有的内容提供器来读取和操作相应程序的数据。第二种是创建自己的内容提供器给我们程序的数据提供外部访问接口。
如果一个应用程序通过内容提供器对其数据提供了外部访问接口，那么任何其他程序都可以对这部分数据进行访问。

ContentResolver的基本用法

对于每一个应用程序来说，如果想要访问内容提供器中共享的数据，就一定要借助ContentResolver类，可以通过Context中的getContentResolver( )方法获取到该类的实例。
ContentResolver中提供了一系列的方法用于对数据进行CRUD操作,其中insert()方法用于添加数据,update( )方法用于更新数据，delete( )方法用于删除数据，query( )方法用于查询数据。
ContentResolver 中的增删改查方法都是不接收表名参数的，而是使用一个Uri参数代替，这个参数被称为内容URI。

内容URI给内容提供器中的数据建立了唯一标识符，它主要由两部分组成: authority 和path。authority是用于对不同的应用程序做区分的，一般为了避免冲突，都会采用程序包名的方式来进行命名。path则是用于对同一应用程序中不同的表做区分的，通常都会添加到authority的后面。
authority：用于对不同的app做区分，一般写法：包名.provider
path：用于对同一应用程序中不同的表做区分

为了看出这是URI还要加上头部协议，标准格式如下
content://com.example.app.provider/table
以路径结尾说明访问该表中的全部数据
还有一种常用格式
content://com.example.app.provider/table/ID
这种表示访问com.example.app程序下table表中id为ID(int)的数据

得到内容URI字符串后，需要将它解析为Uri对象才可以作为参数传入。

//调用Uri.parse方法将URI字符串解析为Uri对象
Uri uri = Uri.parse("com.example.app.provider/table")

使用Uri对象查询table表中的数据

Cursor cursor = getContentResolver().query(
            uri;
            projection;
            selection;
            selectionArgs;
            sortOrder);

在这里插入图片描述
查询后返回一个Cursor对象，这时我们可以将数据从Cursor中逐个读取出来。思路是通过游标的位置来遍历Cursor的所有行。

	if(cursor != null) {
        while(cursor.moveToNext()) {
            String colum1 = cursor.getString(cursor.getColumnIndex("colum1"));
        }
        cursor.close();
    }

添加一条消息

ContentValues values = new ContentValues();
    values.put("colum1", "text");
    getContentResolver().insert(uri, values);

更新数据

    ContentValues values = new ContentValues();
    values.put("colum1", "");
    getContentResolver().update(uri, values, "colum1 = ?", new String[] {"text"});

删除数据

getContentResolver().delete(uri, "colum1 = ?", new String[] {""});

读取系统联系人

public class MainActivity extends AppCompatActivity {
    ArrayAdapter<String> adapter;
    List<String> contactsList = new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ListView contactsView = (ListView)findViewById(R.id.contacts_view);
        //设置适配器
        adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactsList);
        contactsView.setAdapter(adapter);
        //运行时权限处理
        if(ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[] {Manifest.permission.READ_CONTACTS}, 1);
        }else {
            readContacts();
        }
    }

    private void readContacts() {
        //获取光标
        Cursor cursor = null;
        try {
            //查询联系人数据 使用了ContentResolver的query方法
            //ContactsContract.CommonDataKinds.Phone类替我们做好的封装 提供了常量CONTENT_URI 这是使用Uri.parse()方法解析出的结果
            cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, null, null, null);
            if(cursor != null) {
                while(cursor.moveToNext()) {
                    //获取联系人姓名
                    @SuppressLint("Range") String displayName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
                    //获取联系人手机号
                    @SuppressLint("Range") String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                    //添加到集合中
                    contactsList.add(displayName + "\n" + number);
                }
                //更新刷新ListView
                adapter.notifyDataSetChanged();
            }
        }catch (Exception e) {
            e.printStackTrace();
        }finally {
            if(cursor != null) {
                cursor.close();
            }
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        switch (requestCode) {
            case 1:
                if(grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    readContacts();
                }else {
                    Toast.makeText(this, "You denied the permission", Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }
}

添加读取联系人的权限

    <uses-permission android:name="android.permission.READ_CONTACTS"/>

创建自己的内容提供器

可以通过新建一个类去继承ContentProvider 的方式来创建一个自己的内容提供器。ContentProvider类中有6个抽象方法，我们在使用子类继承它的时候，需要将这6个方法全部重写。

onCreate()
初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作,返回true表示内容提供器初始化成功，返回false则表示失败。注意，只有当存在ContentResolver尝试访问我们程序中的数据时，内容提供器才会被初始化。
query()
从内容提供器中查询数据。使用uri参数来确定查询哪张表，projection参数用于确定查询哪些列，selection 和selectionArgs参数用于约束查询哪些行，sortOrder 参数用于对结果进行排序，查询的结果存放在Cursor对象中返回。
insert()
向内容提供器中添加一条数据。使用uri参数来确定要添加到的表，待添加的数据保存在values参数中。添加完成后，返回一个用于表示这条新记录的URI。
update()
更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据,新数据保存在values参数中，selection 和selectionArgs参数用于约束更新哪些行，受影响的行数将作为返回值返回。
delete()
从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据，selection 和 selectionArgs参数用于约束删除哪些行，被删除的行数将作为返回值返回。
getType()
根据传人的内容URI来返回相应的MIME类型。

接着，我们再借助UriMatcher这个类就可以轻松地实现匹配内容URI的功能。UriMatcher中提供了一个addURI()方法，这个方法接收3个参数，可以分别把authority、path和一个自定义代码传进去。这样，当调用UriMatcher的match()方法时，就可以将一个Uri对象传入，返回值是某个能够匹配这个Uri对象所对应的自定义代码,利用这个代码,我们就可以判断出调用方期望访问的是哪张表中的数据了。

    public static final int TABLE1_DIR = 0;
    public static final int TABLE1_ITEM = 1;
    public static final int TABLE2_DIR = 2;
    public static final int TABLE2_ITEM = 3;
    private static UriMatcher uriMatcher;


    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
        uriMatcher.addURI("com.example.app.provider", "table1/#", TABLE1_ITEM);
        uriMatcher.addURI("com.example.app.provider", "table2", TABLE2_DIR);
        uriMatcher.addURI("com.example.app.provider", "table2/#", TABLE2_ITEM);
    }

    @Override
    public boolean onCreate() {
        return false;
    }

    @Nullable
    @Override
    public Cursor query(@NonNull Uri uri, @Nullable String[] strings, @Nullable String s, @Nullable String[] strings1, @Nullable String s1) {
        switch (uriMatcher.match(uri)) {
            case TABLE1_DIR:
                //查询table1表中所有数据
                break;
            case TABLE1_ITEM:
                //查询table1表中的单条数据
                break;
            case TABLE2_DIR:
                //查询table2表中的所有数据
                break;
            case TABLE2_ITEM:
                //查询table2表中的单条数据
                break;
            default:
                break;
        }
    }

可以看到，MyProvider中新增了4个整型常量，其中TABLE1_ DIR表示访问table1表中的有数据，TABLE1 ITEM 表示访问table1 表中的单条数据，TABLE2_ DIR表示访问table2表中的所有数据，TABLE2_ITEM表示访问table2表中的单条数据。接着在静态代码块里我们创建了UriMatcher的实例，并调用addURI()方法，将期望匹配的内容URI格式传递进去，注意这里传人的路径参数是可以使用通配符的。然后当query()方法被调用的时候，就会通过UriMatcher的match()方法对传人的Uri对象进行匹配，如果发现UriMatcher中某个内容URI格式成功匹.配了该Uri对象，则会返回相应的自定义代码,然后我们就可以判断出调用方期望访问的到底是什么数据了。
getType()方法返回的MIME字符串主要由三部分组成

必须以vnd开头
如果内容URI以路径结尾，则后接android.cursor.dir/，如果以id结尾则后接android.cursor.item/
最后接上vnd.<authority>.<path>

    public String getType(@NonNull Uri uri) {
        switch (uriMatcher.match(uri)) {
            case TABLE1_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1";
            case TABLE1_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.app.provider.table1";
            case TABLE2_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2";
            case TABLE2_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.app.provider.table2";
            default:
                break;
        }
        return null;
    }

实现跨程序数据共享

创建内容提供器右击com.example.broadcasttest包→New→Other→Content Provider,
Exported属性表示是否允许外部程序访问我们的内容提供器,Enabled属性表示是否启用这个内容提供器。将两个属性都勾中，点击Finish完成创建。

public class DatabaseProvider extends ContentProvider {
    //定义四个常量 分别表示访问Book表中的单条数据 所有数据 Category表中的单条数据 所有数据
    public static final int BOOK_DIR = 0;
    public static final int BOOK_ITEM = 1;
    public static final int CATEGORY_DIR = 2;
    public static final int CATEGORY_ITEM = 3;
    //在静态代码块中对UriMatcher进行了初始化操作 将希望匹配的几种URI格式加入
    public static final String AUTHORITY = "com.example.databasetest.provider";
    private static UriMatcher uriMatcher;
    private MyDatabaseHelper databaseHelper;
    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(AUTHORITY, "book",BOOK_DIR);
        uriMatcher.addURI(AUTHORITY, "book/#",BOOK_ITEM);
        uriMatcher.addURI(AUTHORITY, "category",CATEGORY_DIR);
        uriMatcher.addURI(AUTHORITY, "category/#",CATEGORY_ITEM);
    }

    public DatabaseProvider() {
    }

    //删除
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        SQLiteDatabase database = databaseHelper.getWritableDatabase();
        //被删除的行数
        int deleteRows = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                deleteRows = database.delete("Book", selection, selectionArgs);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                deleteRows = database.delete("Book", "id = ?", new String[] {bookId});
                break;
            case CATEGORY_DIR:
                deleteRows = database.delete("Category", selection, selectionArgs);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                deleteRows = database.delete("Category", "id = ?", new String[] {categoryId});
                break;
            default:
                break;

        }
        return deleteRows;
    }

    //返回MIME类型
    @Override
    public String getType(Uri uri) {
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.book";
            case BOOK_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.book";
            case CATEGORY_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.book";
            case CATEGORY_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.book";
            default:
                break;
        }
        return null;
    }

    //添加
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        //获取SQLiteDatabase实例
        SQLiteDatabase database = databaseHelper.getWritableDatabase();
        Uri uriReturn = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
            case BOOK_ITEM:
                //insert方法返回一个能够表示这条新增数据的URI 我们还需要调用parse方法将URI解析成uri对象
                long newBookId = database.insert("Book", null, values);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
                break;
            case CATEGORY_DIR:
            case CATEGORY_ITEM:
                long newCategoryId = database.insert("Category", null, values);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/Category/" + newCategoryId);
                break;
            default:
                break;
        }
        return uriReturn;
    }

    //创建
    @Override
    public boolean onCreate() {
        //创建MyDatabaseHelper实例
        databaseHelper = new MyDatabaseHelper(getContext(), "BookStore.db",null, 2);
        //返回true表示内容提供器初始化成功
        return true;
    }

    //查询
    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        //得到SQLiteDatabase实例
        SQLiteDatabase database = databaseHelper.getReadableDatabase();
        Cursor cursor = null;
        //根据传入的参数判断用户想访问哪张表
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                //调用SQLiteDatabase的query方法进行查询
                cursor = database.query("Book", projection, selection, selectionArgs,null, null, sortOrder);
                break;
            case BOOK_ITEM:
                //调用getPathSegments()方法，将内容URI权限之后的部分以"/"分割 并把分割后的结果放入到一个字符串列表中
                //这个列表第0个位置存放的就是路径 第1个位置存放的就是id 得到id后进行约束 就可以实现查询单条数据的功能了
                String bookId = uri.getPathSegments().get(1);
                cursor = database.query("Book", projection, "id = ?", new String[] {bookId},null, null, sortOrder);
                break;
            case CATEGORY_DIR:
                cursor = database.query("Category", projection, selection, selectionArgs,null, null, sortOrder);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                cursor = database.query("Category", projection, "id = ?", new String[] {categoryId},null, null, sortOrder);
                break;
            default:
                break;

        }
        return cursor;
    }

    //更新
    @Override
    public int update(Uri uri, ContentValues values, String selection,
                      String[] selectionArgs) {
        SQLiteDatabase database = databaseHelper.getReadableDatabase();
        //更新的行数
        int updatedRows = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                updatedRows = database.update("Book",values, selection, selectionArgs);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                updatedRows = database.update("Book", values, "id = ?", new String[] {bookId});
                break;
            case CATEGORY_DIR:
                updatedRows = database.update("Category",values, selection, selectionArgs);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                updatedRows = database.update("Category", values, "id = ?", new String[] {categoryId});
                break;
            default:
                break;

        }
        return updatedRows;
    }
}

内容提供器一定要在AndroidManifest.xml中注册才可以使用。

		<provider
            android:name=".DatabaseProvider"
            android:authorities="com.example.databasetest.provider"
            android:enabled="true"
            android:exported="true"></provider>

使用<provider>对内容提供器进行注册,android:name指定了DatabaseTest的类名,android:authorities指定了DatabaseTest的authority,其他两个是我们刚刚勾选的,表示允许被其他程序访问
此时该项目就已经拥有跨程序共享数据的功能了

Judicious_x

关注

2
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Android初体验——内容提供器

文章目录内容提供器简介运行时权限Android权限机制详解在程序运行时申请权限访问其他程序中的数据ContentResolver的基本用法读取系统联系人创建自己的内容提供器实现跨程序数据共享内容提供器简介主要用于在不同的应用程序之间实现数据共享功能，不同于文件存储和SharedPreferences存储中的两种全局可读写操作模式，内容提供器可以选择只对哪一部分数据进行共享，从而保证我们程序中的隐私数据不会有泄漏的风险。运行时权限引用运行时权限，从而更好的保护客户的安全和隐私Android权限机制详
复制链接

扫一扫

专栏目录