app

Documentation

Overview

Package app micserver 最基础的运行单位，app中包含了多个module，app在启动时会初始化所有module， 并且根据配置初始化module之间的连接。 App 是 micserver 中在 "Module" 上一层的概念，使用 micserver 的 第一步就是实例化出一个 App 对象，并且向其中插入你的 Modules 。 建议一个代码上下文中仅存在一个 App 对象，如果你的需求让你觉得你有 必要实例化多个 App 在同一个可执行文件中，那么你应该考虑增加一个 Module 而不是 App 。

Index

• type App
  • func (a *App) Init(modules []module.IModule) (err error)
  • func (a *App) Run(modules []module.IModule)
  • func (a *App) RunAndBlock(modules []module.IModule)
  • func (a *App) Setup(configer *conf.TopConfig)
  • func (a *App) SignalListen()
  • func (a *App) Stop()

Types

type App

type App struct {

	// 匿名成员 Logger 帮助你在此 App 中通过 App.Debug 等方式输出你的
	// 日志信息到指定的输出上。
	// 你可以在任何模块代码中新增 Logger 引用，并且从该 Logger 中 Clone()
	// 出来，定制化 log 的名字/主题 等，Logger 的底层实现已经帮你处理好了
	// Clone() 出来的 Logger 指向同一个输出。
	*log.Logger
	Configer *conf.TopConfig
	// contains filtered or unexported fields
}

App basic runtime

func (*App) Init

func (a *App) Init(modules []module.IModule) (err error)

Init this app

func (*App) Run

func (a *App) Run(modules []module.IModule)

Run 运行，默认执行 RunAndBlock ，阻塞

func (*App) RunAndBlock

func (a *App) RunAndBlock(modules []module.IModule)

RunAndBlock 运行并阻塞本App，直到程序主动退出

func (*App) Setup

func (a *App) Setup(configer *conf.TopConfig)

Setup 初始化App的设置

func (*App) SignalListen

func (a *App) SignalListen()

SignalListen 监听系统信号，对 Ctrl+c 等命令做出反应，通知App阻塞处执行退出逻辑

func (*App) Stop

func (a *App) Stop()

Stop the app