Box

# Installation

go get -u github.com/boxgo/box
1

# Required

go version: go1.12+

grpc-go version: 1.26

# Recommend

建议使用国内源：

  1. goproxy.cn (opens new window)
  2. goproxy.io (opens new window)

# Qucik Start

  1. 编写配置文件
# box.yaml
box:
  name: testBox
  version: 1.0.0

gin:
  default:
    mode: release
    addr: ":9000"

logger:
  default:
    level: info
    outputPaths:
      - stdout
    errorOutputPaths:
      - stderr
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  1. 编写程序代码
// main.go
package main

import (
	"github.com/boxgo/box"
	"github.com/boxgo/box/pkg/server/ginserver"
	"github.com/gin-gonic/gin"
)

func main() {
	app := box.New(
		box.WithBoxes(
			ginserver.Default,
		),
	)

	ginserver.GET("/ping", func(ctx *gin.Context) {
		ctx.Data(200, gin.MIMEPlain, []byte("pong"))
	})

	app.Run()
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
  1. 启动程序
$ go run main.go # 启动程序
1

boot

通过go run main.go命令启动我们的程序，可以看到如上所示界面，这个表格是我们程序所使用到的配置描述。紧跟其后的是程序启动时的配置信息。再往下，我们就看到了box启动器开始启动，box启动器启动GinServer服务，由于我们没有挂载其他组件，这时候启动器启动完成。

通过 ctrl + c 我们看到启动器开始停止工作，然后GinServer被关闭，整个进程退出。

  1. 验证程序
$ curl http://127.0.0.1:9000/ping
$ pong
1
2

可以看到，请求ping接口已经返回"pong"了。

← 启动器 →