Go从入门到精通——接口(interface)——示例：便于扩展输出方式的日志系统
示例：便于扩展输出方式的日志系统
日志可以用于查看和分析应用程序的运行状态。日志一般可以支持输出多种形式，如命令行、文件、网络等。
1、日志对外接口
本例中定义一个日志写入器接口（LogWriter）,要求写入设备必须遵守这个接口协议才能被日志器（Logger）注册。日志器有一个写入器的注册方法（Logger 的 RegisterWriter() 方法）。
日志器还有一个 Log() 方法，进行日志的输出，这个函数会将日志写入到所有已经注册的日志写入器（LogWriter）中，详细代码实现如下：
package main
// LogWriter 声明日志写入器接口。
// 这个接口可以被外部使用。 日志的输出可以有多种设备，这个写入器就是用来实现一个日志的输出设备。
type LogWriter interface {
Write(data interface{}) error
}
// Logger 日志器结构。日志器使用 writeList 记录输出到哪些设备上。
type Logger struct {
//这个日志器用到的日志写入器
writerList []LogWriter
}
/*RegisterWriter 注册一个日志写入器。
使用日志器方法 RegisterWriter() 将一个日志写入器（LogWriter）注册到日志器（Logger）中。
注册的意思就是将日志写入器的接口添加到 writerList 中。
*/
func (l *Logger) RegisterWriter(writer LogWriter) {
l.writerList = append(l.writerList, writer)
}
// Log 将一个 data 类型的数据写入日志
func (l *Logger) Log(data interface{}) {
//遍历日志器拥有的所有日志写入器
for _, writer := range l.writerList {
//将本次日志的内容写入日志写入器
writer.Write(data)
}
}
// NewLogger 创建日志器的实例。
// 定义 Logger结构的函数，返回 Logger 指针
func NewLogger() *Logger {
//取地址实例化 Logger 的结构体
return &Logger{}
}
2、文件写入器
文件写入器（fileWriter）是众多日志写入器（LogWriter）中的一种。文件写入器的功能是根据一个文件名创建日志文件（fileWriter 的 SetFile 方法）。在有日志写入时，将要日志写入文件中。
代码 1-2 文件写入器（logger/file.go）
package main
import (
"errors"
"fmt"
"os"
)
//声明文件写入器。在结构体中保存一个文件句柄，以便每次写入时操作。
type fileWriter struct {
//从字面上看，os.File类型代表了操作系统中的文件。
//比如对于类Unix的操作系统，括Linux、macOS、FreeBSD等，其中的一切都可以被看作是文件。
//os.File类型拥有的都是指针方法，它的指针实现了很多io包中的接口。
file *os.File
}
//设置文件写入器写入的文件名。
//文件写入器通过文件名创建文件，这里通过 SetFile() 的参数提供一个文件名，并创建该文件名。
func (f *fileWriter) SetFile(filename string) (err error) {
//考虑到 SetFile() 方法可以被多次调用，如果文件已经打开，关闭前一个文件
if f.file != nil {
f.file.Close()
}
//创建一个文件并保存文件句柄
f.file, err = os.Create(filename)
//如果创建的过程出现错误，则返回错误
return err
}
// fileWriter 实现 LogWriter 的 Write() 方法
func (f *fileWriter) Write(data interface{}) error {
//日志文件可能没有创建成功
if f.file == nil {
//如果文件没有准备好，文件句柄就为nil，此时使用 errors 包中的 New() 函数返回一个错误对象，包含一个错误字符串返回。
return errors.New("文件不存在！")
}
//传入的参数 data 是 interface{} 类型，而 f.file 的 Write（） 方法需要的是 []bytes 类型。
//所以使用 fmt.Sprintf 将 data 转换为字符串，"%v" 意思是将 data 按其本来的值转换为
str := fmt.Sprintf("%v\n", data)
//通过 f.file 的 Write() 方法，将 str 字符串转换为 []byte 字节数组，再将数据以字节数组写入文件中
_, err := f.file.Write([]byte(str))
return err
}
//创建文件写入器实例
func newFileWriter() *fileWriter {
return &fileWriter{}
}
提示：
一个完备的文件写入器会提供多种文件写入的模式，例子中使用的模式是将日志添加到日志文件的尾部。
随着文件原来越大，文件的访问效率和查看变量性也会大大降低。此时，就需要另外一钟写入模式：滚动写入文件。
滚动写入文件模式也是将日志添加到文件的尾部，但当文件达到设定的期望大小时，会自动开启一个新的文件继续写入文件，最终将获得多个日志文件。
日志文件不仅可以按照文件大小进行分割，还可以按照日期范围进行分割。在到达设定的日期范围，如每天、每小时的周期范围时，日志器会自动创建新的日志文件。这种日志文件创建方法也能方便开发者按日志查看日志。
3、命令行写入器
在 UNIX 的思想中，一切皆文件。文件包括内存、磁盘、网络和命令行等。这种抽象方法方便我们访问这些看不见摸不着的虚拟资源。命令行在 Go 中也是一种文件。
os.Stdout 对应标准输出，一般表示屏幕，也就是命令行，也可以被重定向为打印机或者磁盘文件。
os.Stderr 对应标准错误输出，一般将错误输出到日志中。
不过大多数情况，os.Stdout 会与 os.Stderr 合并输出；
os.Stdin 对应标准输入，一般表示键盘。
os.Stdout、os.Stderr、os.Stdin 都是 *os.File 类型，和文件一样实现了 io.Writer 接口的 Write() 方法。
如何将命令行抽象为日志写入器，代码如下：
代码 1-3 文件写入器（logger/console.go）
package main import ( "fmt" "os" ) //命令行写入器 type consoleWriter struct{ } //实现 LogWriter 的 Write() 方法 func (f *consoleWriter) Write(data interface{}) error{ //将数据序列化为字符串 str := fmt.Sprintf("%v\n", data) //将数据以字节数组写入命令行 _, err := os.Stdout.Write([]byte(str)) return err } //创建命令行写入器实例 func newConsoleWriter() *consoleWriter{ return &consoleWriter{} }
4、使用日志
在程序中使用日志器一般会先通过代码创建日志器（Logger），为日志器添加输出设备（fileWriter、consoleWriter 等）。这些设备中有一部分需要一些参数设定，如文件日志写入器需要提供文件名（fileWriter 的 SetFile() 方法）。
代码 1-4 文件写入器（logger/main.go）
package main
import "fmt"
//创建日志器
func createLogger() *Logger {
//创建日志器
l := newLogger()
//创建命令行写入器
cw := newConsoleWriter()
//注册命令行写入器到日志器中
l.RegisterWriter(cw)
//创建文件写入器
fw := newFileWriter()
//设置文件名
if err := fw.SetFile("log.log"); err != nil {
fmt.Println(err)
}
//注册文件写入器到日志器中
l.RegisterWriter(fw)
return l
}
func main() {
//准备日志器
l := createLogger()
//写一个日志
l.Log("hello")
}
