[修改]1. 修改存档接口所属

Author: AlianBlank

GameFrameX.Core/Actors/Actor.cs

@@ -262,7 +262,7 @@ internal async Task SaveAllState()
     {
         foreach (var item in _componentsMap)
         {
-            await item.Value.SaveState();
+            await item.Value.WriteStateAsync();
         }
     }
 

GameFrameX.Core/Components/BaseComponent.cs

@@ -7,7 +7,7 @@ namespace GameFrameX.Core.Components;
 /// <summary>
 /// 基础组件基类
 /// </summary>
-public abstract class BaseComponent : IComponent
+public abstract class BaseComponent : IComponent, IState
 {
     private readonly object _cacheAgentLock = new();
     private IComponentAgent _cacheAgent;
@@ -93,11 +93,21 @@ public virtual async Task Inactive()
     }
 
     /// <summary>
-    /// 保存数据
+    /// 读取状态
     /// </summary>
-    /// <returns>保存任务</returns>
-    internal virtual Task SaveState()
-    {
-        return Task.CompletedTask;
-    }
+    /// <returns>一个表示异步操作的任务，该任务在状态读取完成时完成</returns>
+    /// <remarks>
+    /// 此方法用于异步读取对象的当前状态信息
+    /// </remarks>
+    public abstract Task ReadStateAsync();
+
+    /// <summary>
+    /// 更新状态
+    /// </summary>
+    /// <returns>一个表示异步操作的任务，该任务在状态更新完成时完成</returns>
+    /// <remarks>
+    /// 此方法用于异步更新对象的状态信息
+    /// 在状态发生变化时应调用此方法以保持状态的同步
+    /// </remarks>
+    public abstract Task WriteStateAsync();
 }

GameFrameX.Core/Components/StateComponent.cs

@@ -88,7 +88,7 @@ public static async Task TimerSave()
 /// 数据状态组件
 /// </summary>
 /// <typeparam name="TState"></typeparam>
-public abstract class StateComponent<TState> : BaseComponent, IState where TState : BaseCacheState, new()
+public abstract class StateComponent<TState> : BaseComponent where TState : BaseCacheState, new()
 {
     private static readonly ConcurrentDictionary<long, TState> StateDic = new ConcurrentDictionary<long, TState>();
 
@@ -127,9 +127,10 @@ protected virtual Task<TState> ActiveReadStateAsync()
 
     /// <summary>
     /// 准备并读取状态数据
+    /// 子类不要重写该函数，而是重写ActiveReadStateAsync函数
     /// </summary>
     /// <returns>异步任务</returns>
-    public async Task ReadStateAsync()
+    public override async Task ReadStateAsync()
     {
         try
         {
@@ -181,7 +182,7 @@ public override Task Inactive()
     /// 保存状态到数据库
     /// </summary>
     /// <returns>异步任务</returns>
-    internal override async Task SaveState()
+    protected async Task SaveState()
     {
         try
         {
@@ -200,20 +201,11 @@ internal override async Task SaveState()
     /// 异步写入状态到数据库
     /// </summary>
     /// <returns>异步任务</returns>
-    public async Task WriteStateAsync()
+    public override async Task WriteStateAsync()
     {
         await SaveState();
     }
 
-    /// <summary>
-    /// 保存数据的虚方法，可被子类重写
-    /// </summary>
-    /// <returns>异步任务</returns>
-    public virtual Task SaveAsync()
-    {
-        return WriteStateAsync();
-    }
-
     #region 仅DBModel.Mongodb调用
 
     /// <summary>