{"id":15154132,"url":"https://github.com/kimmy-wang/spring-cloud-samples","last_synced_at":"2025-09-30T01:32:40.997Z","repository":{"id":57729337,"uuid":"255900623","full_name":"kimmy-wang/spring-cloud-samples","owner":"kimmy-wang","description":"Spring Cloud Samples","archived":true,"fork":false,"pushed_at":"2020-09-22T02:54:04.000Z","size":1030,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2024-09-23T01:06:55.275Z","etag":null,"topics":["bpm","data-process","dubbo","eureka","feign","gateway","hystrix","nacos","sentinel","spring-boot","spring-cloud","zuul"],"latest_commit_sha":null,"homepage":"https://cloud.upcwangying.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kimmy-wang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-15T11:50:40.000Z","updated_at":"2023-01-28T04:45:05.000Z","dependencies_parsed_at":"2022-08-30T23:40:41.856Z","dependency_job_id":null,"html_url":"https://github.com/kimmy-wang/spring-cloud-samples","commit_stats":null,"previous_names":["upcwangying/spring-cloud-samples","kimmy-wang/spring-cloud-samples","kw214/spring-cloud-samples"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimmy-wang%2Fspring-cloud-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimmy-wang%2Fspring-cloud-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimmy-wang%2Fspring-cloud-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimmy-wang%2Fspring-cloud-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kimmy-wang","download_url":"https://codeload.github.com/kimmy-wang/spring-cloud-samples/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219874735,"owners_count":16554611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bpm","data-process","dubbo","eureka","feign","gateway","hystrix","nacos","sentinel","spring-boot","spring-cloud","zuul"],"created_at":"2024-09-26T17:02:58.319Z","updated_at":"2025-09-30T01:32:35.549Z","avatar_url":"https://github.com/kimmy-wang.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Spring Cloud Samples\n\n![Maven Central](https://img.shields.io/maven-central/v/com.upcwangying.cloud.samples/samples-parent)\n![GitHub](https://img.shields.io/github/license/upcwangying/spring-cloud-samples)\n\n这是一个Spring Cloud 样例项目\n\n## 项目依赖\n\n- Spring Boot (2.1.15.RELEASE)\n- Spring Cloud (Greenwich.SR6)\n- Spring Cloud Alibaba (2.1.2.RELEASE)\n\n## Seata\n\n- AT: 注解只在事务最开始发起方添加即可, 框架可以通过链路将事务上下文传递下去并加入事务.\n- MT: 就是TCC, 需要用户自己实现3个接口.\n- 将所有TCC服务都发布成了dubbo服务, 不需要 @LocalTCC 注解, @LocalTCC是在调用本机的TCC bean时才使用的.\n- 需要根据一阶段的结果自己实现，抛异常分布式事务回滚，不抛异常分布式事务提交.\n- TCC模式现在不支持与feign集成.\n- AT模式二阶段是依赖数据资源的, 这个数据资源是指AT一阶段提交业务数据更新和相应回滚日志记录.\n- AT模式必须基于支持本地 ACID 事务的关系型数据库、MT模式不依赖于底层数据资源的事务支持, 是从Seata框架的角度看的.\n- Seata框架只针对资源, AT模式的资源是数据库, MT模式的资源是业务的接口.\n\n根据两阶段行为模式的不同，我们将分支事务划分为 **Automatic (Branch) Transaction Mode** 和 **Manual (Branch) Transaction Mode**.\n\nAT 模式基于支持**本地 ACID 事务**的**关系型数据库**:\n\n- 一阶段 prepare 行为: 在本地事务中, 一并提交业务数据更新和相应回滚日志记录.\n- 二阶段 commit 行为: 马上成功结束, **自动** 异步批量清理回滚日志.\n- 二阶段 rollback 行为: 通过回滚日志, **自动** 生成补偿操作，完成数据回滚.\n\n相应的, MT 模式不依赖于底层数据资源的事务支持:\n\n- 一阶段 prepare 行为: 调用 **自定义** 的 prepare 逻辑.\n- 二阶段 commit 行为: 调用 **自定义** 的 commit 逻辑.\n- 二阶段 rollback 行为: 调用 **自定义** 的 rollback 逻辑.\n\n所谓 MT 模式，是指支持把 **自定义** 的分支事务纳入到全局事务的管理中.\n\n### 流程说明\n\n![](process.png)\n\n1. business通知server开启事务\n2. business调用storage, storage开启本地事务, 本地事务提交时, 通知server创建分支事务\n3. order 和 account 同 storage\n4. rpc调用完毕后, business通知server提交事务\n5. 每个分支本地事务提交后, 会通知server创建分支事务, 当rpc调用完毕后, business通知server提交全局事务(这个business是不是根据全局事务发起者方法里有没有抛出异常来决定提交或者回滚全局事务)\n\n## samples-zuul 项目\n\n\u003e 相关filter执行顺序\n\n```\nRateLimitPreFilter(限流) -\u003e GrayFilter(灰度发布) -\u003e AuthFilter(认证) -\u003e PermissionFilter(鉴权)\n```\n\n### 路由通配符\n\n映射路径 `/user/**` 之后的 `/**` 大有讲究, 还可以配置为 `/*` 或者 `/?`\n\n| 规则 | 释义 | 示例 |\n| :------: | :------: | :------: |\n| /** | 匹配任意数量的路径与字符 | /user/add, /user/add/a, /user/add/a/b |\n| /* | 匹配任意数量的字符 | /user/add, /user/mul, /user/b |\n| /? | 匹配单个字符 | /user/a, /user/b |\n\n## Maven dockerfile plugin\n\n```text\ndocker login  -u yourusername -p yourpassword registry.cn-qingdao.aliyuncs.com\n\nmvn package -DskipTests dockerfile:build dockerfile:push\n\nmvn package -DskipTests dockerfile:build dockerfile:push -Dusername=wangy -Dpassword=Wangy123 \n```\n\n## Docker compose\n\n- 单机模式下运行\n\n在后台运行\n\n```docker\ndocker-compose up -d\n```\n\nor 指定文件名, 默认是docker-compose.yml\n\n```docker\ndocker-compose up -d -f filename\n```\n\n- swarm 集群模式运行\n\nTODO...\n\n- k8s 集群模式运行\n\nTODO...\n\n## 测试用例\n\n测试用例在spring-cloud-samples/samples-product/product-web/src/test目录下\n\n注意\n\n1. 执行 `mvn test` 启动测试用例\n2. 执行 `mvn package` `mvn install` `mvn deploy`时跳过 `mvn test`\n3. 建议使用git子模块管理项目\n\n### Test\n```text\nDskipTests 不执行测试用例, 但编译测试用例类生成相应的class文件至target/test-classes下\n\nDmaven.test.skip=true, 不执行测试用例，也不编译测试用例类\n```\n\n1. 使用`mvn package -Dmaven.test.skip=true`, 不但跳过单元测试的运行, 也跳过测试代码的编译; 也可以在pom.xml文件中修改.\n\n```mvn\n\u003cplugin\u003e  \n    \u003cgroupId\u003eorg.apache.maven.plugin\u003c/groupId\u003e  \n    \u003cartifactId\u003emaven-compiler-plugin\u003c/artifactId\u003e  \n    \u003cversion\u003e2.1\u003c/version\u003e  \n    \u003cconfiguration\u003e  \n        \u003cskip\u003etrue\u003c/skip\u003e  \n    \u003c/configuration\u003e  \n\u003c/plugin\u003e\n\n\u003cplugin\u003e  \n    \u003cgroupId\u003eorg.apache.maven.plugins\u003c/groupId\u003e  \n    \u003cartifactId\u003emaven-surefire-plugin\u003c/artifactId\u003e  \n    \u003cversion\u003e2.5\u003c/version\u003e  \n    \u003cconfiguration\u003e  \n        \u003cskip\u003etrue\u003c/skip\u003e  \n    \u003c/configuration\u003e  \n\u003c/plugin\u003e \n```\n\n2. 使用`mvn package -DskipTests`跳过单元测试, 但是会继续编译; 也可以在pom.xml文件中修改.\n\n```mvn\n\u003cplugin\u003e  \n    \u003cgroupId\u003eorg.apache.maven.plugins\u003c/groupId\u003e  \n    \u003cartifactId\u003emaven-surefire-plugin\u003c/artifactId\u003e  \n    \u003cversion\u003e2.5\u003c/version\u003e  \n    \u003cconfiguration\u003e  \n        \u003cskipTests\u003etrue\u003c/skipTests\u003e  \n    \u003c/configuration\u003e  \n\u003c/plugin\u003e \n```\n\n## Maven archetype\n\n1. 在项目根目录下运行`mvn archetype:create-from-project`\n\n2. 生成archetype项目工程, 在`target/generated-sources/archetype`目录下\n\n## Maven Archetype 配置\n\n\n1. 安装`Maven Archetype Catalog`插件\n\n2. 依次进入设置目录`Settings-\u003eBuild,Execution,Deployment-\u003eBuild Tools-\u003eMaven Archetype Catalogs`\n\n3. 新增http://192.168.88.82:8081/repository/maven-snapshots/archetype-catalog.xml\n\n4. 新建Maven工程, 勾选`Create from archetype`即可, 其余操作不变.\n\n## Deploy\n\n`mvn clean install deploy -P release -Dgpg.passphrase=yourpassword -Ddockerfile.skip=true -DskipTests`\n\n`mvn clean install package -DskipTests -Ddockerfile.push.skip=true`\n\n`mvn clean deploy -projects fundebug-java,fundebug-spring -P release -Dgpg.passphrase=yourpassword -Ddockerfile.skip=true -DskipTests`\n\n`keytool -genkey -alias samples -keypass samples -keyalg RSA -keysize 2048 -validity 30 -keystore samples.jks -storepass samples`\n\n## TODO\n\n- [X] Netflix Eureka切换成Nacos Discovery\n- [X] Spring Cloud Config切换成Nacos Config\n- [X] 原samples-gateway模块更改为samples-zuul模块, 基于Netflix Zuul\n- [X] 新增samples-gateway模块, 基于Spring Cloud Gateway\n- [X] Feign切换成Dubbo\n- [ ] Netflix Hystrix切换成Alibaba Sentinel\n- [ ] Samples bpm集成Activiti\n- [ ] 集成分布式事务中间件Alibaba Seata\n- [ ] Zipkin切换成Skywalking\n- [ ] Feign切换成gRPC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimmy-wang%2Fspring-cloud-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkimmy-wang%2Fspring-cloud-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimmy-wang%2Fspring-cloud-samples/lists"}