Gorsk-Gin 项目教程
1. 项目的目录结构及介绍
Gorsk-Gin 是一个基于 Gin 框架的 Golang RESTful 服务启动器。项目的目录结构如下:
gorsk-gin/
├── cmd/
│ ├── api/
│ │ ├── server.go
│ │ └── ...
│ └── migration/
│ └── main.go
├── internal/
│ ├── mock/
│ │ └── mock.go
│ └── ...
├── platform/
│ └── postgres/
│ └── ...
├── .travis.yml
├── LICENSE
├── README.md
├── test.sh
└── ...
目录结构介绍
-
cmd/: 包含应用程序的主要入口文件。
- api/: 包含 API 服务器的启动文件
server.go
。 - migration/: 包含数据库迁移的入口文件
main.go
。
- api/: 包含 API 服务器的启动文件
-
internal/: 包含项目的内部逻辑和实现细节。
- mock/: 包含用于测试的模拟数据和逻辑。
-
platform/: 包含与特定平台相关的代码,例如数据库访问层。
- postgres/: 包含与 PostgreSQL 数据库交互的代码。
-
.travis.yml: Travis CI 配置文件。
-
LICENSE: 项目许可证文件。
-
README.md: 项目说明文档。
-
test.sh: 测试脚本。
2. 项目的启动文件介绍
cmd/api/server.go
这是 Gorsk-Gin 项目的启动文件,负责初始化并启动 HTTP 服务器。主要功能包括:
- 初始化路由
- 加载配置
- 建立数据库连接
- 启动 HTTP 服务器
cmd/migration/main.go
这是数据库迁移的入口文件,负责创建数据库表和初始数据。主要功能包括:
- 配置数据库连接
- 执行数据库迁移脚本
3. 项目的配置文件介绍
Gorsk-Gin 项目的配置文件通常是一个 YAML 文件,用于配置应用程序的各种参数,例如数据库连接、JWT 密钥、日志级别等。
配置文件示例
database:
host: "localhost"
port: 5432
user: "user"
password: "password"
dbname: "gorsk"
jwt:
secret: "your-secret-key"
logging:
level: "info"
配置文件介绍
-
database: 配置数据库连接信息。
- host: 数据库主机地址。
- port: 数据库端口。
- user: 数据库用户名。
- password: 数据库密码。
- dbname: 数据库名称。
-
jwt: 配置 JWT 密钥。
- secret: JWT 签名密钥。
-
logging: 配置日志级别。
- level: 日志输出级别,例如
info
,debug
,error
等。
- level: 日志输出级别,例如
通过以上配置文件,可以灵活地调整 Gorsk-Gin 项目的运行环境。