设计时函数库管理（MacrosController）

函数库（脚本宏集合，RepositoryVO）的设计时管理：函数库的列表查询、详情获取、新建、更新与批量删除；用于集中维护应用级 iScript 函数库源码。

与 macro.md（MacroController，单数）不同：前者仅提供「服务发现调试 URL」单一端点；本控制器（MacrosController，复数）面向函数库资源本身的 CRUD。

• 接口类型：REST 资源
• 基址：${myapps.context-path.designer:}/api/designtime/applications（类级 @RequestMapping，produces = APPLICATION_JSON_VALUE）
• Tag：设计时-函数库模块

公共说明

• 鉴权：是（需 designerToken）。控制器继承自 AbstractDesignTimeController（基类为 @RestController），通过 Security.getDesignerIdFromToken(request) 从 designerToken JWT 中解析设计器用户。鉴权机制详见 index.md「鉴权说明」。
• 路径变量：{applicationId}、{macroId} 均为**明文设计时 ID**。
• 响应：统一 Resource（见 ../index.md「统一响应结构」）。成功 errcode=0；异常默认 errcode=500；保存校验失败（库名称重复）捕获 OBPMValidateException，返回 errcode=40001，errmsg 形如 " 库名称重复 ,请重新命名再保存！ "。
• HTTP 方法：受 CommonSecurityFilter 限制，仅允许 GET/POST/HEAD/OPTIONS。
• 请求体约定：POST/PUT 接收原始 JSON 字符串（@RequestBody String content），由服务端用 JSONObject.fromObject 解析后 json2obj 转 RepositoryVO；DELETE 接收 JSON 字符串数组（@RequestBody String[]）。
• 隶属关系：新建时 parentId 固定设为 applicationId（函数库直接挂在应用下）。
• 更新语义：更新时先按 macroId 查询旧对象并克隆（BeanUtils.cloneBean），仅应用请求体中的 content/name/description 并清空 uri，再校验后 update（其他字段不被覆盖）。

---

1. 获取函数库列表

分页获取指定应用下的函数库列表，可按名称关键字查询。

• 接口类型：REST 资源
• 请求方式：GET
• 请求路径：/{applicationId}/macros（完整：{designer-context}/api/designtime/applications/{applicationId}/macros）
• 鉴权：是（需 designerToken）
• Tag：设计时-函数库模块

请求参数

参数名	位置	类型	必填	说明
applicationId	path	string	是	应用Id
name	query	string	否	按函数库名称查询关键字
pageNo	query	string	否	页码（缺省 1）
linesPerPage	query	string	否	每页条数（缺省 10）

说明：name/pageNo/linesPerPage 形参未标注 @RequestParam，由 Spring MVC 按请求参数绑定，故均可缺省。

请求示例

GET /api/designtime/applications/{applicationId}/macros?name=&pageNo=1&linesPerPage=10 HTTP/1.1

响应

结构：统一 Resource（见 ../index.md「统一响应结构」）。 data：DataPackage<RepositoryVO>（含分页字段与 datas）。

成功示例：

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "linesPerPage": 10,
    "pageNo": 1,
    "pageCount": 1,
    "rowCount": 1,
    "datas": [
      { "id": "...", "name": "函数库名", "description": "...", "content": "<脚本源码>", "...": "..." }
    ]
  },
  "errors": null
}

失败示例：

{ "errcode": 500, "errmsg": "<异常信息>", "data": null, "errors": null }

---

2. 获取函数库详情

按函数库Id获取完整函数库对象。

• 接口类型：REST 资源
• 请求方式：GET
• 请求路径：/{applicationId}/macros/{macroId}
• 鉴权：是（需 designerToken）
• Tag：设计时-函数库模块

请求参数

参数名	位置	类型	必填	说明
applicationId	path	string	是	应用Id
macroId	path	string	是	函数库Id

响应

data：RepositoryVO 完整对象。

{ "errcode": 0, "errmsg": "ok", "data": { "id": "...", "name": "...", "content": "<脚本源码>", "description": "...", "...": "..." }, "errors": null }

失败示例：

{ "errcode": 500, "errmsg": "<异常信息>", "data": null, "errors": null }

---

3. 新建函数库

在指定应用下新建函数库。请求体解析为 RepositoryVO 后强制覆盖 applicationid/parentId（均设为 applicationId），id 为空时生成新的设计时序列号；保存前调用 doSaveValidate 校验库名称不重复。HTTP 状态码 201。

• 接口类型：REST 资源
• 请求方式：POST
• 请求路径：/{applicationId}/macros
• 鉴权：是（需 designerToken）
• Tag：设计时-函数库模块

请求参数

参数名	位置	类型	必填	说明
applicationId	path	string	是	应用Id
content	body	string(JSON)	是	函数库对象 JSON

请求体

对应 RepositoryVO 对象 JSON（name、content、description 等）。

{ "name": "<函数库名>", "content": "function foo() { ... }", "description": "..." }

响应

data：JSONObject，仅含 id（新建函数库Id）。

{ "errcode": 0, "errmsg": "ok", "data": { "id": "<函数库Id>" }, "errors": null }

失败示例（库名称重复）：

{ "errcode": 40001, "errmsg": " 库名称重复 ,请重新命名再保存！ ", "data": null, "errors": null }

---

4. 更新函数库

按函数库Id更新函数库。先按 macroId 查询旧对象并克隆，仅应用请求体的 content/name/description 并清空 uri，校验名称不重复后 update。

• 接口类型：REST 资源
• 请求方式：PUT
• 请求路径：/{applicationId}/macros/{macroId}
• 鉴权：是（需 designerToken）
• Tag：设计时-函数库模块

请求参数

参数名	位置	类型	必填	说明
applicationId	path	string	是	应用Id
macroId	path	string	是	函数库Id
content	body	string(JSON)	是	函数库对象 JSON（仅取 content/name/description）

请求体

{ "name": "<函数库名>", "content": "function foo() { ... }", "description": "..." }

响应

data：null（成功）。

{ "errcode": 0, "errmsg": "ok", "data": null, "errors": null }

失败示例（库名称重复）：

{ "errcode": 40001, "errmsg": " 库名称重复 ,请重新命名再保存！ ", "data": null, "errors": null }

---

5. 删除函数库（可批量）

按函数库Id数组批量删除函数库（含路径信息收集）。

• 接口类型：REST 资源
• 请求方式：DELETE
• 请求路径：/{applicationId}/macros
• 鉴权：是（需 designerToken）
• Tag：设计时-函数库模块

请求参数

参数名	位置	类型	必填	说明
applicationId	path	string	是	应用Id
ids	body	string	是	函数库Id字符串数组

请求体

["<macroId1>", "<macroId2>"]

响应

data：String，固定为 "删除成功"。

{ "errcode": 0, "errmsg": "ok", "data": "删除成功", "errors": null }

失败示例：

{ "errcode": 500, "errmsg": "<异常信息>", "data": null, "errors": null }

---