Golang的标准库提供了log的机制,但是该模块的功能较为简单(看似简单,其实他有他的设计思路)。不过比手写fmt. Printxxx还是强很多的。至少在输出的位置做了线程安全的保护。其官方手册见Golang log (天朝的墙大家懂的)。这里给出一个简单使用的例子:
packagemainimport( "log")func main(){ log.Fatal("Come with fatal,exit with 1 \n")}
Come with fatal,exit with 1echo $?
一般接口
Golang's log模块主要提供了3类接口。分别是 “Print 、Panic 、Fatal ”。当然是用前先包含log包。
import( "log")
SetOutput
对每一类接口其提供了3中调用方式,分别是 "Xxxx 、 Xxxxln 、Xxxxf" 比如对于Print就有:
log.Printlog.Printflog.Println
fmt.Printfmt.Printffmt.Println
这里是以 “Print”来具体说明的,对于“Panic”和“Fatal”也是一样的。下面再以"Print"为例,看下调用方式:
packagemainimport( "log")func main(){ arr := []int{2,3} log.Print("Print array ",arr,"\n") log.Println("Println array",arr) log.Printf("Printf array with item [%d,%d]\n",arr[0],arr[1])}
会得到如下结果:
2014/05/0212:27:19Print array [23]2014/05/0212:27:19Println array [23]2014/05/0212:27:19Printf array withitem [2,3]
SetFlagsSetPrefix
SetOutputSetFlagsSetPrefix
log.PrintXxxlog.FatalXxxlog.Fatallog.Fatalos.exit(1)
log.PanicXxxpanic
packagemainimport( "log" "fmt")func main(){ defer func(){ ife:= recover();e!= nil { fmt.Println("Just comming recover") fmt.Println("e from recover is :",e) fmt.Println("After recover") } }() arr := []int{2,3} log.Panic("Print array ",arr,"\n")}
结果为:
2014/05/0313:52:42Print array [23]Just comming recovere from recover is: Print array [23]After recover
从结果我们可以看出,是先将日志刷入标准输出,然后通过defer里面的recover进行捕获panic的内容。
自定义Logger类型
log.Logger
func New(out io.Writer, prefix string, flag int) *Logger
SetOutputSetFlagsSetPrefix
-
输出位置out,是一个io.Writer对象,该对象可以是一个文件也可以是实现了该接口的对象。通常我们可以用这个来指定 其输出到哪个文件
-
prefix 我们在前面已经看到,就是在日志内容前面的内容。我们可以将其置为 "[Info]" 、 "[Warning]"等来帮助区分日志 级别。
-
flags 较为迷惑,其实际上就是一个选项,可选的值有:
Ldate = 1<< iota // the date: 2009/01/23 形如 2009/01/23 的日期Ltime // the time: 01:23:23 形如 01:23:23 的时间Lmicroseconds // microsecond resolution: 01:23:23.123123. 形如01:23:23.123123 的时间Llongfile // full file name and line number: /a/b/c/d.go:23 全路径文件名和行号Lshortfile // final file name element and line number: d.go:23. overrides Llongfile 文件名和行号LstdFlags = Ldate | Ltime // 日期和时间
表示在日志内容开头,我们暂且称之为日志抬头,打印出相关内容。对于上面的默认格式就是 LstdFlags 打印出日期和时间。
该方法还定义了如上一些同名方法。
func (l *Logger) Print(v ...interface{})func (l *Logger) Printf(format string, v ...interface{})func (l *Logger) Println(v ...interface{})func (l *Logger) Fatal(v ...interface{})func (l *Logger) Fatalf(format string, v ...interface{})func (l *Logger) Fatalln(v ...interface{})func (l *Logger) Panic(v ...interface{})func (l *Logger) Panicf(format string, v ...interface{})func (l *Logger) Panicln(v ...interface{})func (l *Logger) Flags() intfunc (l *Logger) Prefix() stringfunc (l *Logger) SetFlags(flag int)func (l *Logger) SetPrefix(prefix string)
其中 “Print 、Panic 、Fatal ” 系列函数和之前介绍的一样,Flags和Prefix分别可以获得log.Logger当前的日志抬头和前缀。 SetFlags ,SetPrefix 则可以用来设置日志抬头和前缀。
使用实例
最后我看有log模块将debug日志打印到文件的实例。
packagemainimport( "log" "os")func main(){ fileName := "xxx_debug.log" logFile,err := os.Create(fileName) defer logFile.Close() iferr != nil { log.Fatalln("open file error !") } debugLog := log.New(logFile,"[Debug]",log.Llongfile) debugLog.Println("A debug message here") debugLog.SetPrefix("[Info]") debugLog.Println("A Info Message here ") debugLog.SetFlags(debugLog.Flags() | log.LstdFlags) debugLog.Println("A different prefix")}
运行后打开日志文件我们可以看到相应的日志内容