Kotlin和SpringBoot开发的六边形架构应用案例


TalkAdvisor是一个使用Kotlin和SpringBoot开发的六边形体系结构演示应用程序。

TalkAdvisor由4个不同的模块组成:

1. 六边形内部talkadvisor-domain
此模块保存应用程序的所有业务价值,您可以在其中找到其DDD聚合Recommendation.。 已配置Maven以防止向领域中导入任何外部工件:

 <plugin>
                <artifactId>maven-enforcer-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>enforce</goal>
                        </goals>
                        <configuration>
                            <rules>
                                <bannedDependencies>
                                    <excludes>
                                        <exclude>*</exclude> <!-- forbids non domain dependencies -->
                                    </excludes>
                                    <includes>
                                        <!-- but allow kotlin dependencies-->
                                        <include>org.jetbrains.kotlin:*</include>
                                        <include>org.jetbrains:annotations</include>
                                        <!-- and commons-lang3 because we don't want to make the wheel again -->
                                        <include>org.apache.commons:commons-lang3</include>
                                        <!-- and test dependencies-->
                                        <include>*:*:*:*:test</include>
                                    </includes>
                                </bannedDependencies>
                            </rules>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

如果向pom添加了任何依赖项,如果此列表中不允许,则构建将失败。


2. 六边形的外面talkadvisor-infra
所有适配器都收集​​在talkadvisor-infra模块中。talkadvisor-infra是一个父pom,集中了所有适配器的常见配置(Spring Boot BOM,...)。基础设施分为3个模块:
(1)talkadvisor-infra-application
整个应用程序驻留在此模块中。您可以在此处找到控制器YouTube客户端(SPI适配器),REST资源(API适配器)和Spring Boot应用程序

(2)talkadvisor-infra-external-stubs
保存外部服务存根,基本上是wiremock-based基础设施,其中存储了我们向YouTube发出的请求的一些响应有效负载。这些存根是在集成验收测试期间启动的,以便完全隔离TalkAdvisor的CICD构建。它们也可用于运行应用程序,请参阅运行应用程序

(3)talkadvisor-infra-acceptance-tests
集成验收和应用程序的端到端测试。它们在每个构建中针对具有外部存根的TalkAdvisor的本地实例启动。端到端测试也可以针对插入真实调用的YouTube部署实例启动,请参阅启动端到端测试


使用Cucumber(领域驱动测试)在领域驱动设计和六边形体系结构中实现功能测试
使用领域驱动设计和六边形体系结构,通常意味着应用行为驱动开发方法。
很多人都理解它,这种技术现在很普遍。不幸的是,我们经常看到用于描述应用程序行为的功能测试被实现为测试REST端点的http客户端。
这种(反)模式的主要缺点是测试问题的混合。通过这种类型的测试,我们有责任验证:

  • 应用程序的业务逻辑(功能测试)
  • 外部API的合同(合同测试)
  • 提供给消费者的工作流程 - 或类似的东西(端到端测试)
  • 领域对象和适配器之间的映射(单元测试/集成测试)
  • 应用程序的不同子组件的集成,例如控制器,领域服务,存储库...... (集成测试/组件测试)
  • 大部分时间都不知道它:活动文档(合同测试)

原文