Files

xlgo 示例

两个可运行示例,帮助快速上手 xlgo。

minimal — 最小 HTTP 服务

不依赖 MySQL / Redis / Storage,纯 HTTP + 健康检查。第一次接触 xlgo 从这里开始。

go run ./examples/minimal

访问 http://localhost:8081/health(健康检查)与 http://localhost:8081/api/v1/(示例路由)

full — 完整业务 API

包含 MySQL + Redis + JWT + 一个 user CRUD(登录发 token、认证路由、创建/查询用户)。

运行前需准备

  • MySQL(修改 examples/full/config.yamldatabase 配置)
  • Redis(修改 examples/full/config.yamlredis 配置)
go run ./examples/full

启动后自动迁移 user 表,并初始化示例用户 alice/secret(密码以 bcrypt 哈希保存)。接口:

方法 路径 说明 认证
POST /api/v1/login 登录,返回 token
GET /api/v1/users/:id 查询用户 是(Bearer token
POST /api/v1/users 创建用户 是(Bearer token

登录示例:

curl -X POST http://localhost:8082/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"username":"alice","password":"secret"}'

创建用户示例:

curl -X POST http://localhost:8082/api/v1/users \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"username":"bob","password":"s3cret"}'

示例代码为演示用途,已演示 bcrypt 密码哈希与登录校验;生产环境仍需配合 validation 包完善入参校验、密码强度策略与用户注册流程。