Go: 监测文件修改

小军的求知笔记

2022年06月08日 23:43

在开发过程中，经常需要观察本地文件系统的更改。经过几个小时的搜索后，找到了一个简单的工具来做这件事。

该工具就是fsnotify[https://github.com/fsnotify/fsnotify]是一个Go跨平台文件系统通知工具。它提供了一个简单的接口来监测本地文件系统中的更改。

本文我们就来看看如何使用这个工具。

安装工具

$ go get github.com/fsnotify/fsnotify

关键类型

我们先来了解下fsnotify工具的所有类型。

Event结构体

Event结构体表示单个文件系统事件通知。函数String()返回一个“file: REMOVE|WRITE|…”格式字符串表示事件的字符串。

type Event struct {
    Name string    //文件或目录的相对路径

    Op    Op       //文件更改事件
}

func (e Event) String() string

Op类型

该工具描述了一组文件操作。它们是可以触发通知的通用文件操作。

type Op uint32const (
    Create Op = 1 << iota
    Write
    Remove
    Rename
    Chmod
)

Watcher结构体

Watcher结构体是该工具的核心。包含两个channel和三个函数。

type Watcher struct {
    Events chan Event
    Errors chan error
    ...
}
func (w *Watcher) Add(name string) error

func (w *Watcher) Remove(name string) error 

func (w *Watcher) Close() error

Channel

Events 通道
Errors 通道

函数

Add：非递归监测文件或目录的变化。
Remove：停止文件或目录监测。
Close：关闭所有文件或目录的监测以及关闭Events通道。

Watcher工厂函数

函数NewWatcher通过底层操作系统调用创建watcher对象，并等待事件通知。

func NewWatcher() (*Watcher, error)

完整例子

import (        "log"
     "github.com/fsnotify/fsnotify")func main() {
    watcher, err := fsnotify.NewWatcher()        if err != nil {
        log.Fatal("new watcher failed: ", err)
    }        defer watcher.Close()
    done := make(chan bool)        go func() {                defer close(done)                for {                       select {                          case event, ok := <-watcher.Events:                                   if !ok {                                            return
                    }
               log.Printf("%s %s\n", event.Name, event.Op)                         case err, ok := <-watcher.Errors:                                    if !ok {                                            return
                    }
                  log.Println("error: ", err)
            }
        }
    }()
    err = watcher.Add("./")        if err != nil {
        log.Fatal("add failed:", err)
    }

    <-done
}

上面的代码通过启动一个goroutine在后台监测目录或文件的变化，调用函数watcher.Add("./")添加监测的目录是当前目录，也就是main.go文件所在目录。
运行程序后，如果你修改下当前main.go文件会产生如下结果：

Output

2022/06/09 07:01:15 main.go~ CREATE
2022/06/09 07:01:15 main.go WRITE|CHMOD
2022/06/09 07:01:15 main.go~ CREATE
2022/06/09 07:01:15 main.go CHMOD
2022/06/09 07:01:15 main.go WRITE
2022/06/09 07:01:15 main.go~ REMOVE
2022/06/09 07:01:16 main.go CHMOD

上面的输出过程可以发现，修改文件并保存会触发以下动作：

CREATE动作即临时文件的创建
WRITE写文件动作
CHMOD修改文件属性
REMOVE删除临时文件。

继续滑动看下一个