PDF 生成最佳實踐：Builder 模式的優雅 API

// 產生出貨單 PDF
byte[] pdf = PdfBuilder.create()
.title(“出貨單”)
.separator()
.text(“訂單編號：ORD-2024-001234”)
.text(“出貨日期：2024-03-18”)
.newLine()
.subtitle(“商品明細”)
.table(orderItems)
.newLine()
.subtitle(“收件資訊”)
.text(“收件人：王小明”)
.text(“電話：0912-345-678”)
.text(“地址：台北市信義區信義路五段7號”)
.newPage()
.image(barcodeBytes)
.build();

public class PdfBuilder {

private List<Element> elements = new ArrayList<>();
private FontConfig fontConfig;

// 工廠方法
public static PdfBuilder create() {
return new PdfBuilder(FontConfig.defaultConfig());
}

public static PdfBuilder create(FontConfig config) {
return new PdfBuilder(config);
}

private PdfBuilder(FontConfig config) {
this.fontConfig = config;
}
}

/**
* 標題（最大字體）
*/
public PdfBuilder title(String text) {
elements.add(new TextElement(text, fontConfig.getTitleFont()));
return this; // 回傳 this 支援鏈式呼叫
}

/**
* 副標題
*/
public PdfBuilder subtitle(String text) {
elements.add(new TextElement(text, fontConfig.getSubtitleFont()));
return this;
}

/**
* 一般文字
*/
public PdfBuilder text(String text) {
elements.add(new TextElement(text, fontConfig.getBodyFont()));
return this;
}

/**
* 粗體文字
*/
public PdfBuilder boldText(String text) {
elements.add(new TextElement(text, fontConfig.getBoldFont()));
return this;
}

/**
* 換行
*/
public PdfBuilder newLine() {
elements.add(new NewLineElement());
return this;
}

/**
* 分隔線
*/
public PdfBuilder separator() {
elements.add(new SeparatorElement());
return this;
}

/**
* 換頁
*/
public PdfBuilder newPage() {
elements.add(new NewPageElement());
return this;
}

/**
* 新增表格
* @param data 二維資料，第一列為標題
*/
public PdfBuilder table(List<List<String>> data) {
elements.add(new TableElement(data, TableStyle.BORDERED));
return this;
}

/**
* 新增表格（指定樣式）
*/
public PdfBuilder table(List<List<String>> data, TableStyle style) {
elements.add(new TableElement(data, style));
return this;
}

/**
* 新增圖片
*/
public PdfBuilder image(byte[] imageBytes) {
elements.add(new ImageElement(imageBytes));
return this;
}

/**
* 新增條碼（自動產生）
*/
public PdfBuilder barcode(String content) {
byte[] barcodeImage = BarcodeGenerator.generate(content);
elements.add(new ImageElement(barcodeImage));
return this;
}

/**
* 產生 PDF byte 陣列
*/
public byte[] build() {
ByteArrayOutputStream output = new ByteArrayOutputStream();
Document document = new Document(PageSize.A4);

try {
PdfWriter.getInstance(document, output);
document.open();

for (Element element : elements) {
if (element instanceof NewPageElement) {
document.newPage();
} else {
document.add(element.render());
}
}

document.close();

} catch (DocumentException e) {
throw new PdfGenerationException(“PDF 產生失敗”, e);
}

return output.toByteArray();
}

/**
* 直接寫入檔案
*/
public void toFile(String filename) {
byte[] pdf = build();
try (FileOutputStream fos = new FileOutputStream(filename)) {
fos.write(pdf);
} catch (IOException e) {
throw new PdfGenerationException(“檔案寫入失敗”, e);
}
}

public class FontConfig {

private static final String FONT_PATH = “/fonts/NotoSansTC-Regular.ttf”;
private BaseFont baseFont;

public static FontConfig defaultConfig() {
return new FontConfig();
}

private FontConfig() {
try {
// 載入支援中文的字型
baseFont = BaseFont.createFont(
FONT_PATH,
BaseFont.IDENTITY_H, // Unicode 支援
BaseFont.EMBEDDED // 嵌入字型
);
} catch (Exception e) {
throw new RuntimeException(“字型載入失敗”, e);
}
}

public Font getTitleFont() {
return new Font(baseFont, 24, Font.BOLD);
}

public Font getSubtitleFont() {
return new Font(baseFont, 18, Font.BOLD);
}

public Font getBodyFont() {
return new Font(baseFont, 12, Font.NORMAL);
}

public Font getBoldFont() {
return new Font(baseFont, 12, Font.BOLD);
}
}

public byte[] generateShippingLabel(Order order) {
// 準備商品明細表格
List<List<String>> items = new ArrayList<>();
items.add(List.of(“商品”, “數量”, “單價”, “小計”));

for (OrderItem item : order.getItems()) {
items.add(List.of(
item.getName(),
String.valueOf(item.getQuantity()),
formatPrice(item.getPrice()),
formatPrice(item.getSubtotal())
));
}

items.add(List.of(“合計”, “”, “”, formatPrice(order.getTotal())));

// 產生 PDF
return PdfBuilder.create()
// 標題區
.title(“出貨單”)
.separator()
.text(“訂單編號：” + order.getOrderId())
.text(“出貨日期：” + LocalDate.now())
.newLine()

// 條碼
.barcode(order.getOrderId())
.newLine()

// 商品明細
.subtitle(“商品明細”)
.table(items)
.newLine()

// 收件資訊
.subtitle(“收件資訊”)
.text(“收件人：” + order.getReceiverName())
.text(“電話：” + order.getReceiverPhone())
.text(“地址：” + order.getReceiverAddress())

.build();
}