diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java index 6636dc3..a9613c4 100644 --- a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java +++ b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java @@ -38,11 +38,18 @@ import io.swagger.v3.oas.annotations.tags.Tag; * 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在, * {@code databaseSchemaUpdate=false} 不涉 DDL。

* - *

写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true):坏 XML 返 422 且绝不落库。 + *

存量隔离:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类, + * 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。

+ * + *

写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true + enableSafeBpmnXml=true, + * 后者关外部 DTD/实体解析,防 XXE/SSRF):坏 XML 返 422 且绝不落库;422 只回通用文案,原始解析原因仅进日志。 * 守卫异常在本控制器就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}(那里 FlowableException→400,语义不符)。 * {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法, * 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿, * 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。

+ * + *

鉴权:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点 + * (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。

*/ @RestController @RequestMapping("/api/flow") @@ -51,6 +58,9 @@ public class ProcessModelController { private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class); + /** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */ + static final String EIP4_CATEGORY = "eip4"; + private final RepositoryService repositoryService; private final ObjectMapper objectMapper = new ObjectMapper(); @@ -60,9 +70,11 @@ public class ProcessModelController { @GetMapping("/models") @Operation(summary = "草稿列表", - description = "createModelQuery().orderByLastUpdateTime().desc() → {models:[{id,name,key,lastUpdateTime(ISO)}]}。") + description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → " + + "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。") public ResponseEntity> list() { List> models = repositoryService.createModelQuery() + .modelCategory(EIP4_CATEGORY) .orderByLastUpdateTime().desc().list().stream() .map(m -> { Map row = new LinkedHashMap<>(); @@ -105,9 +117,13 @@ public class ProcessModelController { @PostMapping("/models") @Operation(summary = "建草稿", - description = "body {name,key,bpmnXml,metaInfo?}。XML 先过 BpmnXMLConverter 解析守卫(坏 XML→422 不落库)," - + "过门后 newModel+saveModel+addModelEditorSource → {modelId}。") + description = "body {name,key,bpmnXml,metaInfo?}。name/key 空白→422;XML 过 BpmnXMLConverter 解析守卫" + + "(坏 XML→422 不落库);过门后 newModel+setCategory(eip4)+saveModel+addModelEditorSource → {modelId}。") public ResponseEntity> create(@RequestBody CreateModelRequest req) { + // key 是 T3.1 部署资源名/中文原 key 还原的依赖,name 用于列表展示:空白一律拒。 + if (isBlank(req.name) || isBlank(req.key)) { + return status(HttpStatus.UNPROCESSABLE_ENTITY, "name 与 key 不能为空"); + } ResponseEntity> rejected = parseGuard(req.bpmnXml); if (rejected != null) { return rejected; @@ -115,6 +131,7 @@ public class ProcessModelController { Model model = repositoryService.newModel(); model.setName(req.name); model.setKey(req.key); + model.setCategory(EIP4_CATEGORY); if (req.metaInfo != null) { model.setMetaInfo(req.metaInfo); } @@ -184,6 +201,7 @@ public class ProcessModelController { Model model = repositoryService.newModel(); model.setName(def.getName()); model.setKey(def.getKey()); + model.setCategory(EIP4_CATEGORY); model.setMetaInfo(metaInfoJson); repositoryService.saveModel(model); repositoryService.addModelEditorSource(model.getId(), r.xml().getBytes(StandardCharsets.UTF_8)); @@ -195,17 +213,21 @@ public class ProcessModelController { /** * BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。 * 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。 + * + *

{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)} 两布尔参: + * {@code validateSchema=true} 走 BPMN 2.0 XSD 校验(拒非法结构); + * {@code enableSafeBpmnXml=true} 启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE), + * 关掉 XXE/SSRF 面——校验路径也走加固解析器,不给外部实体注入留口。

+ * + *

422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。

*/ private ResponseEntity> parseGuard(String xml) { try { - new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), true, false); + new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), true, true); return null; } catch (Exception e) { log.warn("[流程草稿] BPMN 解析守卫拒绝: {}", e.toString()); - Map body = new LinkedHashMap<>(); - body.put("status", 1); - body.put("msg", "BPMN 解析失败: " + e.getMessage()); - return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY).body(body); + return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败"); } } @@ -240,6 +262,11 @@ public class ProcessModelController { return d == null ? null : d.toInstant().toString(); } + /** null 或纯空白(含全角/半角空格)视为空白。 */ + private static boolean isBlank(String s) { + return s == null || s.isBlank(); + } + /** 建草稿入参。 */ public static class CreateModelRequest { public String name; diff --git a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java index 705e85b..aa5e2a2 100644 --- a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java +++ b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java @@ -64,13 +64,14 @@ class ProcessModelControllerTest { } @Test - void 列表按最近更新降序返回id名key时间() throws Exception { + void 列表只查eip4分类并按最近更新降序返回id名key时间() throws Exception { Model m = Mockito.mock(Model.class); when(m.getId()).thenReturn("m1"); when(m.getName()).thenReturn("总包合同交底"); when(m.getKey()).thenReturn("总包合同交底"); when(m.getLastUpdateTime()).thenReturn(new Date(0L)); // 1970-01-01T00:00:00Z when(repositoryService.createModelQuery()).thenReturn(modelQuery); + when(modelQuery.modelCategory("eip4")).thenReturn(modelQuery); when(modelQuery.orderByLastUpdateTime()).thenReturn(modelQuery); when(modelQuery.desc()).thenReturn(modelQuery); when(modelQuery.list()).thenReturn(List.of(m)); @@ -81,6 +82,9 @@ class ProcessModelControllerTest { .andExpect(jsonPath("$.models[0].name").value("总包合同交底")) .andExpect(jsonPath("$.models[0].key").value("总包合同交底")) .andExpect(jsonPath("$.models[0].lastUpdateTime").value("1970-01-01T00:00:00Z")); + + // 列表只列 EIP4 建的草稿:隔离库里 143 条老 shape 存量 act_re_model(打不开) + verify(modelQuery).modelCategory("eip4"); } @Test @@ -137,6 +141,7 @@ class ProcessModelControllerTest { verify(m).setName("新流程"); verify(m).setKey("newproc"); + verify(m).setCategory("eip4"); // 建草稿打 EIP4 分类,供 list() 过滤隔离存量 verify(repositoryService).saveModel(m); ArgumentCaptor src = ArgumentCaptor.forClass(byte[].class); verify(repositoryService).addModelEditorSource(eq("newid"), src.capture()); @@ -144,6 +149,19 @@ class ProcessModelControllerTest { new String(src.getValue(), StandardCharsets.UTF_8).contains(" meta = ArgumentCaptor.forClass(String.class); verify(m).setMetaInfo(meta.capture()); @@ -262,6 +299,23 @@ class ProcessModelControllerTest { verify(repositoryService, never()).newModel(); } + @Test + void fromProcDef_BPMN读取为空返found_false不落库() throws Exception { + // procDef 存在但部署 BPMN 资源读不出(getProcessModel 返 null)→ 降级 found:false,不建空草稿。 + ProcessDefinition def = Mockito.mock(ProcessDefinition.class); + when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery); + when(processDefinitionQuery.processDefinitionId("def-empty")).thenReturn(processDefinitionQuery); + when(processDefinitionQuery.singleResult()).thenReturn(def); + when(repositoryService.getProcessModel("def-empty")).thenReturn(null); + + mvc.perform(post("/api/flow/models/from-procdef") + .contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"def-empty\"}")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.found").value(false)); + + verify(repositoryService, never()).newModel(); + } + /** 把任意字符串编成 JSON 字符串字面量(转义引号/反斜杠/换行),用于拼请求体。 */ private static String jsonString(String s) { StringBuilder sb = new StringBuilder("\"");