SuperAPI AI 工具集

jarchi-scripting

编程与开发

查看项目

更新于 10-16 08:16

技能介绍

用途

jarchi-scripting 用于在用户需要编写 JArchi 脚本、创建 Archi 脚本、构建 .ajs 脚本、为脚本添加对话框或使用 SWT 时提供指导。资料定位为一份“编写 JArchi 脚本的过程化指南”,运行环境为 GraalVM GraalJS(ECMAScript 2024),要求 Archi 5.7+、JArchi 1.11+。

主要能力与约束

该技能明确了脚本运行环境的约束(明确说明不是 Node.js):

  • 本地文件使用 load() 加载,绝不使用 require()(require() 会解析到 node_modules/)。
  • 无 Web Workers、无异步 I/O、无 setTimeout(除非做了 shim)。
  • 不使用 Node.js 模块(fs、path、http),改用 Java.type() 获取 Java 等价实现。
  • Java.extend() 中的 this 指向 Java 代理,需使用其给出的对象包装模式。

使用方式

资料给出了若干代码结构约定:

  1. 创建脚本:每个顶层 .ajs 脚本应包含清空控制台、加载 log.js、IIFE、try-catch 以及 "use strict",并给出了带 @name、@description、@version、@author、@lastModifiedDate 注释头的模板;.ajs 文件名建议使用带空格的首字母大写形式(如 ELK Layout.ajs);DIR 已包含尾部路径分隔符,不要再加 /。
  2. 创建库模块:在 lib/ 中使用带双重加载保护的双重导出 IIFE 模式,并可将模块挂载到 globalThis 与 module.exports;加载时使用 load(DIR + "lib/myModule.js") 后从全局解构。
  3. 处理模型:获取活动视图应使用 resolveSelection(资料明确不建议使用 $(selection).filter("archimate-diagram-model")),并给出 resolveSelection.activeView() 与 resolveSelection.selectedConcepts("element") 的用法;查询元素使用 $("business-process"),创建元素使用 model.createElement("business-process", "Name"),创建关系使用 model.createRelationship("serving-relationship", source, target);需对空名称做判空处理。
  4. 构建对话框:使用 swtImports.ExtendedTitleAreaDialog 与对象包装模式,必须同时重写 isResizable 和 getShellStyle(仅重写 isResizable 会失败),并在 open() 前调用 setHelpAvailable(false);资料还给出 window.prompt、window.confirm、window.alert 用于简单提示。

适用场景

适用于在 Archi 中进行 JArchi 脚本开发的场景,包括编写 .ajs 脚本、构建可复用库模块、查询与创建 ArchiMate 模型元素与关系、以及通过 SWT 构建脚本对话框等。

限制与关键陷阱

资料列出了若干关键陷阱:Java.super(this) 会失败,应通过保存的对象属性使用 Java.super(myDialog.dialog);本地文件用 require() 会失败,应使用 load();原始的 $(selection) 会遗漏情况,应使用 resolveSelection 的对应方法;不可调整大小的对话框需同时重写 isResizable() 与 getShellStyle();出现帮助按钮需在 open() 前调用 dialog.setHelpAvailable(false);元素名可能为空需判空;避免直接使用 console.log,应使用 lib/log.js 中的 log.header/info/detail/success/warn/error;未释放的资源应使用 try/finally 处理 Color、Font、Image;避免路径分隔符重复。

参考资料

资料提及以下参考文件:references/script-development-guide.md(完整指南,含对话框模式、模型操作、控件参考与迁移清单)、references/jarchi-api-reference.md(JArchi 1.11 API:集合方法、元素类型、视图操作)、references/graaljs-compatibility.md(GraalJS 运行时:ECMAScript 2024 特性、load() 语义)、references/java-interop.md(Java.type()、Java.extend()、Java.super()、类型映射、数组转换)。关于收费、价格、平台与具体使用效果,资料暂未提供。