123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500 |
- //------------------------------------------------------------
- // 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
- {
- /// <summary>
- /// 数据提供者。
- /// </summary>
- /// <typeparam name="T">数据提供者的持有者的类型。</typeparam>
- internal sealed class DataProvider<T> : IDataProvider<T>
- {
- private const int BlockSize = 1024 * 4;
- private static byte[] s_CachedBytes = null;
- private readonly T m_Owner;
- private readonly LoadAssetCallbacks m_LoadAssetCallbacks;
- private readonly LoadBinaryCallbacks m_LoadBinaryCallbacks;
- private IResourceManager m_ResourceManager;
- private IDataProviderHelper<T> m_DataProviderHelper;
- private EventHandler<ReadDataSuccessEventArgs> m_ReadDataSuccessEventHandler;
- private EventHandler<ReadDataFailureEventArgs> m_ReadDataFailureEventHandler;
- private EventHandler<ReadDataUpdateEventArgs> m_ReadDataUpdateEventHandler;
- private EventHandler<ReadDataDependencyAssetEventArgs> m_ReadDataDependencyAssetEventHandler;
- /// <summary>
- /// 初始化数据提供者的新实例。
- /// </summary>
- /// <param name="owner">数据提供者的持有者。</param>
- public DataProvider(T owner)
- {
- m_Owner = owner;
- m_LoadAssetCallbacks = new LoadAssetCallbacks(LoadAssetSuccessCallback, LoadAssetOrBinaryFailureCallback, LoadAssetUpdateCallback, LoadAssetDependencyAssetCallback);
- m_LoadBinaryCallbacks = new LoadBinaryCallbacks(LoadBinarySuccessCallback, LoadAssetOrBinaryFailureCallback);
- m_ResourceManager = null;
- m_DataProviderHelper = null;
- m_ReadDataSuccessEventHandler = null;
- m_ReadDataFailureEventHandler = null;
- m_ReadDataUpdateEventHandler = null;
- m_ReadDataDependencyAssetEventHandler = null;
- }
- /// <summary>
- /// 获取缓冲二进制流的大小。
- /// </summary>
- public static int CachedBytesSize
- {
- get
- {
- return s_CachedBytes != null ? s_CachedBytes.Length : 0;
- }
- }
- /// <summary>
- /// 读取数据成功事件。
- /// </summary>
- public event EventHandler<ReadDataSuccessEventArgs> ReadDataSuccess
- {
- add
- {
- m_ReadDataSuccessEventHandler += value;
- }
- remove
- {
- m_ReadDataSuccessEventHandler -= value;
- }
- }
- /// <summary>
- /// 读取数据失败事件。
- /// </summary>
- public event EventHandler<ReadDataFailureEventArgs> ReadDataFailure
- {
- add
- {
- m_ReadDataFailureEventHandler += value;
- }
- remove
- {
- m_ReadDataFailureEventHandler -= value;
- }
- }
- /// <summary>
- /// 读取数据更新事件。
- /// </summary>
- public event EventHandler<ReadDataUpdateEventArgs> ReadDataUpdate
- {
- add
- {
- m_ReadDataUpdateEventHandler += value;
- }
- remove
- {
- m_ReadDataUpdateEventHandler -= value;
- }
- }
- /// <summary>
- /// 读取数据时加载依赖资源事件。
- /// </summary>
- public event EventHandler<ReadDataDependencyAssetEventArgs> ReadDataDependencyAsset
- {
- add
- {
- m_ReadDataDependencyAssetEventHandler += value;
- }
- remove
- {
- m_ReadDataDependencyAssetEventHandler -= value;
- }
- }
- /// <summary>
- /// 确保二进制流缓存分配足够大小的内存并缓存。
- /// </summary>
- /// <param name="ensureSize">要确保二进制流缓存分配内存的大小。</param>
- public static void EnsureCachedBytesSize(int ensureSize)
- {
- if (ensureSize < 0)
- {
- throw new GameFrameworkException("Ensure size is invalid.");
- }
- if (s_CachedBytes == null || s_CachedBytes.Length < ensureSize)
- {
- FreeCachedBytes();
- int size = (ensureSize - 1 + BlockSize) / BlockSize * BlockSize;
- s_CachedBytes = new byte[size];
- }
- }
- /// <summary>
- /// 释放缓存的二进制流。
- /// </summary>
- public static void FreeCachedBytes()
- {
- s_CachedBytes = null;
- }
- /// <summary>
- /// 读取数据。
- /// </summary>
- /// <param name="dataAssetName">内容资源名称。</param>
- public void ReadData(string dataAssetName)
- {
- ReadData(dataAssetName, Constant.DefaultPriority, null);
- }
- /// <summary>
- /// 读取数据。
- /// </summary>
- /// <param name="dataAssetName">内容资源名称。</param>
- /// <param name="priority">加载数据资源的优先级。</param>
- public void ReadData(string dataAssetName, int priority)
- {
- ReadData(dataAssetName, priority, null);
- }
- /// <summary>
- /// 读取数据。
- /// </summary>
- /// <param name="dataAssetName">内容资源名称。</param>
- /// <param name="userData">用户自定义数据。</param>
- public void ReadData(string dataAssetName, object userData)
- {
- ReadData(dataAssetName, Constant.DefaultPriority, userData);
- }
- /// <summary>
- /// 读取数据。
- /// </summary>
- /// <param name="dataAssetName">内容资源名称。</param>
- /// <param name="priority">加载数据资源的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- public void ReadData(string dataAssetName, int priority, object userData)
- {
- if (m_ResourceManager == null)
- {
- throw new GameFrameworkException("You must set resource manager first.");
- }
- if (m_DataProviderHelper == null)
- {
- throw new GameFrameworkException("You must set data provider helper first.");
- }
- HasAssetResult result = m_ResourceManager.HasAsset(dataAssetName);
- switch (result)
- {
- case HasAssetResult.AssetOnDisk:
- case HasAssetResult.AssetOnFileSystem:
- m_ResourceManager.LoadAsset(dataAssetName, priority, m_LoadAssetCallbacks, userData);
- break;
- case HasAssetResult.BinaryOnDisk:
- m_ResourceManager.LoadBinary(dataAssetName, m_LoadBinaryCallbacks, userData);
- break;
- case HasAssetResult.BinaryOnFileSystem:
- int dataLength = m_ResourceManager.GetBinaryLength(dataAssetName);
- EnsureCachedBytesSize(dataLength);
- if (dataLength != m_ResourceManager.LoadBinaryFromFileSystem(dataAssetName, s_CachedBytes))
- {
- throw new GameFrameworkException(Utility.Text.Format("Load binary '{0}' from file system with internal error.", dataAssetName));
- }
- try
- {
- if (!m_DataProviderHelper.ReadData(m_Owner, dataAssetName, s_CachedBytes, 0, dataLength, userData))
- {
- throw new GameFrameworkException(Utility.Text.Format("Load data failure in data provider helper, data asset name '{0}'.", dataAssetName));
- }
- if (m_ReadDataSuccessEventHandler != null)
- {
- ReadDataSuccessEventArgs loadDataSuccessEventArgs = ReadDataSuccessEventArgs.Create(dataAssetName, 0f, userData);
- m_ReadDataSuccessEventHandler(this, loadDataSuccessEventArgs);
- ReferencePool.Release(loadDataSuccessEventArgs);
- }
- }
- catch (Exception exception)
- {
- if (m_ReadDataFailureEventHandler != null)
- {
- ReadDataFailureEventArgs loadDataFailureEventArgs = ReadDataFailureEventArgs.Create(dataAssetName, exception.ToString(), userData);
- m_ReadDataFailureEventHandler(this, loadDataFailureEventArgs);
- ReferencePool.Release(loadDataFailureEventArgs);
- return;
- }
- throw;
- }
- break;
- default:
- throw new GameFrameworkException(Utility.Text.Format("Data asset '{0}' is '{1}'.", dataAssetName, result));
- }
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataString">要解析的内容字符串。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(string dataString)
- {
- return ParseData(dataString, null);
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataString">要解析的内容字符串。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(string dataString, object userData)
- {
- if (m_DataProviderHelper == null)
- {
- throw new GameFrameworkException("You must set data helper first.");
- }
- if (dataString == null)
- {
- throw new GameFrameworkException("Data string is invalid.");
- }
- try
- {
- return m_DataProviderHelper.ParseData(m_Owner, dataString, userData);
- }
- catch (Exception exception)
- {
- if (exception is GameFrameworkException)
- {
- throw;
- }
- throw new GameFrameworkException(Utility.Text.Format("Can not parse data string with exception '{0}'.", exception), exception);
- }
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataBytes">要解析的内容二进制流。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(byte[] dataBytes)
- {
- if (dataBytes == null)
- {
- throw new GameFrameworkException("Data bytes is invalid.");
- }
- return ParseData(dataBytes, 0, dataBytes.Length, null);
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataBytes">要解析的内容二进制流。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(byte[] dataBytes, object userData)
- {
- if (dataBytes == null)
- {
- throw new GameFrameworkException("Data bytes is invalid.");
- }
- return ParseData(dataBytes, 0, dataBytes.Length, userData);
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataBytes">要解析的内容二进制流。</param>
- /// <param name="startIndex">内容二进制流的起始位置。</param>
- /// <param name="length">内容二进制流的长度。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(byte[] dataBytes, int startIndex, int length)
- {
- return ParseData(dataBytes, startIndex, length, null);
- }
- /// <summary>
- /// 解析内容。
- /// </summary>
- /// <param name="dataBytes">要解析的内容二进制流。</param>
- /// <param name="startIndex">内容二进制流的起始位置。</param>
- /// <param name="length">内容二进制流的长度。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>是否解析内容成功。</returns>
- public bool ParseData(byte[] dataBytes, int startIndex, int length, object userData)
- {
- if (m_DataProviderHelper == null)
- {
- throw new GameFrameworkException("You must set data helper first.");
- }
- if (dataBytes == null)
- {
- throw new GameFrameworkException("Data bytes is invalid.");
- }
- if (startIndex < 0 || length < 0 || startIndex + length > dataBytes.Length)
- {
- throw new GameFrameworkException("Start index or length is invalid.");
- }
- try
- {
- return m_DataProviderHelper.ParseData(m_Owner, dataBytes, startIndex, length, userData);
- }
- catch (Exception exception)
- {
- if (exception is GameFrameworkException)
- {
- throw;
- }
- throw new GameFrameworkException(Utility.Text.Format("Can not parse data bytes with exception '{0}'.", exception), exception);
- }
- }
- /// <summary>
- /// 设置资源管理器。
- /// </summary>
- /// <param name="resourceManager">资源管理器。</param>
- internal void SetResourceManager(IResourceManager resourceManager)
- {
- if (resourceManager == null)
- {
- throw new GameFrameworkException("Resource manager is invalid.");
- }
- m_ResourceManager = resourceManager;
- }
- /// <summary>
- /// 设置数据提供者辅助器。
- /// </summary>
- /// <param name="dataProviderHelper">数据提供者辅助器。</param>
- internal void SetDataProviderHelper(IDataProviderHelper<T> dataProviderHelper)
- {
- if (dataProviderHelper == null)
- {
- throw new GameFrameworkException("Data provider helper is invalid.");
- }
- m_DataProviderHelper = dataProviderHelper;
- }
- private void LoadAssetSuccessCallback(string dataAssetName, object dataAsset, float duration, object userData)
- {
- try
- {
- if (!m_DataProviderHelper.ReadData(m_Owner, dataAssetName, dataAsset, userData))
- {
- throw new GameFrameworkException(Utility.Text.Format("Load data failure in data provider helper, data asset name '{0}'.", dataAssetName));
- }
- if (m_ReadDataSuccessEventHandler != null)
- {
- ReadDataSuccessEventArgs loadDataSuccessEventArgs = ReadDataSuccessEventArgs.Create(dataAssetName, duration, userData);
- m_ReadDataSuccessEventHandler(this, loadDataSuccessEventArgs);
- ReferencePool.Release(loadDataSuccessEventArgs);
- }
- }
- catch (Exception exception)
- {
- if (m_ReadDataFailureEventHandler != null)
- {
- ReadDataFailureEventArgs loadDataFailureEventArgs = ReadDataFailureEventArgs.Create(dataAssetName, exception.ToString(), userData);
- m_ReadDataFailureEventHandler(this, loadDataFailureEventArgs);
- ReferencePool.Release(loadDataFailureEventArgs);
- return;
- }
- throw;
- }
- finally
- {
- m_DataProviderHelper.ReleaseDataAsset(m_Owner, dataAsset);
- }
- }
- private void LoadAssetOrBinaryFailureCallback(string dataAssetName, LoadResourceStatus status, string errorMessage, object userData)
- {
- string appendErrorMessage = Utility.Text.Format("Load data failure, data asset name '{0}', status '{1}', error message '{2}'.", dataAssetName, status, errorMessage);
- if (m_ReadDataFailureEventHandler != null)
- {
- ReadDataFailureEventArgs loadDataFailureEventArgs = ReadDataFailureEventArgs.Create(dataAssetName, appendErrorMessage, userData);
- m_ReadDataFailureEventHandler(this, loadDataFailureEventArgs);
- ReferencePool.Release(loadDataFailureEventArgs);
- return;
- }
- throw new GameFrameworkException(appendErrorMessage);
- }
- private void LoadAssetUpdateCallback(string dataAssetName, float progress, object userData)
- {
- if (m_ReadDataUpdateEventHandler != null)
- {
- ReadDataUpdateEventArgs loadDataUpdateEventArgs = ReadDataUpdateEventArgs.Create(dataAssetName, progress, userData);
- m_ReadDataUpdateEventHandler(this, loadDataUpdateEventArgs);
- ReferencePool.Release(loadDataUpdateEventArgs);
- }
- }
- private void LoadAssetDependencyAssetCallback(string dataAssetName, string dependencyAssetName, int loadedCount, int totalCount, object userData)
- {
- if (m_ReadDataDependencyAssetEventHandler != null)
- {
- ReadDataDependencyAssetEventArgs loadDataDependencyAssetEventArgs = ReadDataDependencyAssetEventArgs.Create(dataAssetName, dependencyAssetName, loadedCount, totalCount, userData);
- m_ReadDataDependencyAssetEventHandler(this, loadDataDependencyAssetEventArgs);
- ReferencePool.Release(loadDataDependencyAssetEventArgs);
- }
- }
- private void LoadBinarySuccessCallback(string dataAssetName, byte[] dataBytes, float duration, object userData)
- {
- try
- {
- if (!m_DataProviderHelper.ReadData(m_Owner, dataAssetName, dataBytes, 0, dataBytes.Length, userData))
- {
- throw new GameFrameworkException(Utility.Text.Format("Load data failure in data provider helper, data asset name '{0}'.", dataAssetName));
- }
- if (m_ReadDataSuccessEventHandler != null)
- {
- ReadDataSuccessEventArgs loadDataSuccessEventArgs = ReadDataSuccessEventArgs.Create(dataAssetName, duration, userData);
- m_ReadDataSuccessEventHandler(this, loadDataSuccessEventArgs);
- ReferencePool.Release(loadDataSuccessEventArgs);
- }
- }
- catch (Exception exception)
- {
- if (m_ReadDataFailureEventHandler != null)
- {
- ReadDataFailureEventArgs loadDataFailureEventArgs = ReadDataFailureEventArgs.Create(dataAssetName, exception.ToString(), userData);
- m_ReadDataFailureEventHandler(this, loadDataFailureEventArgs);
- ReferencePool.Release(loadDataFailureEventArgs);
- return;
- }
- throw;
- }
- }
- }
- }
|