如何使用PDFBox将网页转换为PDF文件？求推荐相关参考文档

Hey there! Great question—PDFBox is fantastic for working with PDFs, but it doesn’t have native support for converting web pages directly to PDF files out of the box. You’ll need to pair it with a web parsing/rendering tool first to extract or render the web content, then use PDFBox to assemble that content into a proper PDF. Let me walk you through a practical, common approach:

First, you’ll need to grab and clean the web page’s content. Jsoup is a go-to library for this—it makes parsing HTML, extracting text, images, and structured content super straightforward.

Example Setup & Code #

1. Add Jsoup and PDFBox dependencies to your project (if using Maven):

<dependencies>
    <!-- PDFBox -->
    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>pdfbox</artifactId>
        <version>2.0.32</version> <!-- Use the latest stable version -->
    </dependency>
    <!-- Jsoup for HTML parsing -->
    <dependency>
        <groupId>org.jsoup</groupId>
        <artifactId>jsoup</artifactId>
        <version>1.16.1</version> <!-- Latest stable -->
    </dependency>
</dependencies>

2. Use Jsoup to fetch and parse the web page:

import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;

import java.io.IOException;

public class WebToPdf {
    public static void main(String[] args) throws IOException {
        // Fetch and parse the web page
        Document webDoc = Jsoup.connect("https://example.com").get();
        
        // Extract main content (adjust the selector to match your target page's structure)
        Element mainContent = webDoc.selectFirst("main");
        String pageTitle = webDoc.title();
        Elements paragraphs = mainContent.select("p");
        Elements images = mainContent.select("img");
        
        // Now pass this extracted content to PDFBox to build the PDF
        generatePdfFromContent(pageTitle, paragraphs, images);
    }
}

Next, write a method to take the extracted content and build a PDF document. You’ll handle adding text, images, and basic layout here.

Example PDF Generation Code #

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

import java.io.File;
import java.io.IOException;

private static void generatePdfFromContent(String title, Elements paragraphs, Elements images) throws IOException {
    try (PDDocument document = new PDDocument()) {
        PDPage page = new PDPage();
        document.addPage(page);
        
        try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
            // Add title
            contentStream.beginText();
            contentStream.setFont(PDType1Font.HELVETICA_BOLD, 16);
            contentStream.newLineAtOffset(50, 750);
            contentStream.showText(title);
            contentStream.endText();
            
            // Add paragraphs
            float yPosition = 720;
            contentStream.beginText();
            contentStream.setFont(PDType1Font.HELVETICA, 12);
            contentStream.newLineAtOffset(50, yPosition);
            
            for (Element p : paragraphs) {
                String text = p.text();
                // Handle line wrapping (simplified—for complex layout, use PDFBox's text layout utilities)
                contentStream.showText(text);
                contentStream.newLineAtOffset(0, -15);
                yPosition -= 15;
                
                // Add new page if content goes beyond the page bottom
                if (yPosition < 50) {
                    contentStream.endText();
                    page = new PDPage();
                    document.addPage(page);
                    contentStream.close();
                    contentStream = new PDPageContentStream(document, page);
                    contentStream.beginText();
                    contentStream.setFont(PDType1Font.HELVETICA, 12);
                    contentStream.newLineAtOffset(50, 750);
                    yPosition = 750;
                }
            }
            contentStream.endText();
            
            // Add images (simplified—you'll need to handle image paths/URLs properly)
            for (Element img : images) {
                String imgUrl = img.absUrl("src");
                try {
                    PDImageXObject image = PDImageXObject.createFromURL(new java.net.URL(imgUrl), document);
                    contentStream.drawImage(image, 50, yPosition - image.getHeight(), image.getWidth() * 0.7f, image.getHeight() * 0.7f);
                    yPosition -= image.getHeight() * 0.7f + 10;
                    
                    // Check for page overflow again
                    if (yPosition < 50) {
                        page = new PDPage();
                        document.addPage(page);
                        contentStream.close();
                        contentStream = new PDPageContentStream(document, page);
                        yPosition = 750;
                    }
                } catch (IOException e) {
                    // Handle broken image links
                    System.err.println("Could not load image: " + imgUrl);
                }
            }
        }
        
        // Save the PDF
        document.save("webpage-output.pdf");
    }
}

• Complex Layouts & CSS: The above example handles basic text and images, but if your web page has complex CSS (like flexbox, grids, or custom fonts), PDFBox alone won’t render that accurately. For those cases, consider using Flying Saucer (which can render XHTML/CSS to PDF) alongside PDFBox, or use a headless browser like Chrome to render the page to a PDF first, then modify it with PDFBox if needed.
• Fonts: Make sure to embed custom fonts if your web page uses non-standard ones—PDFBox has utilities to load and embed fonts from files or URLs.

• PDFBox Official User Guide: Covers all core features, from document creation to advanced manipulation (like form filling, encryption, and text extraction). It’s the best starting point for understanding PDFBox’s capabilities.
• PDFBox Code Examples Repository: Official collection of ready-to-run code snippets for common tasks—great for copying and adapting to your use case.
• Jsoup Core Documentation: Essential for mastering HTML parsing and content extraction, which is the first step in this workflow.
• Apache PDFBox Tutorials (Community-Curated): Community-written guides dive into specific use cases like handling large documents, optimizing PDF size, and integrating with other libraries.

内容的提问来源于stack exchange，提问作者user3132347