From d4ad93508b94fe883b4116fa88c62e2f45732dbc Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Tue, 3 Sep 2024 18:17:37 +0800
Subject: [PATCH 1/6] feat(master):Hystrix1
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

后备1 + 合并
---
 .../NetflixHystrix.md                         |   4 +-
 .../dev-protocol-springcloud-hystrix/pom.xml  |  21 +++
 .../example/controller/HystrixController.java | 153 ++++++++++++++++++
 .../NacosClientBatchCommand.java              |  50 ++++++
 .../NacosClientCollapseCommand.java           |  85 ++++++++++
 .../AuthorityFeignClientHystrixDemo.java      |  30 ++++
 .../NacosClientService4HystrixDemo.java       |  47 ++++++
 .../bak/AuthorityFeignClientFallback.java     |  21 +++
 .../AuthorityFeignClientFallbackFactory.java  |  27 ++++
 9 files changed, 436 insertions(+), 2 deletions(-)
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientBatchCommand.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientCollapseCommand.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallback.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallbackFactory.java

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
index ff18d86..11924a2 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
@@ -33,10 +33,10 @@
 
 
 ### 编程方式应用 Hystrix 请求合并
-
+- 
 
 ### 注解方式应用 Hystrix 请求合并
-
+- 使用注解的方式比较多
 ### OpenFeign 集成 Hystrix 开启后备模式
 
 
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pom.xml b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pom.xml
index 3c5d3cb..deb2130 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pom.xml
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pom.xml
@@ -49,6 +49,27 @@
             <artifactId>fastjson</artifactId>
             <version>1.2.51</version>
         </dependency>
+
+        <!-- openfeign -->
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-micrometer</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+        </dependency>
+        <!-- feign 替换 JDK 默认的 URLConnection 为 okhttp -->
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-okhttp</artifactId>
+        </dependency>
+        <!-- 使用原生的 Feign Api 做的自定义配置, encoder 和 decoder -->
+        <dependency>
+            <groupId>io.github.openfeign</groupId>
+            <artifactId>feign-gson</artifactId>
+            <version>12.1</version>
+        </dependency>
     </dependencies>
 
     <!--
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/controller/HystrixController.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/controller/HystrixController.java
index 9f70d11..1f88dea 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/controller/HystrixController.java
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/controller/HystrixController.java
@@ -5,6 +5,7 @@ import lombok.extern.slf4j.Slf4j;
 import org.example.hystrix.NacosClientHystrixCommand;
 import org.example.hystrix.NacosClientHystrixObservableCommand;
 import org.example.hystrix.UseHystrixCommandAnnotation;
+import org.example.hystrix.request_merge.NacosClientCollapseCommand;
 import org.example.service.NacosClientService4HystrixDemo;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.cloud.client.ServiceInstance;
@@ -129,4 +130,156 @@ public class HystrixController {
                 JSON.toJSONString(result), Thread.currentThread().getName());
         return result.get(0); // 取一个返回
     }
+
+    /*@GetMapping("/cache-hystrix-command")
+    public void cacheHystrixCommand(@RequestParam String serviceId) {
+
+        // 使用缓存 Command, 发起两次请求
+        CacheHystrixCommand command1 = new CacheHystrixCommand(
+                nacosClientService, serviceId
+        );
+        CacheHystrixCommand command2 = new CacheHystrixCommand(
+                nacosClientService, serviceId
+        );
+
+        List<ServiceInstance> result01 = command1.execute();
+        List<ServiceInstance> result02 = command2.execute();
+        log.info("result01, result02: [{}], [{}]",
+                JSON.toJSONString(result01), JSON.toJSONString(result02));
+
+        // 清除缓存
+        CacheHystrixCommand.flushRequestCache(serviceId);
+
+        // 使用缓存 Command, 发起两次请求
+        CacheHystrixCommand command3 = new CacheHystrixCommand(
+                nacosClientService, serviceId
+        );
+        CacheHystrixCommand command4 = new CacheHystrixCommand(
+                nacosClientService, serviceId
+        );
+
+        List<ServiceInstance> result03 = command3.execute();
+        List<ServiceInstance> result04 = command4.execute();
+        log.info("result03, result04: [{}], [{}]",
+                JSON.toJSONString(result03), JSON.toJSONString(result04));
+    }
+
+    @GetMapping("/cache-annotation-01")
+    public List<ServiceInstance> useCacheByAnnotation01(@RequestParam String serviceId) {
+
+        log.info("use cache by annotation01(controller) to get nacos client info: [{}]",
+                serviceId);
+
+        List<ServiceInstance> result01 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation01(serviceId);
+        List<ServiceInstance> result02 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation01(serviceId);
+
+        // 清除掉缓存
+        cacheHystrixCommandAnnotation.flushCacheByAnnotation01(serviceId);
+
+        List<ServiceInstance> result03 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation01(serviceId);
+        // 这里有第四次调用
+        return cacheHystrixCommandAnnotation.useCacheByAnnotation01(serviceId);
+    }
+
+    @GetMapping("/cache-annotation-02")
+    public List<ServiceInstance> useCacheByAnnotation02(@RequestParam String serviceId) {
+
+        log.info("use cache by annotation02(controller) to get nacos client info: [{}]",
+                serviceId);
+
+        List<ServiceInstance> result01 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation02(serviceId);
+        List<ServiceInstance> result02 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation02(serviceId);
+
+        // 清除掉缓存
+        cacheHystrixCommandAnnotation.flushCacheByAnnotation02(serviceId);
+
+        List<ServiceInstance> result03 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation02(serviceId);
+        // 这里有第四次调用
+        return cacheHystrixCommandAnnotation.useCacheByAnnotation02(serviceId);
+    }
+
+    @GetMapping("/cache-annotation-03")
+    public List<ServiceInstance> useCacheByAnnotation03(@RequestParam String serviceId) {
+
+        log.info("use cache by annotation03(controller) to get nacos client info: [{}]",
+                serviceId);
+
+        List<ServiceInstance> result01 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation03(serviceId);
+        List<ServiceInstance> result02 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation03(serviceId);
+
+        // 清除掉缓存
+        cacheHystrixCommandAnnotation.flushCacheByAnnotation03(serviceId);
+
+        List<ServiceInstance> result03 =
+                cacheHystrixCommandAnnotation.useCacheByAnnotation03(serviceId);
+        // 这里有第四次调用
+        return cacheHystrixCommandAnnotation.useCacheByAnnotation03(serviceId);
+    }*/
+
+    /**
+     * <h2>编程方式实现请求合并</h2>
+     * */
+    @GetMapping("/request-merge")
+    public void requestMerge() throws Exception {
+
+        // 前三个请求会被合并
+        NacosClientCollapseCommand collapseCommand01 = new NacosClientCollapseCommand(
+                nacosClientService4HystrixDemo, "dev-protocol-springcloud-hystrix1");
+        NacosClientCollapseCommand collapseCommand02 = new NacosClientCollapseCommand(
+                nacosClientService4HystrixDemo, "dev-protocol-springcloud-hystrix2");
+        NacosClientCollapseCommand collapseCommand03 = new NacosClientCollapseCommand(
+                nacosClientService4HystrixDemo, "dev-protocol-springcloud-hystrix3");
+
+        Future<List<ServiceInstance>> future01 = collapseCommand01.queue();
+        Future<List<ServiceInstance>> future02 = collapseCommand02.queue();
+        Future<List<ServiceInstance>> future03 = collapseCommand03.queue();
+
+        future01.get();
+        future02.get();
+        future03.get();
+
+        Thread.sleep(2000);
+
+        // 过了合并的时间窗口, 第四个请求单独发起
+        NacosClientCollapseCommand collapseCommand04 = new NacosClientCollapseCommand(
+                nacosClientService4HystrixDemo, "dev-protocol-springcloud-hystrix4");
+        Future<List<ServiceInstance>> future04 = collapseCommand04.queue();
+        future04.get();
+    }
+
+    /**
+     * <h2>注解的方式实现请求合并</h2>
+     * */
+    @GetMapping("/request-merge-annotation")
+    public void requestMergeAnnotation() throws Exception {
+
+        Future<List<ServiceInstance>> future01 = nacosClientService4HystrixDemo.findNacosClientInfo(
+                "dev-protocol-springcloud-hystrix1"
+        );
+        Future<List<ServiceInstance>> future02 = nacosClientService4HystrixDemo.findNacosClientInfo(
+                "dev-protocol-springcloud-hystrix2"
+        );
+        Future<List<ServiceInstance>> future03 = nacosClientService4HystrixDemo.findNacosClientInfo(
+                "dev-protocol-springcloud-hystrix3"
+        );
+
+        future01.get();
+        future02.get();
+        future03.get();
+
+        Thread.sleep(2000);
+
+        Future<List<ServiceInstance>> future04 = nacosClientService4HystrixDemo.findNacosClientInfo(
+                "dev-protocol-springcloud-hystrix4"
+        );
+        future04.get();
+    }
 }
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientBatchCommand.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientBatchCommand.java
new file mode 100644
index 0000000..4711766
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientBatchCommand.java
@@ -0,0 +1,50 @@
+package org.example.hystrix.request_merge;
+
+import com.alibaba.fastjson.JSON;
+import com.netflix.hystrix.HystrixCommand;
+import com.netflix.hystrix.HystrixCommandGroupKey;
+import lombok.extern.slf4j.Slf4j;
+import org.example.service.NacosClientService4HystrixDemo;
+import org.springframework.cloud.client.ServiceInstance;
+
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * <h1>批量请求 Hystrix Command</h1>
+ * */
+@Slf4j
+public class NacosClientBatchCommand extends HystrixCommand<List<List<ServiceInstance>>> {
+
+    private final NacosClientService4HystrixDemo nacosClientService;
+    private final List<String> serviceIds;
+
+    protected NacosClientBatchCommand(
+            NacosClientService4HystrixDemo nacosClientService, List<String> serviceIds
+    ) {
+
+        super(
+                HystrixCommand.Setter.withGroupKey(
+                        HystrixCommandGroupKey.Factory.asKey("NacosClientBatchCommand")
+                )
+        );
+
+        this.nacosClientService = nacosClientService;
+        this.serviceIds = serviceIds;
+    }
+
+    @Override
+    protected List<List<ServiceInstance>> run() throws Exception {
+
+        log.info("use nacos client batch command to get result: [{}]",
+                JSON.toJSONString(serviceIds));
+        return nacosClientService.getNacosClientInfos(serviceIds);
+    }
+
+    @Override
+    protected List<List<ServiceInstance>> getFallback() {
+
+        log.warn("nacos client batch command failure, use fallback");
+        return Collections.emptyList();
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientCollapseCommand.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientCollapseCommand.java
new file mode 100644
index 0000000..2909803
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/hystrix/request_merge/NacosClientCollapseCommand.java
@@ -0,0 +1,85 @@
+package org.example.hystrix.request_merge;
+
+import com.netflix.hystrix.HystrixCollapser;
+import com.netflix.hystrix.HystrixCollapserKey;
+import com.netflix.hystrix.HystrixCollapserProperties;
+import com.netflix.hystrix.HystrixCommand;
+import lombok.extern.slf4j.Slf4j;
+import org.example.service.NacosClientService4HystrixDemo;
+import org.springframework.cloud.client.ServiceInstance;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * <h1>请求合并器</h1>
+ * */
+@Slf4j
+public class NacosClientCollapseCommand
+        extends HystrixCollapser<List<List<ServiceInstance>>, List<ServiceInstance>, String> {
+    // 批量返回类型, 单个请求对象的返回类型, 请求参数的类型
+
+    private final NacosClientService4HystrixDemo nacosClientService;
+    private final String serviceId;
+
+    public NacosClientCollapseCommand(NacosClientService4HystrixDemo nacosClientService, String serviceId) {
+
+        super(
+                HystrixCollapser.Setter.withCollapserKey(
+                        HystrixCollapserKey.Factory.asKey("NacosClientCollapseCommand")
+                ).andCollapserPropertiesDefaults(
+                        HystrixCollapserProperties.Setter().withTimerDelayInMilliseconds(300) // 等待 300ms 合并请求
+                )
+        );
+
+        this.nacosClientService = nacosClientService;
+        this.serviceId = serviceId;
+    }
+
+    /**
+     * <h2>获取请求中的参数</h2>
+     * */
+    @Override
+    public String getRequestArgument() {
+        return this.serviceId;
+    }
+
+    /**
+     * <h2>创建批量请求 Hystrix Command</h2>
+     * */
+    @Override
+    protected HystrixCommand<List<List<ServiceInstance>>> createCommand(
+            Collection<CollapsedRequest<List<ServiceInstance>, String>> collapsedRequests) {
+
+        List<String> serviceIds = new ArrayList<>(collapsedRequests.size()); // 合并请求的大小就是参数们的大小
+        serviceIds.addAll(
+                collapsedRequests.stream()
+                        .map(CollapsedRequest::getArgument) // 获取每个请求的参数
+                        .collect(Collectors.toList())
+        );
+
+        return new NacosClientBatchCommand(nacosClientService, serviceIds);
+    }
+
+    /**
+     * <h2>响应分发给单独的请求</h2>
+     * */
+    @Override
+    protected void mapResponseToRequests(List<List<ServiceInstance>> batchResponse,
+                                         Collection<CollapsedRequest<List<ServiceInstance>,
+                                                 String>> collapsedRequests) {
+
+        int count = 0;
+
+        for (CollapsedRequest<List<ServiceInstance>, String> collapsedRequest : collapsedRequests) {
+
+            // 从批量响应集合中按顺序取出结果
+            List<ServiceInstance> instances = batchResponse.get(count++);
+            // 将结果返回原 Response 中
+            collapsedRequest.setResponse(instances);
+        }
+    }
+}
+
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
new file mode 100644
index 0000000..63638bb
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
@@ -0,0 +1,30 @@
+package org.example.service;
+
+import org.example.service.hystrix.bak.AuthorityFeignClientFallback;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+/**
+ * <h1>与 Authority 服务通信的 Feign Client 接口定义</h1>
+ * */
+@FeignClient(
+        // contextId 是对 FeignClient 的声明, 每一个进行的通信都要进行定义, value 表示需要进行通信的服务id是什么
+        contextId = "AuthorityFeignClient", value = "e-commerce-authority-center",
+        fallback = AuthorityFeignClientFallback.class
+//        fallbackFactory = AuthorityFeignClientFallbackFactory.class
+)
+public interface AuthorityFeignClientHystrixDemo {
+
+    /**
+     * <h2>通过 OpenFeign 访问 Authority 获取 Token</h2>
+     *
+     * value 只需要定义路径即可, 不需要定义 ip + port
+     * consumes, produces: 标识请求和返回的数据格式, 可以不指定, 但是在使用原生 Api 接口的时候必须要进行指定, 要不会不能进行识别对应的接口
+     * */
+    @RequestMapping(value = "/ecommerce-authority-center/authority/token",
+            method = RequestMethod.POST,
+            consumes = "application/json", produces = "application/json")
+    String getTokenByFeign(@RequestBody String usernameAndPassword);
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/NacosClientService4HystrixDemo.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/NacosClientService4HystrixDemo.java
index 7a58ef7..929ffe4 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/NacosClientService4HystrixDemo.java
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/NacosClientService4HystrixDemo.java
@@ -1,11 +1,17 @@
 package org.example.service;
 
+import com.alibaba.fastjson.JSON;
+import com.netflix.hystrix.contrib.javanica.annotation.HystrixCollapser;
+import com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;
+import com.netflix.hystrix.contrib.javanica.annotation.HystrixProperty;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.cloud.client.ServiceInstance;
 import org.springframework.cloud.client.discovery.DiscoveryClient;
 import org.springframework.stereotype.Service;
 
+import java.util.ArrayList;
 import java.util.List;
+import java.util.concurrent.Future;
 
 @Slf4j
 @Service
@@ -35,4 +41,45 @@ public class NacosClientService4HystrixDemo {
         log.info("request nacos client to get service instance info: [{}]", serviceId);
         return discoveryClient.getInstances(serviceId);
     }
+
+
+    /**
+     * <h2>提供给编程方式的 Hystrix 请求合并</h2>
+     * */
+    public List<List<ServiceInstance>> getNacosClientInfos(List<String> serviceIds) {
+
+        log.info("request nacos client to get service instance infos: [{}]",
+                JSON.toJSONString(serviceIds));
+        List<List<ServiceInstance>> result = new ArrayList<>(serviceIds.size());
+
+        serviceIds.forEach(s -> result.add(discoveryClient.getInstances(s)));
+        return result;
+    }
+
+    /**
+     * <h2>使用注解实现 Hystrix 请求合并</h2>
+     */
+    @HystrixCollapser(
+            batchMethod = "findNacosClientInfos",
+            scope = com.netflix.hystrix.HystrixCollapser.Scope.GLOBAL,
+            collapserProperties = {
+                    // 时间窗口的填充
+                    @HystrixProperty(name = "timerDelayInMilliseconds", value = "300")
+            }
+    )
+    public Future<List<ServiceInstance>> findNacosClientInfo(String serviceId) {
+
+        // 系统运行正常, 不会走这个方法
+        throw new RuntimeException("This method body should not be executed!");
+    }
+
+    /**
+     * 配置在上面的方法上
+     */
+    @HystrixCommand // 使用默认的 GroupKey CommandKey
+    public List<List<ServiceInstance>> findNacosClientInfos(List<String> serviceIds) {
+
+        log.info("coming in find nacos client infos: [{}]", JSON.toJSONString(serviceIds));
+        return getNacosClientInfos(serviceIds);
+    }
 }
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallback.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallback.java
new file mode 100644
index 0000000..4a54552
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallback.java
@@ -0,0 +1,21 @@
+package org.example.service.hystrix.bak;
+
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.example.service.AuthorityFeignClientHystrixDemo;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>AuthorityFeignClient 后备 fallback</h1>
+ * */
+@Slf4j
+@Component
+public class AuthorityFeignClientFallback implements AuthorityFeignClientHystrixDemo {
+    @Override
+    public String getTokenByFeign(String usernameAndPassword) {
+        log.info("authority feign client get token by feign request error " +
+                "(Hystrix Fallback): [{}]", JSON.toJSONString(usernameAndPassword));
+        return "qqqqq";
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallbackFactory.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallbackFactory.java
new file mode 100644
index 0000000..1dfea9a
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/hystrix/bak/AuthorityFeignClientFallbackFactory.java
@@ -0,0 +1,27 @@
+package org.example.service.hystrix.bak;
+
+import feign.hystrix.FallbackFactory;
+import lombok.extern.slf4j.Slf4j;
+import org.example.service.AuthorityFeignClientHystrixDemo;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>OpenFeign 集成 Hystrix 的另一种模式</h1>
+ * */
+@Slf4j
+@Component
+public class AuthorityFeignClientFallbackFactory implements FallbackFactory<AuthorityFeignClientHystrixDemo> {
+    @Override
+    public AuthorityFeignClientHystrixDemo create(Throwable throwable) {
+
+        log.warn("authority feign client get token by feign request error " +
+                "(Hystrix FallbackFactory): [{}]", throwable.getMessage(), throwable);
+        return new AuthorityFeignClientHystrixDemo() {
+
+            @Override
+            public String getTokenByFeign(String usernameAndPassword) {
+                return "q-factory";
+            }
+        };
+    }
+}

From 9908ba9929eeba61cd1d3ef01bd346d583bd6b82 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Tue, 3 Sep 2024 18:22:04 +0800
Subject: [PATCH 2/6] feat(master):Hystrix1-1
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

补充解释
---
 .../org/example/service/AuthorityFeignClientHystrixDemo.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
index 63638bb..bc684ae 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
@@ -23,7 +23,7 @@ public interface AuthorityFeignClientHystrixDemo {
      * value 只需要定义路径即可, 不需要定义 ip + port
      * consumes, produces: 标识请求和返回的数据格式, 可以不指定, 但是在使用原生 Api 接口的时候必须要进行指定, 要不会不能进行识别对应的接口
      * */
-    @RequestMapping(value = "/ecommerce-authority-center/authority/token",
+    @RequestMapping(value = "/ecommerce-authority-center/authority/token", // fixme ：这里的调用代码是不对的， 仅仅作为 Hystrix 举例使用
             method = RequestMethod.POST,
             consumes = "application/json", produces = "application/json")
     String getTokenByFeign(@RequestBody String usernameAndPassword);

From 78e48da870e2695f1728abab0b7a2df02b02e5ef Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Wed, 4 Sep 2024 14:48:18 +0800
Subject: [PATCH 3/6] feat(master):Hystrix 2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hystrix 完结
---
 .../README.md                                 |   3 +
 .../pom.xml                                   |  69 ++++++++++++++++++
 .../example/HystrixDashboardApplication.java  |  21 ++++++
 .../src/main/resources/bootstrap.yml          |  33 +++++++++
 .../src/main/resources/http/dashboard.http    |  31 ++++++++
 .../NetflixHystrix.md                         |  67 ++++++++++++++---
 .../pic/Hystrix工作流程图.png                 | Bin 0 -> 136126 bytes
 .../AuthorityFeignClientHystrixDemo.java      |   5 +-
 pom.xml                                       |   1 +
 9 files changed, 218 insertions(+), 12 deletions(-)
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/README.md
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/pom.xml
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/java/org/example/HystrixDashboardApplication.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/bootstrap.yml
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/http/dashboard.http
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pic/Hystrix工作流程图.png

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/README.md b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/README.md
new file mode 100644
index 0000000..e63b277
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/README.md
@@ -0,0 +1,3 @@
+## hystrix-dashboard
+
+- hystrix 监控面板
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/pom.xml b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/pom.xml
new file mode 100644
index 0000000..8f02a97
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/pom.xml
@@ -0,0 +1,69 @@
+<?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">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.example</groupId>
+        <artifactId>dev-protocol</artifactId>
+        <version>1.0-SNAPSHOT</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>dev-protocol-springcloud-hystrix-dashboard</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <!-- 模块名及描述信息 -->
+    <name>dev-protocol-springcloud-hystrix-dashboard</name>
+    <description>Hystrix Dashboard</description>
+
+
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <!-- spring cloud alibaba nacos discovery 依赖 -->
+        <dependency>
+            <groupId>com.alibaba.cloud</groupId>
+            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-netflix-hystrix-dashboard</artifactId>
+        </dependency>
+    </dependencies>
+
+    <!--
+        SpringBoot的Maven插件, 能够以Maven的方式为应用提供SpringBoot的支持，可以将
+        SpringBoot应用打包为可执行的jar或war文件, 然后以通常的方式运行SpringBoot应用
+     -->
+    <build>
+        <finalName>${artifactId}</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/java/org/example/HystrixDashboardApplication.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/java/org/example/HystrixDashboardApplication.java
new file mode 100644
index 0000000..ce530dc
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/java/org/example/HystrixDashboardApplication.java
@@ -0,0 +1,21 @@
+package org.example;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
+import org.springframework.cloud.netflix.hystrix.dashboard.EnableHystrixDashboard;
+
+/**
+ * <h1>hystrix dashboard 入口</h1>
+ * 控制台页面 http://127.0.0.1:9999/dev-protocol-springcloud-hystrix-dashboard/hystrix/
+ * 需要监控的服务 stream 拼接: http://127.0.0.1:8111/dev-protocol-springcloud-hystrix/actuator/hystrix.stream
+ * */
+@EnableDiscoveryClient
+@SpringBootApplication
+@EnableHystrixDashboard     // 开启 Hystrix Dashboard
+public class HystrixDashboardApplication {
+    public static void main(String[] args) {
+
+        SpringApplication.run(HystrixDashboardApplication.class, args);
+    }
+}
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/bootstrap.yml b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/bootstrap.yml
new file mode 100644
index 0000000..976837d
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/bootstrap.yml
@@ -0,0 +1,33 @@
+server:
+  port: 9999
+  servlet:
+    context-path: /dev-protocol-springcloud-hystrix-dashboard
+
+spring:
+  application:
+    name: dev-protocol-springcloud-hystrix-dashboard
+  cloud:
+    nacos:
+      # 服务注册发现
+      discovery:
+        enabled: true # 如果不想使用 Nacos 进行服务注册和发现, 设置为 false 即可
+        server-addr: 127.0.0.1:8848
+        #        server-addr: 127.0.0.1:8848,127.0.0.1:8849,127.0.0.1:8850 # Nacos 服务器地址
+        namespace: 1ccc74ae-9398-4dbe-b9d7-4f9addf9f40c
+        metadata:
+          management:
+            context-path: ${server.servlet.context-path}/actuator
+
+hystrix:
+  dashboard:
+    proxy-stream-allow-list: "127.0.0.1"
+
+# 暴露端点
+management:
+  endpoints:
+    web:
+      exposure:
+        include: '*'
+  endpoint:
+    health:
+      show-details: always
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/http/dashboard.http b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/http/dashboard.http
new file mode 100644
index 0000000..2395cb6
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard/src/main/resources/http/dashboard.http
@@ -0,0 +1,31 @@
+### 获取 Token
+POST http://127.0.0.1:9001/dev-protocol-springcloud-gateway/dev-protocol-springcloud-hystrix/communication/token-by-feign
+Content-Type: application/json
+e-commerce-user: eyJhbGciOiJSUzI1NiJ9.eyJlLWNvbW1lcmNlLXVzZXIiOiJ7XCJpZFwiOjEwLFwidXNlcm5hbWVcIjpcIlFpbnlpQGltb29jLmNvbVwifSIsImp0aSI6IjJlMTgwYzA2LWIwZGQtNDJjYy1iNzk5LTZiNGI4N2Q3NTM3NCIsImV4cCI6MTYyNTQxNDQwMH0.P8gKWcwiibEmq80idCl9QzUaqJnQ7FVQ5yxzlMLfRNcG3nWMYh0o1kBO2vKvDGG8BofQ4__xn210R2P7zjH-uEn7hic0jbBt97vLkzvATnFegxaDSjUp9At9BIGl9Ecu7RPCwSQJFdw6NBMBz02Uom8yvHpUJEfv8_jZRurBp94tzES6IAACKC6NFq-3_mQfT4o_zA51U4hBbIBw6qNXvMSqK-VtaqkTNFfJsP_8Y0nmQck0jxmgdtLfRVfZCCp3rhcLNDBX37THQI6U7lvNFETceAKyJ5NFaA8p68lw_3D2IiZER1jEU3M2QIMQGeU0pmQ6IPwGDdA0MP5IKKzj8A
+token: imooc
+
+{
+  "username": "Qinyi@imooc.com",
+  "password": "25d55ad283aa400af464c76d713c07ad"
+}
+
+
+### 根据提供的 serviceId 获取实例信息
+GET http://127.0.0.1:9001/dev-protocol-springcloud-gateway/ecommerce-nacos-client/hystrix/hystrix-command-annotation?serviceId=e-commerce-nacos-client
+Content-Type: application/json
+e-commerce-user: eyJhbGciOiJSUzI1NiJ9.eyJlLWNvbW1lcmNlLXVzZXIiOiJ7XCJpZFwiOjEwLFwidXNlcm5hbWVcIjpcIlFpbnlpQGltb29jLmNvbVwifSIsImp0aSI6IjJlMTgwYzA2LWIwZGQtNDJjYy1iNzk5LTZiNGI4N2Q3NTM3NCIsImV4cCI6MTYyNTQxNDQwMH0.P8gKWcwiibEmq80idCl9QzUaqJnQ7FVQ5yxzlMLfRNcG3nWMYh0o1kBO2vKvDGG8BofQ4__xn210R2P7zjH-uEn7hic0jbBt97vLkzvATnFegxaDSjUp9At9BIGl9Ecu7RPCwSQJFdw6NBMBz02Uom8yvHpUJEfv8_jZRurBp94tzES6IAACKC6NFq-3_mQfT4o_zA51U4hBbIBw6qNXvMSqK-VtaqkTNFfJsP_8Y0nmQck0jxmgdtLfRVfZCCp3rhcLNDBX37THQI6U7lvNFETceAKyJ5NFaA8p68lw_3D2IiZER1jEU3M2QIMQGeU0pmQ6IPwGDdA0MP5IKKzj8A
+token: imooc
+
+
+### 根据提供的 serviceId 获取实例信息
+GET http://127.0.0.1:9001/dev-protocol-springcloud-gateway/ecommerce-nacos-client/hystrix/simple-hystrix-command?serviceId=e-commerce-nacos-client
+Content-Type: application/json
+e-commerce-user: eyJhbGciOiJSUzI1NiJ9.eyJlLWNvbW1lcmNlLXVzZXIiOiJ7XCJpZFwiOjEwLFwidXNlcm5hbWVcIjpcIlFpbnlpQGltb29jLmNvbVwifSIsImp0aSI6IjJlMTgwYzA2LWIwZGQtNDJjYy1iNzk5LTZiNGI4N2Q3NTM3NCIsImV4cCI6MTYyNTQxNDQwMH0.P8gKWcwiibEmq80idCl9QzUaqJnQ7FVQ5yxzlMLfRNcG3nWMYh0o1kBO2vKvDGG8BofQ4__xn210R2P7zjH-uEn7hic0jbBt97vLkzvATnFegxaDSjUp9At9BIGl9Ecu7RPCwSQJFdw6NBMBz02Uom8yvHpUJEfv8_jZRurBp94tzES6IAACKC6NFq-3_mQfT4o_zA51U4hBbIBw6qNXvMSqK-VtaqkTNFfJsP_8Y0nmQck0jxmgdtLfRVfZCCp3rhcLNDBX37THQI6U7lvNFETceAKyJ5NFaA8p68lw_3D2IiZER1jEU3M2QIMQGeU0pmQ6IPwGDdA0MP5IKKzj8A
+token: imooc
+
+
+### 根据提供的 serviceId 获取实例信息
+GET http://127.0.0.1:9001/dev-protocol-springcloud-gateway/ecommerce-nacos-client/hystrix/hystrix-observable-command?serviceId=e-commerce-nacos-client
+Content-Type: application/json
+e-commerce-user: eyJhbGciOiJSUzI1NiJ9.eyJlLWNvbW1lcmNlLXVzZXIiOiJ7XCJpZFwiOjEwLFwidXNlcm5hbWVcIjpcIlFpbnlpQGltb29jLmNvbVwifSIsImp0aSI6IjJlMTgwYzA2LWIwZGQtNDJjYy1iNzk5LTZiNGI4N2Q3NTM3NCIsImV4cCI6MTYyNTQxNDQwMH0.P8gKWcwiibEmq80idCl9QzUaqJnQ7FVQ5yxzlMLfRNcG3nWMYh0o1kBO2vKvDGG8BofQ4__xn210R2P7zjH-uEn7hic0jbBt97vLkzvATnFegxaDSjUp9At9BIGl9Ecu7RPCwSQJFdw6NBMBz02Uom8yvHpUJEfv8_jZRurBp94tzES6IAACKC6NFq-3_mQfT4o_zA51U4hBbIBw6qNXvMSqK-VtaqkTNFfJsP_8Y0nmQck0jxmgdtLfRVfZCCp3rhcLNDBX37THQI6U7lvNFETceAKyJ5NFaA8p68lw_3D2IiZER1jEU3M2QIMQGeU0pmQ6IPwGDdA0MP5IKKzj8A
+token: imooc
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
index 11924a2..ac687ef 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/NetflixHystrix.md
@@ -21,25 +21,72 @@
   - 请求依赖项失败后，可以选择出错或者是兜底回退
 
 ### 使用注解方式实现服务的容错、降级
-
+---
+- SpringCloud Netflix Hystrix 的三种模式
+  - Hystrix 的断路器模式和后备策略模式
+    - 断路器模式:设置超时或者失败等熔断策略
+    - 后备策略模式:断路器模式触发之后，如果存在后备策略，则执行后备
+    - Hystrix 的舱壁模式：Hystrix 舱壁模式的启发:货船为了进行防止漏水和火灾的扩散，会将货仓分隔为多个当发生灾害时，将所在货仓进行隔离就可以降低整艘船的风险
+      - 舱壁模式功能就是:我们可以通过为各个服务分别指定线程池
+      - 每一个远程资源调用都被放置在自己的线程池中，每一个线程池只有一定数量的线程来处理远程调用
+      - 一个性能低下的服务，只会影响到同一个线程池中的其他服务调用。所以降低了会产生的负面影响
 
 ### 使用编程方式实现服务的容错、降级
 - [NacosClientHystrixCommand.java] - [NacosClientHystrixObservableCommand.java]
 
 ### 编程方式开启 Hystrix 请求缓存
-
+- Hystrix 的结果缓存指的是在一次 Hystrix 的请求上下文中
+- Hystrix 请求缓存的两种实现方式
+  - 编程(继承 HystrixCommand)方式，重写 getCacheKey 方法即可
+  - 注解方式
+    - @CacheResult：该注解用来标记请求命令返回的结果应该被缓存，它必须与@HystrixCommand注解结合使用, 属性: cacheKeyMethod
+    - @CacheRemove: 该注解用来让请求命令的缓存失效，失效的缓存根据commandKey进行查找。属性: commandKey,cacheKeyMethod
+    - @CacheKey: 该注解用来在请求命令的参数上标记，使其作为cacheKey，如果没有使用此注解则会使用所有参数列表中的参数作为cacheKey, 属性: value
 
 ### 注解方式开启 Hystrix 请求缓存
-
-
+-
 ### 编程方式应用 Hystrix 请求合并
-- 
-
+- 默认情况下，每一个请求都会占用一个线程和一次网络请求，高并发场景下效率不高\
+- 使用 Hystrix 的请求合并，将多个请求 merge 为一个，提高服务的并发能力
+---
+- 请求合并的适用场景与注意事项
+  - 适用场景:单个对象的查询并发数很高，服务提供方负载较高，就可以考虑使用请求合并
+  - 注意事项
+    - 请求在代码中人为的设置了延迟时间，会降低请求的响应速度
+    - 可能会提高服务提供方的负载，因为返回 List 结果数据量偏大
+    - 实现请求合并比较复杂
 ### 注解方式应用 Hystrix 请求合并
 - 使用注解的方式比较多
 ### OpenFeign 集成 Hystrix 开启后备模式
-
-
+- OpenFeign 集成 Hystrix 的步骤
+  - 在配置文件中开启 Hystrix 的熔断功能:feign.hystrix.enabled: true
+  - @FeignClient 注解的 fallback 和 fallbackFactory 属性
+    -  fallback 和 fallbackFactory 都是用于配置响应回退，但是不可以同时使用
+    -  fallbackFactory 能够获取到 OpenFeign 调用抛出的异常
 ### 使用 Hystrix 监控面板监测客户端容错
-
-### SpringCloud Netflix Hystrix 容错组件总结
\ No newline at end of file
+- Hystrix Dashboard 是一个单独的应用，用来实时的对 Hystrix 的『使用情况』进行实时的监控
+### SpringCloud Netflix Hystrix 容错组件总结
+- ![Hystrix工作流程图.png](pic/Hystrix工作流程图.png)
+---
+- Hystrix 完整的工作流程
+  - 构造-个 HystrixCommand 或者 HystrixObservableCommand 对象
+    - 表示对一个对依赖项请求的包装
+  - 执行命令获取响应
+    - execute():阻塞，直到收到响应或者抛出异常, 同步执行的, 调用的是 queue().get()
+    - queue():返回一个 Future, 异步执行的, 调用的是 observable.toBlocking().toFuture()
+    - observe():订阅代表响应的 Observable
+    - toObservable():返回一个 Observable,当你订阅它以后，将会执行Hystrix 命令并且推送它的响应
+    - 总结: 最终每一个 HystrixCommand, 都是 Observable 的实现
+  - 响应是否已经被缓存
+    - 如果请求在缓存中的结果是存在的, 该请求在缓存中对应的结果是可用的, 缓存就会立即以一个 Observable 的形式被返回
+  - 断路器是否打开
+    - 缓存不存在的时候, 当你执行命令的时候, Hystrix 检查断路器是否打开, 如果打开, 不会执行任何命令, 执行回退逻辑, 如果是关闭, 检查容量是否可用
+  - 线程池、信号量是否已经使用率 100%
+    - 判断, 线程池和信号量是否已经满了, 如果满了, 不会执行命令, 立马执行回退逻辑
+  - HystrixObservableCommand.construct() or HystrixCommand.run()
+    - 对依赖项的调用请求, 真正的逻辑编写在这里, run 会返回一个响应, 或者抛出一个异常, construct 会返回一个 Observable 对象, 会推送一个响应或者一个 ERROR 通知, 会抛出一个 Timeout 异常
+  - 计算电路健康
+    - Hystrix 报告成功, 失败, 拒绝, 超时给断路器, 断路器会维护一组计算统计的计数器, 断路器会用这些统计数据来决定, 什么时候要跳闸, 后续的所有请求都会被短路, 直到一个恢复周期耗尽以后, 在第一次检查健康检查之后, 才会重新打开电路
+  - 回退或返回成功响应
+    - 一, 当你失败以后, HystrixCommand 会回退一个单一的回退值, HystrixObservableCommand 会返回一个或者多个回退值, 通过 fallback, 当 fallback 有异常也会被进一步抛出, 给调用者发送 ERROR 通知, 命令调用者进行处理
+    - 二, 成功会直接抛出响应给调用者, 返回一个 Observable
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pic/Hystrix工作流程图.png b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/pic/Hystrix工作流程图.png
new file mode 100644
index 0000000000000000000000000000000000000000..639892f81be68555a2d9a611e68d2ec8fbbc2def
GIT binary patch
literal 136126
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%0A@|hVTL&HJjB)!
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
RIf8=xq{S7)s=gZr{vR`?qP+kB

literal 0
HcmV?d00001

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
index bc684ae..02cedd5 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-hystrix/src/main/java/org/example/service/AuthorityFeignClientHystrixDemo.java
@@ -1,6 +1,7 @@
 package org.example.service;
 
 import org.example.service.hystrix.bak.AuthorityFeignClientFallback;
+import org.example.service.hystrix.bak.AuthorityFeignClientFallbackFactory;
 import org.springframework.cloud.openfeign.FeignClient;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -12,8 +13,8 @@ import org.springframework.web.bind.annotation.RequestMethod;
 @FeignClient(
         // contextId 是对 FeignClient 的声明, 每一个进行的通信都要进行定义, value 表示需要进行通信的服务id是什么
         contextId = "AuthorityFeignClient", value = "e-commerce-authority-center",
-        fallback = AuthorityFeignClientFallback.class
-//        fallbackFactory = AuthorityFeignClientFallbackFactory.class
+//        fallback = AuthorityFeignClientFallback.class, // fixme fallback 和 fallbackFactory 只能使用一个
+        fallbackFactory = AuthorityFeignClientFallbackFactory.class
 )
 public interface AuthorityFeignClientHystrixDemo {
 
diff --git a/pom.xml b/pom.xml
index 3d14b7d..d1d50db 100644
--- a/pom.xml
+++ b/pom.xml
@@ -62,6 +62,7 @@
         <module>dev-protocol-springcloud/dev-protocol-springcloud-project-service-sdk</module>
         <module>dev-protocol-springcloud/dev-protocol-springcloud-project-goods-service</module>
         <module>dev-protocol-springcloud/dev-protocol-springcloud-hystrix</module>
+        <module>dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard</module>
     </modules>
 
     <properties>

From d87b716acedba7583d0170c9c1de41ea2fa03e94 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Wed, 4 Sep 2024 16:35:53 +0800
Subject: [PATCH 4/6] =?UTF-8?q?feat(master):=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

文档补充
---
 .../SpringCloud项目介绍.md                    |  3 ++-
 .../SpringCloud-Stream.md                     | 23 +++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md

diff --git a/dev-protocol-springcloud/SpringCloud项目介绍.md b/dev-protocol-springcloud/SpringCloud项目介绍.md
index a48e422..e4af839 100644
--- a/dev-protocol-springcloud/SpringCloud项目介绍.md
+++ b/dev-protocol-springcloud/SpringCloud项目介绍.md
@@ -10,7 +10,8 @@
 - 分布式链路、日志追踪 - (Sleuth + Zipkin)
   - [dev-protocol-springcloud-sleuth-zipkin](dev-protocol-springcloud-sleuth-zipkin)
 - 微服务容错 - (SpringCloud Netflix Hystrix)
-  - todo
+  - [dev-protocol-springcloud-hystrix](dev-protocol-springcloud-hystrix)
+  - [dev-protocol-springcloud-hystrix-dashboard](dev-protocol-springcloud-hystrix-dashboard)
 - 消息驱动微服务 - (SpringCloud Stream)
   - todo
 - 分布式事务 - (SpringCloud Alibaba Seata)
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md b/dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md
new file mode 100644
index 0000000..fd4d062
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md
@@ -0,0 +1,23 @@
+## 基于 SpringCloud Stream 构建消息驱动微服务
+
+
+
+### SpringBoot 集成 Kafka 构建消息驱动微服务
+
+
+### SpringBoot 集成 RocketMQ 构建消息驱动微服务
+
+
+### SpringCloud Stream 消息驱动组件概览
+
+
+### 基于 SpringCloud Stream 消息驱动的简单应用
+
+
+### 自定义 Stream 消息通信信道实现定制分发
+
+
+### SpringCloud Stream 消息分组和消费分区的配置与说明
+
+
+### SpringCloud Stream 消息驱动组件总结

From 02898b00e4ebe88601cde4400ad4bc75b3a8321c Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Thu, 5 Sep 2024 18:04:33 +0800
Subject: [PATCH 5/6] =?UTF-8?q?feat(master):kafka=20=E6=80=BB=E7=BB=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

kafka 的相关代码
---
 .../SpringCloud-Stream.md                     |  4 +-
 .../pom.xml                                   | 99 +++++++++++++++++++
 .../main/java/org/example/Application.java    | 14 +++
 .../example/controller/KafkaController.java   | 41 ++++++++
 .../java/org/example/kafka/KafkaConfig.java   | 81 +++++++++++++++
 .../java/org/example/kafka/KafkaConsumer.java | 56 +++++++++++
 .../java/org/example/kafka/KafkaProducer.java | 77 +++++++++++++++
 .../main/java/org/example/vo/QMessage.java    | 27 +++++
 .../src/main/resources/application-dev.yml    | 49 +++++++++
 .../src/main/resources/bootstrap.yml          | 16 +++
 .../main/resources/http/kafka-controller.http |  7 ++
 .../resources/http/rocket-mq-controller.http  | 15 +++
 .../resources/http/transactional-lose.http    |  7 ++
 pom.xml                                       |  1 +
 14 files changed, 492 insertions(+), 2 deletions(-)
 rename dev-protocol-springcloud/{dev-protocol-springcloud-stream => dev-protocol-springcloud-message-study}/SpringCloud-Stream.md (99%)
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/pom.xml
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/Application.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/KafkaController.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConfig.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConsumer.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaProducer.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/vo/QMessage.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/application-dev.yml
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/bootstrap.yml
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/kafka-controller.http
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/transactional-lose.http

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
similarity index 99%
rename from dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md
rename to dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
index fd4d062..f15be38 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-stream/SpringCloud-Stream.md
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
@@ -3,10 +3,10 @@
 
 
 ### SpringBoot 集成 Kafka 构建消息驱动微服务
-
+-
 
 ### SpringBoot 集成 RocketMQ 构建消息驱动微服务
-
+-
 
 ### SpringCloud Stream 消息驱动组件概览
 
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/pom.xml b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/pom.xml
new file mode 100644
index 0000000..6a62ee6
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/pom.xml
@@ -0,0 +1,99 @@
+<?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">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.example</groupId>
+        <artifactId>dev-protocol</artifactId>
+        <version>1.0-SNAPSHOT</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>dev-protocol-springcloud-message-study</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <name>dev-protocol-springcloud-message-study</name>
+    <description>MQ 学习实践</description>
+
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+        <!-- SpringBoot 监控端点 -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-actuator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <!-- 让 SpringBoot 能够识别 bootstrap.yml -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-context</artifactId>
+            <version>2.2.6.RELEASE</version>
+        </dependency>
+        <!-- Kafka -->
+        <dependency>
+            <groupId>org.springframework.kafka</groupId>
+            <artifactId>spring-kafka</artifactId>
+            <version>2.5.0.RELEASE</version>
+        </dependency>
+        <!-- RocketMQ 这个版本必须和你的 RocketMQ 版本匹配 -->
+        <dependency>
+            <groupId>org.apache.rocketmq</groupId>
+            <artifactId>rocketmq-spring-boot-starter</artifactId>
+            <version>2.1.0</version> <!-- 匹配 4.8.0-->
+        </dependency>
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <version>3.11</version>
+        </dependency>
+        <!-- MySQL 驱动 -->
+        <dependency>
+            <groupId>mysql</groupId>
+            <artifactId>mysql-connector-java</artifactId>
+            <version>8.0.19</version>
+        </dependency>
+        <!-- Spring Data Jpa -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <finalName>${artifactId}</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/Application.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/Application.java
new file mode 100644
index 0000000..5d8dbdc
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/Application.java
@@ -0,0 +1,14 @@
+package org.example;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * <h1>工程启动入口</h1>
+ * */
+@SpringBootApplication
+public class Application {
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+}
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/KafkaController.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/KafkaController.java
new file mode 100644
index 0000000..43daacc
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/KafkaController.java
@@ -0,0 +1,41 @@
+package org.example.controller;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.example.kafka.KafkaProducer;
+import org.example.vo.QMessage;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * <h1>SpringBoot 集成 kafka 发送消息</h1>
+ * */
+@Slf4j
+@RestController
+@RequestMapping("/kafka")
+public class KafkaController {
+
+    private final ObjectMapper mapper;
+    private final KafkaProducer kafkaProducer;
+
+    public KafkaController(ObjectMapper mapper, KafkaProducer kafkaProducer) {
+        this.mapper = mapper;
+        this.kafkaProducer = kafkaProducer;
+    }
+
+    /**
+     * <h2>发送 kafka 消息</h2>
+     * */
+    @GetMapping("/send-message")
+    public void sendMessage(@RequestParam(required = false) String key,
+                            @RequestParam String topic) throws Exception {
+
+        QMessage message = new QMessage(
+                1,
+                "q-Study-Message"
+        );
+        kafkaProducer.sendMessage(key, mapper.writeValueAsString(message), topic);
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConfig.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConfig.java
new file mode 100644
index 0000000..2882d17
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConfig.java
@@ -0,0 +1,81 @@
+package org.example.kafka;
+
+import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.clients.producer.ProducerConfig;
+import org.apache.kafka.common.serialization.StringDeserializer;
+import org.apache.kafka.common.serialization.StringSerializer;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.kafka.config.ConcurrentKafkaListenerContainerFactory;
+import org.springframework.kafka.core.*;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * <h1>通过代码自定义 Kafka 配置</h1>
+ *
+ * 复杂不会怎么更改的配置信息最好以代码的方式进行配置
+ * 一般一些常用的改动的配置, 直接放在配置文件中
+ * */
+@Configuration
+public class KafkaConfig {
+
+    @Value("${spring.kafka.bootstrap-servers}")
+    private String bootstrapServers;
+
+    /**
+     * <h2>Kafka Producer 工厂类配置</h2>
+     * */
+    @Bean
+    public ProducerFactory<String, String> producerFactory() {
+
+        Map<String, Object> configs = new HashMap<>();
+        configs.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, bootstrapServers);
+        configs.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
+        configs.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
+
+        return new DefaultKafkaProducerFactory<>(configs);
+    }
+
+    /**
+     * <h2>Kafka Producer 客户端</h2>
+     * */
+    @Bean
+    public KafkaTemplate<String, String> kafkaTemplate() {
+        return new KafkaTemplate<>(producerFactory());
+    }
+
+    /**
+     * <h2>Kafka Consumer 工厂类配置</h2>
+     * */
+    @Bean
+    public ConsumerFactory<String, String> consumerFactory() {
+
+        Map<String, Object> props = new HashMap<>();
+        props.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, bootstrapServers);
+        // 因为配置为拉取模式, 最多拉取 50条记录
+        props.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, 50);
+        props.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
+        props.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
+
+        return new DefaultKafkaConsumerFactory<>(props);
+    }
+
+    /**
+     * <h2>Kafka Consumer 监听器工厂类配置</h2>
+     * */
+    @Bean
+    public ConcurrentKafkaListenerContainerFactory<String, String>
+    kafkaListenerContainerFactory() {
+
+        ConcurrentKafkaListenerContainerFactory<String, String> factory =
+                new ConcurrentKafkaListenerContainerFactory<>();
+        // 并发数就是一个消费者实例起几个线程
+        factory.setConcurrency(3);
+        factory.setConsumerFactory(consumerFactory());
+
+        return factory;
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConsumer.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConsumer.java
new file mode 100644
index 0000000..1d911ae
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaConsumer.java
@@ -0,0 +1,56 @@
+package org.example.kafka;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.kafka.clients.consumer.ConsumerRecord;
+import org.example.vo.QMessage;
+import org.springframework.kafka.annotation.KafkaListener;
+import org.springframework.stereotype.Component;
+
+import java.util.Optional;
+
+/**
+ * <h1>Kafka 消费者</h1>
+ * */
+@Slf4j
+@Component
+public class KafkaConsumer {
+
+    private final ObjectMapper mapper;
+
+    public KafkaConsumer(ObjectMapper mapper) {
+        this.mapper = mapper;
+    }
+
+    /**
+     * <h2>监听 Kafka 消息并消费</h2>
+     * */
+    @KafkaListener(topics = {"qinyi-springboot"}, groupId = "qinyi-springboot-kafka")
+    public void listener01(ConsumerRecord<String, String> record) throws Exception {
+
+        String key = record.key();
+        String value = record.value();
+
+        QMessage kafkaMessage = mapper.readValue(value, QMessage.class);
+        log.info("in listener01 consume kafka message: [{}], [{}]",
+                key, mapper.writeValueAsString(kafkaMessage));
+    }
+
+    /**
+     * <h2>监听 Kafka 消息并消费</h2>
+     * 不知道发送的类是什么类型的时候发送的
+     * */
+    @KafkaListener(topics = {"qinyi-springboot"}, groupId = "qinyi-springboot-kafka-1")
+    public void listener02(ConsumerRecord<?, ?> record) throws Exception {
+
+        Optional<?> _kafkaMessage = Optional.ofNullable(record.value());
+        if (_kafkaMessage.isPresent()) {
+            Object message = _kafkaMessage.get();
+            // 如果不能确定类型的时候, 下面的代码要进行包装
+            QMessage kafkaMessage = mapper.readValue(message.toString(),
+                    QMessage.class);
+            log.info("in listener02 consume kafka message: [{}]",
+                    mapper.writeValueAsString(kafkaMessage));
+        }
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaProducer.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaProducer.java
new file mode 100644
index 0000000..b63987c
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/kafka/KafkaProducer.java
@@ -0,0 +1,77 @@
+package org.example.kafka;
+
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.StringUtils;
+import org.springframework.kafka.core.KafkaTemplate;
+import org.springframework.kafka.support.SendResult;
+import org.springframework.stereotype.Component;
+import org.springframework.util.concurrent.ListenableFuture;
+
+import java.util.concurrent.TimeUnit;
+
+/**
+ * <h1>kafka 生产者</h1>
+ * */
+@Slf4j
+@Component
+public class KafkaProducer {
+
+    private final KafkaTemplate<String, String> kafkaTemplate;
+
+    public KafkaProducer(KafkaTemplate<String, String> kafkaTemplate) {
+        this.kafkaTemplate = kafkaTemplate;
+    }
+
+    /**
+     * <h2>发送 kafka 消息</h2>
+     * */
+    public void sendMessage(String key, String value, String topic) {
+
+        if (StringUtils.isBlank(value) || StringUtils.isBlank(topic)) {
+            throw new IllegalArgumentException("value or topic is null or empty");
+        }
+
+        ListenableFuture<SendResult<String, String>> future = StringUtils.isBlank(key) ?
+                kafkaTemplate.send(topic, value) : kafkaTemplate.send(topic, key, value);
+
+        // 异步回调的方式获取通知
+        future.addCallback(
+                success -> {
+                    // 元数据信息不为空
+                    assert null != success && null != success.getRecordMetadata();
+                    // 发送到 kafka 的 topic
+                    String _topic = success.getRecordMetadata().topic();
+                    // 消息发送到的分区
+                    int partition = success.getRecordMetadata().partition();
+                    // 消息在分区内的 offset
+                    long offset = success.getRecordMetadata().offset();
+
+                    log.info("send kafka message success: [{}], [{}], [{}]",
+                            _topic, partition, offset);
+                }, failure -> {
+                    log.error("send kafka message failure: [{}], [{}], [{}]",
+                            key, value, topic);
+                }
+        );
+        // future 支持多次获取消息, 不需要重新发送消息
+
+        // 同步等待的方式获取通知
+        try {
+//            SendResult<String, String> sendResult = future.get();
+            SendResult<String, String> sendResult = future.get(5, TimeUnit.SECONDS);
+
+            // 发送到 kafka 的 topic
+            String _topic = sendResult.getRecordMetadata().topic();
+            // 消息发送到的分区
+            int partition = sendResult.getRecordMetadata().partition();
+            // 消息在分区内的 offset
+            long offset = sendResult.getRecordMetadata().offset();
+
+            log.info("send kafka message success: [{}], [{}], [{}]",
+                    _topic, partition, offset);
+        } catch (Exception ex) {
+            log.error("send kafka message failure: [{}], [{}], [{}]",
+                    key, value, topic);
+        }
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/vo/QMessage.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/vo/QMessage.java
new file mode 100644
index 0000000..7d4c20f
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/vo/QMessage.java
@@ -0,0 +1,27 @@
+package org.example.vo;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * <h1>通过 Kafka 传递的消息对象</h1>
+ * */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class QMessage {
+
+    /**
+     * 唯一的标识一个消息对象
+     */
+    private Integer id;
+
+    /**
+     * 项目名称
+     */
+    private String projectName;
+
+    // todo 自己进行扩展
+
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/application-dev.yml b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/application-dev.yml
new file mode 100644
index 0000000..9695606
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/application-dev.yml
@@ -0,0 +1,49 @@
+server:
+  port: 8001
+  servlet:
+    context-path: /dev-protocol-springcloud-message-study
+
+spring:
+  # SpringBoot 集成 Kafka 的配置, 最低配置只需要配置 spring.kafka.bootstrap-servers
+  kafka:
+    bootstrap-servers: 127.0.0.1:9092
+  jpa:
+    show-sql: true
+    hibernate:
+      ddl-auto: none
+    properties:
+      hibernate.show_sql: true
+      hibernate.format_sql: true
+    open-in-view: false
+  datasource:
+    # 数据源
+    url: jdbc:mysql://127.0.0.1:3306/dev_protocol_springcloud_project?autoReconnect=true&useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8
+    username: root
+    password: root
+    type: com.zaxxer.hikari.HikariDataSource
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    # 连接池
+    hikari:
+      maximum-pool-size: 8
+      minimum-idle: 4
+      idle-timeout: 30000
+      connection-timeout: 30000
+      max-lifetime: 45000
+      auto-commit: true
+      pool-name: devProtocolSpringcloudHikariCP
+#    consumer:
+      # 如果 Consumer 没有指定 group-id, 则使用配置文件中配置的; 如果配置文件中也没有定义, 则由框架随机生成
+#      group-id: imooc-study-ecommerce
+#      auto-offset-reset: latest
+#      key-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+#      value-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+#    producer:
+#      key-serializer: org.apache.kafka.common.serialization.StringSerializer
+#      value-serializer: org.apache.kafka.common.serialization.StringSerializer
+
+# RocketMQ 的配置, 这是最低配置
+rocketmq:
+  name-server: 127.0.0.1:9876
+  producer:
+    # 发送同一类消息的设置为同一个 group, 保证唯一
+    group: dev-protocol-springcloud-message-study
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/bootstrap.yml b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/bootstrap.yml
new file mode 100644
index 0000000..2366e3d
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/bootstrap.yml
@@ -0,0 +1,16 @@
+spring:
+  profiles:
+    # prod, dev
+    active: dev
+  application:
+    name: dev-protocol-springcloud-message-study
+
+# 暴露端点
+management:
+  endpoints:
+    web:
+      exposure:
+        include: '*'
+  endpoint:
+    health:
+      show-details: always
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/kafka-controller.http b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/kafka-controller.http
new file mode 100644
index 0000000..6d183bd
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/kafka-controller.http
@@ -0,0 +1,7 @@
+### kafka-send-message
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/kafka/send-message?key=qqq&topic=q-springboot
+Content-Type: application/json
+
+### kafka-send-message - (测试kafka 支持无key消息, key 是用来分区的)
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/kafka/send-message?topic=q-springboot
+Content-Type: application/json
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
new file mode 100644
index 0000000..3fd0c0b
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
@@ -0,0 +1,15 @@
+### message-with-value
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-value
+Content-Type: application/json
+
+### message-with-key
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-key
+Content-Type: application/json
+
+### message-with-tag
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-tag
+Content-Type: application/json
+
+### message-with-all
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-all
+Content-Type: application/json
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/transactional-lose.http b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/transactional-lose.http
new file mode 100644
index 0000000..de7d991
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/transactional-lose.http
@@ -0,0 +1,7 @@
+### wrong-rollback-for
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/transactional-lose/wrong-rollback-for
+Content-Type: application/json
+
+### wrong-inner-call
+GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/transactional-lose/wrong-inner-call
+Content-Type: application/json
diff --git a/pom.xml b/pom.xml
index d1d50db..fb471b6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -63,6 +63,7 @@
         <module>dev-protocol-springcloud/dev-protocol-springcloud-project-goods-service</module>
         <module>dev-protocol-springcloud/dev-protocol-springcloud-hystrix</module>
         <module>dev-protocol-springcloud/dev-protocol-springcloud-hystrix-dashboard</module>
+        <module>dev-protocol-springcloud/dev-protocol-springcloud-message-study</module>
     </modules>
 
     <properties>

From 08b87590cd9d03c805da746fd75c77205ac55e4a Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Fri, 6 Sep 2024 16:52:40 +0800
Subject: [PATCH 6/6] =?UTF-8?q?feat(master):RMQ=20=E6=80=BB=E7=BB=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

RMQ 的相关代码
---
 .../SpringCloud-Stream.md                     |  29 +++--
 .../controller/RocketMQController.java        |  51 +++++++++
 .../rocket/RocketMQConsumerMessageExt.java    |  29 +++++
 .../rocket/RocketMQConsumerObject.java        |  27 +++++
 .../rocket/RocketMQConsumerString.java        |  28 +++++
 .../rocket/RocketMQConsumerTagString.java     |  28 +++++
 .../org/example/rocket/RocketMQProducer.java  | 100 ++++++++++++++++++
 .../resources/http/rocket-mq-controller.http  |   8 +-
 .../src/main/resources/bootstrap.yml          |  12 +--
 9 files changed, 296 insertions(+), 16 deletions(-)
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/RocketMQController.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerMessageExt.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerObject.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerString.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerTagString.java
 create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQProducer.java

diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
index f15be38..703e3f7 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/SpringCloud-Stream.md
@@ -3,21 +3,38 @@
 
 
 ### SpringBoot 集成 Kafka 构建消息驱动微服务
--
+- 下载安装 kafka
+- 下载 Kafka :https://kafka.apache.org/quickstart
+- 解压、启动 ZK 和 Kafka Server 即可(使用默认配置)
+---
+- 基本架构
+  - Producer -> Message[Topic] -> Kafka Broker -> Partition <- Consumer[Topic]
 
 ### SpringBoot 集成 RocketMQ 构建消息驱动微服务
--
+- 下载、安装 RocketMQ
+  - 下载 RocketMQ: http://rocketmg.apache.org/docs/quick-start
+  - 下载以 bin-release 结尾的 zip 包解压即完成安装
+---
+- MQ 的启动, 关注2个
+  - mqnamesrv
+    - sh mqnamesrv
+  - mqbroker
+    - sh mqbroker -n localhost:9876
 
 ### SpringCloud Stream 消息驱动组件概览
-
+- 为什么会出现 SpringCloud Stream
+  - 如果没有 SpringCloud Stream,我们会怎么应用消息驱动?
+    - Producer -> Message -> Kafka/RocketMQ <- Consumer
+  - 有了Stream
+    - Producer -> Message -> [Kafka/RocketMQ][Stream] <- Consumer
 
 ### 基于 SpringCloud Stream 消息驱动的简单应用
-
+- [dev-protocol-springcloud-stream](..%2Fdev-protocol-springcloud-stream)
 
 ### 自定义 Stream 消息通信信道实现定制分发
-
+- [dev-protocol-springcloud-stream](..%2Fdev-protocol-springcloud-stream)
 
 ### SpringCloud Stream 消息分组和消费分区的配置与说明
-
+- [dev-protocol-springcloud-stream](..%2Fdev-protocol-springcloud-stream)
 
 ### SpringCloud Stream 消息驱动组件总结
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/RocketMQController.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/RocketMQController.java
new file mode 100644
index 0000000..8d2bb65
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/controller/RocketMQController.java
@@ -0,0 +1,51 @@
+package org.example.controller;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.example.rocket.RocketMQProducer;
+import org.example.vo.QMessage;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * <h1>SpringBoot 集成 RocketMQ</h1>
+ * */
+@Slf4j
+@RestController
+@RequestMapping("/rocket-mq")
+public class RocketMQController {
+
+    private static final QMessage RocketMQMessage = new QMessage(
+            1,
+            "Q-Study-RocketMQ-In-SpringBoot"
+    );
+
+    private final RocketMQProducer rocketMQProducer;
+
+    public RocketMQController(RocketMQProducer rocketMQProducer) {
+        this.rocketMQProducer = rocketMQProducer;
+    }
+
+    @GetMapping("/message-with-value")
+    public void sendMessageWithValue() {
+        rocketMQProducer.sendMessageWithValue(JSON.toJSONString(RocketMQMessage));
+    }
+
+    @GetMapping("/message-with-key")
+    public void sendMessageWithKey() {
+        rocketMQProducer.sendMessageWithKey("qy", JSON.toJSONString(RocketMQMessage));
+    }
+
+    @GetMapping("/message-with-tag")
+    public void sendMessageWithTag() {
+        rocketMQProducer.sendMessageWithTag("qy",
+                JSON.toJSONString(RocketMQMessage));
+    }
+
+    @GetMapping("/message-with-all")
+    public void sendMessageWithAll() {
+        rocketMQProducer.sendMessageWithAll("q", "q",
+                JSON.toJSONString(RocketMQMessage));
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerMessageExt.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerMessageExt.java
new file mode 100644
index 0000000..69a832f
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerMessageExt.java
@@ -0,0 +1,29 @@
+package org.example.rocket;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.rocketmq.common.message.MessageExt;
+import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
+import org.apache.rocketmq.spring.core.RocketMQListener;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>第三个 RocketMQ 消费者, </h1>
+ * */
+@Slf4j
+@Component
+@RocketMQMessageListener(
+        topic = "q-study-rocketmq",
+        consumerGroup = "q-springboot-rocketmq-message-ext"
+)
+public class RocketMQConsumerMessageExt implements RocketMQListener<MessageExt> {
+
+    @Override
+    public void onMessage(MessageExt message) {
+
+        String value = new String(message.getBody());
+        log.info("consume message in RocketMQConsumerMessageExt: [{}], [{}]",
+                message.getKeys(), value); // 能拿到消息中的 key
+        log.info("MessageExt: [{}]", JSON.toJSONString(message));   // 会慢一些
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerObject.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerObject.java
new file mode 100644
index 0000000..1a58319
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerObject.java
@@ -0,0 +1,27 @@
+package org.example.rocket;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
+import org.apache.rocketmq.spring.core.RocketMQListener;
+import org.example.vo.QMessage;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>第四个, RocketMQ 消费者, 指定消费带有 tag 的消息, 且消费的是 Java Pojo</h1>
+ * */
+@Slf4j
+@Component
+@RocketMQMessageListener(
+        topic = "imooc-study-rocketmq",
+        consumerGroup = "q-springboot-rocketmq-tag-object",
+        selectorExpression = "q"    // 根据 tag 做过滤
+)
+public class RocketMQConsumerObject implements RocketMQListener<QMessage> {
+    @Override
+    public void onMessage(QMessage message) {
+        log.info("consume message in RocketMQConsumerObject: [{}]",
+                JSON.toJSONString(message));
+        // so something
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerString.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerString.java
new file mode 100644
index 0000000..5c274bd
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerString.java
@@ -0,0 +1,28 @@
+package org.example.rocket;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
+import org.apache.rocketmq.spring.core.RocketMQListener;
+import org.example.vo.QMessage;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>第一个 RocketMQ 消费者</h1>
+ * */
+@Slf4j
+@Component
+@RocketMQMessageListener(
+        topic = "q-study-rocketmq",
+        consumerGroup = "q-springboot-rocketmq-string"
+)
+public class RocketMQConsumerString implements RocketMQListener<String> {
+
+    @Override
+    public void onMessage(String message) {
+
+        QMessage rocketMessage = JSON.parseObject(message, QMessage.class);
+        log.info("consume message in RocketMQConsumerString: [{}]",
+                JSON.toJSONString(rocketMessage));
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerTagString.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerTagString.java
new file mode 100644
index 0000000..c5a8f7d
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQConsumerTagString.java
@@ -0,0 +1,28 @@
+package org.example.rocket;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
+import org.apache.rocketmq.spring.core.RocketMQListener;
+import org.example.vo.QMessage;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>第二个 RocketMQ 消费者, 指定了消费带有 tag 的消息</h1>
+ * */
+@Slf4j
+@Component
+@RocketMQMessageListener(
+        topic = "q-study-rocketmq",
+        consumerGroup = "q-springboot-rocketmq-tag-string",
+        selectorExpression = "qy"        // 根据 tag 过滤, tag 中要带有 qy
+)
+public class RocketMQConsumerTagString implements RocketMQListener<String> {
+    @Override
+    public void onMessage(String message) {
+
+        QMessage rocketMessage = JSON.parseObject(message, QMessage.class);
+        log.info("consume message in RocketMQConsumerTagString: [{}]",
+                JSON.toJSONString(rocketMessage));
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQProducer.java b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQProducer.java
new file mode 100644
index 0000000..13711ff
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/java/org/example/rocket/RocketMQProducer.java
@@ -0,0 +1,100 @@
+package org.example.rocket;
+
+import com.alibaba.fastjson.JSON;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.rocketmq.client.producer.SendCallback;
+import org.apache.rocketmq.client.producer.SendResult;
+import org.apache.rocketmq.spring.core.RocketMQTemplate;
+import org.apache.rocketmq.spring.support.RocketMQHeaders;
+import org.example.vo.QMessage;
+import org.springframework.messaging.Message;
+import org.springframework.messaging.support.MessageBuilder;
+import org.springframework.stereotype.Component;
+
+/**
+ * <h1>通过 RocketMQ 发送消息</h1>
+ * Spring Messaging 模块
+ * */
+@Slf4j
+@Component
+public class RocketMQProducer {
+
+    /** 类似 Kafka 中的 topic, 默认的读写队列都是4个, 默认自动创建topic */
+    private static final String TOPIC = "q-study-rocketmq";
+
+    /** RocketMQ 客户端 */
+    private final RocketMQTemplate rocketMQTemplate;
+
+    public RocketMQProducer(RocketMQTemplate rocketMQTemplate) {
+        this.rocketMQTemplate = rocketMQTemplate;
+    }
+
+    /**
+     * <h2>使用同步的方式发送消息, 不指定 key 和 tag</h2>
+     * */
+    public void sendMessageWithValue(String value) {
+
+        // 随机选择一个 Topic 的 Message Queue 发送消息
+        SendResult sendResult = rocketMQTemplate.syncSend(TOPIC, value);
+        log.info("sendMessageWithValue result: [{}]", JSON.toJSONString(sendResult));
+
+        SendResult sendResultOrderly = rocketMQTemplate.syncSendOrderly(
+                TOPIC, value, "QQQ"
+        );
+        log.info("sendMessageWithValue orderly result: [{}]",
+                JSON.toJSONString(sendResultOrderly));
+    }
+
+    /**
+     * <h2>使用异步的方式发送消息, 指定 key</h2>
+     * */
+    public void sendMessageWithKey(String key, String value) {
+
+        Message<String> message = MessageBuilder.withPayload(value)
+                // 这个Key 不是分区的效果, 只是方便进行查询, 在设置的时候, 可以使用空格进行分开, 例如: aaaa bbb
+                .setHeader(RocketMQHeaders.KEYS, key).build();
+
+        // 异步发送消息, 并设定回调
+        rocketMQTemplate.asyncSend(TOPIC, message, new SendCallback() {
+
+            @Override
+            public void onSuccess(SendResult sendResult) {
+                log.info("sendMessageWithKey success result: [{}]",
+                        JSON.toJSONString(sendResult));
+            }
+
+            @Override
+            public void onException(Throwable e) {
+                log.error("sendMessageWithKey failure: [{}]", e.getMessage(), e);
+            }
+        });
+    }
+
+    /**
+     * <h2>使用同步的方式发送消息, 带有 tag, 且发送的是 Java Pojo</h2>
+     * 发送消息可以定义自己的消息数据结构
+     * */
+    public void sendMessageWithTag(String tag, String value) {
+
+        QMessage qMessage = JSON.parseObject(value, QMessage.class);
+        SendResult sendResult = rocketMQTemplate.syncSend(
+                String.format("%s:%s", TOPIC, tag), // 不同的消费者组使用不同的 tag
+                qMessage
+        );
+        log.info("sendMessageWithTag result: [{}]", JSON.toJSONString(sendResult));
+    }
+
+    /**
+     * <h2>使用同步的方式发送消息, 带有 key 和 tag</h2>
+     * */
+    public void sendMessageWithAll(String key, String tag, String value) {
+
+        Message<String> message = MessageBuilder.withPayload(value)
+                .setHeader(RocketMQHeaders.KEYS, key).build();
+        SendResult sendResult = rocketMQTemplate.syncSend(
+                String.format("%s:%s", TOPIC, tag),
+                message
+        );
+        log.info("sendMessageWithAll result: [{}]", JSON.toJSONString(sendResult));
+    }
+}
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
index 3fd0c0b..dc3cd2d 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-message-study/src/main/resources/http/rocket-mq-controller.http
@@ -1,15 +1,15 @@
 ### message-with-value
-GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-value
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/rocket-mq/message-with-value
 Content-Type: application/json
 
 ### message-with-key
-GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-key
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/rocket-mq/message-with-key
 Content-Type: application/json
 
 ### message-with-tag
-GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-tag
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/rocket-mq/message-with-tag
 Content-Type: application/json
 
 ### message-with-all
-GET http://127.0.0.1:8001/imooc-study-ecommerce-dev/rocket-mq/message-with-all
+GET http://127.0.0.1:8001/dev-protocol-springcloud-message-study/rocket-mq/message-with-all
 Content-Type: application/json
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-stream/src/main/resources/bootstrap.yml b/dev-protocol-springcloud/dev-protocol-springcloud-stream/src/main/resources/bootstrap.yml
index 775c208..500ebe9 100644
--- a/dev-protocol-springcloud/dev-protocol-springcloud-stream/src/main/resources/bootstrap.yml
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-stream/src/main/resources/bootstrap.yml
@@ -12,7 +12,7 @@ spring:
       discovery:
         enabled: true # 如果不想使用 Nacos 进行服务注册和发现, 设置为 false 即可
         server-addr: 127.0.0.1:8848
-        namespace: 1bc13fd5-843b-4ac0-aa55-695c25bc0ac6
+        namespace: 1ccc74ae-9398-4dbe-b9d7-4f9addf9f40c
         metadata:
           management:
             context-path: ${server.servlet.context-path}/actuator
@@ -27,15 +27,15 @@ spring:
       #      rocketmq:
       #        binder:
       #          name-server: 127.0.0.1:9876
-      # fixme 开启 stream 分区支持
+      # 开启 stream 分区支持
       instanceCount: 1  # 消费者的总数
-      instanceIndex: 0  # 当前消费者的索引
+      instanceIndex: 0  # 当前消费者的索引, 多个的时候, 另外一个要配置成 1, 依次类推
       bindings:
         # 默认发送方
         output: # 这里用 Stream 给我们提供的默认 output 信道
           destination: dev-protocol-springcloud-stream-client-default    # 消息发往的目的地, Kafka 中就是 Topic
           content-type: text/plain    # 消息发送的格式, 接收端不用指定格式, 但是发送端要
-          # fixme 消息分区
+          # 消息分区 - 只对默认接收方和发送方进行配置, 下面自定义的原理相同
           producer:
             # fixme partitionKeyExpression 这种方式需要我们需要对 author 字段进行各种处理, 这里不使用这个方式, 使用下面自定义的配置策略
             # partitionKeyExpression: payload.author  # 分区关键字, payload 指的是发送的对象, author 是对象中的属性, 不存在 author 可能会报错
@@ -46,9 +46,9 @@ spring:
         # 默认接收方
         input: # 这里用 Stream 给我们提供的默认 input 信道
           destination: dev-protocol-springcloud-stream-client-default
-          # fixme 这里指定了group 方便其进行 分组消费
+          # 这里指定了group 方便其进行 分组消费
           group: dev-protocol-springcloud-stream-client-group-default
-          # fixme 消费者开启 分区支持
+          # 消费者开启 分区支持
           consumer:
             partitioned: true
         # q 发送方 destination 对应