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 {
	corectx.Context
	reinterpret.InstanceProvider
	extension.AddInProvider
	pt.EntityPTProvider
	Caller
	fmt.Stringer

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

type ContextBehavior struct {
	corectx.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.ServiceAddInManager // 插件管理器
	RunningEventCB RunningEventCB                // 运行事件回调
}

type EntityManager interface {
	// GetEntity 查询实体
	GetEntity(id uid.Id) (ec.ConcurrentEntity, bool)
	// GetOrAddEntity 查询或添加实体
	GetOrAddEntity(entity ec.ConcurrentEntity) (ec.ConcurrentEntity, bool, error)
	// RemoveEntity 删除实体
	RemoveEntity(id uid.Id)
}

type RunningEvent int32

type RunningEventCB = generic.ActionVar2[Context, RunningEvent, any] // 运行事件回调