Kratos 序列化

序列化

我們抽象出了?Codec?接口，用于統(tǒng)一處理請求的序列化/反序列化邏輯，您也可以實現(xiàn)您自己的Codec以便支持更多格式。具體源代碼在encoding。

目前內(nèi)置支持了如下格式：

• form
• json
• protobuf
• xml
• yaml

接口實現(xiàn)

?encoding ?的 ?Codec ?接口中,包含了 Marshal，Unmarshal，Name 三個方法，用戶只需要實現(xiàn) ?Codec ?即可使用自定義的 ?encoding?。

// Codec 用于定義傳輸時用到的編碼和解碼接口，實現(xiàn)這個接口時必須注意，實現(xiàn)必須是線程安全的，可以并發(fā)協(xié)程調(diào)用。
type Codec interface {
    Marshal(v interface{}) ([]byte, error)
    Unmarshal(data []byte, v interface{}) error
    Name() string
}

實現(xiàn)示例

在實現(xiàn) ?Codec ?時，可以參考 kratos 的內(nèi)置實現(xiàn), 如 json encoding，源代碼如下。

// https://github.com/go-kratos/kratos/blob/main/encoding/json/json.go
package json

import (
    "encoding/json"
    "reflect"

    "github.com/go-kratos/kratos/v2/encoding"
    "google.golang.org/protobuf/encoding/protojson"
    "google.golang.org/protobuf/proto"
)

// Name is the name registered for the json codec.
const Name = "json"

var (
    // MarshalOptions is a configurable JSON format marshaller.
    MarshalOptions = protojson.MarshalOptions{
        EmitUnpopulated: true,
    }
    // UnmarshalOptions is a configurable JSON format parser.
    UnmarshalOptions = protojson.UnmarshalOptions{
        DiscardUnknown: true,
    }
)

func init() {
    encoding.RegisterCodec(codec{})
}

// codec is a Codec implementation with json.
type codec struct{}

func (codec) Marshal(v interface{}) ([]byte, error) {
    switch m := v.(type) {
    case json.Marshaler:
        return m.MarshalJSON()
    case proto.Message:
        return MarshalOptions.Marshal(m)
    default:
        return json.Marshal(m)
    }
}

func (codec) Unmarshal(data []byte, v interface{}) error {
    switch m := v.(type) {
    case json.Unmarshaler:
        return m.UnmarshalJSON(data)
    case proto.Message:
        return UnmarshalOptions.Unmarshal(data, m)
    default:
        rv := reflect.ValueOf(v)
        for rv := rv; rv.Kind() == reflect.Ptr; {
            if rv.IsNil() {
                rv.Set(reflect.New(rv.Type().Elem()))
            }
            rv = rv.Elem()
        }
        if m, ok := reflect.Indirect(rv).Interface().(proto.Message); ok {
            return UnmarshalOptions.Unmarshal(data, m)
        }
        return json.Unmarshal(data, m)
    }
}

func (codec) Name() string {
    return Name
}

使用方式

注冊 Codec

encoding.RegisterCodec(codec{})

獲取 Codec

jsonCodec := encoding.GetCodec("json")

序列化

// 直接使用內(nèi)置 Codec 時需要 import _ "github.com/go-kratos/kratos/v2/encoding/json"
jsonCodec := encoding.GetCodec("json")
type user struct {
    Name string
    Age string
    state bool
}
u := &user{
    Name:  "kratos",
    Age:   "2",
    state: false,
}
bytes, _ := jsonCodec.Marshal(u)
fmt.Println(string(bytes))
// 輸出：{"Name":"kratos","Age":"2"}

反序列化

// 直接使用內(nèi)置 Codec 時需要 import _ "github.com/go-kratos/kratos/v2/encoding/json"
jsonCodec := encoding.GetCodec("json")
type user struct {
    Name string
    Age string
    state bool
}
u := &user{}
jsonCodec.Unmarshal([]byte(`{"Name":"kratos","Age":"2"}`), &u)
fmt.Println(*u)
// 輸出：&{kratos 2 false}