Golang 创建第一个web项目（Gin + Gorm）

1. 写这篇博客的由来：

当你想使用最快的框架创建项目的时候是不是有点束手无策？

当你想配置数据库写 SQL 甚至不知道如何写，文件夹都不知道建在哪里？
在这里插入图片描述

😄因为Golang 目前并没有 JAVA 那种硬性规范，但是 没硬性规范≠没有规范

我们以 Gin （一个轻量的 WEB 框架，类似 SpringMVC）为切入点，来了解如何使用 Golang 快速创建一个规范的 web 项目，并且了解内部的一些简单的思维逻辑转换。

2. 创建合适的目录

首先我们要明白一个根本思路，Golang项目都是一小再小的项目，是为微服务服务的。

😄我们可以直接去掉一些没必要的抽象层，只保留最基本的逻辑层划分。

在这里插入图片描述
这些对应着 controller --> controller， service --> logic, dao --> db.

当然，这些根据自己喜好就行，规范如 JAVA 都没有强制大家目录一致，更不用说灵活的 Golang 了。

3. 没有了application.yml 如何写数据库（ DAO --> DB ）

在这里插入图片描述
我这里分为两个文件，

一个文件为保存一些基本信息，初始化方法，连接池指针（db_config.go）在 Go 一般通过环境变量配置数据库信息，这里直接创建连接池。

由于 dao 和这个配置文件都在 db 包下，所以可以不直接暴露连接池指针。

import ("fmt""gorm.io/driver/mysql""gorm.io/gorm""os"
)var db *gorm.DBtype DBConfig struct {DbUser     stringDbPassword stringDbName     stringDbHost     stringDbPort     string
}func NewDBConfig() *DBConfig {return &DBConfig{DbUser:     os.Getenv("DB_USER"),DbPassword: os.Getenv("DB_PASSWORD"),DbName:     os.Getenv("DB_NAME"),DbHost:     os.Getenv("DB_HOST"),DbPort:     os.Getenv("DB_PORT"),}
}
func InitDB() {config := NewDBConfig()dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", config.DbUser, config.DbPassword, config.DbHost, config.DbPort, config.DbName)var err errordb, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})if err != nil {panic("failed to connect database")}
}

另一个文件是传统的 dao 层的内容，写一些读取数据的接口正常的dao。

4. 写一个登录接口

我们就从 gin 的入口开始一直写到 db 层

在 main.go 中写相关路由

func main() {//初始化连接池db.InitDB()// 创建路由r := gin.Default()r.POST("/register", func(c *gin.Context) {email := c.PostForm("email")username := c.PostForm("username")age, _ := strconv.Atoi(c.PostForm("age"))fmt.Println("email->"+email, "username->"+username+"age->", age)code, data := controller.RegisterUser(email, username, age)c.JSON(code, gin.H{"data": data})})// 运行服务器r.Run(":8080")
}

在这里插入图片描述
其实这里获取参数最好是放到controller里面，其实思路和 JAVA 一致，不过这里用的是方法而不是注解。

然后是controller层

package logicimport "easylive-user/db"func RegisterUser(email string, username string, age int) (int, interface{}) {return db.AddUser(email, username, age)
}

由于我在main.go 里已经处理过参数了，这里不需要怎么处理，这里如果想方便一点可以封装成结构体

然后是逻辑业务层 logic

注意到我们直接返回两个参数，一个状态码，一个返回数据，这里借助golang 可以返回多结果的特点，我们再次简化封装，不在使用 JAVA 的再封装一个回复体。

直接借助 Http 的自有code 码判断，Golang 的思路是灵活，我的思路就是精简精简再精简。
在这里插入图片描述

Golang 由于本身不适合巨大的单体项目，我们就反其道而行之，能精简就精简

package logicimport "easylive-user/db"func RegisterUser(email string, username string, age int) (int, interface{}) {affected := db.AddUser(email, username, age)if affected >= 1 {return 200, nil} else {return 500, nil}
}

然后是 db/dao层，这里涉及数据库的调用处理，这里我使用的是 Gorm 框架，类似 JAVA 的 Mybatis Plus，

func AddUser(email string, username string, age int) int {result := db.Create(&User{Email: email, Name: username, Age: age})fmt.Println(result)return int(result.RowsAffected)}type User struct {id    intName  stringEmail stringAge   int
}