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

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

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

    返回 *Route

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

    DirOptions 结构体是这样的：

    1. type DirOptions struct {
    2.     // 默认为 /index.html, 如果请求路径以 **/*/$IndexName 结尾，它会重定向到 **/*(/)，
    3.     // 然后另一个处理器会处理它，
    4.     // 如果最后开发人员没有设法手动处理它，
    5.     // 框架会自动注册一个名为index handler 的处理器来作为这个处理器
    6.     IndexName string
    8.    // 文件是否需要gzip压缩
    9.     Gzip bool
    11.     // 如果 IndexName没有找到，是否列出当前请求目录中的文件
    12.     ShowList bool
    14.     // 如果 ShowList 为 true，这个函数将会替代默认的列出当前请求目录中文件的函数。
    15.     DirList func(ctx iris.Context, dirName string, dir http.File) error
    17.     // 内嵌时
    18.     Asset      func(name string) ([]byte, error)   
    19.     AssetInfo  func(name string) (os.FileInfo, error)
    20.     AssetNames func() []string
    22.     //  循环遍历每个找到的请求资源的可选验证器。
    23.     AssetValidator func(ctx iris.Context, name string) bool
    24. }

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

    1. app := iris.New()
    3. app.HandleDir("/static", "./assets")
    5. app.Run(iris.Addr(":8080"))

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

    安装 go-bindata

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

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

    1. $ go-bindata ./assets/...

    上面创建了一个go文件，其中包含三个主要的函数：Asset，AssetInfo，AssetNames。在 iris.DirOptions 中使用它们：

    1. // [app := iris.New...]
    3. app.HandleDir("/static", "./assets", iris.DirOptions {
    4.     Asset: Asset,
    5.     AssetInfo: AssetInfo,
    6.     AssetNames: AssetNames,
    7.     Gzip: false,
    8. })

    编译你的程序：

    1. $ go build

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

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

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

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

    使用：

    1. handler := iris.FileServer("./assets", iris.DirOptions {
    2.     ShowList: true, Gzip: true, IndexName: "index.html",
    3. })