---
gin:
  - name: greeter                     # Required
    port: 8080                        # Required
    enabled: true                     # Required
    static:
      enabled: true                   # Optional, default: false
      path: "/rk/v1/static"           # Optional, default: /rk/v1/static
      sourceType: local               # Required, options: pkger, local
      sourcePath: "."                 # Required, full path of source directory

2.創(chuàng)建 main.go

// Copyright (c) 2021 rookie-ninja
//
// Use of this source code is governed by an Apache-style
// license that can be found in the LICENSE file.
package main

import (
 "context"
 "github.com/rookie-ninja/rk-boot"
)

// Application entrance.
func main() {
 // Create a new boot instance.
 boot := rkboot.NewBoot()

 // Bootstrap
 boot.Bootstrap(context.Background())

 // Wait for shutdown sig
 boot.WaitForShutdownSig(context.Background())
}

3.文件夾結構

.
├── boot.yaml
├── go.mod
├── go.sum
└── main.go

0 directories, 4 files

4.驗證

訪問 http://localhost:8080/rk/v1/static

從 pkger 讀取文件 (嵌入式靜態(tài)文件)

pkger 是一個可以把靜態(tài)文件，嵌入到 .go 文件的工具。

這個例子中，我們把當前文件夾下的所有文件，都嵌入到 pkger.go 文件中。

這樣做的好處就是，在部署的時候，可以不用考慮復制一堆文件夾結構。

1.下載 pkger 命令行

go get github.com/markbates/pkger/cmd/pkger

2.創(chuàng)建 boot.yaml

pkger 會使用 module 來區(qū)分不同的 package，所以，sourcePath 里，我們添加了相應 module 的前綴。

---
gin:
  - name: greeter                                             # Required
    port: 8080                                                # Required
    enabled: true                                             # Required
    static:
      enabled: true                                           # Optional, default: false
      path: "/rk/v1/static"                                   # Optional, default: /rk/v1/static
      sourceType: pkger                                       # Required, options: pkger, local
      sourcePath: "github.com/rookie-ninja/rk-demo:/"         # Required, full path of source directory

3.創(chuàng)建 main.go

代碼中，有兩個地方需要注意。

pkger.Include("./")
這段代碼不做任何事情，是告訴 pkger 命令行打包哪些文件。

_ “github.com/rookie-ninja/rk-demo/internal”
一定要這么引入，因為我們會把 pkger.go 文件放到 internal/pkger.go 中，pkger.go 文件里定一個一個 variable，只有這么引入，才可以在編譯 main.go 的時候，順利引入 variable。

// Copyright (c) 2021 rookie-ninja
//
// Use of this source code is governed by an Apache-style
// license that can be found in the LICENSE file.
package main

import (
 "context"
 "github.com/markbates/pkger"
 "github.com/rookie-ninja/rk-boot"
 // Must be present in order to make pkger load embedded files into memory.
 _ "github.com/rookie-ninja/rk-demo/internal"
)

func init() {
 // This is used while running pkger CLI
 pkger.Include("./")
}

// Application entrance.
func main() {
 // Create a new boot instance.
 boot := rkboot.NewBoot()

 // Bootstrap
 boot.Bootstrap(context.Background())

 // Wait for shutdown sig
 boot.WaitForShutdownSig(context.Background())
}

4.生成 pkger.go

pkger -o internal

5.文件夾結構

.
├── boot.yaml
├── go.mod
├── go.sum
├── internal
│   └── pkged.go
└── main.go

1 directory, 5 files

6.驗證

訪問 http://localhost:8080/rk/v1/static

自定義文件源

我們將使用 afero package 里面的 memFs 作為例子。

如果想要從類似 AWS S3 中讀取，用戶可以實現(xiàn)一個屬于自己的 http.FileSystem。

rk-boot 會在后續(xù)的更新中，逐漸實現(xiàn)這些功能。

1.創(chuàng)建 boot.yaml

---
gin:
  - name: greeter                     # Required
    port: 8080                        # Required
    enabled: true                     # Required

2.創(chuàng)建 main.go

我們在 memFs 中創(chuàng)建了一個 /folder 文件夾和一個 /file.txt 文件。

// Copyright (c) 2021 rookie-ninja
//
// Use of this source code is governed by an Apache-style
// license that can be found in the LICENSE file.
package main

import (
 "context"
 "github.com/rookie-ninja/rk-boot"
 "github.com/rookie-ninja/rk-gin/boot"
 "github.com/spf13/afero"
 "os"
)

// Application entrance.
func main() {
 // Create a new boot instance.
 boot := rkboot.NewBoot()

 // Create a memory fs
 fs := afero.NewHttpFs(afero.NewMemMapFs())

 // Add folder and file.txt into memory fs
 fs.MkdirAll("/folder", os.ModePerm)
 f, _ := fs.Create("/file.txt")
 f.Write([]byte("this is my content!"))
 f.Close()

 // Set StaticFileEntry
 ginEntry := boot.GetGinEntry("greeter")
 ginEntry.StaticFileEntry = rkgin.NewStaticFileHandlerEntry(
  rkgin.WithPathStatic("/rk/v1/static"),
  rkgin.WithFileSystemStatic(fs))

 // Bootstrap
 boot.Bootstrap(context.Background())

 // Wait for shutdown sig
 boot.WaitForShutdownSig(context.Background())
}