[原]Golang FileServer

Posted Accept

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了[原]Golang FileServer相关的知识,希望对你有一定的参考价值。

转载请注明出处

 

今天我们用go来搭建一个文件服务器FileServer,并且我们简单分析一下,它究竟是如何工作的。知其然,并知其所以然!

首先搭建一个最简单的,资源就挂载在服务器的根目录下,并且路由路径为根路径:127.0.0.1:8080/

    
    http.Handle("/", http.FileServer(http.Dir("sourse")))

err := http.ListenAndServe(":8080", nil) if err != nil { fmt.Println(err) }

服务器程序和资源结构如下:

 

打开源码,我们定位到net/http/fs.go文件中,看看http.FileServer是如何定义的

func FileServer(root FileSystem) Handler {
    return &fileHandler{root}
}

原来FileServer函数是返回一个Handler,接下来我们再看看fileHandler是怎么定义的

type fileHandler struct {
    root FileSystem
}

原来是个结构体,既然是个Handler,那么它一定实现了ServeHttp函数,找找看

func (f *fileHandler) ServeHTTP(w ResponseWriter, r *Request) {
    upath := r.URL.Path
    if !strings.HasPrefix(upath, "/") {
        upath = "/" + upath
        r.URL.Path = upath
    }
    serveFile(w, r, f.root, path.Clean(upath), true) //看来关键在这里
}

进入到关键函数serveFile看看,它的函数声明如下:

func serveFile(w ResponseWriter, r *Request, fs FileSystem, name string, redirect bool) //最后一个参数表示是否重新定向,在web服务中,它总是true

这里最后一个参数很重要,我们下面会揭示为什么,好啦,看看源码,无关部分我都砍掉:

func serveFile(w ResponseWriter, r *Request, fs FileSystem, name string, redirect bool) {
    const indexPage = "/index.html"

    // redirect .../index.html to .../
    // can\'t use Redirect() because that would make the path absolute,
    // which would be a problem running under StripPrefix
    if strings.HasSuffix(r.URL.Path, indexPage) {
        localRedirect(w, r, "./")
        return
    }

    f, err := fs.Open(name)
    if err != nil {
        msg, code := toHTTPError(err)
        Error(w, msg, code)
        return
    }
    defer f.Close()

    d, err := f.Stat()
    if err != nil {
        msg, code := toHTTPError(err)
        Error(w, msg, code)
        return
    }

    if redirect {
        // redirect to canonical path: / at end of directory url
        // r.URL.Path always begins with /
        url := r.URL.Path
        if d.IsDir() {
            if url[len(url)-1] != \'/\' {
                localRedirect(w, r, path.Base(url)+"/")     ---------------------------- 1
                return
            }
        } else {
            if url[len(url)-1] == \'/\' {
                localRedirect(w, r, "../"+path.Base(url))   ---------------------------- 2
                return
            }
        }
    }

    // serveContent will check modification time
    sizeFunc := func() (int64, error) { return d.Size(), nil }
    serveContent(w, r, d.Name(), d.ModTime(), sizeFunc, f)  ---------------------------- 3
}

重点看到红色标注部分,现在我们假设我们请求是http://127.0.0.1/abc/d.jpg。那么我们 r.URL.Path的值就是/abc/d.jpg,于是乎,程序进入到1部分(看我蓝色字体标注),path.Base()函数是取函数最后/部分,也就是/d.jpg。现在请求变成了/d.jpg,然后进行重定向,这时浏览器根据重定向内容再次发送请求,这次请求的url.Path是我们上一次处理好的/d.jpg,最后,程序便顺利的进入到了第3部分(见我蓝色字体标注)。serveContent 这个函数是最终向浏览器发送资源文件的

 

大概的一个处理文件资源请求的流程就是这样子,现在我们来解释一下,为什么

func serveFile(w ResponseWriter, r *Request, fs FileSystem, name string, redirect bool) 函数的第四个参数那么重要

因为在web服务中,我们发现它永远都是true,这就导致了我们的url无论是什么,都将会被它cut成只剩最后一部分/xxx.jpg类似的样子。换句话说,假设我们为文本服务器设置的路由格式是/xxx/xxx/xxx/x.jpg的话。
那么文本服务器根本没法正常工作,因为它只认识/xx.jpg的路由格式。

这或许也正是你在网上找相关资料的时候,发现大家转发的内容都是将文本服务器挂载在根节点上。

"/"路由我们通常会将它拿来做网站的入口,这样岂不是很不爽了?那么有没有解决的办法呢? 当然是有的啦,在net/http/server.go文件中,有这么一个函数:
// StripPrefix returns a handler that serves HTTP requests
// by removing the given prefix from the request URL\'s Path
// and invoking the handler h. StripPrefix handles a
// request for a path that doesn\'t begin with prefix by
// replying with an HTTP 404 not found error.
func StripPrefix(prefix string, h Handler) Handler {
    if prefix == "" {
        return h
    }
    return HandlerFunc(func(w ResponseWriter, r *Request) {
        if p := strings.TrimPrefix(r.URL.Path, prefix); len(p) < len(r.URL.Path) {
            r.URL.Path = p
            h.ServeHTTP(w, r)
        } else {
            NotFound(w, r)
        }
    })
}

根据注释以及代码来看,它的作用是返回一个Handler,但是这个Handler呢,有点点不一样,不一样在哪里呢,它会过滤掉一部分路由前缀。

比如我们有如下路由:/aaa/bbb/ccc.jpg,那么执行StripPrefix("/aaa/bbb", ..handler)之后,我们将会得到一个新的Handler,这个新Handler的执行函数和原来的handler是一样的,但是这个新Handler在处理路由请求的时候,会自动将/aaa/bbb/ccc.jpg理解为/aaa.jpg

 

好啦,分析到这里,我们现在再来搭建一个路由路径为/s/下的文件服务器,代码如下:

func main() {

    http.Handle("/s/", http.StripPrefix("/s/", http.FileServer(http.Dir("sourse"))))  

    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Println(err)
    }
}

 

以上是关于[原]Golang FileServer的主要内容,如果未能解决你的问题,请参考以下文章

在 golang HTTP FileServer 的 Content-Type 标头上设置 'charset' 属性

戈朗。用啥? http.ServeFile(..) 还是 http.FileServer(..)?

golang goroutine例子[golang并发代码片段]

golang代码片段(摘抄)

代码片段 - Golang 实现简单的 Web 服务器

代码片段 - Golang 实现集合操作