IDataNodeManager.cs 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. //------------------------------------------------------------
  2. // Game Framework
  3. // Copyright © 2013-2021 loyalsoft. All rights reserved.
  4. // Homepage: http://www.game7000.com/
  5. // Feedback: http://www.game7000.com/
  6. //------------------------------------------------------------
  7. namespace GameFramework.DataNode
  8. {
  9. /// <summary>
  10. /// 数据结点管理器接口。
  11. /// </summary>
  12. public interface IDataNodeManager
  13. {
  14. /// <summary>
  15. /// 获取根数据结点。
  16. /// </summary>
  17. IDataNode Root
  18. {
  19. get;
  20. }
  21. /// <summary>
  22. /// 根据类型获取数据结点的数据。
  23. /// </summary>
  24. /// <typeparam name="T">要获取的数据类型。</typeparam>
  25. /// <param name="path">相对于 node 的查找路径。</param>
  26. /// <returns>指定类型的数据。</returns>
  27. T GetData<T>(string path) where T : Variable;
  28. /// <summary>
  29. /// 获取数据结点的数据。
  30. /// </summary>
  31. /// <param name="path">相对于 node 的查找路径。</param>
  32. /// <returns>数据结点的数据。</returns>
  33. Variable GetData(string path);
  34. /// <summary>
  35. /// 根据类型获取数据结点的数据。
  36. /// </summary>
  37. /// <typeparam name="T">要获取的数据类型。</typeparam>
  38. /// <param name="path">相对于 node 的查找路径。</param>
  39. /// <param name="node">查找起始结点。</param>
  40. /// <returns>指定类型的数据。</returns>
  41. T GetData<T>(string path, IDataNode node) where T : Variable;
  42. /// <summary>
  43. /// 获取数据结点的数据。
  44. /// </summary>
  45. /// <param name="path">相对于 node 的查找路径。</param>
  46. /// <param name="node">查找起始结点。</param>
  47. /// <returns>数据结点的数据。</returns>
  48. Variable GetData(string path, IDataNode node);
  49. /// <summary>
  50. /// 设置数据结点的数据。
  51. /// </summary>
  52. /// <typeparam name="T">要设置的数据类型。</typeparam>
  53. /// <param name="path">相对于 node 的查找路径。</param>
  54. /// <param name="data">要设置的数据。</param>
  55. void SetData<T>(string path, T data) where T : Variable;
  56. /// <summary>
  57. /// 设置数据结点的数据。
  58. /// </summary>
  59. /// <param name="path">相对于 node 的查找路径。</param>
  60. /// <param name="data">要设置的数据。</param>
  61. void SetData(string path, Variable data);
  62. /// <summary>
  63. /// 设置数据结点的数据。
  64. /// </summary>
  65. /// <typeparam name="T">要设置的数据类型。</typeparam>
  66. /// <param name="path">相对于 node 的查找路径。</param>
  67. /// <param name="data">要设置的数据。</param>
  68. /// <param name="node">查找起始结点。</param>
  69. void SetData<T>(string path, T data, IDataNode node) where T : Variable;
  70. /// <summary>
  71. /// 设置数据结点的数据。
  72. /// </summary>
  73. /// <param name="path">相对于 node 的查找路径。</param>
  74. /// <param name="data">要设置的数据。</param>
  75. /// <param name="node">查找起始结点。</param>
  76. void SetData(string path, Variable data, IDataNode node);
  77. /// <summary>
  78. /// 获取数据结点。
  79. /// </summary>
  80. /// <param name="path">相对于 node 的查找路径。</param>
  81. /// <returns>指定位置的数据结点,如果没有找到,则返回空。</returns>
  82. IDataNode GetNode(string path);
  83. /// <summary>
  84. /// 获取数据结点。
  85. /// </summary>
  86. /// <param name="path">相对于 node 的查找路径。</param>
  87. /// <param name="node">查找起始结点。</param>
  88. /// <returns>指定位置的数据结点,如果没有找到,则返回空。</returns>
  89. IDataNode GetNode(string path, IDataNode node);
  90. /// <summary>
  91. /// 获取或增加数据结点。
  92. /// </summary>
  93. /// <param name="path">相对于 node 的查找路径。</param>
  94. /// <returns>指定位置的数据结点,如果没有找到,则创建相应的数据结点。</returns>
  95. IDataNode GetOrAddNode(string path);
  96. /// <summary>
  97. /// 获取或增加数据结点。
  98. /// </summary>
  99. /// <param name="path">相对于 node 的查找路径。</param>
  100. /// <param name="node">查找起始结点。</param>
  101. /// <returns>指定位置的数据结点,如果没有找到,则创建相应的数据结点。</returns>
  102. IDataNode GetOrAddNode(string path, IDataNode node);
  103. /// <summary>
  104. /// 移除数据结点。
  105. /// </summary>
  106. /// <param name="path">相对于 node 的查找路径。</param>
  107. void RemoveNode(string path);
  108. /// <summary>
  109. /// 移除数据结点。
  110. /// </summary>
  111. /// <param name="path">相对于 node 的查找路径。</param>
  112. /// <param name="node">查找起始结点。</param>
  113. void RemoveNode(string path, IDataNode node);
  114. /// <summary>
  115. /// 移除所有数据结点。
  116. /// </summary>
  117. void Clear();
  118. }
  119. }