本文档旨在指导Android开发者如何从设备的指定文件夹中读取PDF文件，并将这些文件显示在RecyclerView中。我们将涵盖必要的权限申请、文件读取以及如何在RecyclerView中展示这些文件，确保代码在Android API 30及以上版本也能正常运行。
1. 权限申请
在Android应用中访问外部存储，需要申请相应的权限。在AndroidManifest.xml文件中添加以下权限声明：
android:requestLegacyExternalStorage="true" 属性是为了兼容旧版本的Android系统，允许应用访问外部存储。
在代码中动态申请权限：
private static final int REQUEST_PERMISSIONS = 123;
private boolean boolean_permission;
private void fn_permission() {
if ((ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) ||
(ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED)) {
if ((ActivityCompat.shouldShowRequestPermissionRationale(getActivity(), android.Manifest.permission.READ_EXTERNAL_STORAGE))) {
// 可以向用户解释为什么需要此权限
} else {
ActivityCompat.requestPermissions(getActivity(), new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE},
REQUEST_PERMISSIONS);
}
if ((ActivityCompat.shouldShowRequestPermissionRationale(getActivity(), Manifest.permission.WRITE_EXTERNAL_STORAGE))) {
// 可以向用户解释为什么需要此权限
} else {
ActivityCompat.requestPermissions(getActivity(), new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
REQUEST_PERMISSIONS);
}
} else {
boolean_permission = true;
}
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
if (requestCode == REQUEST_PERMISSIONS) {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
boolean_permission = true;
// 权限已授予，可以执行文件操作
} else {
// 权限被拒绝，给出提示
Toast.makeText(getActivity(), "请授予存储权限以访问文件", Toast.LENGTH_SHORT).show();
}
}
}注意事项：
- 在Android 6.0（API级别23）及以上版本，需要在运行时动态申请权限。
- 在申请权限之前，可以向用户解释为什么需要这些权限。
- 处理权限申请结果，如果用户拒绝了权限，给出相应的提示。
2. 读取指定文件夹中的PDF文件
以下代码展示了如何从指定文件夹中读取PDF文件：
private ListreadFilesFromSpecificDir() { List list = new ArrayList<>(); File filePath = new File(getDefaultStorageLocation()); File[] fileList = filePath.listFiles(); if (fileList != null) { for (File file : fileList) { if (file.isFile() && file.getName().toLowerCase().endsWith(".pdf")) { // 创建 PdfModel 对象，并添加到列表中 PdfModel pdfModel = new PdfModel(file.getName(), "123", 1.12, "pdf", file.getPath()); list.add(pdfModel); Log.e(TAG, "readFilesFromSpecificDir: working list of files are given below ______________________________________________" + file.getName()); } } } else { Toast.makeText(getActivity(), "List empty...", Toast.LENGTH_SHORT).show(); } return list; } public String getDefaultStorageLocation() { File dir = new File(Environment.getExternalStorageDirectory().getAbsolutePath(), "/YourFolderName/"); Log.e(TAG, "getDefaultStorageLocation: __________________________________" + dir); if (!dir.exists()) { boolean isDirectoryCreated = dir.mkdir(); if (!isDirectoryCreated) { Toast.makeText(getActivity(), "Directory cannot be created", Toast.LENGTH_SHORT).show(); Log.e("Error", "Directory could not be created"); } } return dir.getAbsolutePath() + "/"; }
代码解释：
- getDefaultStorageLocation() 方法用于获取指定文件夹的路径。可以根据实际情况修改文件夹名称。
- readFilesFromSpecificDir() 方法用于读取指定文件夹中的PDF文件。
- 首先，获取文件夹的 File 对象。
- 然后，调用 listFiles() 方法获取文件夹中的所有文件。
- 遍历文件列表，判断是否为PDF文件。
- 如果是PDF文件，则创建 PdfModel 对象，并添加到列表中。
注意事项：
- PdfModel 是一个自定义的数据模型，用于存储PDF文件的信息。需要根据实际情况修改 PdfModel 的定义。
- 在判断文件是否为PDF文件时，需要忽略大小写。
- 确保文件夹存在，如果不存在，则创建文件夹。
3. 在RecyclerView中显示PDF文件列表
首先，需要在布局文件中添加 RecyclerView：
然后，创建 RecyclerView 的 Adapter：
public class PdfAdapter extends RecyclerView.Adapter{ private List pdfList; public PdfAdapter(List pdfList) { this.pdfList = pdfList; } @NonNull @Override public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) { View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_pdf, parent, false); return new ViewHolder(view); } @Override public void onBindViewHolder(@NonNull ViewHolder holder, int position) { PdfModel pdfModel = pdfList.get(position); holder.fileNameTextView.setText(pdfModel.getFileName()); // 其他数据绑定 } @Override public int getItemCount() { return pdfList.size(); } public static class ViewHolder extends RecyclerView.ViewHolder { TextView fileNameTextView; public ViewHolder(@NonNull View itemView) { super(itemView); fileNameTextView = itemView.findViewById(R.id.file_name_text_view); // 其他 View 的初始化 } } }
代码解释：
- PdfAdapter 是 RecyclerView 的 Adapter，用于将数据绑定到 RecyclerView 的 ViewHolder。
- onCreateViewHolder() 方法用于创建 ViewHolder。
- onBindViewHolder() 方法用于将数据绑定到 ViewHolder。
- getItemCount() 方法用于返回列表的大小。
- ViewHolder 用于缓存 View 的引用，避免重复查找 View。
最后，在 Activity 或 Fragment 中使用 RecyclerView：
RecyclerView recyclerView = findViewById(R.id.recycler_view); recyclerView.setLayoutManager(new LinearLayoutManager(this)); ListpdfList = readFilesFromSpecificDir(); PdfAdapter adapter = new PdfAdapter(pdfList); recyclerView.setAdapter(adapter);
代码解释：
- 首先，获取 RecyclerView 的引用。
- 然后，设置 RecyclerView 的 LayoutManager。
- 调用 readFilesFromSpecificDir() 方法获取PDF文件列表。
- 创建 PdfAdapter 对象，并将PDF文件列表传递给 PdfAdapter。
- 设置 RecyclerView 的 Adapter。
4. 总结
本文档详细介绍了如何在Android应用中从指定文件夹读取PDF文件，并将这些文件显示在RecyclerView中。通过正确申请权限、读取文件以及使用RecyclerView，可以轻松实现文件浏览功能。请注意，代码示例需要根据实际应用场景进行适当修改。
