using System;
using System.Linq;/// <summary>
/// 当值发生变化时触发回调(例如当玩家血量变化时更新GUI)。
/// </summary>
public class ReactiveValue<T>
{/// <summary>/// 定义过滤器委托,允许在设置新值时对值进行过滤或修正。/// </summary>private delegate T Filter(T originalValue, T newValue);/// <summary>/// 值变化时的回调委托。/// </summary>private Action<T> m_Set;/// <summary>/// 用于处理值变化前的过滤器。/// </summary>private Filter m_Filter;/// <summary>/// 当前的值。/// </summary>private T m_CurrentValue;/// <summary>/// 上一次的值,仅供内部使用。/// </summary>private T m_LastValue;/// <summary>/// 初始化值。/// </summary>/// <param name="initialValue">初始值。</param>public ReactiveValue(T initialValue){m_CurrentValue = initialValue;m_LastValue = m_CurrentValue;}/// <summary>/// 使用T的默认值初始化值/// </summary>public ReactiveValue() : this(default(T)) { }/// <summary>/// 判断当前值是否等于指定值。/// </summary>/// <param name="value">要比较的值。</param>/// <returns>如果当前值等于指定值,返回 true;否则返回 false。</returns>public bool IsEquals(T value){return m_CurrentValue != null && m_CurrentValue.Equals(value);}/// <summary>/// 添加值变化的监听器,如果监听器尚未存在。/// </summary>/// <param name="callback">回调函数。</param>public void AddChangeListener(Action<T> callback){if (m_Set == null || !m_Set.GetInvocationList().Contains(callback)){m_Set += callback;}}/// <summary>/// 移除指定的监听器。/// </summary>/// <param name="callback">要移除的回调函数。</param>public void RemoveChangeListener(Action<T> callback){if (m_Set != null && m_Set.GetInvocationList().Contains(callback)){m_Set -= callback;}}/// <summary>/// 设置过滤器,过滤器将在回调前被调用,适合用于值限制(如玩家血量不能超过最大值等)。/// </summary>/// <param name="filter">过滤器委托:<原值,新值,返回值>。</param>public void SetFilter(Func<T, T, T> filter){m_Filter = new Filter(filter);}/// <summary>/// 获取当前值。/// </summary>/// <returns>返回当前值。</returns>public T Get(){return m_CurrentValue;}/// <summary>/// 设置新值,只有当新值与旧值不相同时才会触发回调。/// </summary>/// <param name="value">要设置的新值。</param>public void Set(T value){m_LastValue = m_CurrentValue;m_CurrentValue = value;if (m_Filter != null)m_CurrentValue = m_Filter(m_LastValue, m_CurrentValue);// 当新值和旧值不相等时触发回调if (m_LastValue == null || !m_LastValue.Equals(m_CurrentValue))m_Set?.Invoke(m_CurrentValue);}/// <summary>/// 强制更新值并触发回调,即使新值与旧值相同。/// </summary>/// <param name="value">要设置的新值。</param>public void SetValueForceCallBack(T value){m_LastValue = m_CurrentValue;m_CurrentValue = value;if (m_Filter != null)m_CurrentValue = m_Filter(m_LastValue, m_CurrentValue);// 强制触发回调m_Set?.Invoke(m_CurrentValue);}/// <summary>/// 设置新值但不触发回调。/// </summary>/// <param name="value">要设置的新值。</param>public void SetValueDontCallBack(T value){m_LastValue = m_CurrentValue;m_CurrentValue = value;if (m_Filter != null)m_CurrentValue = m_Filter(m_LastValue, m_CurrentValue);}
}