Sub-topic 1.1: JasperReports Lifecycle & Internal Mechanics

การเปลี่ยนแปลงเชิงโครงสร้าง (7.0.x vs 6.x):

• Legacy 6.x (Fat Monolith): ผูกมัด Core Engine, iText 2.1.7 (ติด Security CVE และ LGPL), และ javax.servlet เมื่อรันบน Spring Boot 3+ จะเกิด Classpath Conflict และ Metaspace Pollution ทันที
• Modern 7.0.x (Decoupled Modules): แยกเป็น jasperreports-core, jasperreports-pdf (OpenPDF/PDFBox สะอาดปราศจากข้อจำกัด License), jasperreports-excel (Decoupled POI), และ jasperreports-jakarta สำหรับ Web Integration

ผัง 4 สเตจหลัก (Core Lifecycle Flow):

1. Design Stage (.jrxml): เอกสารนิยามโครงสร้างและนิพจน์ (Expressions) ในรูป XML Schema 7.0.x
2. Compile Stage (JasperCompileManager): แปลง XML Template และ Expressions ภาษา Java ให้อยู่ในรูป Executable Bytecode (JasperReport / .jasper)
3. Fill Stage (JasperFillManager): ฉีดข้อมูลจริงจาก Data Source และ Parameters เข้าไปใน Template เพื่อคำนวณและวาด Layout ทีละหน้า ได้ผลลัพธ์เป็น JasperPrint
4. Export Stage (JRAbstractExporter): สังเคราะห์ Abstract Page Model ให้ออกมาเป็น Byte Stream ของไฟล์มาตรฐานจริง เช่น PDF หรือ Excel

กลไกการทำงานภายใน (Execution Steps):

1. XML Digestion: JRXmlDigester อ่านและสกัด Java Expressions ทั้งหมด
2. Dynamic Source Synthesis: สร้างซอร์สโค้ดภาษา Java ขึ้นมา 1 คลาสสดๆ ในหน่วยความจำ (เช่น invoice_1715000000_12345.java) บรรจุ Logic การคำนวณลงใน Method evaluate()
3. In-Memory Compilation: เรียกใช้ Eclipse JDT Core หรือ JDK Compiler คอมไพล์ String ซอร์สโค้ดนั้นให้เป็น Bytecode (.class)
4. Dynamic ClassLoading: Engine สร้าง Custom ClassLoader ตัวใหม่เพื่อโหลด Bytecode ก้อนนั้นเข้าไปยัง JVM Metaspace
5. JasperReport Output: มัดรวม Template Layout เข้ากับ Compiled Class กลายเป็นอ็อบเจกต์ JasperReport ที่พร้อมนำไป Fill

Internal Filler Pipeline (JRVerticalFiller):

• Record Iteration: วน Loop ดึงข้อมูลแถวถัดไปด้วย datasource.next()
• Expression Evaluation: ส่งข้อมูลเข้าไปประเมินผลใน Dynamic Bytecode เพื่อดึงค่า $F{}, $P{} และสะสมตัวแปร $V{}
• Band Height & Overflow Check: เช็คความสูง Detail Band หากเกินพื้นที่หน้ากระดาษ จะ Trigger New Page (JRPrintPage) ทันที
• Element Materialization: คำนวณพิกัดสัมบูรณ์ ($X, Y$) และขนาด ($W, H$) แล้ว Instantiate Concrete Objects (JRPrintText, JRPrintLine) ยัดลงใน Page Model

Abstract Model Serialization:

• JRPdfExporter (Vector-based): อ่าน Element Nodes แล้วนำพิกัด Points ($1/72$ นิ้ว) ไปวาดลง Canvas เวกเตอร์ของ PDF และฝัง Font Extensions ลงในไบนารีสตรีม
• JRXlsxExporter (Grid-based): สลายระบบพิกัดสัมบูรณ์ แล้วแปลง Elements ลง Matrix ตาราง (Row, Column) หากวางเหลื่อมกันจะเกิดปัญหา Cell Merging ทันที

// Production-Grade Implementation (Spring Boot 3.x / Java 21)
@Configuration
public class JasperReportConfig {
    @Bean
    public JasperReport invoiceReport() throws JRException, IOException {
        // แนะนำที่สุด: โหลด .jasper ที่ Pre-compile แล้วจาก CI/CD
        try (InputStream is = new ClassPathResource("reports/invoice.jasper").getInputStream()) {
            return (JasperReport) JRLoader.loadObject(is);
        }
    }
}

@Service
public class InvoiceReportingService {
    private final JasperReport invoiceReport;
    public InvoiceReportingService(JasperReport invoiceReport) { this.invoiceReport = invoiceReport; }

    public void streamInvoicePdf(InvoiceData data, OutputStream outputStream) throws JRException {
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("REPORT_LOCALE", Locale.of("th", "TH"));
        JRDataSource dataSource = new JRBeanCollectionDataSource(data.getItems());

        // Fill Stage: สร้าง JasperPrint แยก Context ต่อ Request Thread
        JasperPrint jasperPrint = JasperFillManager.fillReport(invoiceReport, parameters, dataSource);

        // Export Stage: สตรีมตรงสู่ OutputStream โดยไม่เก็บ Buffer ก้อนใหญ่ใน Heap
        JRPdfExporter exporter = new JRPdfExporter();
        exporter.setExporterInput(new SimpleExporterInput(jasperPrint));
        exporter.setExporterOutput(new SimpleOutputStreamExporterOutput(outputStream));
        exporter.exportReport();
    }
}