zero-ai 0.3.25

package/src/cab/plugin/Component.java.tpl

@@ -0,0 +1,52 @@
+package #PACKAGE#.component;
+
+import cn.originx.optic.advanced.AbstractHBatch;
+import #PACKAGE#.input.#ALIAS#In;
+import io.vertx.up.commune.config.Database;
+import io.vertx.up.commune.config.Integration;
+import io.vertx.up.commune.exchange.DictFabric;
+import io.vertx.up.util.Ut;
+
+public abstract class Abstract#ALIAS#Component extends AbstractHBatch {
+
+    protected #ALIAS#In input() {
+        final #ALIAS#In in = null;   // 创建 input 组件专用
+        Ut.contract(in, Database.class, this.database());
+        Ut.contract(in, Integration.class, this.integration());
+        final DictFabric fabric = this.fabric.createCopy(this.mapping().child());
+        Ut.contract(in, DictFabric.class, fabric);
+        return in;
+    }
+    /*
+     *  构造 Atomy 对象
+     * @Override
+     * public Future<Atomy> transferIn(final ActIn request) {
+     *     final JsonObject criteria = new JsonObject();
+     *     // 构造查询条件
+     *     return this.dao().fetchAsync(criteria).compose(Ux::futureA)
+     *                      // 构造新旧数据
+     *                      // original - 旧数据
+     *                      // normalized - 新数据
+     *                      // ADD -> Atomy.create(new JsonArray(), original);    旧 Empty, 新 Data
+     *                      // UPDATE -> Atomy.create(original, normalized);      旧 Data,  新 Data
+     *                      // DELETE -> Atomy.create(original, new JsonArray()); 旧 Data,  新 Empty
+     *                      .compose(original -> Ux.future(Atomy.create(new JsonArray(), original)))
+     * }
+     *
+     * @Override
+     * public Future<JsonArray> transferAsync(final Atomy atomy, final ActIn request,
+     *                                        final DataAtom atom) {
+     *      // Atomy.create(旧，新)
+     *      // atomy.add(),             对比后新增数据
+     *      // atomy.update(),          对比后更新数据
+     *      // atomy.current(),         对比前新数据
+     *      // atomy.original(),        对比前旧数据
+     *      //
+     *      // 更新 - #ALIAS#Io.ci(ChangeFlag.UPDATE, atom)::pushAsync)
+     *      // 添加 - #ALIAS#Io.ci(ChangeFlag.ADD, atom)::pushAsync)
+     *      // 删除 - #ALIAS#Io.ci(ChangeFlag.DELETE, atom)::pushAsync)
+     *      return ....;
+     * }
+     *
+     */
+}

package/src/cab/plugin/Cv.java.tpl

@@ -0,0 +1,21 @@
+package #PACKAGE#.cv;
+
+public interface #ALIAS#Cv {
+
+    String CONFIG_FOLDER = "plugin/#MODULE#/";
+
+    String INTEGRATION_FILE = CONFIG_FOLDER + "integration.json";
+
+    String CONFIGURATION_FILE = CONFIG_FOLDER + "configuration.json";
+
+    // CMDB 专用数据文件
+    // String MAPPING_FILE = CONFIG_FOLDER + "cmdb-v2/mapping/ci.device.json";
+
+    interface Web {
+    }
+
+    interface Mock {
+        // mock数据文件目录
+        // data/mock/demo.json
+    }
+}

package/src/cab/plugin/ErrorIo.java.tpl

@@ -0,0 +1,26 @@
+package #PACKAGE#.error;
+
+import io.vertx.core.http.HttpStatusCode;
+import io.vertx.up.exception.WebException;
+
+public class _501#ALIAS#IoNullException extends WebException {
+    public _501#ALIAS#IoNullException(final Class<?> clazz,
+                                      final String type) {
+        super(clazz, type);
+    }
+
+    @Override
+    public int getCode() {
+        /*
+         * 必须在 vertx-error.yml 文件中定义该值
+         * 1）值小于0
+         * 2）必须是小于 -100000 的值
+         */
+        return -1;
+    }
+
+    @Override
+    public HttpStatusCode getStatus() {
+        return HttpStatusCode.NOT_IMPLEMENTED;
+    }
+}

package/src/cab/plugin/In.Abstract.java.tpl

@@ -0,0 +1,30 @@
+package #PACKAGE#.input;
+
+import io.vertx.core.Future;
+import io.vertx.core.json.JsonArray;
+import io.vertx.up.commune.config.Integration;
+import io.vertx.up.uca.cosmic.AbstractWebClient;
+import io.vertx.up.uca.cosmic.security.WebToken;
+import io.vertx.up.unity.Ux;
+
+public abstract class Abstract#ALIAS#In extends AbstractWebClient implements #ALIAS#In {
+
+    public Abstract#ALIAS#In(final Integration integration) {
+        super(integration);
+    }
+
+    @Override
+    public WebToken token() {
+        return null;
+    }
+
+    @Override
+    public Future<JsonArray> readyAsync(final JsonArray input) {
+        return Ux.future(input);
+    }
+
+    @Override
+    public Future<JsonArray> fetchAsync() {
+        return this.fetchAsync(null);
+    }
+}

package/src/cab/plugin/In.java.tpl

@@ -0,0 +1,25 @@
+package #PACKAGE#.input;
+
+import io.vertx.core.Future;
+import io.vertx.core.json.JsonArray;
+import io.vertx.core.json.JsonObject;
+
+/*
+ * 数据读取专用接口
+ */
+public interface #ALIAS#In {
+
+    /*
+     * 预处理数据专用接口
+     */
+    Future<JsonArray> readyAsync(JsonArray input);
+
+    /*
+     * 读取所有信息
+     */
+    Future<JsonArray> fetchAsync();
+
+    Future<JsonArray> fetchAsync(JsonObject params);
+
+    Future<JsonObject> oneAsync(JsonObject params);
+}

package/src/cab/plugin/Io.Abstract.java.tpl

@@ -0,0 +1,36 @@
+package #PACKAGE#.output;
+
+import #PACKAGE#.refine.#ALIAS#;
+import io.vertx.core.Future;
+import io.vertx.core.json.JsonArray;
+import io.vertx.tp.atom.modeling.data.DataAtom;
+import io.vertx.up.uca.cosmic.AbstractWebClient;
+import io.vertx.up.uca.cosmic.security.WebToken;
+import io.vertx.up.unity.Ux;
+
+public abstract class Abstract#ALIAS#Io extends AbstractWebClient implements #ALIAS#Io {
+    protected final transient DataAtom atom;
+
+    public Abstract#ALIAS#Io(final DataAtom atom) {
+        super(#ALIAS#.integration());
+        this.atom = atom;
+    }
+
+    @Override
+    public WebToken token() {
+        /*
+         * BasicToken 专用
+         * 头部执行：
+         * import io.vertx.up.uca.cosmic.security.BasicToken;
+         *
+         * 实现部分：
+         * return new BasicToken(this.integration);
+         */
+        return null;
+    }
+
+    @Override
+    public Future<JsonArray> pushAsync(final JsonArray input) {
+        return Ux.thenCombine(input, this::pushAsync);
+    }
+}

package/src/cab/plugin/Io.Impl.java.tpl

@@ -0,0 +1,21 @@
+package #PACKAGE#.output;
+
+import io.vertx.core.Future;
+import io.vertx.core.json.JsonObject;
+import io.vertx.tp.atom.modeling.data.DataAtom;
+import io.vertx.up.unity.Ux;
+
+/*
+ * 添加推送
+ */
+class #ALIAS#Io#OP# extends Abstract#ALIAS#Io {
+
+    public #ALIAS#Io#OP#(final DataAtom atom) {
+        super(atom);
+    }
+
+    @Override
+    public Future<JsonObject> pushAsync(final JsonObject input) {
+        return Ux.futureJ();
+    }
+}

package/src/cab/plugin/Io.java.tpl

@@ -0,0 +1,73 @@
+package #PACKAGE#.output;
+
+import #PACKAGE#.error._501#ALIAS#IoNullException;
+import io.vertx.core.Future;
+import io.vertx.core.json.JsonArray;
+import io.vertx.core.json.JsonObject;
+import io.vertx.tp.atom.modeling.data.DataAtom;
+import io.vertx.up.eon.em.ChangeFlag;
+import io.vertx.up.fn.Fn;
+
+import java.util.Objects;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+import java.util.function.Function;
+
+/*
+ * 推送专用接口，执行推送的
+ * ADD：添加
+ * UPDATE：更新
+ * DELETE：删除
+ */
+public interface #ALIAS#Io {
+
+    /*
+     * 专用实例化 #ALIAS#Io 专用方法，其他实现类是包域
+     * 执行双重检查
+     * 1. 第一个池是：ChangeFlag = Supplier
+     * 2. 第二个池是：identifier = #ALIAS#Io（每种模型一个）
+     */
+    @SuppressWarnings("all")
+    static #ALIAS#Io io(final ChangeFlag type, final DataAtom atom) {
+        final Function<DataAtom, #ALIAS#Io> executor = Pool.IO_POOL_SUPPLIER.get(type);
+        Fn.out(Objects.isNull(executor), _501#ALIAS#IoNullException.class, #ALIAS#Io.class, "Io");
+        final ConcurrentMap<String, #ALIAS#Io> pool = Pool.IO_POOL.get(type);
+        if (Objects.isNull(pool)) {
+            return executor.apply(atom);
+        } else {
+            final String identifier = atom.identifier();
+            return Fn.pool(pool, identifier, () -> executor.apply(atom));
+        }
+    }
+
+    /*
+     * 单量推送主逻辑
+     */
+    Future<JsonObject> pushAsync(JsonObject input);
+
+    /**
+     * 批量推送主逻辑
+     * 内部调用单量执行专用接口
+     */
+    Future<JsonArray> pushAsync(JsonArray input);
+}
+
+
+interface Pool {
+
+    ConcurrentMap<ChangeFlag, ConcurrentHashMap<String, #ALIAS#Io>> IO_POOL = new ConcurrentHashMap<ChangeFlag, ConcurrentHashMap<String, #ALIAS#Io>>() {
+        {
+            this.put(ChangeFlag.ADD, new ConcurrentHashMap<>());
+            this.put(ChangeFlag.UPDATE, new ConcurrentHashMap<>());
+            this.put(ChangeFlag.DELETE, new ConcurrentHashMap<>());
+        }
+    };
+
+    ConcurrentMap<ChangeFlag, Function<DataAtom, #ALIAS#Io>> IO_POOL_SUPPLIER = new ConcurrentHashMap<ChangeFlag, Function<DataAtom, #ALIAS#Io>>() {
+        {
+            this.put(ChangeFlag.ADD, #ALIAS#IoAdd::new);
+            this.put(ChangeFlag.UPDATE, #ALIAS#IoUpdate::new);
+            this.put(ChangeFlag.DELETE, #ALIAS#IoDelete::new);
+        }
+    };
+}

package/src/cab/plugin/Plugin.After.java.tpl

@@ -0,0 +1,22 @@
+package #PACKAGE#.plugin;
+
+import cn.originx.scaffold.plugin.AbstractAfter;
+
+public abstract class Abstract#ALIAS#After extends AbstractAfter {
+    /*
+     *   this.atom: 和当前模型相关的 DataAtom 对象
+     *   this.fabric：和当前通道直接绑定的字典翻译器
+     *   this.logger(): 当前日志器
+     *
+     *   public Future<JsonObject> afterAsync(JsonObject record, JsonObject options){
+     *      // Before 后置插件（单记录）
+     *      // options 对应 ServiceConfig 中配置的Json配置数据
+     *   }
+     *
+     *
+     *   public Future<JsonArray> afterAsync(JsonArray records, JsonObject options){
+     *      // Before 后置插件（批量记录）
+     *      // options 对应 ServiceConfig 中配置的Json配置数据
+     *   }
+     */
+}

package/src/cab/plugin/Plugin.Before.java.tpl

@@ -0,0 +1,22 @@
+package #PACKAGE#.plugin;
+
+import cn.originx.scaffold.plugin.AbstractBefore;
+
+public abstract class Abstract#ALIAS#Before extends AbstractBefore {
+    /*
+     *   this.atom: 和当前模型相关的 DataAtom 对象
+     *   this.fabric：和当前通道直接绑定的字典翻译器
+     *   this.logger(): 当前日志器
+     *
+     *   public Future<JsonObject> beforeAsync(JsonObject record, JsonObject options){
+     *      // Before 前置插件（单记录）
+     *      // options 对应 ServiceConfig 中配置的Json配置数据
+     *   }
+     *
+     *
+     *   public Future<JsonArray> beforeAsync(JsonArray records, JsonObject options){
+     *      // Before 前置插件（批量记录）
+     *      // options 对应 ServiceConfig 中配置的Json配置数据
+     *   }
+     */
+}

package/src/cab/plugin/Refine.Log.java.tpl

@@ -0,0 +1,47 @@
+package #PACKAGE#.refine;
+
+import io.vertx.up.log.Annal;
+
+class #ALIAS#Log {
+    private static void info(final Annal logger,
+                             final String flag, final String pattern, final Object... args) {
+        logger.info("[ #LOG_UP# ] ( " + flag + " ) " + pattern, args);
+    }
+
+    private static void warn(final Annal logger,
+                             final String flag, final String pattern, final Object... args) {
+        logger.warn("[ #LOG_UP# ] ( " + flag + " ) " + pattern, args);
+    }
+
+    static void infoInit(final Annal logger, final String pattern, final Object... args) {
+        info(logger, "初始化", pattern, args);
+    }
+
+    static void infoCode(final Annal logger, final String pattern, final Object... args) {
+        info(logger, "执行", pattern, args);
+    }
+
+    static void infoApi(final Annal logger, final String pattern, final Object... args) {
+        info(logger, "Api访问", pattern, args);
+    }
+
+    static void infoJob(final Annal logger, final String pattern, final Object... args) {
+        info(logger, "任务执行", pattern, args);
+    }
+
+    static void warnInit(final Annal logger, final String pattern, final Object... args) {
+        warn(logger, "初始化", pattern, args);
+    }
+
+    static void warnCode(final Annal logger, final String pattern, final Object... args) {
+        warn(logger, "执行", pattern, args);
+    }
+
+    static void warnApi(final Annal logger, final String pattern, final Object... args) {
+        warn(logger, "Api访问", pattern, args);
+    }
+
+    static void warnJob(final Annal logger, final String pattern, final Object... args) {
+        warn(logger, "任务执行", pattern, args);
+    }
+}

package/src/cab/plugin/Refine.Pin.java.tpl

@@ -0,0 +1,70 @@
+package #PACKAGE#.refine;
+
+import #PACKAGE#.cv.PbCv;
+import io.vertx.core.json.JsonObject;
+import io.vertx.up.commune.config.Integration;
+import io.vertx.up.log.Annal;
+import io.vertx.up.util.Ut;
+
+import java.util.Objects;
+
+class #ALIAS#Pin {
+
+    private static final Annal LOGGER = Annal.get(#ALIAS#Pin.class);
+    private static final JsonObject CONFIGURATION = new JsonObject();
+    private static Integration INTEGRATION;
+
+    static {
+        /*
+         * 默认：resources/plugin/#MODULE#/integration.json
+         * 开发：resources/plugin/#MODULE#/integration-dev.json
+         * 生产：resources/plugin/#MODULE#/integration-home.json
+         */
+        final JsonObject config = Ut.ioJObject(#ALIAS#Cv.INTEGRATION_FILE);
+        if (Objects.nonNull(config)) {
+            #ALIAS#Log.infoInit(LOGGER, "读取 #LOG_UP# 集成配置：\n{0}", config.encodePrettily());
+            INTEGRATION = new Integration();
+            INTEGRATION.fromJson(config);
+        }
+
+        /*
+         * resources/plugin/#MODULE#/configuration.json
+         */
+        final JsonObject configuration = Ut.ioJObject(#ALIAS#Cv.CONFIGURATION_FILE);
+        if (Ut.notNil(configuration)) {
+            CONFIGURATION.mergeIn(configuration, true);
+            #ALIAS#Log.infoInit(LOGGER, "读取 #LOG_UP# 核心配置：\n{0}", configuration.encodePrettily());
+        }
+    }
+
+    /*
+     * 数据结构
+     {
+         "endpoint": "集成专用 EndPoint",
+         "port": "数值，端口号",
+         "hostname": "主机地址，或IP",
+         "username": "账号",
+         "password": "密码",
+         "apis": {
+             "接口1-键": {
+                 "path": "接口1-路径",
+                 "method": "HTTP方法"
+             },
+             "接口2-键": {
+                 "path": "接口2-路径",
+                 "method": "HTTP方法"
+             }
+         },
+         "options": {
+             "debug": "布尔值，是否打开调试模式"
+         }
+     }
+     */
+    static Integration integration() {
+        return INTEGRATION;
+    }
+
+    static JsonObject configuration() {
+        return CONFIGURATION;
+    }
+}

package/src/cab/plugin/Refine.java.tpl

@@ -0,0 +1,67 @@
+package #PACKAGE#.refine;
+
+import io.vertx.core.json.JsonObject;
+import io.vertx.up.commune.config.Integration;
+import io.vertx.up.log.Annal;
+
+public class #ALIAS# {
+    /*
+     * 当前插件使用的日志器
+     * Api：Api组件专用日志
+     * Job：任务组件专用日志
+     * Code：普通代码执行专用日志
+     * Init：初始化流程专用日志
+     */
+    public static class Log {
+        // Level = INFO级
+        public static void infoApi(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.infoApi(logger, pattern, args);
+        }
+
+        public static void infoJob(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.infoJob(logger, pattern, args);
+        }
+
+        public static void infoCode(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.infoCode(logger, pattern, args);
+        }
+
+        public static void infoInit(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.infoInit(logger, pattern, args);
+        }
+        // Level = WARN级
+        public static void warnApi(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.warnApi(logger, pattern, args);
+        }
+
+        public static void warnJob(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.warnJob(logger, pattern, args);
+        }
+
+        public static void warnCode(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.warnCode(logger, pattern, args);
+        }
+
+        public static void warnInit(final Class<?> clazz, final String pattern, final Object... args) {
+            final Annal logger = Annal.get(clazz);
+            #ALIAS#Log.warnInit(logger, pattern, args);
+        }
+    }
+
+    // 集成信息
+    public static Integration integration() {
+        return #ALIAS#Pin.integration();
+    }
+
+    // 配置信息
+    public static JsonObject configuration() {
+        return #ALIAS#Pin.configuration();
+    }
+}

package/src/cab/plugin/configuration.json.tpl

@@ -0,0 +1,3 @@
+{
+
+}

package/src/cab/plugin/infix.xml.tpl

@@ -0,0 +1,22 @@
+<included>
+    <appender name="#LOG_UP#" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FOLDER}/ox-plugin/plugin-#LOG_L#.log</fileNamePattern>
+            <maxHistory>${LOG_MAX_HISTORY}</maxHistory>
+        </rollingPolicy>
+        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
+            <Pattern>${LOG_PATTERN}</Pattern>
+        </encoder>
+        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
+            <MaxFileSize>${LOG_MAX_FILE_SIZE}</MaxFileSize>
+        </triggeringPolicy>
+    </appender>
+    <appender name="ASYNC_#LOG_UP#" class="ch.qos.logback.classic.AsyncAppender">
+        <discardingThreshold>0</discardingThreshold>
+        <queueSize>512</queueSize>
+        <appender-ref ref="#LOG_UP#"/>
+    </appender>
+    <logger name="cn.originx.#LOG_L#" level="INFO">
+        <appender-ref ref="ASYNC_#LOG_UP#"/>
+    </logger>
+</included>

package/src/cab/plugin/integration.json.tpl

@@ -0,0 +1,20 @@
+{
+    "endpoint": "",
+    "port": 0,
+    "hostname": "",
+    "username": "",
+    "password": "",
+    "apis": {
+        "apiGet": {
+            "path": "/api/path",
+            "method": "GET"
+        },
+        "apiPost": {
+            "path": "/api/path",
+            "method": "POST"
+        }
+    },
+    "options": {
+        "debug": true
+    }
+}

package/src/cab/resource/resource.json

@@ -0,0 +1,8 @@
+{
+    "phase": "AFTER",
+    "data": {
+        "type": "RECORD",
+        "viewId": "`${viewId}`",
+        "identifier": "x.integration"
+    }
+}

package/src/commander/ai.zero

@@ -0,0 +1,10 @@
+A;
+command,    executor,       description,                                option1,option2, option3, option4
+uuid,       executeUuid,    生成UUID的值，可直接拷贝,                      n=「20」生成的数量
+csv,        executeCsv,     将JsonArray数据转换成csv,                     p=输入数据文件路径, c=配置文件路径, s=分割符
+uk,         executeUk,      检查数据文件中的Data数据是否符合唯一值规范,       p=输入数据文件路径, f=需要检查的字段名
+data,       executeData,    根据配置文件生成数据,                          c=配置文件路径, o=「.」输出文件基本路径, j=「false」是否Array, n=「23」如果是Array则生效
+key,        executeKey,     为数据模板添加key属性（UUID格式）,              p=输入数据文件路径, f=「key」标识key的字段名
+init,       executeInit,    初始化Zero Ui工程,                           n=项目名称（必须填写，最终写入package.json）
+str,        executeString,  生成随机字符串，可直接拷贝,                     n=「1」生成的数量, l=「64」长度信息（默认64）
+md5,        executeMD5,     加密字符串，可直接拷贝,                        i=输入字符串

package/src/commander/aj.zero

@@ -0,0 +1,8 @@
+A;
+command,    executor,           description,                            option1,option2, option3, option4
+perm,       javaPermission,     用于生成Excel的权限数据,                    r=角色ID,i=输入的额外目录,o=输出路径
+rs,         javaResource,       用于生成Excel的资源定义和默认权限,           c=配置文件路径,o=输出路径
+plugin,     javaPlugin,         用于初始化第三方集成模块专用,                c=配置文件路径,m=模块名称,p=工作路径
+mod,        javaMod,            执行模块化专用初始化命令,                   p=输入路径（initialize.json）路径,e=扩展名过滤,w=替换模式
+init,       javaInit,           初始化Zero Api工程,                       n=项目名称（必须填写，最终写入pom.xml）
+bundle,     javaBundle,         初始化OSGI Bundle工程,                    p=输入路径，若无则取当前路径

package/src/commander/ar.zero

@@ -0,0 +1,4 @@
+A;
+command,    executor,           description,                            option1,option2, option3, option4
+complex,    reactComplex,       完整模块生成`ExListXxx`模块,               c=配置文件路径
+form,       reactForm,          完整生成表单`ExForm`专用,                  c=配置文件路径,u=表单文件名

package/src/commander/option.zero

@@ -0,0 +1,21 @@
+P;
+f=field
+d=data
+p=path
+c=config
+j=json
+n=number
+o=out
+k=key
+u=ui
+t=target
+s=separator
+m=module
+a=all
+y=yes
+v=value
+r=role
+i=input
+l=length
+e=extension
+w=write