@alanwang-merit/meritdata-platform-skill-package 1.0.0

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

@@ -0,0 +1,245 @@
+---
+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

@@ -0,0 +1,49 @@
+---
+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

@@ -0,0 +1,28 @@
+---
+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@
+```