如何在 Golang 中优雅的处理 MySQL 中的 Null 值

本文探讨了在Golang中处理MySQL返回的null值,特别是datetime字段,介绍了一种使用自定义NullTime类型来实现与time.Time一致的JSON序列化和反序列化的方法。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

众所周知,在 MySQL 中,有一些字段不可逃避的要有 null 值。比如 datetime 字段,如果没有值,那么只能是 null 值。如果在 Golang 中不去做处理,而直接使用 time.Time 类型,则会报错,提示不能将 sql.NullTime 值转换为 time.Time

这时候,一脸懵逼。

当你开心的将 struct 中 time.Time 类型改为 sql.NullTime 类型的时候,以为自己解决了这个问题。

但是之后将从 DB 取出来的数据 Marshal 到 一个 time.Time 类型的 struct 的时候,出现了惊人的一幕。
Marshal 的结果,他不是一个 time.Time,而是一个 sql.NullTime的结构。

{"Time":"2020-07-19T20:10:01.972722+08:00","Valid":true}

那么如何让 sql.NullTimeMarshalUnmarshaltime.Time 表现一致呢?

{"Time":"2020-07-19T20:10:01.972722+08:00","Valid":true}
=>
"2020-07-19T20:10:01.972722+08:00"

可以使用 json.Marshaler 的 interface 下 MarshalJSONUnmarshalJSON 方法:

如下大法可以轻松破解此问题。
(参考:https://zhuanlan.zhihu.com/p/21933959

package types

import (
	"database/sql"
	"encoding/json"
	"time"
)

type NullTime struct {
	sql.NullTime
}

func (v NullTime) MarshalJSON() ([]byte, error) {
	if v.Valid {
		return json.Marshal(v.Time)
	} else {
		return json.Marshal(nil)
	}
}

func (v *NullTime) UnmarshalJSON(data []byte) error {
	var s *time.Time
	if err := json.Unmarshal(data, &s); err != nil {
		return err
	}
	if s != nil {
		v.Valid = true
		v.Time = *s
	} else {
		v.Valid = false
	}
	return nil
}

注意 MarshalJSON 方法是「非指针」的

利用 MarshalerMarshalJSONUnmarshalJSON 的方法来处理 null 值的情况。具体依据来源于 golang json marshal 源码 https://github.com/golang/go/blob/master/src/encoding/json/encode.go#L494

### 使用 Golang 和 Gin 框架连接 MySQL 创建 API 接口 #### 创建并配置项目结构 为了构建一个基于Gin框架的应用程序,首先需要初始化一个新的Go模块: ```bash go mod init example.com/gin-mysql-api ``` 接着安装必要的依赖包: ```bash go get -u github.com/gin-gonic/gin go get -u gorm.io/gorm go get -u gorm.io/driver/mysql ``` #### 初始化数据库连接 在 `main.go` 文件中设置MySQL数据库的连接字符串,并利用GORM建立与数据库之间的会话。 ```go package main import ( "fmt" "gorm.io/driver/mysql" "gorm.io/gorm" ) var db *gorm.DB var err error func InitDB() { dsn := "user:password@tcp(127.0.0.1:3306)/gin_demo?charset=utf8mb4&parseTime=True&loc=Local" db, err = gorm.Open(mysql.Open(dsn), &gorm.Config{}) if err != nil { fmt.Println("Failed to connect database:", err) panic(err) } } ``` 这段代码展示了如何打开到名为 `gin_demo` 的MySQL数据库的连接[^1]。请注意替换DSN中的用户名、密码和其他参数以匹配实际环境下的配置。 #### 定义模型层 (Model Layer) 假设要管理成员(`Member`)的数据,则可以在应用里定义相应的结构体来映射表字段。 ```go type Member struct { ID uint `json:"id"` Name string `json:"name" gorm:"not null"` Email string `json:"email" gorm:"uniqueIndex;not null"` CreatedAt time.Time UpdatedAt time.Time } ``` 此部分描述了实体类的设计原则及其属性约束条件[^2]。 #### 实现业务逻辑服务 (Service Layer) 编写服务于具体功能的服务函数,比如新增会员记录: ```go // CreateMember creates a new member record. func CreateMember(m *Member) (*Member, error) { result := db.Create(&m) if result.Error != nil { return nil, result.Error } return m, nil } ``` 上述片段说明了怎样封装基本的操作以便于后续调用。 #### 构建控制器 (Controller Layer) 最后一步是在HTTP请求处理器内实现对外暴露的功能端点。下面的例子实现了POST /members 路由用来接收客户端提交的新用户资料并保存至数据库。 ```go package controllers import ( "net/http" "github.com/gin-gonic/gin" ) func AddMember(c *gin.Context) { var input Member if err := c.ShouldBindJSON(&input); err == nil { createdMember, _ := service.CreateMember(&input) c.JSON(http.StatusOK, gin.H{"data": createdMember}) } else { c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) } } func SetupRoutes(engine *gin.Engine) { v1 := engine.Group("/api/v1") { members := v1.Group("/members") { members.POST("", AddMember) } } } ``` 以上内容解释了如何通过组合先前各层次组件完成一次完整的API交互过程。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值