通过 Party.HandleDir 方法指定特定的目录(系统目录或者嵌入式应用)以获取静态文件。

HandleDir 注册一个处理程序,该处理程序使用文件系统的内容(物理或嵌入式)为HTTP请求提供服务。

  • 第一个参数:路由路径
  • 第二个参数:需要保存文件的系统或者嵌入式目录
  • 第三个参数:不必要,目录选项,设置字段是可选的。

返回 *Route

HandleDir(requestPath, directory string, opts ...DirOptions) (getRoute *Route)

DirOptions 结构体是这样的:

type DirOptions struct {
    // 默认为 /index.html, 如果请求路径以 **/*/$IndexName 结尾,它会重定向到 **/*(/),
    // 然后另一个处理器会处理它,
    // 如果最后开发人员没有设法手动处理它,
    // 框架会自动注册一个名为index handler 的处理器来作为这个处理器
    IndexName string

   // 文件是否需要gzip压缩
    Gzip bool

    // 如果 IndexName没有找到,是否列出当前请求目录中的文件
    ShowList bool

    // 如果 ShowList 为 true,这个函数将会替代默认的列出当前请求目录中文件的函数。
    DirList func(ctx iris.Context, dirName string, dir http.File) error

    // 内嵌时
    Asset      func(name string) ([]byte, error)   
    AssetInfo  func(name string) (os.FileInfo, error)
    AssetNames func() []string

    //  循环遍历每个找到的请求资源的可选验证器。
    AssetValidator func(ctx iris.Context, name string) bool
}

让我假设在你的可执行文件目录中有一个 ./assets 文件夹,你想要处理 http://localhost:8080/static/**/* 路由下的文件。

app := iris.New()

app.HandleDir("/static", "./assets")

app.Run(iris.Addr(":8080"))

现在,如果您想将静态文件嵌入可执行文件内部以不依赖于系统目录,则可以使用 go-bindata 之类的工具将文件转换为程序内的[] byte。 让我们快速学习一下,以及Iris如何帮助服务这些数据。

安装 go-bindata

go get -u github.com/go-bindata/go-bindata/...

导航到你程序的目录,并且 ./assets 子目录存在,然后执行:

$ go-bindata ./assets/...

上面创建了一个go文件,其中包含三个主要的函数:AssetAssetInfoAssetNames。在 iris.DirOptions 中使用它们:

// [app := iris.New...]

app.HandleDir("/static", "./assets", iris.DirOptions {
    Asset: Asset,
    AssetInfo: AssetInfo,
    AssetNames: AssetNames,
    Gzip: false,
})

编译你的程序:

$ go build

HandleDir 物理目录和内嵌目录的所有标准,包括 content-range

然而,如果你仅仅想要一个处理器工作,而不注册路由,你可以使用 iris.FileServer 包级别函数替代。

FileServer 函数返回一个处理器,该处理器为来自特定系统,物理目录,嵌入式目录的文件提供服务。

  • 第一个参数:目录
  • 第一个参数:可选参数,调用者可选的配置
    iris.FileServer(directory string, options ...DirOptions)

使用:

handler := iris.FileServer("./assets", iris.DirOptions {
    ShowList: true, Gzip: true, IndexName: "index.html",
})
文档更新时间: 2020-08-14 10:44   作者:kuteng