Android教程：从指定文件夹读取PDF文件并在RecyclerView中显示_技术教程

本文档旨在指导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 List readFilesFromSpecificDir() {
    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));

List pdfList = readFilesFromSpecificDir();
PdfAdapter adapter = new PdfAdapter(pdfList);
recyclerView.setAdapter(adapter);

代码解释：