DataTableBase.cs 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304
  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. using GameFramework.Resource;
  8. using System;
  9. namespace GameFramework.DataTable
  10. {
  11. /// <summary>
  12. /// 数据表基类。
  13. /// </summary>
  14. public abstract class DataTableBase : IDataProvider<DataTableBase>
  15. {
  16. private readonly string m_Name;
  17. private readonly DataProvider<DataTableBase> m_DataProvider;
  18. /// <summary>
  19. /// 初始化数据表基类的新实例。
  20. /// </summary>
  21. public DataTableBase()
  22. : this(null)
  23. {
  24. }
  25. /// <summary>
  26. /// 初始化数据表基类的新实例。
  27. /// </summary>
  28. /// <param name="name">数据表名称。</param>
  29. public DataTableBase(string name)
  30. {
  31. m_Name = name ?? string.Empty;
  32. m_DataProvider = new DataProvider<DataTableBase>(this);
  33. }
  34. /// <summary>
  35. /// 获取数据表名称。
  36. /// </summary>
  37. public string Name
  38. {
  39. get
  40. {
  41. return m_Name;
  42. }
  43. }
  44. /// <summary>
  45. /// 获取数据表完整名称。
  46. /// </summary>
  47. public string FullName
  48. {
  49. get
  50. {
  51. return new TypeNamePair(Type, m_Name).ToString();
  52. }
  53. }
  54. /// <summary>
  55. /// 获取数据表行的类型。
  56. /// </summary>
  57. public abstract Type Type
  58. {
  59. get;
  60. }
  61. /// <summary>
  62. /// 获取数据表行数。
  63. /// </summary>
  64. public abstract int Count
  65. {
  66. get;
  67. }
  68. /// <summary>
  69. /// 读取数据表成功事件。
  70. /// </summary>
  71. public event EventHandler<ReadDataSuccessEventArgs> ReadDataSuccess
  72. {
  73. add
  74. {
  75. m_DataProvider.ReadDataSuccess += value;
  76. }
  77. remove
  78. {
  79. m_DataProvider.ReadDataSuccess -= value;
  80. }
  81. }
  82. /// <summary>
  83. /// 读取数据表失败事件。
  84. /// </summary>
  85. public event EventHandler<ReadDataFailureEventArgs> ReadDataFailure
  86. {
  87. add
  88. {
  89. m_DataProvider.ReadDataFailure += value;
  90. }
  91. remove
  92. {
  93. m_DataProvider.ReadDataFailure -= value;
  94. }
  95. }
  96. /// <summary>
  97. /// 读取数据表更新事件。
  98. /// </summary>
  99. public event EventHandler<ReadDataUpdateEventArgs> ReadDataUpdate
  100. {
  101. add
  102. {
  103. m_DataProvider.ReadDataUpdate += value;
  104. }
  105. remove
  106. {
  107. m_DataProvider.ReadDataUpdate -= value;
  108. }
  109. }
  110. /// <summary>
  111. /// 读取数据表时加载依赖资源事件。
  112. /// </summary>
  113. public event EventHandler<ReadDataDependencyAssetEventArgs> ReadDataDependencyAsset
  114. {
  115. add
  116. {
  117. m_DataProvider.ReadDataDependencyAsset += value;
  118. }
  119. remove
  120. {
  121. m_DataProvider.ReadDataDependencyAsset -= value;
  122. }
  123. }
  124. /// <summary>
  125. /// 读取数据表。
  126. /// </summary>
  127. /// <param name="dataTableAssetName">数据表资源名称。</param>
  128. public void ReadData(string dataTableAssetName)
  129. {
  130. m_DataProvider.ReadData(dataTableAssetName);
  131. }
  132. /// <summary>
  133. /// 读取数据表。
  134. /// </summary>
  135. /// <param name="dataTableAssetName">数据表资源名称。</param>
  136. /// <param name="priority">加载数据表资源的优先级。</param>
  137. public void ReadData(string dataTableAssetName, int priority)
  138. {
  139. m_DataProvider.ReadData(dataTableAssetName, priority);
  140. }
  141. /// <summary>
  142. /// 读取数据表。
  143. /// </summary>
  144. /// <param name="dataTableAssetName">数据表资源名称。</param>
  145. /// <param name="userData">用户自定义数据。</param>
  146. public void ReadData(string dataTableAssetName, object userData)
  147. {
  148. m_DataProvider.ReadData(dataTableAssetName, userData);
  149. }
  150. /// <summary>
  151. /// 读取数据表。
  152. /// </summary>
  153. /// <param name="dataTableAssetName">数据表资源名称。</param>
  154. /// <param name="priority">加载数据表资源的优先级。</param>
  155. /// <param name="userData">用户自定义数据。</param>
  156. public void ReadData(string dataTableAssetName, int priority, object userData)
  157. {
  158. m_DataProvider.ReadData(dataTableAssetName, priority, userData);
  159. }
  160. /// <summary>
  161. /// 解析数据表。
  162. /// </summary>
  163. /// <param name="dataTableString">要解析的数据表字符串。</param>
  164. /// <returns>是否解析数据表成功。</returns>
  165. public bool ParseData(string dataTableString)
  166. {
  167. return m_DataProvider.ParseData(dataTableString);
  168. }
  169. /// <summary>
  170. /// 解析数据表。
  171. /// </summary>
  172. /// <param name="dataTableString">要解析的数据表字符串。</param>
  173. /// <param name="userData">用户自定义数据。</param>
  174. /// <returns>是否解析数据表成功。</returns>
  175. public bool ParseData(string dataTableString, object userData)
  176. {
  177. return m_DataProvider.ParseData(dataTableString, userData);
  178. }
  179. /// <summary>
  180. /// 解析数据表。
  181. /// </summary>
  182. /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
  183. /// <returns>是否解析数据表成功。</returns>
  184. public bool ParseData(byte[] dataTableBytes)
  185. {
  186. return m_DataProvider.ParseData(dataTableBytes);
  187. }
  188. /// <summary>
  189. /// 解析数据表。
  190. /// </summary>
  191. /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
  192. /// <param name="userData">用户自定义数据。</param>
  193. /// <returns>是否解析数据表成功。</returns>
  194. public bool ParseData(byte[] dataTableBytes, object userData)
  195. {
  196. return m_DataProvider.ParseData(dataTableBytes, userData);
  197. }
  198. /// <summary>
  199. /// 解析数据表。
  200. /// </summary>
  201. /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
  202. /// <param name="startIndex">数据表二进制流的起始位置。</param>
  203. /// <param name="length">数据表二进制流的长度。</param>
  204. /// <returns>是否解析数据表成功。</returns>
  205. public bool ParseData(byte[] dataTableBytes, int startIndex, int length)
  206. {
  207. return m_DataProvider.ParseData(dataTableBytes, startIndex, length);
  208. }
  209. /// <summary>
  210. /// 解析数据表。
  211. /// </summary>
  212. /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
  213. /// <param name="startIndex">数据表二进制流的起始位置。</param>
  214. /// <param name="length">数据表二进制流的长度。</param>
  215. /// <param name="userData">用户自定义数据。</param>
  216. /// <returns>是否解析数据表成功。</returns>
  217. public bool ParseData(byte[] dataTableBytes, int startIndex, int length, object userData)
  218. {
  219. return m_DataProvider.ParseData(dataTableBytes, startIndex, length, userData);
  220. }
  221. /// <summary>
  222. /// 检查是否存在数据表行。
  223. /// </summary>
  224. /// <param name="id">数据表行的编号。</param>
  225. /// <returns>是否存在数据表行。</returns>
  226. public abstract bool HasDataRow(int id);
  227. /// <summary>
  228. /// 增加数据表行。
  229. /// </summary>
  230. /// <param name="dataRowString">要解析的数据表行字符串。</param>
  231. /// <param name="userData">用户自定义数据。</param>
  232. /// <returns>是否增加数据表行成功。</returns>
  233. public abstract bool AddDataRow(string dataRowString, object userData);
  234. /// <summary>
  235. /// 增加数据表行。
  236. /// </summary>
  237. /// <param name="dataRowBytes">要解析的数据表行二进制流。</param>
  238. /// <param name="startIndex">数据表行二进制流的起始位置。</param>
  239. /// <param name="length">数据表行二进制流的长度。</param>
  240. /// <param name="userData">用户自定义数据。</param>
  241. /// <returns>是否增加数据表行成功。</returns>
  242. public abstract bool AddDataRow(byte[] dataRowBytes, int startIndex, int length, object userData);
  243. /// <summary>
  244. /// 移除指定数据表行。
  245. /// </summary>
  246. /// <param name="id">要移除数据表行的编号。</param>
  247. /// <returns>是否移除数据表行成功。</returns>
  248. public abstract bool RemoveDataRow(int id);
  249. /// <summary>
  250. /// 清空所有数据表行。
  251. /// </summary>
  252. public abstract void RemoveAllDataRows();
  253. /// <summary>
  254. /// 设置资源管理器。
  255. /// </summary>
  256. /// <param name="resourceManager">资源管理器。</param>
  257. internal void SetResourceManager(IResourceManager resourceManager)
  258. {
  259. m_DataProvider.SetResourceManager(resourceManager);
  260. }
  261. /// <summary>
  262. /// 设置数据提供者辅助器。
  263. /// </summary>
  264. /// <param name="dataProviderHelper">数据提供者辅助器。</param>
  265. internal void SetDataProviderHelper(IDataProviderHelper<DataTableBase> dataProviderHelper)
  266. {
  267. m_DataProvider.SetDataProviderHelper(dataProviderHelper);
  268. }
  269. /// <summary>
  270. /// 关闭并清理数据表。
  271. /// </summary>
  272. internal abstract void Shutdown();
  273. }
  274. }