user-feign

用户模块API, 供其他模块调用

License	License MIT License
Categories	Categories Feign Net HTTP Clients
GroupId	GroupId com.upcwangying.cloud.samples.user
ArtifactId	ArtifactId user-feign
Last Version	Last Version 0.2.1.RELEASE
Release Date	Release Date Jun 19, 2020
Type	Type jar
Description	Description user-feign 用户模块API, 供其他模块调用

Download user-feign

Filename	Size
user-feign-0.2.1.RELEASE.pom
user-feign-0.2.1.RELEASE.jar	7 KB
user-feign-0.2.1.RELEASE-sources.jar	6 KB
user-feign-0.2.1.RELEASE-javadoc.jar	54 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.upcwangying.cloud.samples.user/user-feign/ -->
<dependency>
    <groupId>com.upcwangying.cloud.samples.user</groupId>
    <artifactId>user-feign</artifactId>
    <version>0.2.1.RELEASE</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.upcwangying.cloud.samples.user/user-feign/
implementation 'com.upcwangying.cloud.samples.user:user-feign:0.2.1.RELEASE'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.upcwangying.cloud.samples.user/user-feign/
implementation ("com.upcwangying.cloud.samples.user:user-feign:0.2.1.RELEASE")

Apache Buildr

'com.upcwangying.cloud.samples.user:user-feign:jar:0.2.1.RELEASE'

Apache Ivy

<dependency org="com.upcwangying.cloud.samples.user" name="user-feign" rev="0.2.1.RELEASE">
  <artifact name="user-feign" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.upcwangying.cloud.samples.user', module='user-feign', version='0.2.1.RELEASE')
)

Scala SBT

libraryDependencies += "com.upcwangying.cloud.samples.user" % "user-feign" % "0.2.1.RELEASE"

Leiningen

[com.upcwangying.cloud.samples.user/user-feign "0.2.1.RELEASE"]

Dependencies

compile (4)

Group / Artifact	Type	Version
com.upcwangying.cloud.samples : samples-core	jar	0.2.1.RELEASE
com.upcwangying.cloud.samples.user : user-common	jar	0.2.1.RELEASE
org.springframework.cloud : spring-cloud-starter-openfeign	jar
net.devh : grpc-server-spring-boot-starter	jar	2.9.0.RELEASE

test (1)

Group / Artifact	Type	Version
org.springframework.boot : spring-boot-starter-test	jar	2.1.15.RELEASE

Project Modules

There are no modules declared in this project.

Spring Cloud Samples

这是一个Spring Cloud 样例项目

项目依赖

Spring Boot (2.1.15.RELEASE)
Spring Cloud (Greenwich.SR6)
Spring Cloud Alibaba (2.1.2.RELEASE)

Seata

AT: 注解只在事务最开始发起方添加即可, 框架可以通过链路将事务上下文传递下去并加入事务.
MT: 就是TCC, 需要用户自己实现3个接口.
将所有TCC服务都发布成了dubbo服务, 不需要 @LocalTCC 注解, @LocalTCC是在调用本机的TCC bean时才使用的.
需要根据一阶段的结果自己实现，抛异常分布式事务回滚，不抛异常分布式事务提交.
TCC模式现在不支持与feign集成.
AT模式二阶段是依赖数据资源的, 这个数据资源是指AT一阶段提交业务数据更新和相应回滚日志记录.
AT模式必须基于支持本地 ACID 事务的关系型数据库、MT模式不依赖于底层数据资源的事务支持, 是从Seata框架的角度看的.
Seata框架只针对资源, AT模式的资源是数据库, MT模式的资源是业务的接口.

根据两阶段行为模式的不同，我们将分支事务划分为 Automatic (Branch) Transaction Mode 和 Manual (Branch) Transaction Mode.

AT 模式基于支持本地 ACID 事务的关系型数据库:

一阶段 prepare 行为: 在本地事务中, 一并提交业务数据更新和相应回滚日志记录.
二阶段 commit 行为: 马上成功结束, 自动异步批量清理回滚日志.
二阶段 rollback 行为: 通过回滚日志, 自动生成补偿操作，完成数据回滚.

相应的, MT 模式不依赖于底层数据资源的事务支持:

一阶段 prepare 行为: 调用 自定义 的 prepare 逻辑.
二阶段 commit 行为: 调用 自定义 的 commit 逻辑.
二阶段 rollback 行为: 调用 自定义 的 rollback 逻辑.

所谓 MT 模式，是指支持把 自定义 的分支事务纳入到全局事务的管理中.

流程说明

business通知server开启事务
business调用storage, storage开启本地事务, 本地事务提交时, 通知server创建分支事务
order 和 account 同 storage
rpc调用完毕后, business通知server提交事务
每个分支本地事务提交后, 会通知server创建分支事务, 当rpc调用完毕后, business通知server提交全局事务(这个business是不是根据全局事务发起者方法里有没有抛出异常来决定提交或者回滚全局事务)

samples-zuul 项目

相关filter执行顺序

RateLimitPreFilter(限流) -> GrayFilter(灰度发布) -> AuthFilter(认证) -> PermissionFilter(鉴权)

路由通配符

映射路径 /user/** 之后的 /** 大有讲究, 还可以配置为 /* 或者 /?

规则	释义	示例
/**	匹配任意数量的路径与字符	/user/add, /user/add/a, /user/add/a/b
/*	匹配任意数量的字符	/user/add, /user/mul, /user/b
/?	匹配单个字符	/user/a, /user/b

Maven dockerfile plugin

docker login  -u yourusername -p yourpassword registry.cn-qingdao.aliyuncs.com

mvn package -DskipTests dockerfile:build dockerfile:push

mvn package -DskipTests dockerfile:build dockerfile:push -Dusername=wangy -Dpassword=Wangy123

Docker compose

单机模式下运行

在后台运行

docker-compose up -d

or 指定文件名, 默认是docker-compose.yml

docker-compose up -d -f filename

swarm 集群模式运行

TODO...

k8s 集群模式运行

TODO...

测试用例

测试用例在spring-cloud-samples/samples-product/product-web/src/test目录下

注意

执行 mvn test 启动测试用例
执行 mvn package mvn install mvn deploy时跳过 mvn test
建议使用git子模块管理项目

Test

DskipTests 不执行测试用例, 但编译测试用例类生成相应的class文件至target/test-classes下

Dmaven.test.skip=true, 不执行测试用例，也不编译测试用例类

使用mvn package -Dmaven.test.skip=true, 不但跳过单元测试的运行, 也跳过测试代码的编译; 也可以在pom.xml文件中修改.

<plugin>  
    <groupId>org.apache.maven.plugin</groupId>  
    <artifactId>maven-compiler-plugin</artifactId>  
    <version>2.1</version>  
    <configuration>  
        <skip>true</skip>  
    </configuration>  
</plugin>

<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-surefire-plugin</artifactId>  
    <version>2.5</version>  
    <configuration>  
        <skip>true</skip>  
    </configuration>  
</plugin>

使用mvn package -DskipTests跳过单元测试, 但是会继续编译; 也可以在pom.xml文件中修改.

<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-surefire-plugin</artifactId>  
    <version>2.5</version>  
    <configuration>  
        <skipTests>true</skipTests>  
    </configuration>  
</plugin>

Maven archetype

在项目根目录下运行mvn archetype:create-from-project
生成archetype项目工程, 在target/generated-sources/archetype目录下

Maven Archetype 配置

安装Maven Archetype Catalog插件
依次进入设置目录Settings->Build,Execution,Deployment->Build Tools->Maven Archetype Catalogs
新增http://192.168.88.82:8081/repository/maven-snapshots/archetype-catalog.xml
新建Maven工程, 勾选Create from archetype即可, 其余操作不变.

Deploy

mvn clean install deploy -P release -Dgpg.passphrase=yourpassword -Ddockerfile.skip=true -DskipTests

mvn clean install package -DskipTests -Ddockerfile.push.skip=true

mvn clean deploy -projects fundebug-java,fundebug-spring -P release -Dgpg.passphrase=yourpassword -Ddockerfile.skip=true -DskipTests

keytool -genkey -alias samples -keypass samples -keyalg RSA -keysize 2048 -validity 30 -keystore samples.jks -storepass samples

TODO

Versions

Version
0.2.1.RELEASE Jun 19, 2020