上一篇文章講解了log/slog 包中的 LogValuer 和日志記錄函數(shù)的正確包裝方法，本文詳細(xì)講解一下 slog.Record 結(jié)構(gòu)體的使用方法和需要注意的點。

slog.Record

Record 類型用來保存日志事件的信息，定義如下：

type Record struct {
    Time time.Time
    Message string
    Level Level
    PC uintptr
    front [nAttrsInline]Attr
    nFront int
    back []Attr
}

有如下幾個方法：

func (r Record) Clone() Record，返回一個不共享狀態(tài)的副本，Record 和其克隆副本都可以被修改并且不會相互干擾。

func (r Record) NumAttrs() int，返回日志記錄中屬性的個數(shù)。

func (r Record) Attrs(f func(Attr) bool)，使用函數(shù) f 作用于日志記錄中的每個屬性，如果 f 返回 false，則停止迭代。

func (r *Record) AddAttrs(attrs ...Attr)，將給定的屬性追加到日志記錄的屬性列表中。

func (r *Record) Add(args ...any)，將參數(shù)轉(zhuǎn)換為 Logger.Log 中描述的 Attrs，然后將Attrs 追加到日志記錄中的 Attrs 列表。

func (r Record) source() *Source，返回日志事件的 Source。

使用示例

可以使用 slog.NewRecord 函數(shù)創(chuàng)建一個 Record 對象，使用 Record 記錄日志的示例代碼如下：

package main
 
import (
    "context"
    "log/slog"
    "os"
    "time"
)
 
func main() {
    logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
    r := slog.NewRecord(time.Now(), slog.LevelInfo, "test", 1)
    r.Add("title", "路多辛的博客")
    _ = logger.Handler().Handle(context.Background(), r)
}

運行程序，輸出結(jié)果如下：

time=2023-10-17T21:01:12.041+08:00 level=INFO msg=test title=路多辛的博客

在日常的使用場景中，會有這么一種情況，首先創(chuàng)建一個基礎(chǔ)的 Record 對象，然后會使用不同的 Handler 來基于這個對象分別做不同的處理。這種場景下，需要先調(diào)用 Clone 方法克隆一份 Record 對象的副本，然后傳遞給其他 Handler 做處理。這樣對副本的修改不會影響到原本的對象，對原本對象的修改也不會影響到副本，示例代碼如下：

package main
 
import (
    "context"
    "log/slog"
    "os"
    "time"
)
 
func main() {
    logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
    r := slog.NewRecord(time.Now(), slog.LevelInfo, "test", 1)
    r.Add("title", "路多辛的博客")
    _ = logger.Handler().Handle(context.Background(), r)
 
    r2 := r.Clone()
    r2.Add("subTitle", "路多辛的所思所想")
    l := slog.NewJSONHandler(os.Stdout, nil)
    _ = l.Handle(context.Background(), r2)
}

運行程序輸出結(jié)果如下：

time=2023-10-17T21:24:23.588+08:00 level=INFO msg=test title=路多辛的博客
{"time":"2023-10-17T21:24:23.588517+08:00","level":"INFO","msg":"test","title":"路多辛的博客","subTitle":"路多辛的所思所想"}

小結(jié)

本文講解了 slog.Record 結(jié)構(gòu)體的簡單使用方法和使用時需要注意的點，對應(yīng)的方法使用起來也都比較簡單，不再逐個講解，可以自己去嘗試使用。

到此這篇關(guān)于golang結(jié)構(gòu)化日志log/slog包之slog.Record的用法簡介的文章就介紹到這了,更多相關(guān)go結(jié)構(gòu)化日志slog內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論