Golang創(chuàng)建第一個web項目(Gin+Gorm)

更新時間：2024年06月03日 09:11:49 作者：只會寫bug的靚仔

本文主要介紹了Golang創(chuàng)建第一個web項目(Gin+Gorm),文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

1. 寫這篇博客的由來：

當你想使用最快的框架創(chuàng)建項目的時候是不是有點束手無策？

當你想配置數據庫寫 SQL 甚至不知道如何寫，文件夾都不知道建在哪里？

在這里插入圖片描述

??因為Golang 目前并沒有 JAVA 那種硬性規(guī)范，但是 沒硬性規(guī)范≠沒有規(guī)范

我們以 Gin （一個輕量的 WEB 框架，類似 SpringMVC）為切入點，來了解如何使用 Golang 快速創(chuàng)建一個規(guī)范的 web 項目，并且了解內部的一些簡單的思維邏輯轉換。

2. 創(chuàng)建合適的目錄

首先我們要明白一個根本思路，Golang項目都是一小再小的項目，是為微服務服務的。

??我們可以直接去掉一些沒必要的抽象層，只保留最基本的邏輯層劃分。

在這里插入圖片描述

這些對應著 controller --> controller， service --> logic, dao --> db.

當然，這些根據自己喜好就行，規(guī)范如 JAVA 都沒有強制大家目錄一致，更不用說靈活的 Golang 了。

3. 沒有了application.yml 如何寫數據庫（ DAO --> DB ）

在這里插入圖片描述

我這里分為兩個文件，

一個文件為保存一些基本信息，初始化方法，連接池指針（db_config.go）在 Go 一般通過環(huán)境變量配置數據庫信息，這里直接創(chuàng)建連接池。

由于 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。

4. 寫一個登錄接口

我們就從 gin 的入口開始一直寫到 db 層

在 main.go 中寫相關路由

func main() {
	//初始化連接池

	db.InitDB()
	// 創(chuàng)建路由

	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 里已經處理過參數了，這里不需要怎么處理，這里如果想方便一點可以封裝成結構體

然后是邏輯業(yè)務層 logic

注意到我們直接返回兩個參數，一個狀態(tài)碼，一個返回數據，這里借助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
}