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

创作时间:

作者:

@小白创作中心

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

引用

CSDN

https://blog.csdn.net/faker1234546/article/details/139217696

当你想使用最快的框架创建项目的时候是不是有点束手无策？当你想配置数据库写 SQL 甚至不知道如何写，文件夹都不知道建在哪里？因为Golang 目前并没有 JAVA 那种硬性规范，但是没硬性规范≠没有规范。本文将以 Gin（一个轻量的 WEB 框架，类似 SpringMVC）为切入点，来了解如何使用 Golang 快速创建一个规范的 web 项目，并且了解内部的一些简单的思维逻辑转换。

1. 创建合适的目录

首先我们要明白一个根本思路，Golang项目都是一小再小的项目，是为微服务服务的。我们可以直接去掉一些没必要的抽象层，只保留最基本的逻辑层划分。这些对应着：

controller --> controller
service --> logic
dao --> db

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

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

我这里分为两个文件：

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

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

import (
    "fmt"
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
    "os"
)

var db *gorm.DB

type DBConfig struct {
    DbUser     string
    DbPassword string
    DbName     string
    DbHost     string
    DbPort     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 error
    db, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
}

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

3. 写一个登录接口

我们就从 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 logic
import "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 logic
import "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    int
    Name  string
    Email string
    Age   int
}