Thunder 项目教程

1. 项目的目录结构及介绍

Thunder 项目的目录结构如下：

thunder/
├── client/
├── concurrencylimiter/
├── diff/
├── doc/
├── example/
├── federation/
├── federationexample/
├── graphql/
├── internal/
├── livesql/
├── logger/
├── merge/
├── reactive/
├── sqlgen/
├── thunderpb/
├── tools/
│   └── listEntryNonNullablePatcher/
├── .gitignore
├── .travis.yml
├── CHANGELOG.md
├── LICENSE
├── README.md
├── go.mod
├── go.sum
└── runfederationexample.sh

目录介绍：

• client/: 包含 Thunder 的客户端相关代码。
• concurrencylimiter/: 并发限制器相关代码。
• diff/: 差异比较相关代码。
• doc/: 项目文档相关文件。
• example/: 示例代码，展示如何使用 Thunder。
• federation/: 联邦相关代码。
• federationexample/: 联邦示例代码。
• graphql/: GraphQL 相关代码。
• internal/: 内部使用的代码，不对外公开。
• livesql/: 实时 SQL 相关代码。
• logger/: 日志记录相关代码。
• merge/: 合并相关代码。
• reactive/: 响应式编程相关代码。
• sqlgen/: SQL 生成相关代码。
• thunderpb/: Thunder 的 Protocol Buffers 相关代码。
• tools/: 工具代码，例如 listEntryNonNullablePatcher。
• .gitignore: Git 忽略文件配置。
• .travis.yml: Travis CI 配置文件。
• CHANGELOG.md: 项目更新日志。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• go.mod: Go 模块依赖文件。
• go.sum: Go 模块依赖校验文件。
• runfederationexample.sh: 运行联邦示例的脚本。

2. 项目的启动文件介绍

Thunder 项目的启动文件主要是 example/ 目录下的示例代码。这些示例代码展示了如何使用 Thunder 构建 GraphQL 服务。

示例启动文件：

• example/main.go: 这是 Thunder 的一个简单示例，展示了如何使用 Thunder 构建一个基本的 GraphQL 服务。

启动步骤：

1. 进入 example/ 目录：

   cd example
   

2. 运行示例代码：

   go run main.go
   

3. 访问 http://localhost:8080/graphql 即可查看 GraphQL 接口。

3. 项目的配置文件介绍

Thunder 项目的主要配置文件是 go.mod 和 go.sum，它们用于管理 Go 模块的依赖。

go.mod

go.mod 文件定义了项目的模块路径和依赖项。例如：

module github.com/samsarahq/thunder

go 1.16

require (
    github.com/gorilla/websocket v1.4.2
    github.com/stretchr/testify v1.7.0
    // 其他依赖项
)

go.sum

go.sum 文件包含了所有依赖项的校验和，确保依赖项的完整性和安全性。

其他配置文件

• .gitignore: 用于指定 Git 忽略的文件和目录。
• .travis.yml: Travis CI 的配置文件，用于持续集成。
• CHANGELOG.md: 记录项目的更新日志。
• LICENSE: 项目的开源许可证。
• README.md: 项目的介绍和使用说明。

这些配置文件共同确保了 Thunder 项目的正常运行和维护。