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

蔚落 2024-03-26 18:44 5阅读 0赞

##  ##

## 概述 ##

*  文档（国内）\[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集群日志收集）支持代码无侵入的全链路实时监控。

### 集成的组件 ###

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

### 如何开始 ###

*main.go*

package main
    import "github.com/farseer-go/fs"
    
    func main() {
       fs.Initialize[StartupModule]("your project Name")
    }

> 在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\]

文档（国内）: *https://farseer-go.gitee.io/*

\[2\]

文档（国外）: *https://farseer-go.github.io/doc/*

\[3\]

开源（Github）: *https://github.com/farseer-go/fs*

\[4\]

.net core: *https://github.com/FarseerNet/Farseer.Net/*

\[5\]

FOPS: *https://github.com/FarseerNet/FOPS*

##  ##