service

type Caller interface {
	// CallAsync 查找实体并异步调用函数，有返回值。不会阻塞当前线程，会返回AsyncRet。
	//
	//	注意：
	//	- 代码片段中的线程安全问题，如临界区访问、线程死锁等。
	//	- 调用过程中的panic信息，均会转换为error返回。
	CallAsync(entityId uid.Id, fun generic.FuncVar1[ec.Entity, any, async.Ret], args ...any) async.AsyncRet

	// CallDelegateAsync 查找实体并异步调用委托，有返回值。不会阻塞当前线程，会返回AsyncRet。
	//
	//	注意：
	//	- 代码片段中的线程安全问题，如临界区访问、线程死锁等。
	//	- 调用过程中的panic信息，均会转换为error返回。
	CallDelegateAsync(entityId uid.Id, fun generic.DelegateVar1[ec.Entity, any, async.Ret], args ...any) async.AsyncRet

	// CallVoidAsync 查找实体并异步调用函数，无返回值。在运行时中。不会阻塞当前线程，会返回AsyncRet。
	//
	//	注意：
	//	- 代码片段中的线程安全问题，如临界区访问、线程死锁等。
	//	- 调用过程中的panic信息，均会转换为error返回。
	CallVoidAsync(entityId uid.Id, fun generic.ActionVar1[ec.Entity, any], args ...any) async.AsyncRet

	// CallDelegateVoidAsync 查找实体并异步调用委托，无返回值。在运行时中。不会阻塞当前线程，会返回AsyncRet。
	//
	//	注意：
	//	- 代码片段中的线程安全问题，如临界区访问、线程死锁等。
	//	- 调用过程中的panic信息，均会转换为error返回。
	CallDelegateVoidAsync(entityId uid.Id, fun generic.DelegateVoidVar1[ec.Entity, any], args ...any) async.AsyncRet
}

type Context interface {
	ictx.Context
	reinterpret.InstanceProvider
	extension.AddInProvider
	pt.EntityPTProvider
	Caller
	fmt.Stringer

	// GetName 获取名称
	GetName() string
	// GetId 获取服务Id
	GetId() uid.Id
	// GetReflected 获取反射值
	GetReflected() reflect.Value
	// GetEntityManager 获取实体管理器
	GetEntityManager() EntityManager
	// contains filtered or unexported methods
}

type ContextBehavior struct {
	ictx.ContextBehavior
	// contains filtered or unexported fields
}

type ContextOptions struct {
	InstanceFace           iface.Face[Context]    // 实例，用于扩展服务上下文能力
	Context                context.Context        // 父Context
	AutoRecover            bool                   // 是否开启panic时自动恢复
	ReportError            chan error             // panic时错误写入的error channel
	Name                   string                 // 服务名称
	PersistId              uid.Id                 // 服务持久化Id
	EntityLib              pt.EntityLib           // 实体原型库
	AddInManager           extension.AddInManager // 插件管理器
	RunningStatusChangedCB RunningStatusChangedCB // 运行状态变化回调
}

type EntityManager interface {
	// GetContext 获取服务上下文
	GetContext() Context
	// GetEntity 查询实体
	GetEntity(id uid.Id) (ec.ConcurrentEntity, bool)
	// GetOrAddEntity 查询或添加实体
	GetOrAddEntity(entity ec.ConcurrentEntity) (ec.ConcurrentEntity, bool, error)
	// AddEntity 添加实体
	AddEntity(entity ec.ConcurrentEntity) error
	// GetAndRemoveEntity 查询并删除实体
	GetAndRemoveEntity(id uid.Id) (ec.ConcurrentEntity, bool)
	// RemoveEntity 删除实体
	RemoveEntity(id uid.Id)
}

type RunningStatus int32

type RunningStatusChangedCB = generic.ActionVar2[Context, RunningStatus, any] // 运行状态变化回调