七叶笔记 » golang编程 » go语言学习总结(三十六)log,logger

go语言学习总结(三十六)log,logger

介绍一下golang如何记log。

log 首先是golang自带的package log。使用godoc查看,godoc -http=:8001,然后就可以在localhost:8001/pkg/log就可以查看了。

最重要的是SetOutput这个函数,原型是func SetOutput(w io.Writer),决定了log应该输出到什么地方,默认是标准输出。下面是把log输出到文件的一个简单代码示例。

 package main
import (
    "log"
    "os"
)
func main() {
    f, err := os.OpenFile("logfile.log", os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)
    if err != nil {
    log.Fatalf("file open error : %v", err)
    }
    defer f.Close()
    log.SetOutput(f)
    log.Println("This is a test log entry")
}  

我们此时打开文件logfile.log,会看到文件内容如下。

 2016/03/11 17:54:10 This is a test log entry  

有时候我们并不需要前面的日期以及时间信息,比如做自动化测试的时候比对log肯定不希望有时间信息。那应该怎么办呢?这时候就该SetFlags()出场了。

 package main
import (
    "log"
    "os"
)
func main() {
    f, err := os.OpenFile("logfile.log", os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)
    if err != nil {
    log.Fatalf("file open error : %v", err)
    }
    defer f.Close()
    log.SetOutput(f)
    log.SetFlags(0)
    log.Println("This is a test log entry")
}  

SetFlags(flag int)函数可以用来自定义log的输出格式,flag可选如下任意个标志的或操作的组合。

 const (
    Ldate         = 1 << iota     // the date: 2009/01/23
    Ltime                         // the time: 01:23:23
    Lmicroseconds                 // microsecond resolution: 01:23:23.123123.  assumes Ltime.
    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 // initial values for the standard logger
)  

iota的语法就不细说了,这里Ldate,Ltime,Lmicroseconds分别表示右起第一二三位。

自定义log形式还可以使用SetPrefix(prefix string)可以在我们的log最前面添加特定的prefix。除此之外剩下的API,比如Fatal,Fatalf,Panic等都相当于先输出log,然后调用Exit()或者panic函数。

logger

logger是log的一个简单封装,使用logger可以使记log更加的便捷。一个简单的示例如下。

 package main
import (
    "log"
    "os"
)
func main() {
    logger := log.New(os.Stdout, "DEBUG", log.Ldata | log.Ltime)
    logger.Println("This is a DEBUG LOG")
}  

运行上述go程序,将在终端得到如下结果:DEBUG: 2016/03/11 22:21:19 This is a DEBUG LOG

我们简单看一下log.New()函数原型。func New(out io.Writer, prefix string, flag int) *Logger

os.Stdout表示标准输出,如果你想记录到文件中,将os.Open()或者os.OpenFile()的返回值传入即可。”DEBUG”即为每条log的前缀,最后的flag就为上述的flag。相比于上面的代码片段,下面的代码更加的实用。

 package main
import (
    "io"
    "io/ioutil"
    "log"
    "os"
)
var (
    Info    *log.Logger
    Warning *log.Logger
    Error   *log.Logger
)
func Init(
    infoHandle io.Writer,
    warningHandle io.Writer,
    errorHandle io.Writer) {
    Info = log.New(infoHandle,
        "INFO: ",
        log.Ldate|log.Ltime|log.Lshortfile)
    Warning = log.New(warningHandle,
        "WARNING: ",
        log.Ldate|log.Ltime|log.Lshortfile)
    Error = log.New(errorHandle,
        "ERROR: ",
        log.Ldate|log.Ltime|log.Lshortfile)
}
func main() {
    Init(ioutil.Discard, os.Stdout, os.Stdout, os.Stderr)
    Info.Println("Special Information")
    Warning.Println("There is something you need to know about")
    Error.Println("Something has failed")
}  

相关文章