Android中的内容提供者

2024-10-14 08:49:51

目录

1.创建内容提供者

1--手动创建一个Android应用程序

2--创建自定义的内容提供者

2.访问其他应用程序

1. 解析URI

2. 查询数据

3. 遍历查询结果

3)案例:读取手机通信录

1.声明权限

2.activity_main.xml文件内容

3.my_phone_list.xml文件内容

4.定义PhoneInfo实体

5.定义MyPhoneUiAdapter类(适配器)

6.MainActivity类里面的内容

7.效果图

1.创建内容提供者

1--手动创建一个Android应用程序

2--创建自定义的内容提供者

包名===>鼠标右键===》鼠标移至new===>鼠标移至other===>鼠标点击Content provide

MyContentProvider类的内容

package com.xiji.mycontentprovider;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;

public class MyContentProvider extends ContentProvider {
    public MyContentProvider() {
    }

    //删除操作
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // Implement this to handle requests to delete one or more rows.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    
    @Override
    public String getType(Uri uri) {
        // TODO: Implement this to handle requests for the MIME type of the data
        // at the given URI.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    //插入操作
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // TODO: Implement this to handle requests to insert a new row.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    //初始化操作
    @Override
    public boolean onCreate() {
        // TODO: Implement this to initialize your content provider on startup.
        return false;
    }
    

    //查询操作
    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        // TODO: Implement this to handle query requests from clients.
        throw new UnsupportedOperationException("Not yet implemented");
    }

    //更新操作
    @Override
    public int update(Uri uri, ContentValues values, String selection,
                      String[] selectionArgs) {
        // TODO: Implement this to handle requests to update one or more rows.
        throw new UnsupportedOperationException("Not yet implemented");
    }
}

2.访问其他应用程序

1. 解析URI

当你从其他应用获取到一个URI时，可能需要解析这个URI以获得更多的信息，比如权限或者路径等。虽然Android没有直接提供一个叫做parse()的方法来解析URI，但你可以使用Uri类的一些方法来处理它。

// 假设你已经有一个URI对象
Uri uri = ...;

// 获取authority（即内容提供者的名称）
String authority = uri.getAuthority();

// 获取path（即数据的具体位置）
String path = uri.getPath();

2. 查询数据

使用ContentResolver的query()方法可以向内容提供者发起查询请求。你需要指定要查询的URI和列名，还可以设置选择条件、排序方式等。

// 获取ContentResolver实例
ContentResolver resolver = getContentResolver();

// 定义查询参数
Uri uri = ...; // 目标内容提供者的URI
String[] projection = { /* 列名 */ }; // 想要查询的列
String selection = null; // 选择条件
String[] selectionArgs = null; // 选择条件参数
String sortOrder = null; // 排序方式

// 执行查询
Cursor cursor = resolver.query(uri, projection, selection, selectionArgs, sortOrder);

3. 遍历查询结果

一旦得到了Cursor对象，就可以用它来遍历查询结果。通常我们会使用while()循环来遍历所有行，并且对于每一行，可以通过getColumnIndex()和getString(), getInt()等方法来读取具体的数据。

if (cursor != null && cursor.moveToFirst()) {
    // 循环遍历所有的行
    do {
        // 读取特定列的数据
        String columnValue = cursor.getString(cursor.getColumnIndex("column_name"));
        
        // 处理数据...
        
    } while (cursor.moveToNext());
}

// 关闭游标
if (cursor != null) {
    cursor.close();
}

这里的关键点是确保在循环结束后关闭Cursor，以释放相关的资源。此外，在执行moveToFirst()之前检查cursor是否为null是很重要的，以防止出现空指针异常。

3)案例:读取手机通信录

1.声明权限

<!--读取权限-->
<uses-permission android:name="android.permission.READ_CONTACTS" />

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">


    <!--读取权限-->
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.MyPhoneNumber"
        tools:targetApi="31">


        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

2.activity_main.xml文件内容

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical"

    >


    <TextView
        android:layout_width="match_parent"
        android:layout_height="50dp"
        android:text="我的手机通信录"
        android:gravity="center"
        android:textSize="30dp"
        android:background="#147CE4"
        android:textColor="#EFF2F4"
        />

    <!--绑定控件-->
    <androidx.recyclerview.widget.RecyclerView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/myRecycle"

        />

</LinearLayout>

3.my_phone_list.xml文件内容

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    >
    <ImageView
        android:id="@+id/iv_icon"
        android:layout_width="200dp"
        android:layout_height="200dp"
        android:src="@drawable/girl_one"
        android:padding="20dp"
        />

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:layout_margin="20dp"
        android:padding="20dp"
        android:gravity="center"
        >
        <TextView
            android:id="@+id/tv_name"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="20sp"
            android:textColor="#000"
            android:text="name"
            android:layout_marginBottom="15dp"
            />
        <TextView
            android:id="@+id/tv_phone"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="12sp"
            android:textColor="#000"
            android:text="phone"
            />
    </LinearLayout>

</LinearLayout>

4.定义PhoneInfo实体

package com.xiji.myphonenumber;

public class PhoneInfo {
    private String name;
    private String numberPhone;


    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getNumberPhone() {
        return numberPhone;
    }

    public void setNumberPhone(String numberPhone) {
        this.numberPhone = numberPhone;
    }

    public PhoneInfo() {
    }

    public PhoneInfo(String name, String numberPhone) {
        this.name = name;
        this.numberPhone = numberPhone;
    }
}

5.定义MyPhoneUiAdapter类(适配器)

package com.xiji.myphonenumber;

import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.TextView;

import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;

import java.util.ArrayList;

/**
 * 数据适配已经完成
 */

public class MyPhoneUiAdapter extends RecyclerView.Adapter<MyPhoneUiViewHolder> {

    //定义数据集合
    ArrayList<PhoneInfo> phoneInfos;


    //创建视图
    @NonNull
    @Override
    public MyPhoneUiViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {

        //创建视图
        View view = View.inflate(parent.getContext(), R.layout.my_phone_list,null);

        return new MyPhoneUiViewHolder(view);


    }

    //绑定数据
    @Override
    public void onBindViewHolder(@NonNull MyPhoneUiViewHolder holder, int position) {

        //数据设置
        holder.tv_name.setText(phoneInfos.get(position).getName());

        //设置手机号
        holder.tv_phone.setText(phoneInfos.get(position).getNumberPhone());

    }

    @Override
    public int getItemCount() {
        return phoneInfos.size();
    }
}


//定义 ViewHolder
class MyPhoneUiViewHolder extends RecyclerView.ViewHolder {
    TextView tv_name;
    TextView tv_phone;


    public MyPhoneUiViewHolder(@NonNull View itemView) {
        super(itemView);

        //绑定控件
        tv_name = itemView.findViewById(R.id.tv_name);
        tv_phone = itemView.findViewById(R.id.tv_phone);



    }
}

解释：

MyPhoneUiAdapter 类

继承：这个类继承自RecyclerView.Adapter<MyPhoneUiViewHolder>，这意味着它是一个适配器，专门用来为RecyclerView提供数据和视图绑定。
成员变量：
- ArrayList<PhoneInfo> phoneInfos：一个存储电话信息（PhoneInfo对象）的列表，这些信息将被显示在RecyclerView中。
方法：
- onCreateViewHolder(ViewGroup parent, int viewType)：这是RecyclerView.Adapter的一个抽象方法。当RecyclerView需要一个新的视图来显示项目时，会调用此方法。这里使用了View.inflate()方法从资源文件R.layout.my_phone_list创建了一个新的视图，并将其封装在一个MyPhoneUiViewHolder实例中返回。
- onBindViewHolder(MyPhoneUiViewHolder holder, int position)：这也是RecyclerView.Adapter的一个抽象方法。当RecyclerView需要更新某个位置的数据时，会调用此方法。这里设置了当前position对应的PhoneInfo对象中的姓名和电话号码到holder的相应TextView中。
- getItemCount()：返回phoneInfos列表的大小，告诉RecyclerView有多少个条目需要显示。

MyPhoneUiViewHolder 类

继承：这个类继承自RecyclerView.ViewHolder，它是用来保存对itemView中各个子视图引用的容器，从而避免在onBindViewHolder方法中重复查找视图。
成员变量：
- TextView tv_name 和 TextView tv_phone：分别对应于布局文件my_phone_list中的tv_name和tv_phone控件。
构造函数：
- MyPhoneUiViewHolder(View itemView)：构造函数接收一个View作为参数，并通过findViewById方法找到并初始化tv_name和tv_phone这两个TextView。

6.MainActivity类里面的内容

package com.xiji.myphonenumber;

import android.annotation.SuppressLint;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.widget.Toast;

import androidx.activity.EdgeToEdge;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;

import java.sql.Array;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {

    //列表渲染
    private RecyclerView recyclerView;

    //获取数据变量声明
    private ArrayList<PhoneInfo> phoneInfoList;



    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EdgeToEdge.enable(this);
        setContentView(R.layout.activity_main);
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
            return insets;
        });

        initView();
    }

    //控件初始化

    private void initView(){
        recyclerView = findViewById(R.id.myRecycle);
        //设置布局器
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        //获取权限
        getMyPermission();
    }

    /**
     * 获取自己所需要的权限
     */
    private void getMyPermission() {
        //定义读取权限
        String readPhoneState = android.Manifest.permission.READ_CONTACTS;
        //判断当前应用是否有权限，没有则申请
        ActivityCompat.requestPermissions(this, new String[]{readPhoneState}, 1);
        if (ActivityCompat.checkSelfPermission(this, readPhoneState) != PackageManager.PERMISSION_GRANTED) {

            //申请权限  ===》为当前程序申请权限，请求码为1  ===》重写onRequestPermissionsResult 方法
            ActivityCompat.requestPermissions(this, new String[]{readPhoneState}, 1);
        }

        //设置数据
        setData();




    }
    //设置数据
    private void setData(){
        //获取数据
        phoneInfoList = getPhoneInfoDataList();
        //设置适配器
        MyPhoneUiAdapter myPhoneUiAdapter = new MyPhoneUiAdapter();
        myPhoneUiAdapter.phoneInfos = phoneInfoList;
        //设置适配器
        recyclerView.setAdapter(myPhoneUiAdapter);
    }

    //获取数据
    private ArrayList<PhoneInfo> getPhoneInfoDataList(){
        //这里遍历数据并且存在phoneInfoList列表中
        ArrayList<PhoneInfo> phoneInfos = new ArrayList<>();
        phoneInfos.add(new PhoneInfo("张三","123456789"));

        phoneInfos.add(new PhoneInfo("李四","123456789"));
        phoneInfos.add(new PhoneInfo("王五","123456789"));
        phoneInfos.add(new PhoneInfo("赵六","123456789"));
        phoneInfos.add(new PhoneInfo("钱七","123456789"));


        //获取游标
        Cursor cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, null, null, null);

        //清空里面的数据
        if(phoneInfos!= null) phoneInfos.clear();
        while (cursor.moveToNext()) {

            @SuppressLint("Range") String name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));

            //获取电话号码
            @SuppressLint("Range") String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));

            phoneInfos.add(new PhoneInfo(name,number));


        }
        return phoneInfos;

    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        //判断申请权限是否成功
        if (requestCode == 1) {
            //判断是否授权
            //遍历权限
            for (int i = 0; i < grantResults.length; i++) {
                //判断是否授权  ===> 读取权限
                if (grantResults[i] == PackageManager.PERMISSION_GRANTED  &&  permissions[i].equals("android.permission.READ_CONTACTS")) {
                    //授权成功
                    Toast.makeText(this, "授权成功", Toast.LENGTH_SHORT).show();
                    //设置数据
                    setData();

                    return;
                }else {
                    Toast.makeText(this, "授权失败", Toast.LENGTH_SHORT).show();

                }
                    //授权失败


            }


        }
    }
}

解释:

MainActivity 类

成员变量

recyclerView：用于显示联系人列表的RecyclerView。
phoneInfoList：一个ArrayList<PhoneInfo>，用于存储从联系人中获取的电话信息。

onCreate 方法

调用super.onCreate(savedInstanceState)初始化父类。
使用EdgeToEdge.enable(this)启用全屏模式。
通过setContentView(R.layout.activity_main)设置布局文件。
设置窗口内边距，以适应系统栏。
调用initView()方法初始化视图组件。

initView 方法

通过findViewById找到RecyclerView实例并赋值给recyclerView。
为recyclerView设置布局管理器LinearLayoutManager。
调用getMyPermission()方法请求读取联系人的权限。

getMyPermission 方法

定义了需要的权限READ_CONTACTS。
检查当前应用是否已经拥有该权限，如果没有，则调用ActivityCompat.requestPermissions请求权限。
如果权限被授予，调用setData()方法来设置数据。

setData 方法

调用getPhoneInfoDataList()方法获取联系人数据。
创建一个新的MyPhoneUiAdapter实例，并将获取到的数据设置给适配器。
将适配器设置给recyclerView。

getPhoneInfoDataList 方法

创建一个空的ArrayList<PhoneInfo>用于存储联系人信息。
通过getContentResolver().query()查询联系人数据库，获取所有联系人的游标Cursor。
遍历游标中的每一行，提取联系人的姓名和电话号码，并创建新的PhoneInfo对象添加到phoneInfos列表中。
返回填充了联系人信息的phoneInfos列表。

onRequestPermissionsResult 方法

当用户对权限请求做出响应时，系统会调用此方法。
检查请求码是否为1（即我们之前请求的READ_CONTACTS权限）。
遍历grantResults数组，检查每个权限的结果。
如果权限被授予，显示“授权成功”的Toast消息，并调用setData()方法更新数据。
如果权限未被授予，显示“授权失败”的Toast消息。

码农公寓