application

type ComponentAfterService interface {
	Inject(instance ComponentInstance, context InstanceContext) error
	Init(instance ComponentInstance) error
	Destroy(instance ComponentInstance) error
}

type ComponentFactory interface {
	GetPrototype() lang.Object
	NewInstance() ComponentInstance
	AfterService() ComponentAfterService
}

type ComponentGroup interface {
	Size() int
	ListAll() []ComponentHolder
	ListWithFilter(f ComponentHolderFilter) []ComponentHolder
	Name() string
}

type ComponentGroupManager interface {
	GetGroup(selector string) ComponentGroup
	Reload() error
}

type ComponentHolder interface {
	GetInstance() ComponentInstance
	IsOriginalName(name string) bool
	GetInfo() ComponentInfo
	GetPrototype() lang.Object
	GetContext() Context
	MakeChild(context Context) ComponentHolder
}

type ComponentHolderFilter func(name string, holder ComponentHolder) bool

type ComponentInfo interface {
	GetID() string
	GetAliases() []string
	GetClasses() []string
	GetScope() ComponentScope
	GetFactory() ComponentFactory
	GetPrototype() lang.Object

	IsTypeOf(typeName string) bool
	IsNameOf(alias string) bool
}

type ComponentInstance interface {
	Factory() ComponentFactory
	Get() lang.Object
	State() ComponentState
	Inject(context InstanceContext) error
	Init() error
	Destroy() error
}

type ComponentScope uint32

type ComponentState uint32

type Components interface {
	// ids
	GetComponentNameList(includeAliases bool) []string

	// finders
	FindComponent(selector string) (ComponentHolder, error)
	FindComponents(selector string) []ComponentHolder
	FindComponentsWithFilter(selector string, f ComponentHolderFilter) []ComponentHolder

	GroupManager() ComponentGroupManager

	// export & import
	Export(map[string]ComponentHolder) map[string]ComponentHolder
	Import(map[string]ComponentHolder)
}

type ConfigBuilder interface {
	AddComponent(info ComponentInfo)
	AddResources(res collection.Resources)
	AddProperties(p collection.Properties)
	AddProperties2(theDefault, theFinal collection.Properties)

	SetModules(mods []Module)

	SetResources(res collection.Resources)
	SetAttribute(name string, value interface{})

	SetErrorHandler(h lang.ErrorHandler)

	SetEnableLoadPropertiesFromArguments(enable bool)
	IsEnableLoadPropertiesFromArguments() bool

	DefaultProperties() collection.Properties
	FinalProperties() collection.Properties

	Create() Configuration
}

type Configuration interface {
	GetLoader() ContextLoader
	GetModules() []Module
	GetComponents() []ComponentInfo
	GetResources() collection.Resources
	GetAttributes() collection.Attributes
	GetEnvironment() collection.Environment
	GetDefaultProperties() collection.Properties
	GetFinalProperties() collection.Properties
	GetErrorHandler() lang.ErrorHandler
	IsEnableLoadPropertiesFromArguments() bool
}

type Context interface {
	context.Context
	ContextCollections
	ContextInfo
	io.Closer

	// helper
	SetErrorHandler(h lang.ErrorHandler)
	GetErrorHandler() lang.ErrorHandler
	NewChild() Context

	GetComponent(selector string) (lang.Object, error)
	GetComponentList(selector string) ([]lang.Object, error)
}

type ContextCollections interface {

	// GetReleasePool 取context的生命周期管理池
	GetReleasePool() lang.ReleasePool

	// GetComponents 取context组件管理器
	GetComponents() Components

	// GetResources 取context的资源管理器
	GetResources() collection.Resources

	GetArguments() collection.Arguments
	GetAttributes() collection.Attributes
	GetEnvironment() collection.Environment
	GetProperties() collection.Properties
	GetParameters() collection.Parameters
}

type ContextGetter interface {

	// for property
	GetProperty(name string) (string, error)
	GetPropertySafely(name string, _default string) string
	GetPropertyString(name string, _default string) string
	GetPropertyInt(name string, _default int) int
}

type ContextInfo interface {

	// info
	GetURI() string
	GetApplicationName() string
	GetApplicationVersion() string
	GetStartupTimestamp() int64
	GetShutdownTimestamp() int64
}

type ContextLoader interface {
	Load(config Configuration, args []string) (Context, error)
}

type DefineModule struct {
	Name         string
	Version      string
	Revision     int
	Resources    collection.Resources
	Dependencies []Module
	OnMount      OnMountFunc
}

type ExitCodeGenerator interface {
	ExitCode() int
}

type FunctionInjectionTarget struct {
	// contains filtered or unexported fields
}

type FunctionInjectionTargetFn func(lang.Object) error

type Initializer interface {
	Run()
	RunEx() (Runtime, error)

	SetErrorHandler(h lang.ErrorHandler) Initializer
	SetAttribute(name string, value interface{}) Initializer
	SetExitEnabled(enabled bool) Initializer
	SetPanicEnabled(enabled bool) Initializer
	SetArguments(args []string) Initializer

	UseResources(res collection.Resources) Initializer
	UseProperties(res collection.Properties) Initializer
	Use(module Module) Initializer
	UseMain(module Module) Initializer
	UsePanic() Initializer
}

type Injection interface {
	io.Closer
	lang.ErrorHandler

	Context() Context
	Pool() lang.ReleasePool

	// 类选择器: ".class"
	// ID选择器: "#id"
	// 属性选择器: "${prop.name}"
	// value选择器: "foo"
	// context选择器: "context"
	Select(selector string) InjectionSource
}

type InjectionSource interface {
	io.Closer
	Count() int
	Selector() string
	HasMore() bool

	Read() (lang.Object, error)
	ReadString() (string, error)
	ReadInt() (int, error)
	ReadInt32() (int32, error)
	ReadInt64() (int64, error)
	ReadFloat32() (float32, error)
	ReadFloat64() (float64, error)
	ReadBool() (bool, error)
}

type InjectionTarget interface {
	io.Closer
	Write(lang.Object) error
}

type Injector interface {
	OpenInjection(context Context) (Injection, error)
}

type InstanceContext interface {
	Context() Context
	Pool() lang.ReleasePool

	HandleError(err error)
	LastError() error

	GetComponent(selector string) (lang.Object, error)
	GetComponents(selector string) ([]lang.Object, error)
	GetComponentsByFilter(selector string, f ComponentHolderFilter) ([]lang.Object, error)

	GetInt(selector string) (int, error)
	GetInt8(selector string) (int8, error)
	GetInt16(selector string) (int16, error)
	GetInt32(selector string) (int32, error)
	GetInt64(selector string) (int64, error)
	GetFloat32(selector string) (float32, error)
	GetFloat64(selector string) (float64, error)
	GetBool(selector string) (bool, error)
	GetString(selector string) (string, error)
}

type Killer interface {
	Shutdown() error
}

type Life LifeRegistration

type LifeRegistration struct {
	Priority int // 数值越大，优先级越高，优先执行OnInit & OnStart

	OnInit    OnLifeFunc
	OnStart   OnLifeFunc
	Looper    Looper
	OnStop    OnLifeFunc
	OnDestroy OnLifeFunc
}

type LifeRegistrationSorter struct {
	List []*LifeRegistration
}

type LifeRegistry interface {
	GetLifeRegistration() *LifeRegistration
}

type Looper interface {
	Loop() error
}

type MainLooper interface {
	Killer
	RunMain() error
}

type Module interface {
	GetName() string
	GetVersion() string
	GetRevision() int
	GetResources() collection.Resources
	GetDependencies() []Module
	Apply(cb ConfigBuilder) error
}

type ModuleBuilder struct {
	// contains filtered or unexported fields
}

type ModuleFactory interface {

	// 以简单的方式获取一个模块
	ModuleProvider

	// 按照参数定制模块
	CreateModule(params *DefineModule) Module
}

type ModuleProvider interface {
	GetModule() Module
}

type OnLifeFunc func() error

type OnMountFunc func(cb ConfigBuilder) error

type Runnable interface {
	Run(context Context) error
}

type Runtime interface {
	Context() Context
	Loop() error
	Exit() error
}