目录
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消息。