开源项目 SOS 指南

开源项目 SOS 指南

sos Sample projects for my talk "Refactoring to a System of Systems" 项目地址: https://gitcode.com/gh_mirrors/sos1/sos

1. 项目目录结构及介绍

开源项目 SOS 是一个用于演示“重构至系统之系统”演讲的概念性样例集合。它通过不同阶段的项目，展示如何将单块架构逐步演进为更模块化或微服务化的系统。以下是关键的目录结构及其简介：

• main: 根目录下包含了多个代表不同进化阶段的子目录。
  • 00-monolith: 单块应用程序，所有业务逻辑位于单一Spring Boot项目内。
  • 10-microlith: 迈向微服务的过渡形态，各部分仍以较紧密的方式通信但已分离为不同的组件。
  • 20-modulith: 使用Spring事件实现模块间的解耦。
  • 30-messaging-sos: 引入Kafka等消息队列，实现基于消息的系统间通信。
  • 40-restful-sos: 系统间交互通过REST API完成，模块进一步独立。

每个子目录下通常包含： - src: 项目源代码，分main和test目录。 - pom.xml: Maven配置文件，定义依赖关系和构建指令。 - README.md: 该子项目的具体说明文档。

• images: 存放项目相关的图像文件。
• github: 包含与GitHub工作流程相关的配置文件。
• mvnw, mvnw.cmd: Maven Wrapper脚本，方便跨平台运行Maven命令。

2. 项目的启动文件介绍

在每个子目录下的src/main/java路径中，你可以找到主程序入口类。例如，在单块架构的00-monolith项目里，这个类通常是标记有@SpringBootApplication注解的类，例如com.example.Application。通过运行此类的main方法来启动应用程序。例如：

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

对于其他以微服务形式组织的模块，每个模块也会有类似的启动类。

3. 项目的配置文件介绍

全局配置：pom.xml

• pom.xml 文件作为Maven的核心配置，定义了项目的依赖、构建生命周期、插件配置等。它确保了项目的环境一致性以及构建过程的自动化。

局部配置：application.properties 或 application.yml

在每个子项目的src/main/resources目录下，可以找到如application.properties或application.yml这样的配置文件。这些文件用于设置Spring Boot应用的具体配置项，比如数据库连接、端口号、以及自定义的业务配置。示例配置可能包括数据库URL、用户名和密码等。

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=my-secret-pw

请注意，由于项目旨在展示不同架构模式，并非所有的子项目都使用同样的配置文件结构，特别是在从单块架构演变为微服务架构的过程中，配置的管理方式也会有所不同，可能会引入外部配置中心或者使用环境变量进行配置。

此指南提供了一个概览性的介绍，具体的配置细节和启动步骤应参照各子项目内部的详细说明文档。

sos Sample projects for my talk "Refactoring to a System of Systems" 项目地址: https://gitcode.com/gh_mirrors/sos1/sos