如何在Android应用中加载和显示网络PDF文件？

Android 加载网络 PDF

在 Android 应用开发中，经常需要加载并显示网络上的 PDF 文件，本文将详细介绍如何在 Android 应用中实现这一功能，我们将使用一些常用的库和工具，如 OkHttp、PDF.js 等，来帮助我们完成这项任务，以下是具体的步骤和代码示例：

一、准备工作

1、创建一个新的 Android 项目

打开 Android Studio，选择 "Start a new Android Studio project"。

配置项目名称、包名等信息，然后点击 "Finish"。

2、添加依赖

在项目的build.gradle 文件中添加 OkHttp 和 PDFView 的依赖。

dependencies {
    implementation 'com.github.barteksc:android-pdf-viewer:2.8.2'
    implementation 'com.squareup.okhttp3:okhttp:4.9.0'
}

二、下载 PDF 文件

我们需要使用 OkHttp 来下载网络上的 PDF 文件，以下是一个简单的示例，演示如何下载 PDF 文件并将其保存到本地存储中。

import okhttp3.*;
import java.io.*;
public class PdfDownloader {
    private static final String URL = "https://example.com/sample.pdf";
    private static final String DESTINATION_FILE = "/sdcard/Download/sample.pdf";
    public void downloadPdf() throws IOException {
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder()
                .url(URL)
                .build();
        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                e.printStackTrace();
            }
            @Override
            public void onResponse(Call call, Response response) throws IOException {
                if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
                // Get response body as a byte array
                long fileSize = response.body().contentLength();
                byte[] fileBytes = new byte[fileSize];
                InputStream in = response.body().byteStream();
                in.read(fileBytes);
                in.close();
                // Write to destination file
                FileOutputStream out = new FileOutputStream(DESTINATION_FILE);
                out.write(fileBytes);
                out.close();
            }
        });
    }
}

三、显示 PDF 文件

我们将使用 PDFView 库来显示下载的 PDF 文件，需要在布局文件中添加 PDFView。

<!-res/layout/activity_main.xml -->
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <com.github.barteksc.pdfviewer.PDFView
        android:id="@+id/pdfView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</RelativeLayout>

然后在活动文件中加载 PDF 文件。

import com.github.barteksc.pdfviewer.PDFView;
import com.github.barteksc.pdfviewer.scroll.DefaultScrollHandle;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import java.io.File;
public class MainActivity extends AppCompatActivity {
    private PDFView pdfView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        pdfView = findViewById(R.id.pdfView);
        pdfView.fromFile(new File("/sdcard/Download/sample.pdf"))
                .defaultPage(0) // 默认显示第一页
                .enableSwipe(true) // 启用滑动翻页
                .swipeHorizontal(false) // 水平滑动翻页
                .onLoad(this::addScrollHandle) // 加载完成后添加滚动条
                .onPageChange(this::onPageChanged) // 页面改变时回调
                .load();
    }
    private void addScrollHandle(int pageCount) {
        DefaultScrollHandle recycler = new DefaultScrollHandle(this, R.layout.scroll_handle);
        pdfView.setHorizontalScrollBarEnabled(true);
        recycler.setView(pdfView, pageCount);
    }
    private void onPageChanged(int page, int pageCount) {
        // 处理页面改变逻辑
    }
}

四、优化与扩展

1. 异步加载 PDF 文件

为了避免阻塞主线程，可以使用异步任务或协程来处理 PDF 文件的下载和加载，使用 Kotlin 协程：

import kotlinx.coroutines.*
import java.io.*
import okhttp3.*
class PdfDownloader {
    private val url = "https://example.com/sample.pdf"
    private val destinationFile = File("/sdcard/Download/sample.pdf")
    suspend fun downloadPdf() {
        withContext(Dispatchers.IO) {
            try {
                val client = OkHttpClient()
                val request = Request.Builder().url(url).build()
                val response = client.newCall(request).execute()
                if (response.isSuccessful) {
                    response.body?.let { body ->
                        destinationFile.outputStream().use { outputStream ->
                            body.byteStream().use { inputStream ->
                                inputStream.copyTo(outputStream)
                            }
                        }
                    }
                } else {
                    throw IOException("Failed to download PDF")
                }
            } catch (e: Exception) {
                e.printStackTrace()
            }
        }
    }
}

2. 错误处理与重试机制

在实际应用中，网络请求可能会失败，我们可以添加错误处理和重试机制以提高应用的稳定性。

suspend fun downloadPdfWithRetry(retries: Int = 3) {
    repeat(retries) {
        try {
            downloadPdf() // 假设这是上面定义的异步下载方法
            return // 如果成功则返回
        } catch (e: Exception) {
            if (it == retries 1) throw e // 如果达到最大重试次数则抛出异常
        }
    }
}

3. 缓存机制

为了提高用户体验，可以添加缓存机制，避免重复下载相同的文件，可以使用 OkHttp 提供的缓存功能或第三方缓存库来实现。

implementation 'com.jakewharton:disklrucache:2.0.2'

并在代码中使用缓存：

val cache = DiskLruCache.open(context, "pdf_cache", appVersion, appVersion, 1 * 1024 * 1024) // 1MB缓存大小
val key = "https://example.com/sample.pdf"
val cachedPdf = cache.get(key) ?: runBlocking { downloadPdf() } // 如果缓存中没有则下载并缓存
pdfView.fromUri(Uri.parse("file://${cachedPdf.absolutePath}")).load()

通过以上步骤，我们已经实现了一个基本的 Android 应用，能够从网络下载并显示 PDF 文件，根据实际需求，还可以进一步优化和扩展功能，如添加进度条、支持多种 PDF 文件格式、处理大文件等，希望本文对你有所帮助！