標籤: Design Pattern

// 產生出貨單 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();
}

/**
* 蝦皮訂單 API 回應（對應蝦皮 API 文件）
*/
@Data
public class ShopeeGetOrderResponse {

// 蝦皮欄位名稱（底線命名）
@JsonProperty(“order_sn”)
private String orderSn;

@JsonProperty(“order_status”)
private String orderStatus;

@JsonProperty(“total_amount”)
private BigDecimal totalAmount;

@JsonProperty(“create_time”)
private Long createTime; // Unix timestamp

@JsonProperty(“buyer_username”)
private String buyerUsername;

@JsonProperty(“item_list”)
private List<ShopeeOrderItem> itemList;
}

/**
* Momo 訂單 API 回應（對應 Momo API 文件）
*/
@Data
public class MomoGetOrderResponse {

// Momo 欄位名稱（駝峰命名）
private String orderNo;
private String orderStatus;
private BigDecimal orderAmount;
private String orderDate; // yyyy/MM/dd HH:mm
private String customerName;
private List<MomoOrderItem> products;
}

/**
* 系統內部訂單 DTO（統一格式）
*/
@Data
@Builder
public class OrderDTO {

// 統一的欄位命名
private String orderId;
private String platformOrderId;
private ChannelType channel;
private OrderStatus status;
private BigDecimal totalAmount;
private ZonedDateTime createdAt; // 統一用 ZonedDateTime
private String buyerName;
private List<OrderItemDTO> items;
}

@Component
public class ShopeeConverter {

/**
* 蝦皮格式 → 內部格式
*/
public OrderDTO toOrderDTO(ShopeeGetOrderResponse response) {
return OrderDTO.builder()
.platformOrderId(response.getOrderSn())
.channel(ChannelType.SHOPEE)
.status(mapStatus(response.getOrderStatus()))
.totalAmount(response.getTotalAmount())
.createdAt(convertTimestamp(response.getCreateTime()))
.buyerName(response.getBuyerUsername())
.items(convertItems(response.getItemList()))
.build();
}

// Unix timestamp → ZonedDateTime
private ZonedDateTime convertTimestamp(Long timestamp) {
return Instant.ofEpochSecond(timestamp)
.atZone(ZoneId.of(“Asia/Taipei”));
}

// 蝦皮狀態 → 系統狀態
private OrderStatus mapStatus(String shopeeStatus) {
return switch (shopeeStatus) {
case “UNPAID” -> OrderStatus.PENDING_PAYMENT;
case “READY_TO_SHIP” -> OrderStatus.PENDING_SHIPMENT;
case “SHIPPED” -> OrderStatus.SHIPPED;
case “COMPLETED” -> OrderStatus.COMPLETED;
case “CANCELLED” -> OrderStatus.CANCELLED;
default -> OrderStatus.UNKNOWN;
};
}
}

@Component
public class MomoConverter {

private static final DateTimeFormatter MOMO_DATE_FORMAT =
DateTimeFormatter.ofPattern(“yyyy/MM/dd HH:mm”);

/**
* Momo 格式 → 內部格式
*/
public OrderDTO toOrderDTO(MomoGetOrderResponse response) {
return OrderDTO.builder()
.platformOrderId(response.getOrderNo())
.channel(ChannelType.MOMO)
.status(mapStatus(response.getOrderStatus()))
.totalAmount(response.getOrderAmount())
.createdAt(convertDate(response.getOrderDate()))
.buyerName(response.getCustomerName())
.items(convertItems(response.getProducts()))
.build();
}

// Momo 日期格式 → ZonedDateTime
private ZonedDateTime convertDate(String dateStr) {
LocalDateTime ldt = LocalDateTime.parse(dateStr, MOMO_DATE_FORMAT);
return ldt.atZone(ZoneId.of(“Asia/Taipei”));
}
}

@Service
public class OrderSyncService {

@Autowired private ShopeeConverter shopeeConverter;
@Autowired private MomoConverter momoConverter;

public List<OrderDTO> syncOrders(ChannelType channel, Merchant merchant) {

if (channel == ChannelType.SHOPEE) {
// 呼叫蝦皮 API，取得蝦皮格式
List<ShopeeGetOrderResponse> shopeeOrders = shopeeApi.getOrders();

// 轉換成內部格式
return shopeeOrders.stream()
.map(shopeeConverter::toOrderDTO)
.toList();
}

if (channel == ChannelType.MOMO) {
// 呼叫 Momo API，取得 Momo 格式
List<MomoGetOrderResponse> momoOrders = momoApi.getOrders();

// 轉換成內部格式
return momoOrders.stream()
.map(momoConverter::toOrderDTO)
.toList();
}

// … 其他平台
}
}