Go 标准库 http.FileServer 实现静态文件服务

2018-10-08 14:47:24 浏览数 (1)

原文作者:舆图易稿 发表地址:格物 原文链接:https://segmentfault.com/a/1190000016086653

http.FileServer 方法属于标准库 net/http,返回一个使用 FileSystem 接口 root 提供文件访问服务的 HTTP 处理器。可以方便的实现静态文件服务器。

代码语言:javascript复制
http.ListenAndServe(":8080", http.FileServer(http.Dir("/files/path")))

访问 http://127.0.0.1:8080,即可看到类似 Nginx 中 autoindex 目录浏览功能。

源码解析

我们现在开始将上述的那仅有的一行代码进行剖析,看看到底是如何实现的。源码中英文注释也比较详细,可以参考。

我们先看 http.Dir(),再看 http.FileServer(),而 http.ListenAndServe() 监听 TCP 端口并提供路由服务,此处不赘述。

http.Dir()

从以下源码我们可以看出,type Dir string 实现了 type FileSystem interface 的接口函数 Openhttp.Dir("/") 实际返回的是 http.Dir 类型,将字符串路径转换成文件系统。

代码语言:javascript复制
1// 所属文件: src/net/http/fs.go, 26-87行type Dir stringfunc (d Dir) Open(name string) (File, error) {    // ...}type FileSystem interface {
2    Open(name string) (File, error)
3}

http.FileServer()

http.FileServer() 方法返回的是 fileHandler 实例,而 fileHandler 结构体实现了 Handler 接口的方法ServeHTTP()ServeHTTP 方法内的核心是 serveFile() 方法。

代码语言:javascript复制
 1// 所属文件: src/net/http/fs.go, 690-716行type fileHandler struct {
 2    root FileSystem
 3}func FileServer(root FileSystem) Handler {    return &fileHandler{root}
 4}func (f *fileHandler) ServeHTTP(w ResponseWriter, r *Request) {
 5    upath := r.URL.Path    if !strings.HasPrefix(upath, "/") {
 6        upath = "/"   upath
 7        r.URL.Path = upath
 8    }
 9    serveFile(w, r, f.root, path.Clean(upath), true)
10}
代码语言:javascript复制
1// 所属文件: src/net/http/server.go, 82行type Handler interface {
2    ServeHTTP(ResponseWriter, *Request)
3}

serveFile() 方法判断,如果访问路径是目录,则列出目录内容,如果是文件则使用 serveContent() 方法输出文件内容。serveContent() 方法则是个读取文件内容并输出的方法,此处不再贴代码。

代码语言:javascript复制
 1// 所属文件: src/net/http/fs.go, 540行// name is '/'-separated, not filepath.Separator.func serveFile(w ResponseWriter, r *Request, fs FileSystem, name string, redirect bool) {    // 中间代码已省略
 2
 3    if d.IsDir() {        if checkIfModifiedSince(r, d.ModTime()) == condFalse {
 4            writeNotModified(w)            return
 5        }
 6        w.Header().Set("Last-Modified", d.ModTime().UTC().Format(TimeFormat))
 7        dirList(w, r, f)        return
 8    }    // serveContent will check modification time
 9    sizeFunc := func() (int64, error) { return d.Size(), nil }
10    serveContent(w, r, d.Name(), d.ModTime(), sizeFunc, f)
11}

支持子目录路径

http.StripPrefix() 方法配合 http.Handle()http.HandleFunc() 可以实现带路由前缀的文件服务。

代码语言:javascript复制
 1package mainimport (    "net/http"
 2    "fmt")func main() {
 3
 4    http.Handle("/tmpfiles/", http.StripPrefix("/tmpfiles/", http.FileServer(http.Dir("/tmp"))))
 5
 6    err := http.ListenAndServe(":8080", nil)    if err != nil {
 7        fmt.Println(err)
 8    }
 9
10}

版权申明:内容来源网络,版权归原创者所有。除非无法确认,我们都会标明作者及出处,如有侵权烦请告知,我们会立即删除并表示歉意。谢谢。

0 人点赞