XYS.FR 4.0.0

XYS.FR.V3

FastReport 数据契约与配置层。只负责：把 POCO 实体注册为 DataSet 表结构、生成 FastReport Designer 所需的 FRTables.frd、加载模板/行列对照配置。不含任何渲染引擎（PDF/图片/打印由 XYS.FRNet.* / XYS.FRCore.* / XYS.FR.NetCore3 等宿主项目实现，它们继承本项目的 BaseFRService）。

• 目标框架：net8.0 / net462 / netcoreapp3.1 / netstandard2.0 / netstandard2.1
• 依赖：XYS.Utils.Sys、XYS.Utils.Log4Net（同解决方案项目引用）
• 程序集名：XYS.FR（命名空间同名）

核心概念

快速使用

1. 定义实体

using XYS.FR;

public class LabItem : FRBaseEntity
{
    [FRExport] public string ItemName { get; set; }
    [FRExport] public string Value { get; set; }
    [FRExport] public string Unit { get; set; }

    [FRExport(false)] public string InternalNote { get; set; }   // 不导出
    [FRExport(true, "结果标志")] public string Flag { get; set; } // 列名重命名
}

2. 继承 BaseFRService

public sealed class LabFRService : BaseFRService
{
    public LabFRService()
    {
        LoggerName = "LabFRService";
        ActualType = typeof(LabFRService);
        Init();  // 注册实体 + 加载配置
    }

    protected override List<Type> GetFRTypes() => new List<Type>
    {
        typeof(FRInfo),
        typeof(LabItem),
    };

    protected override void InitFRConfig()
    {
        var cfg = new XmlConfigManager();  // 默认 AppBase/Config/fr.config.xml
        cfg.Init();                        // 失败会抛异常，视为致命错误
        ConfigManager = cfg;
    }

    public override void ExportStream(FRReport report, Stream stream, ExportType type = ExportType.Pdf)
    {
        // 由具体渲染引擎实现（见 XYS.FRNet.2021 / XYS.FR.NetCore3 等）
    }

    public override void Print(FRReport report, string printer = null) { }
}

3. 生产 FRReport 并渲染

var report = new FRReport { ModelNo = "LAB001", RID = "R123" };
report.Items.Add(new FRInfo { ID = "1", RID = "R123", PatName = "张三" });
report.Items.Add(new LabItem { ID = "1", RID = "R123", ItemName = "WBC", Value = "6.5" });

using (var fs = File.Create("out.pdf"))
{
    labSvc.ExportStream(report, fs, ExportType.Pdf);
}

4. 配置文件 Config/fr.config.xml 示例

<?xml version="1.0" encoding="utf-8"?>
<frConfig>
  <modelMap>
    <model modelNo="LAB001" name="常规生化" alias="lab" fileName="lab_normal.frx" />
    <model modelNo="LAB002" name="血常规"   alias="cbc" fileName="lab_cbc.frx" />
  </modelMap>
  <mapMap>
    <map tType="0" rowId="WBC" colName="C0" />
    <map tType="0" rowId="RBC" colName="C1" />
  </mapMap>
</frConfig>

关键契约

4.0.0 变更（相对 3.1.0）

破坏性

• ExportType 枚举值改 PascalCase：pdf/jpg/html/xls → Pdf/Jpg/Html/Xls
• XML DTO 类重命名：FRModel_Xml → FRConfigXml、FRModel_M → FRModelXml、FRMap_M → FRMapXml（XML 节点名不变，兼容旧配置文件）
• IConfigManager.Maps / Models 由 List<T> 收紧为 IReadOnlyList<T>；外部不再可整体替换
• IFREntity 接口去掉误导性的 [FRExport] 装饰（C# 属性 Attribute 不从接口继承，原来就没生效）
• 删除死接口 IFRModel、空壳 ISetting/BaseSettings
• FRInfo 拼写修正：Equipentment→Equipment、SmapleExp→SampleExp、ColletTime→CollectTime、InceptTime→AcceptTime、InceptSign→AcceptSign
• DataStruct 从"通过公共 TList.Add 修改集合"改为"通过 Register() 幂等注册"；InitXMLStruct/InitRamStruct 已由 Register + EnsureXmlFile 取代
• BaseConfigManager.Maps/Models 公开的可写属性已改为只读；子类改用 protected 字段 _maps / _models

修复

• _initFlag 是静态导致多子类竞态：现改为 HashSet<Type> per-type 幂等注册，多个 BaseFRService 子类可安全共存
• [FRExport(false)] 曾被忽略：DataStruct.IsExport(PropertyInfo) 现真正读取 IsExport 属性
• FRExportAttribute.Name 曾被忽略：现作为导出列名生效
• XmlConfigManager.Init 静默吞异常：文件不存在 / 解析失败 / 反序列化 null 都会抛异常向上传播
• Models/Maps 节点为 null 时 NRE：分别判空
• throw ex; 丢失堆栈：移除无意义 try/catch
• ExportData.IsExport 与 DataStruct.IsExport 重复代码：统一到 DataStruct
• ExportData 抛通用 Exception：改为 InvalidOperationException / ArgumentNullException

清理

• 依赖由 PackageReference XYS.Utils.Sys 2.2.1.1 / XYS.Utils.Log4Net 2.1.1.1 改为 ProjectReference，与解决方案统一
• DataStruct.Gender*AttrDic → Build*Attrs（原方法名拼写疑似 Generate 之误）
• static readonly string 常量 → const
• 删除 DataStruct.ConvertXml2DataTable/ConvertXml2TableRelation/GetRelationColumns 等死代码
• MethodBase.GetCurrentMethod().Name 反射调用 → nameof

建议

• Init() 在服务构造末尾调用，WorkerCount 等属性设置在前
• XmlConfigManager 配置加载失败视为致命错误，让 App 启动失败胜过运行期打空模板
• [FRExport(name: "...")] 用于列名重命名，Designer 端字段名与 C# 属性名可解耦
• 同进程内允许多个 BaseFRService 子类共存（如 Lab / Exam / EMR），共享同一 DataStruct 实体注册表