JasperReports 3.3: Linux and Docker Fonts

⚡ Warm-up Quick Fire (Anti-Forgetting Protocol: Chapter 3.2 Review)

Snowball Scenario Check

คำถาม: ในสถาปัตยกรรม Direct Socket Streaming ของบทที่ 3.2 หากรายงานที่กำลังเรนเดอร์มีการใช้ฟอนต์ TrueType ที่ไม่ได้ติดตั้งใน OS ของ Production Docker Container (Linux Alpine/Debian) และไม่มี Font Extension JAR ใน Classpath จะเกิดความเสียหายใดในระดับ Engine และ JVM?

เฉลยทางสถาปัตยกรรม: 1) หากไม่ได้ตั้งค่า -Djava.awt.headless=true JVM AWT Engine จะพังด้วย HeadlessException ทันที 2) หากขาด Font Extension แต่ AWT ทำงานได้ JasperReports จะตกไปสู่ Fallback Font (เช่น Helvetica หรือ Dialog) ซึ่งไม่มีฟอนต์ Glyph ภาษาไทย ทำให้สระลอย สระจม กลายเป็นกล่องสี่เหลี่ยมเต๋า (Tofu Characters □) หรือพังด้วย JRFontNotFoundException และขนาดความกว้างข้อความที่เปลี่ยนไปจะทำลาย Typographic Grid จนข้อความล้น Band (Stretch Overflow)

1. Contextual Anchoring & Dynamic Core Pillars

The "Why" & Real-world Problem: The Silent Container Typography Disaster
บ่อยครั้งที่นักพัฒนาทดสอบบน Windows หรือ macOS ซึ่งมีระบบปฏิบัติการที่พ่วงฟอนต์ลิขสิทธิ์และ Font Rasterizer มาให้ครบ รายงานจึงเรนเดอร์สวยงาม แต่เมื่อ Deploy เป็น Docker Container บน Kubernetes (Ubuntu/Alpine Linux) กลับพบหายนะ 3 ชั้น:

Tofu Effect & Font Drift: ตัวอักษรภาษาไทยกลายเป็นกล่องว่างสี่เหลี่ยม (Tofu □□□) เนื่องจาก Linux Container ขาด TTF Files
Complex Glyph Stacking Failure: สระบน-ล่างและวรรณยุกต์ไทยลอยซ้อนทับกัน (เช่น คำว่า "ที่", "น้ำ", "สิทธิ์") เพราะ Font Rasterizer ทั่วไปไม่รองรับ Complex Text Shaping
Text Truncation & Grid Distortion: ฟอนต์ Fallback มี Font Metrics (Advance Widths) ไม่ตรงกับฟอนต์จริง ทำให้ข้อความขยายกว้างเกินเซลล์และตัดคำตกขอบตาราง

Pillar 1: Self-contained Font Extension Packaging

แยกไฟล์ TrueType (`.ttf`) บรรจุร่วมกับ `jasperreports_extension.properties` และ XML Font Families เป็น Extension JAR เอกเทศ บรรจุเข้า Classpath ของแอปพลิเคชัน ตัดการพึ่งพา OS-level Fonts 100%

Pillar 2: HarfBuzz Complex Text Shaping Engine

ใช้ HarfBuzz Engine ควบคู่กับ AWT Layout Engine เพื่อคำนวณ Glyph Substitution (GSUB) และ Glyph Positioning (GPOS) จัดสระและวรรณยุกต์ภาษาไทย/Indic ให้อยู่ในระดับพิกัดที่สมบูรณ์แบบ ไร้ปัญหาสระลอย

Pillar 3: PDF Font Embedding & Identity-H Encoding

บังคับ `pdfEmbedded="true"` และ `pdfEncoding="Identity-H"` ใน Font Family Definition เพื่อฝัง Subset ของ Unicode Font เข้าไปใน PDF Stream โดยตรง แสดงผลถูกต้องทุกอุปกรณ์แม้อุปกรณ์ผู้ใช้ไม่มีฟอนต์นั้น

Pillar 4: Headless AWT Container Hardening

ติดตั้ง Package พื้นฐานที่จำเป็นของ Native Library (`libfontconfig1`, `libfreetype6`) ใน Dockerfile พร้อมตั้ง JVM Flag `-Djava.awt.headless=true` เพื่อให้ AWT FontMetrics คำนวณพิกัดข้อความได้แม่นยำ 100%

2. Step 1: Deep Dive - JVM Graphics2D & Container Font Hazards

Failure Pattern	Engine & JVM Mechanics	Architectural Defense (Standard 7.0.x)
HeadlessException Crash	เมื่อไม่มี Display Device (X11) AWT Graphics2D ของ JVM จะโยน Exception ทันทีที่สั่งคำนวณ FontMetrics	กำหนดตัวแปร JVM Flag `-Djava.awt.headless=true` ใน Container Entrypoint และติดตั้ง `libfontconfig1`
Tofu Characters (□□□)	PDF Exporter ไม่พบ Glyph สำหรับรหัส Unicode ภาษาไทยในฟอนต์มาตรฐาน (Helvetica/Times) จึงวาดเป็น Missing Glyph Box	ประกาศ Font Extension JAR กำหนด `pdfEncoding="Identity-H"` และ `pdfEmbedded="true"`
Floating Vowels (สระลอย)	Text Layout ทั่วไปขาด HarfBuzz OpenType Shaping ทำให้ไม่สามารถทำ Contextual Ligature และ Mark-to-Base Attachment ได้	เปิดใช้งาน JasperReports HarfBuzz Shaper integration และใช้ฟอนต์ OpenType/TrueType ที่มีตาราง GPOS/GSUB สมบูรณ์ (เช่น Sarabun)
JRFontNotFoundException	ตัวแปรคอนฟิก `net.sf.jasperreports.awt.ignore.missing.font=false` ทำงานเมื่อระบบมองไม่เห็นฟอนต์ที่ระบุใน JRXML	ใช้ Font Extension Name เป็น Logical Font Name ที่แมปเข้ากับ Physical TTF File อย่างแม่นยำ

3. Step 2: Architecture Implementation - Hands-on Studio

สลับแท็บเพื่อศึกษาและทดสอบทั้ง 3 ส่วน: Lab 3.3.1 (Font Extension XML & Config), Lab 3.3.2 (Production Dockerfile Hardening), และ Lab 3.3.3 (Unified JRXML Template 7.0.x)

TARGET PRODUCTION ARTIFACT (Commercial PDF A4) Scale: 100% (595 x 842 pt)

ใบสำคัญยืนยันการทำรายการหลักทรัพย์ (Securities Clearing Note)

เลขอ้างอิงรายการ: SET-TX-2026-0915-0042 วันที่ทำรายการ: 15 กันยายน 2569 สถานะ: ชำระราคาเสร็จสิ้น (T+1)

บัญชีผู้ลงทุน: นายสรวิชญ์ เกษมสันต์ (ACT-BKK-9921) ตัวแทนผู้รับฝาก: ธนาคารกสิกรไทย จำกัด (มหาชน)

รหัสหลักทรัพย์	ชื่อรายการหลักทรัพย์	จำนวนหน่วย	ราคาเฉลี่ย	มูลค่าสุทธิ (บาท)
PTT	บมจ. ปตท. (หุ้นสามัญ)	10,000	34.50	345,000.00
KBANK	บมจ. ธนาคารกสิกรไทย	3,500	148.00	518,000.00
ADVANC	บมจ. แอดวานซ์ อินโฟร์ เซอร์วิส	2,200	285.00	627,000.00
AOT	บมจ. ท่าอากาศยานไทย	5,000	63.25	316,250.00

ยอดรวมการชำระราคาสุทธิ (บาท): 1,806,250.00 บาท

Font Family Extension Configuration (fonts.xml) JasperReports Font Registry

คลิก "Verify & Lint Configuration" เพื่อตรวจสอบความถูกต้องของระบบ Font Extension และ Container Integration...

4. Step 3: Architectural Knowledge Assessment (15 In-depth Questions)

ทดสอบความเข้าใจเชิงลึกเกี่ยวกับ Linux Headless AWT, Font Extensions, TrueType Embedding, HarfBuzz Text Shaping, และ Docker Container Environments

Score: 0 / 15 (0 answered)

0%