types

README

types

types 包提供了一些实现了sql.Scanner和sql.Valuer接口的实例类型

适合作为 databases/sql 的扫描和赋值目标。 类型列表：

• GzippedText
• JSONText
• NullJSONText
• BitBool
• SqlDate
• SqlDateTime
• SqlTime

Documentation

Overview

Package types 提供了一些实现了`sql.Scanner`和`sql.Valuer`接口的实例类型 适合作为 databases/sql 的扫描和赋值目标。

Index

• type BitBool
  • func (b *BitBool) Scan(src any) error
  • func (b BitBool) Value() (driver.Value, error)
• type DBDate
  • func (d *DBDate) Scan(src any) error
  • func (d DBDate) String() string
  • func (d DBDate) Value() (driver.Value, error)
• type DBDateTime
  • func (d *DBDateTime) Scan(src any) error
  • func (d DBDateTime) String() string
  • func (d DBDateTime) Value() (driver.Value, error)
• type DBTime
  • func (t *DBTime) Scan(src any) error
  • func (t DBTime) String() string
  • func (t DBTime) Value() (driver.Value, error)
• type GzippedText
  • func (g *GzippedText) Scan(src any) error
  • func (g GzippedText) Value() (driver.Value, error)
• type JSONText
  • func (j JSONText) MarshalJSON() ([]byte, error)
  • func (j *JSONText) Scan(src any) error
  • func (j JSONText) String() string
  • func (j *JSONText) Unmarshal(v any) error
  • func (j *JSONText) UnmarshalJSON(data []byte) error
  • func (j JSONText) Value() (driver.Value, error)
• type NullJSONText
  • func (n *NullJSONText) Scan(value any) error
  • func (n NullJSONText) Value() (driver.Value, error)

Types

type BitBool

type BitBool bool

BitBool 是 MySQL BIT(1) 类型的 bool 实现。 此类型使你可以避免为 MySQL 的布尔类型 TINYINT 浪费整个字节。

func (*BitBool) Scan

func (b *BitBool) Scan(src any) error

Scan 实现 sql.Scanner 接口， 将 MySQL 传入的 bitfield 转换为 BitBool。

func (BitBool) Value

func (b BitBool) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口， 将 BitBool 转换为 bitfield (BIT(1)) 用于 MySQL 存储。

type DBDate

type DBDate time.Time

DBDate 表示一个只包含年月日的日期类型。 它实现了 sql.Scanner 和 driver.Valuer 接口， 入库时转换为 yyyy-MM-dd 格式，出库时按 yyyy-MM-dd 格式解析。

func (*DBDate) Scan

func (d *DBDate) Scan(src any) error

Scan 实现 sql.Scanner 接口，按 yyyy-MM-dd 格式解析数据库返回值。

func (DBDate) String

func (d DBDate) String() string

String 返回 yyyy-MM-dd 格式的字符串。

func (DBDate) Value

func (d DBDate) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口，返回 yyyy-MM-dd 格式的字符串。

type DBDateTime

type DBDateTime time.Time

DBDateTime 表示一个包含年月日时分秒的日期时间类型。 它实现了 sql.Scanner 和 driver.Valuer 接口， 入库时转换为 yyyy-MM-dd HH:mm:ss 格式，出库时按该格式解析。

func (*DBDateTime) Scan

func (d *DBDateTime) Scan(src any) error

Scan 实现 sql.Scanner 接口，按 yyyy-MM-dd HH:mm:ss 格式解析数据库返回值。

func (DBDateTime) String

func (d DBDateTime) String() string

String 返回 yyyy-MM-dd HH:mm:ss 格式的字符串。

func (DBDateTime) Value

func (d DBDateTime) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口，返回 yyyy-MM-dd HH:mm:ss 格式的字符串。

type DBTime

type DBTime time.Time

DBTime 表示一个只包含时分秒的时间类型。 它实现了 sql.Scanner 和 driver.Valuer 接口， 入库时转换为 HH:mm:ss 格式，出库时按 HH:mm:ss 格式解析。

func (*DBTime) Scan

func (t *DBTime) Scan(src any) error

Scan 实现 sql.Scanner 接口，按 HH:mm:ss 格式解析数据库返回值。

func (DBTime) String

func (t DBTime) String() string

String 返回 HH:mm:ss 格式的字符串。

func (DBTime) Value

func (t DBTime) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口，返回 HH:mm:ss 格式的字符串。

type GzippedText

type GzippedText []byte

GzippedText 是一个 []byte, 在提交到数据库时自动 gzip 压缩数据 并在从数据库中 Scan 时自动解压数据

func (*GzippedText) Scan

func (g *GzippedText) Scan(src any) error

Scan 实现 sql.Scanner 接口，解压从网络传输过来的值， 并将原始结果存储在 GzippedText 中。

func (GzippedText) Value

func (g GzippedText) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口，对此 GzippedText 的原始值进行 gzip 压缩。

type JSONText

type JSONText json.RawMessage

JSONText 是 json.RawMessage 的类型别名，底层是 []byte。 Value() 验证源数据中的 JSON 格式，如果 JSON 无效则返回错误。 Scan 不进行验证。JSONText 还实现了 Unmarshal 方法， 将内部的 JSON 反序列化到 any。

func (JSONText) MarshalJSON

func (j JSONText) MarshalJSON() ([]byte, error)

MarshalJSON 返回 *j 的 JSON 编码。

func (*JSONText) Scan

func (j *JSONText) Scan(src any) error

Scan 将 src 存储到 *j 中，不进行验证。

func (JSONText) String

func (j JSONText) String() string

String 支持 JSONText 类型的格式化输出。

func (*JSONText) Unmarshal

func (j *JSONText) Unmarshal(v any) error

Unmarshal 将 j 中的 JSON 反序列化到 v，类似于 json.Unmarshal。

func (*JSONText) UnmarshalJSON

func (j *JSONText) UnmarshalJSON(data []byte) error

UnmarshalJSON 将 *j 设置为 data 的副本。

func (JSONText) Value

func (j JSONText) Value() (driver.Value, error)

Value 将 j 作为值返回。它会执行一次验证性的反序列化到另一个 RawMessage。如果 j 是无效的 JSON，则返回错误。

type NullJSONText

type NullJSONText struct {
	JSONText
	Valid bool // Valid 为 true 表示 JSONText 不为 NULL
}

NullJSONText 表示一个可能为 null 的 JSONText。 NullJSONText 实现了 Scanner 接口，因此可以像 NullString 一样 用作扫描目标。

func (*NullJSONText) Scan

func (n *NullJSONText) Scan(value any) error

Scan 实现 Scanner 接口。

func (NullJSONText) Value

func (n NullJSONText) Value() (driver.Value, error)

Value 实现 driver.Valuer 接口。