flowable 获取自定义属性

### 如何在 Flowable 中获取自定义属性值

为了实现这一目标，在 Flowable 设计器中设置好节点的自定义属性之后，可以通过编程方式访问这些属性。对于流程中的任意元素，可以利用 `FlowElement` 接口来取得该元素及其附加的信息。

当需要读取特定活动（如用户任务）上的自定义属性时，可采用如下方法：

#### 获取指定 ID 的流对象并提取其自定义属性

通过调用 `process.getFlowElementMap()` 方法获得整个 BPMN 流程图内所有流对象的地图集合，再依据具体活动ID定位到对应的流对象实例[^1]。

// 假设 activityId 是要查询的目标活动唯一标识符
String activityId = "someActivityId";
FlowElement flowElement = process.getFlowElementMap().get(activityId);
if (flowElement instanceof UserTask){
    UserTask userTask = (UserTask) flowElement;
    
    // 获取所有的扩展元素作为 Map<String, List<ExtensionElement>>
    Map<String, List<ExtensionElement>> extensionElements = userTask.getExtensionElements();
}

上述代码片段展示了如何先找到具体的 `UserTask` 实例，进而获取它的全部扩展元素列表。这里的 `extensionElements` 就包含了所有已配置好的自定义属性键值对[^2]。

如果想要进一步处理某个特别命名的自定义属性，则可以根据名称检索相应的 `List<ExtensionElement>` 并解析其中的内容。通常情况下，每个 `ExtensionElement` 对象会携带有关此自定义字段的数据类型以及实际存储的位置等元数据信息。

#### 解析单个自定义属性的具体内容

假设有一个名为 `"customProperty"` 的自定义属性被添加到了某用户的任务上，那么就可以按照下面的方式去获取它的确切数值：

import org.flowable.bpmn.model.ExtensionAttribute;

...

List<ExtensionElement> customProperties = extensionElements.get("customProperty");
for(ExtensionElement element : customProperties){
    String value = null;
    for(ExtensionAttribute attribute : element.getAttributes()){
        if ("value".equals(attribute.getName())){
            value = attribute.getValue();
            break;
        }
    }

    System.out.println("Custom Property Value: "+value);
}

这段 Java 代码遍历了给定名字下的每一个可能存在的多值情况，并最终打印出了所关心的那个字符串类型的自定义属性的实际值[^3]。