Fire Workflow 源碼深度解析 (四)：資源管理模組與 XML 解析實現

Fire Workflow `org.fireflow.model.resource` 套件定義工作流引用的資源類型與管理機制。資源分為子流程、應用程式、表單、參與者四類，資源管理器負責從 XML 文件解析載入。

資源體系架構

IResource - 資源介面

定義資源基本屬性：名稱 (`name`)、顯示名稱 (`displayName`)、描述 (`description`)。

AbstractResource - 抽象基類

實作 `IResource`，提供屬性存取與 `toString()` 重寫。

四大具體資源類型

資源管理器 - XML 解析實現

`ResourceManager4XmlFile` 實作 `IResourceManager`，提供 `parseResource(String filePath)` 和 `parseResource(InputStream in)` 重載方法。解析流程：

1. 使用 Dom4J 讀取 XML 文件
2. 依序調用 `loadForms()`、`loadParticipants()`、`loadApplications()`
3. 各 `load` 方法提取對應元素屬性與子元素，建構資源物件列表

loadForms() 範例程式碼

protected List<Form> loadForms(Element element) {
  Element formsElement = Util4Parser.child(element, "Forms");
  if (formsElement == null) return null;
  List<Element> formElementList = Util4Parser.children(formsElement, "Form");
  List<Form> forms = new Vector<Form>();
  for (int i = 0; formElementList != null && i < formElementList.size(); i++) {
    Element formElm = formElementList.get(i);
    String name = formElm.attributeValue("Name");
    Form form = new Form(name);
    form.setDisplayName(formElm.attributeValue("DisplayName"));
    form.setDescription(Util4Parser.elementAsString(formElm, "Description"));
    form.setUri(Util4Parser.elementAsString(formElm, "Uri"));
    forms.add(form);
  }
  return forms;
}

XML 資源文件結構範例

<Resources>
  <Forms>
    <Form Name="leaveForm" DisplayName="請假單">
      <Description>員工請假申請表單</Description>
      <Uri>/forms/leave.jsp</Uri>
    </Form>
  </Forms>
  <Participants>...</Participants>
  <Applications>...</Applications>
</Resources>

設計觀察與改進建議

• 子流程即資源：將 `SubWorkflowProcess` 歸類為資源而非流程元素，與 `org.fireflow.model.WorkflowProcess` 存在概念重疊，建議統一抽象層級
• 資源管理器功能單薄：僅支援 XML 靜態解析，缺乏快取、熱重載、資料庫/註冊中心等動態資源來源支援
• 型別安全：解析過程大量使用字串屬性名，易拼寫錯誤，可引入註解或常數定義強化

下一篇將介紹模組最後部分：流程定義文件的序列化與解析核心。