DataTableComponent.cs 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399
  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;
  8. using GameFramework.DataTable;
  9. using GameFramework.Resource;
  10. using System;
  11. using System.Collections.Generic;
  12. using UnityEngine;
  13. namespace UnityGameFramework.Runtime
  14. {
  15. /// <summary>
  16. /// 数据表组件。
  17. /// </summary>
  18. [DisallowMultipleComponent]
  19. [AddComponentMenu("Game Framework/Data Table")]
  20. public sealed class DataTableComponent : GameFrameworkComponent
  21. {
  22. private const int DefaultPriority = 0;
  23. private IDataTableManager m_DataTableManager = null;
  24. private EventComponent m_EventComponent = null;
  25. [SerializeField]
  26. private bool m_EnableLoadDataTableUpdateEvent = false;
  27. [SerializeField]
  28. private bool m_EnableLoadDataTableDependencyAssetEvent = false;
  29. [SerializeField]
  30. private string m_DataTableHelperTypeName = "UnityGameFramework.Runtime.DefaultDataTableHelper";
  31. [SerializeField]
  32. private DataTableHelperBase m_CustomDataTableHelper = null;
  33. [SerializeField]
  34. private int m_CachedBytesSize = 0;
  35. /// <summary>
  36. /// 获取数据表数量。
  37. /// </summary>
  38. public int Count
  39. {
  40. get
  41. {
  42. return m_DataTableManager.Count;
  43. }
  44. }
  45. /// <summary>
  46. /// 获取缓冲二进制流的大小。
  47. /// </summary>
  48. public int CachedBytesSize
  49. {
  50. get
  51. {
  52. return m_DataTableManager.CachedBytesSize;
  53. }
  54. }
  55. /// <summary>
  56. /// 游戏框架组件初始化。
  57. /// </summary>
  58. protected override void Awake()
  59. {
  60. base.Awake();
  61. m_DataTableManager = GameFrameworkEntry.GetModule<IDataTableManager>();
  62. if (m_DataTableManager == null)
  63. {
  64. Log.Fatal("Data table manager is invalid.");
  65. return;
  66. }
  67. }
  68. private void Start()
  69. {
  70. BaseComponent baseComponent = GameEntry.GetComponent<BaseComponent>();
  71. if (baseComponent == null)
  72. {
  73. Log.Fatal("Base component is invalid.");
  74. return;
  75. }
  76. m_EventComponent = GameEntry.GetComponent<EventComponent>();
  77. if (m_EventComponent == null)
  78. {
  79. Log.Fatal("Event component is invalid.");
  80. return;
  81. }
  82. if (baseComponent.EditorResourceMode)
  83. {
  84. m_DataTableManager.SetResourceManager(baseComponent.EditorResourceHelper);
  85. }
  86. else
  87. {
  88. m_DataTableManager.SetResourceManager(GameFrameworkEntry.GetModule<IResourceManager>());
  89. }
  90. DataTableHelperBase dataTableHelper = Helper.CreateHelper(m_DataTableHelperTypeName, m_CustomDataTableHelper);
  91. if (dataTableHelper == null)
  92. {
  93. Log.Error("Can not create data table helper.");
  94. return;
  95. }
  96. dataTableHelper.name = "Data Table Helper";
  97. Transform transform = dataTableHelper.transform;
  98. transform.SetParent(this.transform);
  99. transform.localScale = Vector3.one;
  100. m_DataTableManager.SetDataProviderHelper(dataTableHelper);
  101. m_DataTableManager.SetDataTableHelper(dataTableHelper);
  102. if (m_CachedBytesSize > 0)
  103. {
  104. EnsureCachedBytesSize(m_CachedBytesSize);
  105. }
  106. }
  107. /// <summary>
  108. /// 确保二进制流缓存分配足够大小的内存并缓存。
  109. /// </summary>
  110. /// <param name="ensureSize">要确保二进制流缓存分配内存的大小。</param>
  111. public void EnsureCachedBytesSize(int ensureSize)
  112. {
  113. m_DataTableManager.EnsureCachedBytesSize(ensureSize);
  114. }
  115. /// <summary>
  116. /// 释放缓存的二进制流。
  117. /// </summary>
  118. public void FreeCachedBytes()
  119. {
  120. m_DataTableManager.FreeCachedBytes();
  121. }
  122. /// <summary>
  123. /// 是否存在数据表。
  124. /// </summary>
  125. /// <typeparam name="T">数据表行的类型。</typeparam>
  126. /// <returns>是否存在数据表。</returns>
  127. public bool HasDataTable<T>() where T : IDataRow
  128. {
  129. return m_DataTableManager.HasDataTable<T>();
  130. }
  131. /// <summary>
  132. /// 是否存在数据表。
  133. /// </summary>
  134. /// <param name="dataRowType">数据表行的类型。</param>
  135. /// <returns>是否存在数据表。</returns>
  136. public bool HasDataTable(Type dataRowType)
  137. {
  138. return m_DataTableManager.HasDataTable(dataRowType);
  139. }
  140. /// <summary>
  141. /// 是否存在数据表。
  142. /// </summary>
  143. /// <typeparam name="T">数据表行的类型。</typeparam>
  144. /// <param name="name">数据表名称。</param>
  145. /// <returns>是否存在数据表。</returns>
  146. public bool HasDataTable<T>(string name) where T : IDataRow
  147. {
  148. return m_DataTableManager.HasDataTable<T>(name);
  149. }
  150. /// <summary>
  151. /// 是否存在数据表。
  152. /// </summary>
  153. /// <param name="dataRowType">数据表行的类型。</param>
  154. /// <param name="name">数据表名称。</param>
  155. /// <returns>是否存在数据表。</returns>
  156. public bool HasDataTable(Type dataRowType, string name)
  157. {
  158. return m_DataTableManager.HasDataTable(dataRowType, name);
  159. }
  160. /// <summary>
  161. /// 获取数据表。
  162. /// </summary>
  163. /// <typeparam name="T">数据表行的类型。</typeparam>
  164. /// <returns>要获取的数据表。</returns>
  165. public IDataTable<T> GetDataTable<T>() where T : IDataRow
  166. {
  167. return m_DataTableManager.GetDataTable<T>();
  168. }
  169. /// <summary>
  170. /// 获取数据表。
  171. /// </summary>
  172. /// <param name="dataRowType">数据表行的类型。</param>
  173. /// <returns>要获取的数据表。</returns>
  174. public DataTableBase GetDataTable(Type dataRowType)
  175. {
  176. return m_DataTableManager.GetDataTable(dataRowType);
  177. }
  178. /// <summary>
  179. /// 获取数据表。
  180. /// </summary>
  181. /// <typeparam name="T">数据表行的类型。</typeparam>
  182. /// <param name="name">数据表名称。</param>
  183. /// <returns>要获取的数据表。</returns>
  184. public IDataTable<T> GetDataTable<T>(string name) where T : IDataRow
  185. {
  186. return m_DataTableManager.GetDataTable<T>(name);
  187. }
  188. /// <summary>
  189. /// 获取数据表。
  190. /// </summary>
  191. /// <param name="dataRowType">数据表行的类型。</param>
  192. /// <param name="name">数据表名称。</param>
  193. /// <returns>要获取的数据表。</returns>
  194. public DataTableBase GetDataTable(Type dataRowType, string name)
  195. {
  196. return m_DataTableManager.GetDataTable(dataRowType, name);
  197. }
  198. /// <summary>
  199. /// 获取所有数据表。
  200. /// </summary>
  201. public DataTableBase[] GetAllDataTables()
  202. {
  203. return m_DataTableManager.GetAllDataTables();
  204. }
  205. /// <summary>
  206. /// 获取所有数据表。
  207. /// </summary>
  208. /// <param name="results">所有数据表。</param>
  209. public void GetAllDataTables(List<DataTableBase> results)
  210. {
  211. m_DataTableManager.GetAllDataTables(results);
  212. }
  213. /// <summary>
  214. /// 创建数据表。
  215. /// </summary>
  216. /// <typeparam name="T">数据表行的类型。</typeparam>
  217. /// <returns>要创建的数据表。</returns>
  218. public IDataTable<T> CreateDataTable<T>() where T : class, IDataRow, new()
  219. {
  220. return CreateDataTable<T>(null);
  221. }
  222. /// <summary>
  223. /// 创建数据表。
  224. /// </summary>
  225. /// <param name="dataRowType">数据表行的类型。</param>
  226. /// <returns>要创建的数据表。</returns>
  227. public DataTableBase CreateDataTable(Type dataRowType)
  228. {
  229. return CreateDataTable(dataRowType, null);
  230. }
  231. /// <summary>
  232. /// 创建数据表。
  233. /// </summary>
  234. /// <typeparam name="T">数据表行的类型。</typeparam>
  235. /// <param name="name">数据表名称。</param>
  236. /// <returns>要创建的数据表。</returns>
  237. public IDataTable<T> CreateDataTable<T>(string name) where T : class, IDataRow, new()
  238. {
  239. IDataTable<T> dataTable = m_DataTableManager.CreateDataTable<T>(name);
  240. DataTableBase dataTableBase = (DataTableBase)dataTable;
  241. dataTableBase.ReadDataSuccess += OnReadDataSuccess;
  242. dataTableBase.ReadDataFailure += OnReadDataFailure;
  243. if (m_EnableLoadDataTableUpdateEvent)
  244. {
  245. dataTableBase.ReadDataUpdate += OnReadDataUpdate;
  246. }
  247. if (m_EnableLoadDataTableDependencyAssetEvent)
  248. {
  249. dataTableBase.ReadDataDependencyAsset += OnReadDataDependencyAsset;
  250. }
  251. return dataTable;
  252. }
  253. /// <summary>
  254. /// 创建数据表。
  255. /// </summary>
  256. /// <param name="dataRowType">数据表行的类型。</param>
  257. /// <param name="name">数据表名称。</param>
  258. /// <returns>要创建的数据表。</returns>
  259. public DataTableBase CreateDataTable(Type dataRowType, string name)
  260. {
  261. DataTableBase dataTable = m_DataTableManager.CreateDataTable(dataRowType, name);
  262. dataTable.ReadDataSuccess += OnReadDataSuccess;
  263. dataTable.ReadDataFailure += OnReadDataFailure;
  264. if (m_EnableLoadDataTableUpdateEvent)
  265. {
  266. dataTable.ReadDataUpdate += OnReadDataUpdate;
  267. }
  268. if (m_EnableLoadDataTableDependencyAssetEvent)
  269. {
  270. dataTable.ReadDataDependencyAsset += OnReadDataDependencyAsset;
  271. }
  272. return dataTable;
  273. }
  274. /// <summary>
  275. /// 销毁数据表。
  276. /// </summary>
  277. /// <typeparam name="T">数据表行的类型。</typeparam>
  278. /// <returns>是否销毁数据表成功。</returns>
  279. public bool DestroyDataTable<T>() where T : IDataRow, new()
  280. {
  281. return m_DataTableManager.DestroyDataTable<T>();
  282. }
  283. /// <summary>
  284. /// 销毁数据表。
  285. /// </summary>
  286. /// <param name="dataRowType">数据表行的类型。</param>
  287. /// <returns>是否销毁数据表成功。</returns>
  288. public bool DestroyDataTable(Type dataRowType)
  289. {
  290. return m_DataTableManager.DestroyDataTable(dataRowType);
  291. }
  292. /// <summary>
  293. /// 销毁数据表。
  294. /// </summary>
  295. /// <typeparam name="T">数据表行的类型。</typeparam>
  296. /// <param name="name">数据表名称。</param>
  297. /// <returns>是否销毁数据表成功。</returns>
  298. public bool DestroyDataTable<T>(string name) where T : IDataRow
  299. {
  300. return m_DataTableManager.DestroyDataTable<T>(name);
  301. }
  302. /// <summary>
  303. /// 销毁数据表。
  304. /// </summary>
  305. /// <param name="dataRowType">数据表行的类型。</param>
  306. /// <param name="name">数据表名称。</param>
  307. /// <returns>是否销毁数据表成功。</returns>
  308. public bool DestroyDataTable(Type dataRowType, string name)
  309. {
  310. return m_DataTableManager.DestroyDataTable(dataRowType, name);
  311. }
  312. /// <summary>
  313. /// 销毁数据表。
  314. /// </summary>
  315. /// <typeparam name="T">数据表行的类型。</typeparam>
  316. /// <param name="dataTable">要销毁的数据表。</param>
  317. /// <returns>是否销毁数据表成功。</returns>
  318. public bool DestroyDataTable<T>(IDataTable<T> dataTable) where T : IDataRow
  319. {
  320. return m_DataTableManager.DestroyDataTable(dataTable);
  321. }
  322. /// <summary>
  323. /// 销毁数据表。
  324. /// </summary>
  325. /// <param name="dataTable">要销毁的数据表。</param>
  326. /// <returns>是否销毁数据表成功。</returns>
  327. public bool DestroyDataTable(DataTableBase dataTable)
  328. {
  329. return m_DataTableManager.DestroyDataTable(dataTable);
  330. }
  331. private void OnReadDataSuccess(object sender, ReadDataSuccessEventArgs e)
  332. {
  333. m_EventComponent.Fire(this, LoadDataTableSuccessEventArgs.Create(e));
  334. }
  335. private void OnReadDataFailure(object sender, ReadDataFailureEventArgs e)
  336. {
  337. Log.Warning("Load data table failure, asset name '{0}', error message '{1}'.", e.DataAssetName, e.ErrorMessage);
  338. m_EventComponent.Fire(this, LoadDataTableFailureEventArgs.Create(e));
  339. }
  340. private void OnReadDataUpdate(object sender, ReadDataUpdateEventArgs e)
  341. {
  342. m_EventComponent.Fire(this, LoadDataTableUpdateEventArgs.Create(e));
  343. }
  344. private void OnReadDataDependencyAsset(object sender, ReadDataDependencyAssetEventArgs e)
  345. {
  346. m_EventComponent.Fire(this, LoadDataTableDependencyAssetEventArgs.Create(e));
  347. }
  348. }
  349. }