123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304 |
- //------------------------------------------------------------
- // Game Framework
- // Copyright © 2013-2021 loyalsoft. All rights reserved.
- // Homepage: http://www.game7000.com/
- // Feedback: http://www.game7000.com/
- //------------------------------------------------------------
- using GameFramework.Resource;
- using System;
- namespace GameFramework.DataTable
- {
- /// <summary>
- /// 数据表基类。
- /// </summary>
- public abstract class DataTableBase : IDataProvider<DataTableBase>
- {
- private readonly string m_Name;
- private readonly DataProvider<DataTableBase> m_DataProvider;
- /// <summary>
- /// 初始化数据表基类的新实例。
- /// </summary>
- public DataTableBase()
- : this(null)
- {
- }
- /// <summary>
- /// 初始化数据表基类的新实例。
- /// </summary>
- /// <param name="name">数据表名称。</param>
- public DataTableBase(string name)
- {
- m_Name = name ?? string.Empty;
- m_DataProvider = new DataProvider<DataTableBase>(this);
- }
- /// <summary>
- /// 获取数据表名称。
- /// </summary>
- public string Name
- {
- get
- {
- return m_Name;
- }
- }
- /// <summary>
- /// 获取数据表完整名称。
- /// </summary>
- public string FullName
- {
- get
- {
- return new TypeNamePair(Type, m_Name).ToString();
- }
- }
- /// <summary>
- /// 获取数据表行的类型。
- /// </summary>
- public abstract Type Type
- {
- get;
- }
- /// <summary>
- /// 获取数据表行数。
- /// </summary>
- public abstract int Count
- {
- get;
- }
- /// <summary>
- /// 读取数据表成功事件。
- /// </summary>
- public event EventHandler<ReadDataSuccessEventArgs> ReadDataSuccess
- {
- add
- {
- m_DataProvider.ReadDataSuccess += value;
- }
- remove
- {
- m_DataProvider.ReadDataSuccess -= value;
- }
- }
- /// <summary>
- /// 读取数据表失败事件。
- /// </summary>
- public event EventHandler<ReadDataFailureEventArgs> ReadDataFailure
- {
- add
- {
- m_DataProvider.ReadDataFailure += value;
- }
- remove
- {
- m_DataProvider.ReadDataFailure -= value;
- }
- }
- /// <summary>
- /// 读取数据表更新事件。
- /// </summary>
- public event EventHandler<ReadDataUpdateEventArgs> ReadDataUpdate
- {
- add
- {
- m_DataProvider.ReadDataUpdate += value;
- }
- remove
- {
- m_DataProvider.ReadDataUpdate -= value;
- }
- }
- /// <summary>
- /// 读取数据表时加载依赖资源事件。
- /// </summary>
- public event EventHandler<ReadDataDependencyAssetEventArgs> ReadDataDependencyAsset
- {
- add
- {
- m_DataProvider.ReadDataDependencyAsset += value;
- }
- remove
- {
- m_DataProvider.ReadDataDependencyAsset -= value;
- }
- }
- /// <summary>
- /// 读取数据表。
- /// </summary>
- /// <param name="dataTableAssetName">数据表资源名称。</param>
- public void ReadData(string dataTableAssetName)
- {
- m_DataProvider.ReadData(dataTableAssetName);
- }
- /// <summary>
- /// 读取数据表。
- /// </summary>
- /// <param name="dataTableAssetName">数据表资源名称。</param>
- /// <param name="priority">加载数据表资源的优先级。</param>
- public void ReadData(string dataTableAssetName, int priority)
- {
- m_DataProvider.ReadData(dataTableAssetName, priority);
- }
- /// <summary>
- /// 读取数据表。
- /// </summary>
- /// <param name="dataTableAssetName">数据表资源名称。</param>
- /// <param name="userData">用户自定义数据。</param>
- public void ReadData(string dataTableAssetName, object userData)
- {
- m_DataProvider.ReadData(dataTableAssetName, userData);
- }
- /// <summary>
- /// 读取数据表。
- /// </summary>
- /// <param name="dataTableAssetName">数据表资源名称。</param>
- /// <param name="priority">加载数据表资源的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- public void ReadData(string dataTableAssetName, int priority, object userData)
- {
- m_DataProvider.ReadData(dataTableAssetName, priority, userData);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableString">要解析的数据表字符串。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(string dataTableString)
- {
- return m_DataProvider.ParseData(dataTableString);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableString">要解析的数据表字符串。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(string dataTableString, object userData)
- {
- return m_DataProvider.ParseData(dataTableString, userData);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(byte[] dataTableBytes)
- {
- return m_DataProvider.ParseData(dataTableBytes);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(byte[] dataTableBytes, object userData)
- {
- return m_DataProvider.ParseData(dataTableBytes, userData);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
- /// <param name="startIndex">数据表二进制流的起始位置。</param>
- /// <param name="length">数据表二进制流的长度。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(byte[] dataTableBytes, int startIndex, int length)
- {
- return m_DataProvider.ParseData(dataTableBytes, startIndex, length);
- }
- /// <summary>
- /// 解析数据表。
- /// </summary>
- /// <param name="dataTableBytes">要解析的数据表二进制流。</param>
- /// <param name="startIndex">数据表二进制流的起始位置。</param>
- /// <param name="length">数据表二进制流的长度。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析数据表成功。</returns>
- public bool ParseData(byte[] dataTableBytes, int startIndex, int length, object userData)
- {
- return m_DataProvider.ParseData(dataTableBytes, startIndex, length, userData);
- }
- /// <summary>
- /// 检查是否存在数据表行。
- /// </summary>
- /// <param name="id">数据表行的编号。</param>
- /// <returns>是否存在数据表行。</returns>
- public abstract bool HasDataRow(int id);
- /// <summary>
- /// 增加数据表行。
- /// </summary>
- /// <param name="dataRowString">要解析的数据表行字符串。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否增加数据表行成功。</returns>
- public abstract bool AddDataRow(string dataRowString, object userData);
- /// <summary>
- /// 增加数据表行。
- /// </summary>
- /// <param name="dataRowBytes">要解析的数据表行二进制流。</param>
- /// <param name="startIndex">数据表行二进制流的起始位置。</param>
- /// <param name="length">数据表行二进制流的长度。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否增加数据表行成功。</returns>
- public abstract bool AddDataRow(byte[] dataRowBytes, int startIndex, int length, object userData);
- /// <summary>
- /// 移除指定数据表行。
- /// </summary>
- /// <param name="id">要移除数据表行的编号。</param>
- /// <returns>是否移除数据表行成功。</returns>
- public abstract bool RemoveDataRow(int id);
- /// <summary>
- /// 清空所有数据表行。
- /// </summary>
- public abstract void RemoveAllDataRows();
- /// <summary>
- /// 设置资源管理器。
- /// </summary>
- /// <param name="resourceManager">资源管理器。</param>
- internal void SetResourceManager(IResourceManager resourceManager)
- {
- m_DataProvider.SetResourceManager(resourceManager);
- }
- /// <summary>
- /// 设置数据提供者辅助器。
- /// </summary>
- /// <param name="dataProviderHelper">数据提供者辅助器。</param>
- internal void SetDataProviderHelper(IDataProviderHelper<DataTableBase> dataProviderHelper)
- {
- m_DataProvider.SetDataProviderHelper(dataProviderHelper);
- }
- /// <summary>
- /// 关闭并清理数据表。
- /// </summary>
- internal abstract void Shutdown();
- }
- }
|