Package io.leandev.appfuse.report

@ExperimentalApi("REP-09\uff1a\u81f3\u5c11\u5169\u500b\u5be6\u969b\u5831\u8868\u9a57\u8b49\u5f8c\u8f49\u70ba\u7a69\u5b9a") package io.leandev.appfuse.report

報表文件模型（實驗性）

與 renderer 無關的報表文件：應用以 ReportTemplate 把資料轉成 ReportDocument，再交給 renderer 分頁輸出。

模組內容

• ReportDocument - 不可變的文件與建構器，建構時執行模型驗證
• ReportTemplate、ReportContext - 樣板與產生環境
• GroupedRows - 串流分組與彙總，記憶體與列數無關
• ReportDiagnostic、ReportValidationException - 驗證結果
• 節點、樣式與列來源見 io.leandev.appfuse.report.node

設計與驗證規則見文檔站「REP-02 ReportDocument 核心契約設計」。

Related Packages

Package	Description
io.leandev.appfuse.report.chart	圖表 adapter（實驗性）：把圖表資料轉成含受限 SVG 的 Figure BarChart：並排長條圖
io.leandev.appfuse.report.internal	報表的內部實作：模型驗證、樣式解析，以及之後的 renderer 與第三方 adapter
io.leandev.appfuse.report.node	報表節點、樣式與列來源（實驗性）
io.leandev.appfuse.report.web	報表的 HTTP 交付（實驗性）：在請求執行緒同步寫出 ReportArtifact 保存後的報表以 io.leandev.appfuse.file.FileResponseBuilder 下載（ETag 為 fileId）， 已授權內容必須使用私有快取（cacheControl(CacheControl.noCache().cachePrivate())），不得使用 immutable()。

Class	Description
FontSource	字型檔的來源；登錄時只記錄來源，render 時才讀取
FontSource.Bytes	由應用提供位元組；每次讀取都呼叫 supplier
FontSource.Classpath	classpath 上的字型資源
FontSource.File	檔案系統上的字型檔
GroupedRows<T>	把已排序的領域資料串流轉成帶群組角色的 TableRow 串流
GroupedRows.Aggregate<R>	彙總結果的 handle；只能用於建立它的 GroupedRows
GroupedRows.Group	結束中的群組
GroupedRows.Totals	一個群組或總計的彙總結果
Margins	頁面邊界
PageRegion	頁首或頁尾；左、中、右三格，v1 全部頁面共用同一組
PageRegion.Builder	頁首頁尾建構器
PageSetup	頁面尺寸與邊界
PageSummary	每頁內容末端的左右摘要；可以使用頁碼及總頁數，不改變固定 PageRegion 頁尾。 位於頂層 pageBreakBefore=true Section 的頁面另可使用 SectionPageNumber／SectionPageCount， 解析為該分節的頁碼與排版完成後的實際總頁數。 左右內容不自動換行，超寬時失敗而非截斷；同字級單行內容使用相同基線。 左右內距只縮排文字，摘要上線仍畫滿內容區寬度。 最後頁採 lastPage，其他頁採 everyPage；分節最後頁可逐側優先採 PageSummaryOverride。 無摘要文字時仍保留設定的線及空間。
PageSummary.Builder	摘要建構器；最後頁未覆寫的側沿用一般頁內容
PdfReportRenderer	PDF renderer 的建立入口
PdfReportSubsets	從已保存的 PDF 擷取選取的頁面（REP-08）
RenderOptions	單次 render 的選項
RenderResult	render 成功的結果
ReportArtifact	render 完成的報表產物（REP-05）；以 renderer 的暫存檔承載，關閉後刪除
ReportContext	產生報表時的環境
ReportDiagnostic	驗證或排版時回報的訊息
ReportDiagnostic.Severity	嚴重度
ReportDocument	與 renderer 無關的報表文件：資料已套入、尚未分頁
ReportDocument.Builder	ReportDocument 建構器；不可重複使用於多份文件以外的用途，但 ReportDocument.Builder.build() 可呼叫多次
ReportDocument.SectionBuilder	Section 建構器；摘要的線、間距及文字預設沿用文件 PageSummary。
ReportDocument.TableBuilder	Table 建構器
ReportFonts	renderer 使用的字型登錄；不可變，可在多執行緒共用
ReportFonts.Builder	ReportFonts 建構器
ReportFonts.Family	字型家族；每個字面是一條 fallback 鏈，regular 必填
ReportFonts.FamilyBuilder	家族的字面設定；每個方法依序列出 fallback 字型
ReportMetadata	文件 metadata；除 keywords 外皆為選填
ReportMetadata.Builder	metadata 建構器
ReportPages	選取的 PDF physical pages（REP-08）
ReportPages.PageRange	連續頁的區間（1 <= from <= to <= MAX_PAGE）
ReportPageSelectionException	選頁不合法（REP-08）；經 StandardRestExceptionHandler 轉為 400
ReportRenderCancelledException	render 在產生階段被取消；已開啟的列來源與暫存資源都已釋放，out 未被寫入
ReportRenderer	把 ReportDocument 輸出成特定格式
ReportStatus	報表產生的狀態值型別；status() 對齊前端 ReportViewer 的 generating／ready／failed／expired
ReportStatus.Expired	已過期（應用依保存期限刪除後）
ReportStatus.Failed	失敗
ReportStatus.Generating	產生中
ReportStatus.Ready	已保存、可下載
ReportTemplate<T>	把應用資料轉成報表文件
ReportValidationException	報表模型不合法；建構時由 ReportDocument.Builder#build() 丟出，讀取延遲列時由 renderer 丟出
StoredReport	已保存到 FileStorage 的報表
StoredReports	把 ReportArtifact 保存到 FileStorage StoredReport stored = StoredReports.save(fileStorage, partition, renderer.render(document, options)); partition 由應用決定：tenant 模組傳目前 tenant ID，tenantless 模組傳應用常數或依資料範圍設計的值。 保存期限由應用以 StoredReport.storedAt() 計算並自行刪除；框架不排程刪除。