@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.12

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20207_/345/257/271/345/244/226/350/260/203/345/272/246/344/273/273/345/212/241_API_/346/216/245/345/217/243.md

@@ -1,245 +0,0 @@
----
-name: 攻略-10-定时调度-章节07_对外调度任务_API_接口
-description: 对外调度任务 API 接口 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 对外调度任务 API 接口]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-source-section: 5. 对外调度任务 API 接口
-source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 5. 对外调度任务 API 接口
-
-```java
-/**
-* 获取任务信息
-*/
-@RequestMapping(value = "/jobinfo/get", method = RequestMethod.POST)
-ReturnT<CloudJobInfo> getJob(@RequestParam(name = "id") int id);
-
-/**
-* 获取任务信息列表
-*/
- @RequestMapping(value = "/jobinfo/pageList", method = RequestMethod.POST)
- Map<String, Object>  pageList(@RequestParam(name = "param") Map param);
-
-/**
-* 执行调度任务
-*/
-@RequestMapping(value = "/jobinfo/trigger", method = RequestMethod.POST)
-ReturnT<String> triggerJob(@RequestParam(name = "id") int id,
-                               @RequestParam(name = "executorParam", required = false) String executorParam);
-
-/**
-* 启动调度任务
-*@Param id 任务Id
-*/
- @RequestMapping(value = "/jobinfo/start", method = RequestMethod.POST)
- ReturnT<String> startJob(@RequestParam(name = "id") int id);
-
-/**
-* 停止调度任务
-*@Param id 任务Id
-*/
-@RequestMapping(value = "/jobinfo/stop", method = RequestMethod.POST)
-ReturnT<String> stopJob(@RequestParam(name = "id") int id);
-
-/**
-* 新增调度任务
-*/
-@RequestMapping(value = "/jobinfo/add", method = RequestMethod.POST)
-ReturnT<String> add(@SpringQueryMap CloudJobInfo jobInfo);
-
-/**
-* 更新调度任务
-*/
-@RequestMapping(value = "/jobinfo/update", method = RequestMethod.POST)
-ReturnT<String> update(@SpringQueryMap CloudJobInfo jobInfo);
-
-/**
-* 删除调度任务
-*@Param id 任务Id
-*/
- @RequestMapping(value = "/jobinfo/remove", method = RequestMethod.POST)
- ReturnT<String> remove(@RequestParam(name = "id") int id);
-
-/**
-* 根据应用名获取执行器
-*@Param appName 应用名
-*/
-@RequestMapping(value = "/jobgroup/getByAppName", method = RequestMethod.POST)
-CloudJobGroup getByAppName(@RequestParam(name = "appName") String appName);
-
-/**
-* 根据执行器名称获取job信息
-*/
-@RequestMapping(value = "/jobinfo/getHandler", method = RequestMethod.POST)
-ReturnT<CloudJobInfo> getHandler(@RequestParam(name = "handlerName") String handlerName);
-```
-
-```java
-import com.meritdata.cloud.job.api.IJobApi;
-import com.meritdata.cloud.job.model.CloudJobInfo;
-import com.xxl.job.core.biz.model.ReturnT;
-import com.xxl.job.core.handler.IJobHandler;
-import com.xxl.job.core.handler.annotation.JobHandler;
-
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Component;
-
-import java.util.HashMap;
-import java.util.Map;
-
-/**
- 任务 Handler 示例（Bean 模式）
- 开发步骤：
- 1、继承"IJobHandler"：“com.xxl.job.core.handler.IJobHandler”；
- 2、注册到 Spring 容器：添加“@Component”注解，被 Spring 容器扫描为 Bean 实例；
- 3、注册到执行器工厂：添加“@JobHandler(value="自定义 jobhandler 名称")”注解，注解 value 值对应的是调度中心新建任务的 JobHandler 属性的值。
- 4、执行日志：需要通过 "XxlJobLogger.log" 打印执行日志；
- */
-@Component(value="demoJobHandler")
-@JobHandler(value="demoJobHandler")
-public class HelloWorldJob extends IJobHandler {
-
-    @Autowired
-    IJobApi webServerJobService;
-
-    /**
-    *   调用新增: param(1.动作，2.执行器Id，3.调度任务名称，4.路由策略，
-    *   5.运行模式，6.cron表达式，7.jobHandler名称，8.阻塞处理策略，9.负责人，10.任务周期类型，11.任务类型) 
-    *   create,1,测试新增,FIRST,BEAN,0 1/1 * * * ?,
-    *   helloWorldHandler,SERIAL_EXECUTION,张三
-    *
-    *   调用更新param（1.动作，2.Id，3.执行器Id，4.调度任务名称，5.路由策略，
-    *   6.运行模式，7.cron表达式，8.jobHandler名称，9.阻塞处理策略，10.负责人，11.任务周期类型，12.任务类型）
-    *   update,22,1,测试新增,FIRST,BEAN,0 1/1 * * * ?,
-    *   helloWorldHandler,SERIAL_EXECUTION,张三
-    *
-    *   调用启动任务param(1.动作，2.Id) start,22
-    *
-    *   调用停止任务param(1.动作，2.Id) stop,22
-    *
-    *   调用执行任务param(1.动作，2.Id) trigger,22
-    *
-    *   调用删除任务param(1.动作，2.Id) delete,22
-    *
-    */
-    @Override
-    public ReturnT<String> execute(String param) throws Exception {
-        String [] paramArr = param.split(",");
-        String type = paramArr[0];
-        Map map = new HashMap<>();
-        CloudJobInfo cloudJobInfo = new CloudJobInfo();
-        switch (type){
-            case "create" :
-
-                cloudJobInfo.setJobGroup(Integer.parseInt(paramArr[1]));
-                cloudJobInfo.setJobDesc(paramArr[2]);
-                cloudJobInfo.setExecutorRouteStrategy(paramArr[3]);
-                cloudJobInfo.setGlueType(paramArr[4]);
-                cloudJobInfo.setJobCron(paramArr[5]);
-
-                cloudJobInfo.setExecutorHandler(paramArr[6]);
-                cloudJobInfo.setExecutorBlockStrategy(paramArr[7]);
-                cloudJobInfo.setAuthor(paramArr[8]);
-                //任务的周期类型：{"7:年任务", "6:季度任务", "5:月任务", "4:周任务", "3:天任务", "2:小时任务", "1:分钟任务", "0:秒任务"}
-                cloudJobInfo.setPeroid(paramArr[9]);
-                //任务创建的产品类型
-                cloudJobInfo.setType(paramArr[10]);
-                webServerJobService.add(cloudJobInfo);
-                break;
-            case "update" :
-                cloudJobInfo.setId(Integer.parseInt(paramArr[1]));
-                cloudJobInfo.setJobGroup(Integer.parseInt(paramArr[2]));
-                cloudJobInfo.setJobDesc(paramArr[3]);
-                cloudJobInfo.setExecutorRouteStrategy(paramArr[4]);
-                cloudJobInfo.setGlueType(paramArr[5]);
-                cloudJobInfo.setJobCron(paramArr[6]);
-
-                cloudJobInfo.setExecutorHandler(paramArr[7]);
-                cloudJobInfo.setExecutorBlockStrategy(paramArr[8]);
-                cloudJobInfo.setAuthor(paramArr[9]);
-                //任务的周期类型：{"7:年任务", "6:季度任务", "5:月任务", "4:周任务", "3:天任务", "2:小时任务", "1:分钟任务", "0:秒任务"}
-                cloudJobInfo.setPeroid(paramArr[10]);
-                //任务创建的产品类型
-                cloudJobInfo.setType(paramArr[11]);
-                webServerJobService.update(cloudJobInfo);
-                break;
-            case "start" :
-                map.put("id",paramArr[1]);
-                webServerJobService.startJob(Integer.parseInt(paramArr[1]));
-                break;
-            case "stop" :
-                map.put("id",paramArr[1]);
-                webServerJobService.stopJob(Integer.parseInt(paramArr[1]));
-                break;
-            case "trigger":
-                map.put("id",paramArr[1]);
-                webServerJobService.triggerJob(Integer.parseInt(paramArr[1]),"");
-                break;
-            case "delete":
-                map.put("id",paramArr[1]);
-                webServerJobService.remove(Integer.parseInt(paramArr[1]));
-                break;
-            default:
-        }
-        return SUCCESS;
-    }
-}
-```
-
-
-
-## 附录 A. https 方式的执行器注册
-
-- 获取执行器微服务中的服务名，参考样例如下图：
-  ![image](/imgs/定时调度任务/2-3.png)
-
-- 在 nacos 中，新增配置文件 common.properties，参考样例如下图：
-
-  ```shell
-  #前端工程部署的ip和端口号 如果前端工程也是集群模式 此处配置为系统的入口的ip和端口号 单机默认和后端的服务器一致
-  meritdata.cloud.web-server=http://${meritdata.cloud.server.ip}:8080
-  #调用gateway的ip和端口号 用于服务之间的互相调用（跳过nginx）
-  meritdata.cloud.web-server-gateway=http://${meritdata.cloud.server.ip}:8081
-  ```
-
-  ![image](/imgs/定时调度任务/2-2.png)
-
-- 修改执行器微服务中的配置文件，参考样例如下图：
-  ![image](/imgs/定时调度任务/2-1.png)
-
-- 重启执行器微服务
-
-
-## 附录 1. cron表达式
-  - 结构：从左到右： 秒  分  时  日  月  周   年
-
-  - 各字段含义：
-
-      | 字段               | 允许值                         | 允许特殊字符                                     |
-      | ------------------ | ------------------------------ | ------------------------------------------------ |
-      | 秒（second）       | 0~59的整数                     | ,    -    *    /   四个字符                      |
-      | 分（minute）       | 0~59的整数                     | ,    -    *    /   四个字符                      |
-      | 时（hour）         | 0~59的整数                     | ,    -    *    /   四个字符                      |
-      | 日（dayOfMonth）   | 1~31的整数（需要考虑月的天数） | ,    -    *    /    ?    L    W    C   八个字符  |
-      | 月（month）        | 1~12的整数                     | ,    -    *    /   四个字符                      |
-      | 周（weekOfMonth）  | 1~7的整数  或者 SUN~SAT(1=SUN) | ,    -    *    /    ?    L    C    #    八个字符 |
-      | 年（year）可以不填 | 1970~2099                      | ,    -    *    /   四个字符                      |
-
-  - 特殊字符含义：
-      - *: 表示匹配该域的任意值，加入在minute域中使用，表示每分钟都会触发事件。
-      - ?: 智能用在dayOfMonth和dayOfWeek两个域。它也匹配域的任意值，但实际不会。因为dayOfMonth和dayOfWeek会互相影响。例如想在每月的20日触发调度任务，不管20日是星期几，则只能用如下写法：13 13 15 20 * ?,其中最后一位只能用? ,而不能使用*，如果使用*表示不管在星期几都会触发，并不是我们想要的效果。
-      - -: 表示范围，例如在minute域中使用5-20，表示从5分钟到20分钟，每分钟执行一次。
-      - /: 表示起始时间开始触发，然后每隔固定时间触发一次。例如在minute域中使用5/20，则意味着每5分钟触发一次，而25，45等分钟分别触发一次。
-      - ,: 表示列举出枚举值，例如：在minute域中使用5,20 则表示在5和20分钟各触发一次。
-      - L: 表示最后，只能出现在dayOfMonth和dayOfWeek域。如果在dayOfWeek域使用5L,意味着在最后一个的星期四触发。
-      - W: 表示有效工作日（周一到周五），只能出现在dayOfMonth域，系统将在离指定日期的最近的有效工作日触发。例如：在dayOfMonth使用5W，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在6日（周一）触发。如果5日在星期一到星期五中的某一天，则就在5日触发。另外一点，W的最近寻找不会跨月。
-      - LW: 这两个字符可以连用，表示在某个月的最后一个工作日，即最后一个星期五。
-      - #: 用于确定每个月第几个星期几，只能出现在dayOfMonth，例如在4#2，表示某月的第二个星期三。
-  - 常用表达式：
-
-      - 0  0  2  1   * ？ *  每月1日 凌晨2点 执行
-      - 0 15 10 ？* MON-FRI  周一到周五 10点15分  执行
-      - 0  0  10,14,16  * * ? 每天10点 14点  16点 执行
-      - 0 0/5 14,18  *  *  ?  每天下午2点到2点55，下午6点到6点55 每五分钟执行一次

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-11-/351/205/215/347/275/256/351/241/271-00_/346/200/273/350/247/210.md

@@ -1,49 +0,0 @@
----
-name: 攻略-11-配置项-00_总览
-description: 美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
-keywords: [配置项, nacos, 命名空间, common.properties, datasource, cache, gateway, cas, bpm, 多租户]
-use-cases: [nacos 配置查询, 配置项修改, 新增配置, 配置项文件说明]
-related: [nacos_config_export / cloud-service-common]
-source: 应用开发平台-基础平台-使用攻略（二）：系统配置项管理.md
----
-
-# 应用开发平台使用攻略（二）：系统配置项管理 — 总览
-
-**摘要**：美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
-
-**关联**：nacos_config_export / cloud-service-common
-
-## 章节索引
-
-01. [应用配置项相关](攻略-11-配置项-章节01_应用配置项相关.md) (原 1)
-02. [配置中心配置项说明](攻略-11-配置项-章节02_配置中心配置项说明.md) (原 2)
-03. [配置项的使用](攻略-11-配置项-章节03_配置项的使用.md) (原 3)
-
-## 引言
-
-系统配置项交由统一的配置中心(Nacos)进行管理，在程序启动时，从配置中心中根据应用配置文件配置获取相关配置项后进行启动。
-
-
-## 📑 API 速查
-
-本攻略共 **1 个 API**（按章节排序）：
-
-| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
-|------|------|------|----------|------|------|
-| 章节03_配置项的使用 | `MeritdataCloudProperties` | - | `class MeritdataCloudProperties` | class | 配置实体类（@ConfigurationProperties 绑定） |
-
-### JSON Schema 完整索引
-
-```json
-[
-  {
-    "chapter": "章节03_配置项的使用",
-    "apiName": "MeritdataCloudProperties",
-    "method": "",
-    "urlPattern": "",
-    "type": "class",
-    "signature": "class MeritdataCloudProperties",
-    "functionDesc": "配置实体类（@ConfigurationProperties 绑定）"
-  }
-]
-```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-11-/351/205/215/347/275/256/351/241/271-/347/253/240/350/212/20201_/345/272/224/347/224/250/351/205/215/347/275/256/351/241/271/347/233/270/345/205/263.md

@@ -1,28 +0,0 @@
----
-name: 攻略-11-配置项-章节01_应用配置项相关
-description: 应用配置项相关 — 美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
-keywords: [配置项, nacos, 命名空间, common.properties, datasource, cache, gateway, cas, bpm, 多租户, 应用配置项相关]
-use-cases: [nacos 配置查询, 配置项修改, 新增配置, 配置项文件说明]
-source-section: 1. 应用配置项相关
-source-file: 应用开发平台-基础平台-使用攻略（二）：系统配置项管理.md
----
-
-# 1 应用配置项相关
-
-配置中心的地址配置在应用的 bootstrap.properties 中
-
-```properties
-#nacos的启动地址，在nacos的启动日志中查看
-meritdata.cloud.nacos-addr=127.0.0.1:8848
-spring.cloud.nacos.config.server-addr=${meritdata.cloud.nacos-addr}
-spring.cloud.nacos.discovery.server-addr=${meritdata.cloud.nacos-addr}
-#程序加载的配置文件
-spring.profiles.include=server,cache,freemarker,datasource,sentinel,cloud-system-cas,oauth2,cloud-system-job,@project.artifactId@
-#服务启动的时候会读取 prefix.properties 和 prefix-profiles.properties 文件下的配置项
-spring.cloud.nacos.config.prefix=common
-#nacos的配置的命名空间，默认为空
-#在nacos中配置命名空间后，此处的配置值是namespace的id值
-spring.cloud.nacos.config.namespace=
-#系统的程序名，在创建工程的时候确定，挂载到nacos中的名称
-spring.application.name=@project.artifactId@
-```