skwax 发布的文章 - 记录笔记的地方

Swagger 3.0 集成 Pom.xml<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>ecloud-common</artifactId> <groupId>com.ecloud</groupId> <version>1.0.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>ecloud-common-swagger</artifactId> <dependencies> <!-- SpringBoot Web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Swagger 依赖配置 --> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-models</artifactId> <version>$</version> </dependency> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-annotations</artifactId> <version>$</version> </dependency> <!-- Swagger --> <!-- 3.0版本只需要引入一个，不再像2.x版本需要引入两个包 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>$</version> </dependency> </dependencies> </project>Swagger 配置类package com.ecloud.common.swagger.config; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.http.HttpMethod; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox.documentation.builders.RequestHandlerSelectors; import springfox.documentation.service.*; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spi.service.contexts.SecurityContext; import springfox.documentation.spring.web.plugins.Docket; import java.util.*; /** * swagger 配置 * * @Author Skwax * @Date 2021/07/23 8:53 * @Version 1.0 */ @Configuration public class SwaggerConfig { @Value("$") private Boolean enable; @Bean public Docket api() { return new Docket(DocumentationType.OAS_30) //资源 .globalResponses(HttpMethod.GET, new ArrayList<>()) .globalResponses(HttpMethod.PUT, new ArrayList<>()) .globalResponses(HttpMethod.POST, new ArrayList<>()) .globalResponses(HttpMethod.DELETE, new ArrayList<>()) //是否启动 .enable(enable) //头部信息 .apiInfo(apiInfo()) .select() /** * RequestHandlerSelectors,配置要扫描接口的方式 * basePackage指定要扫描的包 * any()扫描所有，项目中的所有接口都会被扫描到 * none()不扫描 * withClassAnnotation()扫描类上的注解 * withMethodAnnotation()扫描方法上的注解 */ .apis(RequestHandlerSelectors.any()) //过滤某个路径 .paths(PathSelectors.any()) .build() //协议 .protocols(newHashSet("https", "http")) .securitySchemes(securitySchemes()) .securityContexts(securityContexts()); } /** * API 页面上半部分展示信息 */ private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("接口文档") .description("@author etiersoft") .contact(new Contact("etiersoft", null, "etiersoft@etiersoft.com")) .version("1.0") .build(); } /** * 设置接口单独的授权信息 */ private List<SecurityScheme> securitySchemes() { return Collections.singletonList(new ApiKey("access_token", "access_token", "header")); } /** * 授权信息全局应用 */ private List<SecurityContext> securityContexts() { return Collections.singletonList( SecurityContext.builder() .securityReferences( Collections.singletonList(new SecurityReference("access_token", new AuthorizationScope[] ))) //.forPaths(PathSelectors.any()) .build() ); } @SafeVarargs private final <T> Set<T> newHashSet(T... ts) { if (ts.length > 0) { return new LinkedHashSet<>(Arrays.asList(ts)); } return null; } } spring.factories org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.ecloud.common.swagger.config.SwaggerConfig

SkyWalking 链路追踪 复制 192.168.2.9 上 /home/etier/skywalking 内 agent 目录至微服务运行服务器​在微服务 运行启动时 加入参数埋点需要时指定 Skywalking Server 地址java -javaagent:/home/etier/skywalking/agent/skywalking-agent.jar -Dskywalking.agent.service_name=yourappname -Dskywalking.collector.backend_service=192.168.2.9:11800 -jar yourappname.jaridea如何使用配置vm参数idea配置vm参数图：​-javaagent:D:/agent/skywalking-agent.jar-Dskywalking.agent.service_name=ecloud-test-Dskywalking.collector.backend_service=192.168.2.9:11800

Dubbo 服务间通信 pom.xml <!-- SpringCloud Alibaba Dubbo --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-dubbo</artifactId> </dependency> <!-- 公有的dubbo接口 引入公共API模块 --> <dependency> <groupId>ssssss</groupId> <artifactId>ecloud-base-api</artifactId> <version>$</version> </dependency>参考 https://www.cnblogs.com/babycomeon/p/11546737.html新版本 的 @Reference 替换为 org.apache.dubbo.config.annotation.DubboReference @DubboReference新版本 的 @Service 替换为 org.apache.dubbo.config.annotation.DubboService @DubboService项目配置：dubbo: protocol: name: dubbo port: -1 registry: address: spring-cloud://192.168.2.9:8848

分布式定时任务 xxl-job​文档 https://www.xuxueli.com/xxl-job/​docker 部署调度中心admin-ui: http://192.168.2.9:8083/xxl-job-admin​依靠数据库锁来实现分布式的任务调度，不重复，所以要求连接主库​配置部署“执行器项目”引用 ecloud-common-job参考 ecloud-job-executorJobHander 示例package com.xxl.job.executor.service.jobhandler; import com.xxl.job.core.context.XxlJobHelper; import com.xxl.job.core.handler.annotation.XxlJob; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Component; import java.io.BufferedInputStream; import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import java.util.Arrays; import java.util.concurrent.TimeUnit; /** * XxlJob开发示例（Bean模式） * * 开发步骤： * 1、任务开发：在Spring Bean实例中，开发Job方法； * 2、注解配置：为Job方法添加注解 "@XxlJob(value="自定义jobhandler名称", init = "JobHandler初始化方法", destroy = "JobHandler销毁方法")"，注解value值对应的是调度中心新建任务的JobHandler属性的值。 * 3、执行日志：需要通过 "XxlJobHelper.log" 打印执行日志； * 4、任务结果：默认任务结果为 "成功" 状态，不需要主动设置；如有诉求，比如设置任务结果为失败，可以通过 "XxlJobHelper.handleFail/handleSuccess" 自主设置任务结果； * * @author xuxueli 2019-12-11 21:52:51 */ @Component public class SampleXxlJob { private static Logger logger = LoggerFactory.getLogger(SampleXxlJob.class); /** * 1、简单任务示例（Bean模式） */ @XxlJob("demoJobHandler") public void demoJobHandler() throws Exception { XxlJobHelper.log("XXL-JOB, Hello World."); for (int i = 0; i < 5; i++) { XxlJobHelper.log("beat at:" + i); TimeUnit.SECONDS.sleep(2); } // default success } /** * 2、分片广播任务 */ @XxlJob("shardingJobHandler") public void shardingJobHandler() throws Exception { // 分片参数 int shardIndex = XxlJobHelper.getShardIndex(); int shardTotal = XxlJobHelper.getShardTotal(); XxlJobHelper.log("分片参数：当前分片序号 = , 总分片数 = ", shardIndex, shardTotal); // 业务逻辑 for (int i = 0; i < shardTotal; i++) { if (i == shardIndex) { XxlJobHelper.log("第 片, 命中分片开始处理", i); } else { XxlJobHelper.log("第 片, 忽略", i); } } } /** * 3、命令行任务 */ @XxlJob("commandJobHandler") public void commandJobHandler() throws Exception { String command = XxlJobHelper.getJobParam(); int exitValue = -1; BufferedReader bufferedReader = null; try { // command process ProcessBuilder processBuilder = new ProcessBuilder(); processBuilder.command(command); processBuilder.redirectErrorStream(true); Process process = processBuilder.start(); //Process process = Runtime.getRuntime().exec(command); BufferedInputStream bufferedInputStream = new BufferedInputStream(process.getInputStream()); bufferedReader = new BufferedReader(new InputStreamReader(bufferedInputStream)); // command log String line; while ((line = bufferedReader.readLine()) != null) { XxlJobHelper.log(line); } // command exit process.waitFor(); exitValue = process.exitValue(); } catch (Exception e) { XxlJobHelper.log(e); } finally { if (bufferedReader != null) { bufferedReader.close(); } } if (exitValue == 0) { // default success } else { XxlJobHelper.handleFail("command exit value("+exitValue+") is failed"); } } /** * 4、跨平台Http任务 * 参数示例： * "url: http://www.baidu.com\n" + * "method: get\n" + * "data: content\n"; */ @XxlJob("httpJobHandler") public void httpJobHandler() throws Exception { // param parse String param = XxlJobHelper.getJobParam(); if (param==null || param.trim().length()==0) { XxlJobHelper.log("param["+ param +"] invalid."); XxlJobHelper.handleFail(); return; } String[] httpParams = param.split("\n"); String url = null; String method = null; String data = null; for (String httpParam: httpParams) { if (httpParam.startsWith("url:")) { url = httpParam.substring(httpParam.indexOf("url:") + 4).trim(); } if (httpParam.startsWith("method:")) { method = httpParam.substring(httpParam.indexOf("method:") + 7).trim().toUpperCase(); } if (httpParam.startsWith("data:")) { data = httpParam.substring(httpParam.indexOf("data:") + 5).trim(); } } // param valid if (url==null || url.trim().length()==0) { XxlJobHelper.log("url["+ url +"] invalid."); XxlJobHelper.handleFail(); return; } if (method==null || !Arrays.asList("GET", "POST").contains(method)) { XxlJobHelper.log("method["+ method +"] invalid."); XxlJobHelper.handleFail(); return; } boolean isPostMethod = method.equals("POST"); // request HttpURLConnection connection = null; BufferedReader bufferedReader = null; try { // connection URL realUrl = new URL(url); connection = (HttpURLConnection) realUrl.openConnection(); // connection setting connection.setRequestMethod(method); connection.setDoOutput(isPostMethod); connection.setDoInput(true); connection.setUseCaches(false); connection.setReadTimeout(5 * 1000); connection.setConnectTimeout(3 * 1000); connection.setRequestProperty("connection", "Keep-Alive"); connection.setRequestProperty("Content-Type", "application/json;charset=UTF-8"); connection.setRequestProperty("Accept-Charset", "application/json;charset=UTF-8"); // do connection connection.connect(); // data if (isPostMethod && data!=null && data.trim().length()>0) { DataOutputStream dataOutputStream = new DataOutputStream(connection.getOutputStream()); dataOutputStream.write(data.getBytes("UTF-8")); dataOutputStream.flush(); dataOutputStream.close(); } // valid StatusCode int statusCode = connection.getResponseCode(); if (statusCode != 200) { throw new RuntimeException("Http Request StatusCode(" + statusCode + ") Invalid."); } // result bufferedReader = new BufferedReader(new InputStreamReader(connection.getInputStream(), "UTF-8")); StringBuilder result = new StringBuilder(); String line; while ((line = bufferedReader.readLine()) != null) { result.append(line); } String responseMsg = result.toString(); XxlJobHelper.log(responseMsg); return; } catch (Exception e) { XxlJobHelper.log(e); XxlJobHelper.handleFail(); return; } finally { try { if (bufferedReader != null) { bufferedReader.close(); } if (connection != null) { connection.disconnect(); } } catch (Exception e2) { XxlJobHelper.log(e2); } } } /** * 5、生命周期任务示例：任务初始化与销毁时，支持自定义相关逻辑； */ @XxlJob(value = "demoJobHandler2", init = "init", destroy = "destroy") public void demoJobHandler2() throws Exception { XxlJobHelper.log("XXL-JOB, Hello World."); } public void init(){ logger.info("init"); } public void destroy(){ logger.info("destory"); } }

向Spring Boot Admin 注册客户端 pom文件引入client的起步依赖和web的起步依赖 <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-starter-client</artifactId> <version>2.1.0</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>在工程的配置文件application.yml中配置应用名和端口信息，以及向server注册的地址为http://localhost:8800，最后暴露自己的actuator的所有端口信息spring: application: name: client boot: admin: client: url: http://192.168.2.9:8800 instance: service-url: http://192.168.2.9:$ server: port: 8768 management: endpoints: web: exposure: include: '*' endpoint: health: show-details: ALWAYS启动 server 和 client 后在 server 内查看信息