Java實現(xiàn)給PDF文件增加背景圖的操作指南
更新時間：2025年11月27日 09:47:29 作者：何中應
本文介紹了如何在Java中生成PDF文件并為其添加背景圖,通過兩種不同的方式實現(xiàn)：一種使用了iText庫,另一種使用了PdfBox庫,這兩種方法都可以實現(xiàn)將背景圖片添加到PDF文件中,并且可以根據(jù)項目需求選擇合適的方法,需要的朋友可以參考下
說明：本文介紹在使用代碼生成 PDF 文件的基礎上，如何給生成的的 PDF 文件增加背景圖。生成 PDF 文件參看下面這篇博客。
思路
思路是在生成后的 PDF 文件基礎上操作，不是在生成 PDF 的模板文件上實現(xiàn)。
如下，是前文中生成的 PDF 文件。
將下面這張圖作為文件背景放入到 PDF 文件中
實現(xiàn)一
如下，在原生成 PDF 文件的基礎上，增加設置背景的代碼
@PostMapping("/pdf")
public byte[] pdf() throws IOException {
// 構建響應頭
String fileName = "example.pdf";
String encodedFileName = URLEncoder.encode(fileName, StandardCharsets.UTF_8);
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
headers.setContentDispositionFormData("attachment", encodedFileName);
// 生成PDF文件
byte[] pdf = pdfService.pdf();
// PDF文件
File pdfFile = FileUtil.createTempFile("demo", ".pdf", null, true);
FileUtil.writeBytes(pdf, pdfFile);
// 背景圖片
ClassPathResource resource = new ClassPathResource("template/picture.jpg");
File pictureFile = FileUtil.createTempFile("picture", ".jpg", null, true);
FileUtil.writeBytes(resource.getInputStream().readAllBytes(), pictureFile);
// 添加背景圖片，獲取添加背景后的PDF文件
byte[] bytes = addBackground1(pdfFile, pictureFile);
// 返回
return ResponseEntity.ok()
.headers(headers)
.body(bytes).getBody();
}
其中，添加背景圖片方法代碼如下：
/**
* 添加背景圖片
*
* @param pdfFile PDF文件
* @param pictureFile 背景圖片
* @return 添加背景后的PDF文件
*/
private byte[] addBackground1(File pdfFile, File pictureFile) {
// 定義輸出流，存添加完背景的PDF文件
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
// 透明度設置為0.2
float transparency = 0.2f;
// 加載PDF文件
try (PDDocument document = PDDocument.load(pdfFile)) {
// 加背景圖片
PDImageXObject backgroundImage = PDImageXObject.createFromFileByExtension(pictureFile, document);
// 創(chuàng)建透明度配置
PDExtendedGraphicsState graphicsState = new PDExtendedGraphicsState();
graphicsState.setNonStrokingAlphaConstant(transparency);
// 遍歷每一頁
for (PDPage page : document.getPages()) {
// 獲取頁面尺寸（單位：點，1點=1/72英寸）
float pageWidth = page.getMediaBox().getWidth();
float pageHeight = page.getMediaBox().getHeight();
// 創(chuàng)建內容流（追加模式，放在最底層）
try (PDPageContentStream contentStream = new PDPageContentStream(
document, page, PDPageContentStream.AppendMode.PREPEND, true)) {
// 應用透明度配置
contentStream.setGraphicsStateParameters(graphicsState);
// 繪制背景圖（鋪滿整個頁面）
contentStream.drawImage(backgroundImage, 0, 0, pageWidth, pageHeight);
}
}
// 保存修改后的PDF
document.save(outputStream);
// 以字節(jié)數(shù)組的形式返回加完背景的PDF文件
return outputStream.toByteArray();
} catch (IOException e) {
e.printStackTrace();
}
return new byte[0];
}
這種方式所需下面這個依賴
<dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>pdfbox</artifactId> <version>2.0.27</version> </dependency>
實現(xiàn)二
還可以用下面這段代碼
/**
* 添加背景圖片
*
* @param pdfFile PDF文件
* @param pictureFile 背景圖片
* @return 添加背景后的PDF文件
*/
private byte[] addBackground2(File pdfFile, File pictureFile) throws DocumentException, IOException {
// 定義輸出流，存添加完背景的PDF文件
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
// 透明度設置為0.2
float transparency = 0.2f;
PdfReader reader = null;
PdfStamper stamper = null;
try {
reader = new PdfReader(FileUtil.readBytes(pdfFile));
stamper = new PdfStamper(reader, outputStream);
Image backgroundImage = Image.getInstance(FileUtil.readBytes(pictureFile));
// 創(chuàng)建透明度配置對象
PdfGState gState = new PdfGState();
gState.setFillOpacity(transparency);
int totalPages = reader.getNumberOfPages();
for (int i = 1; i <= totalPages; i++) {
// 直接通過PdfReader獲取頁面尺寸
Rectangle pageSize = reader.getPageSize(i);
float pageWidth = pageSize.getWidth();
float pageHeight = pageSize.getHeight();
backgroundImage.scaleToFit(pageWidth, pageHeight);
backgroundImage.setAbsolutePosition(0, 0);
PdfContentByte content = stamper.getUnderContent(i);
// 應用透明度設置
content.setGState(gState);
content.addImage(backgroundImage);
}
stamper.close();
reader.close();
return outputStream.toByteArray();
} catch (IOException | DocumentException e) {
e.printStackTrace();
} finally {
if (stamper != null) {
stamper.close();
}
if (reader != null) {
reader.close();
}
}
return new byte[0];
}
這段代碼所需下面這個依賴
<dependency> <groupId>com.itextpdf</groupId> <artifactId>itextpdf</artifactId> <version>5.5.13.3</version> </dependency>
效果
兩種方式，實現(xiàn)的效果如下：
（實現(xiàn)一）
（實現(xiàn)二）
一個自適應了 PDF 文件的尺寸，一個沒有，如果添加的背景圖片（版權標識、企業(yè) logo）尺寸合適的話，這兩種實現(xiàn)方式?jīng)]有大的區(qū)別。
作為開發(fā)者，可以根據(jù)當前項目中是否已引入上面哪個依賴，來選擇使用哪種實現(xiàn)方式。
到此這篇關于Java實現(xiàn)給PDF文件增加背景圖的操作指南的文章就介紹到這了,更多相關Java PDF文件增加背景圖內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
java調用百度定位api服務獲取地理位置示例，大家參考使用吧2013-12-12
Playwright?是一個用于自動化?Web?應用測試的現(xiàn)代工具,支持多種語言（包括?Java）及多個瀏覽器,本文主要介紹了Java如何使用Playwright實現(xiàn)瀏覽器最大化,需要的可以參考下2024-12-12
Java中的重寫(Override)與重載(Overload)詳解
這篇文章主要介紹了Java中的重寫(Override)與重載(Overload)使用方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-05-05
這篇文章主要介紹了Java實現(xiàn)中序表達式的實例代碼,需要的朋友可以參考下2018-08-08
單例模式（Singleton Pattern）是 Java 中最簡單的設計模式之一。這種類型的設計模式屬于創(chuàng)建型模式，它提供了一種創(chuàng)建對象的最佳方式2021-06-06
這篇文章主要為大家介紹了Java常用加密方法AES?SHA1?md5總結及示例demo，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-06-06
這篇文章主要介紹了解決SpringSecurity 一直登錄失敗的問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-06-06
Java 中POI 導入EXCEL2003 和EXCEL2007的實現(xiàn)方法
這篇文章主要介紹了Java 中POI 導入EXCEL2003 和EXCEL2007的實現(xiàn)方法的相關資料,希望通過本文大家能掌握理解這種方法，需要的朋友可以參考下2017-09-09
Default方法是在java8中引入的關鍵字,也可稱為Virtual extension methods—虛擬擴展方法,這篇文章主要給大家介紹了關于Java8接口中引入default關鍵字的本質原因,需要的朋友可以參考下2022-01-01
這篇文章主要分析了SpringBoot的啟動原理，幫助大家更好的理解和使用spring boot框架，感興趣的朋友可以了解下2020-09-09