引入数据库驱动

GoFrame的数据库组件使用了接口化设计,接口与实现是分离的,这样能提供更好的抽象和扩展性。我们这里使用了mysql数据库,那么需要引入具体的mysql驱动实现。我们在main.go中加上_ "github.com/gogf/gf/contrib/drivers/mysql/v2"即可。

示例源码:https://github.com/gogf/quick-demo/blob/main/main.go

main.go

  1. package main
  2. import (
  3. _ "demo/internal/packed"
  4. _ "github.com/gogf/gf/contrib/drivers/mysql/v2"
  5. "github.com/gogf/gf/v2/os/gctx"
  6. "demo/internal/cmd"
  7. )
  8. func main() {
  9. cmd.Main.Run(gctx.GetInitCtx())
  10. }

数据库的驱动,项目只需要引入这一次即可,后续都不需要做调整。 更多关于数据库驱动的支持以及详细介绍,请参考章节 数据库ORM

如果在没有引入数据库驱动的情况下执行数据库操作,数据库ORM组件会报如下的错误提示:

  1. cannot find database driver for specified database type "mysql", did you misspell type name "mysql" or forget importing the database driver? possible reference: https://github.com/gogf/gf/tree/master/contrib/drivers

Step6 - 配置与路由 - 图1提示

在脚手架项目模板main.goimport中有一段_ "demo/internal/packed",表示GoFrame框架的资源管理,这是一个高级特性。该特性可以将任何资源打包进二进制文件,这样我们在发布的时候,仅需要发布一个二进制文件即可。我们这里没有用到该特性,因此大家了解即可,感兴趣可以后续查阅开发手册相关章节。

添加数据库配置

在脚手架项目模板中主要有两个配置文件。

工具配置 hack/config.yaml

在前面的章节我们已经有过介绍。这个配置文件主要是本地开发时候使用,当cli脚手架工具执行时会自动读取其中的配置内容。

示例源码:https://github.com/gogf/quick-demo/blob/main/hack/config.yaml

业务配置 manifest/config/config.yaml

主要维护业务项目的组件配置信息、业务模块配置,完全由开发者自行维护。在程序启动时会读取该配置文件。该业务 默认的脚手架项目模板提供的业务配置如下:

manifest/config/config.yaml

  1. # https://goframe.org/docs/web/server-config-file-template
  2. server:
  3. address: ":8000"
  4. openapiPath: "/api.json"
  5. swaggerPath: "/swagger"
  6. # https://goframe.org/docs/core/glog-config
  7. logger:
  8. level : "all"
  9. stdout: true
  10. # https://goframe.org/docs/core/gdb-config-file
  11. database:
  12. default:
  13. link: "mysql:root:12345678@tcp(127.0.0.1:3306)/test"

默认提供了3项组件的配置,分别为:

  • serverWeb Server的配置。这里默认配置的监听地址为:8000,并启用了接口文档特性。
  • logger:默认日志组件的配置。这里的日志级别是所有日志都会打印,并且都会输出到标准输出。
  • database:数据库组件的配置。这只是一个模板,需要我们根据实际情况修改链接地址。

每一项组件配置的注释上提供了官网文档的配置参考链接。我们这里需要修改数据库配置中的链接信息,为我们真实可用的链接信息。关于数据库的配置详细介绍,感兴趣请参考章节:ORM使用配置-配置文件

示例源码:https://github.com/gogf/quick-demo/blob/main/manifest/config/config.yaml

添加路由注册

添加我们新填写的api到路由非常简单,如下:

goframe路由注册

在分组路由的group.Bind方法中,通过user.NewV1()添加我们的路由对象即可。

示例源码:https://github.com/gogf/quick-demo/blob/main/internal/cmd/cmd.go

到目前为止,我们的接口已经完全开发完了,下一步,我们将启动服务,并做一些接口测试,查看效果。

学习小结

当我们在使用数据库功能的时候,需要引入特定的数据库驱动。在GoFrame官方仓库中,通过社区组件的形式提供了常用数据库的驱动实现。我们的程序主要使用的是业务配置,并且需要将其中的数据库连接地址修改为我们搭建的数据库地址。

路由注册就太简单了,添加一个controller对象到分组路由注册中group.Bind即可。

目前为止,我们已经将CURD接口开发完成啦👏👏。可以看到,我们做的事情主要是这几项:

  • 数据库表设计
  • api接口定义
  • 接口的业务逻辑实现
  • 简单的配置和路由注册

下一步,我们启动程序看看效果吧。