extension

Documentation

Overview

Package extension 插件系统，用于扩展服务或运行时能力，例如服务发现、消息队列与日志系统等。

• 插件主要以组合方式安装在服务或运行时上下文上，用于扩展服务或运行时能力。
• 服务与运行时上下文均支持安装插件，注意服务上的插件需要支持多线程环境，运行时上的插件仅需支持单线程环境即可。

Index

• Variables
• func Install[T any](provider PluginProvider, plugin T, name ...string)
• func Uninstall(provider PluginProvider, name string)
• func UnsafePluginBundle(pluginBundle PluginBundle) _UnsafePluginBundle
• func UnsafePluginStatus(status PluginStatus) _UnsafePluginStatus
• func Using[T any](provider PluginProvider, name string) T
• type PluginBundle
  • func NewPluginBundle() PluginBundle
• type PluginProvider
• type PluginState
  • func (i PluginState) String() string
• type PluginStatus

Variables

var (
	ErrExtension = fmt.Errorf("%w: extension", exception.ErrCore) // 插件系统错误
)

Functions

func Install

func Install[T any](provider PluginProvider, plugin T, name ...string)

Install 安装插件

func Uninstall

func Uninstall(provider PluginProvider, name string)

Uninstall 卸载插件

func UnsafePluginBundle

func UnsafePluginBundle(pluginBundle PluginBundle) _UnsafePluginBundle

Deprecated: UnsafePluginBundle 访问插件包的内部方法

func UnsafePluginStatus

func UnsafePluginStatus(status PluginStatus) _UnsafePluginStatus

Deprecated: UnsafePluginStatus 访问插件状态信息的内部方法

func Using

func Using[T any](provider PluginProvider, name string) T

Using 使用插件

Types

type PluginBundle

type PluginBundle interface {
	PluginProvider

	// Install 安装插件，不设置插件名称时，将会使用插件实例名称作为插件名称
	Install(pluginFace iface.FaceAny, name ...string)
	// Uninstall 卸载插件
	Uninstall(name string)
	// Get 获取插件
	Get(name string) (PluginStatus, bool)
	// Range 遍历所有已注册的插件
	Range(fun generic.Func1[PluginStatus, bool])
	// ReversedRange 反向遍历所有已注册的插件
	ReversedRange(fun generic.Func1[PluginStatus, bool])
	// contains filtered or unexported methods
}

PluginBundle 插件包

func NewPluginBundle

func NewPluginBundle() PluginBundle

NewPluginBundle 创建插件包

type PluginProvider

type PluginProvider interface {
	// GetPluginBundle 获取插件包
	GetPluginBundle() PluginBundle
}

PluginProvider 插件提供者

type PluginState

type PluginState int8

PluginState 插件状态

const (
	PluginState_Loaded   PluginState = iota // 已加载
	PluginState_Active                      // 已激活
	PluginState_Inactive                    // 未激活
)

func (PluginState) String

func (i PluginState) String() string

type PluginStatus

type PluginStatus interface {

	// Name 插件名称
	Name() string
	// InstanceFace 插件实例
	InstanceFace() iface.FaceAny
	// Reflected 插件反射值
	Reflected() reflect.Value
	// State 状态
	State() PluginState
	// contains filtered or unexported methods
}

PluginStatus 插件状态信息