Farseer-Go，一个模块化的完整基础设施框架

2023-02-28

com go 模块

概述文档（国内）[1]文档（国外）[2]开源（Github）[3]什么是farseer-go基于Golang模块化完整的基础设施框架，创建现代化Web应用和APIs。使用目前最为流行的组件，并用模块化技术来提供这些组件。框架完美支持 DDD领域驱动 的战术设计，如仓储资源库、应

概述

文档（国内）[1]
文档（国外）[2]
开源（Github）[3]

什么是farseer-go

基于Golang模块化完整的基础设施框架，创建现代化Web应用和APIs。

使用目前最为流行的组件，并用模块化技术来提供这些组件。

框架完美支持 DDD领域驱动的战术设计，如仓储资源库、应用层事务、领域事件、应用层动态WebAPI。

它有一个.net core[4] 成熟版本，已经使用了10多年，非常棒

不用担心框架会让你依赖过多的包，farseer-go的组件都是独立的包，不使用的包不会下载到您的应用程序中

每个组件都是单独的包，因此版本号也是单独发布的

有什么特点？

统一配置：所有的配置被整合到./farseer.yaml
优雅：所有的模块都遵循开发者体验优先为原则。
模块化：供了完整的模块化系统，使你能够开发可重复使用的应用程序模块。
领域驱动：帮助你实现基于DDD的分层架构并构建可维护的代码库。
链路追踪（下个版本推出）：如果您使用框架中的Orm、Redis、Http、Grpc、ES、MQ、EventBus、Task、FSS，将隐式为您实现链路追踪，并提供API请求日志、慢查询。

结合FOPS[5] 项目（自动构建、链路追踪控制台、K8S集群日志收集）支持代码无侵入的全链路实时监控。

集成的组件

包名	描述	地址
fs	基础核心包	https://github.com/farseer-go/fs
collections	数据集合	https://github.com/farseer-go/collections
webapi	web api服务	https://github.com/farseer-go/webapi
async	异步编程	https://github.com/farseer-go/async
mapper	对象转换	https://github.com/farseer-go/mapper
cacheMemory	本地缓存	https://github.com/farseer-go/cacheMemory
redis	client	https://github.com/farseer-go/redis
data	数据库ORM	https://github.com/farseer-go/data
elasticSearch	client	https://github.com/farseer-go/elasticSearch
eventBus	事件总线	https://github.com/farseer-go/eventBus
queue	本地队列	https://github.com/farseer-go/queue
tasks	本地任务	https://github.com/farseer-go/tasks
fss	分布试调度client	https://github.com/farseer-go/fss
utils	工具集	https://github.com/farseer-go/utils

如何开始

main.go

package main
import "github.com/farseer-go/fs"

func main() {
   fs.Initialize[StartupModule]("your project Name")
}1.
2.
3.
4.
5.
6.

在main函数第一行，执行fs.Initialize，开始初始化框架

运行后控制台打印加载信息：

2022-12-01 17:07:24 应用名称：your project Name
2022-12-01 17:07:24 主机名称：MacBook-Pro.local
2022-12-01 17:07:24 系统时间：2022-12-01 17:07:24
2022-12-01 17:07:24   进程ID：6123
2022-12-01 17:07:24   应用ID：193337022963818496
2022-12-01 17:07:24   应用IP：192.168.1.4
2022-12-01 17:07:24 ---------------------------------------
2022-12-01 17:07:24 加载模块...
2022-12-01 17:07:24 加载模块：webapi.Module
2022-12-01 17:07:24 加载模块：domain.Module
2022-12-01 17:07:24 加载模块：application.Module
2022-12-01 17:07:24 加载模块：interfaces.Module
2022-12-01 17:07:24 加载模块：data.Module
2022-12-01 17:07:24 加载模块：eventBus.Module
2022-12-01 17:07:24 加载模块：queue.Module
2022-12-01 17:07:24 加载模块：infrastructure.Module
2022-12-01 17:07:24 加载模块：main.StartupModule
2022-12-01 17:07:24 加载完毕，共加载 10 个模块
2022-12-01 17:07:24 ---------------------------------------
2022-12-01 17:07:24 初始化完毕，共耗时：1 ms 
2022-12-01 17:07:24 ---------------------------------------
2022-12-01 17:07:24 [Info] Web服务已启动：http://localhost:8888/1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.