// TODO: adapter à Silverlight (utiliser System.Threading.Timer ?) et à WinRT

#if !SILVERLIGHT && !NETFX_CORE

using System;
using System.Text;
using System.Timers;
using Developpez.Dotnet.Properties;

namespace Developpez.Dotnet
{
    /// <summary>
    /// Représente une chaîne de caractères à durée de vie limitée.
    /// Lorsque la durée de vie expire, la chaîne de caractères est vidée.
    /// La durée de vie est réinitialisée à chaque ajout de caractère.
    /// </summary>
    public class TemporaryString
    {

#region Fields

        /// <summary>
        /// Durée de vie par défaut.
        /// </summary>
        private static readonly double _DEFAULTLIFETIME = 1000;

        /// <summary>
        /// Instance du Timer.
        /// </summary>
        private readonly Timer _timer;

        /// <summary>
        /// Chaîne de caractères.
        /// </summary>
        private readonly StringBuilder _value;

        /// <summary>
        /// Evènement levé lorsque la durée de vie a expiré.
        /// </summary>
        /// <remarks>La chaîne de caractère est vidée.</remarks>
        public event EventHandler Reset;

        /// <summary>
        /// Evènement levé lorsqu'un caractère a été ajouté à l'instance.
        /// </summary>
        /// <remarks>La durée de vie est réinitialisée.</remarks>
        public event EventHandler CharAdded;

        #endregion



#region Constructors

        /// <summary>
        /// Intialise une nouvelle instance de la classe <see cref="TemporaryString" /> avec la durée de vie par défaut.
        /// </summary>
        public TemporaryString()
            : this(_DEFAULTLIFETIME, string.Empty)
        { }


        /// <summary>
        /// Intialise une nouvelle instance de la classe <see cref="TemporaryString" /> avec la durée de vie donnée.
        /// </summary>
        /// <param name="lifeTime">Durée de vie (en millisecondes).</param>
        public TemporaryString(double lifeTime)
            : this(lifeTime, string.Empty)
        { }


        /// <summary>
        /// Intialise une nouvelle instance de la classe <see cref="TemporaryString" /> avec la valeur initiale donnée.
        /// </summary>
        /// <param name="value">Valeur initiale.</param>
        public TemporaryString(string value)
            : this(_DEFAULTLIFETIME, value)
        { }


        /// <summary>
        /// Intialise une nouvelle instance de la classe <see cref="TemporaryString" /> 
        /// avec la durée de vie et la valeur initiale données.
        /// </summary>
        /// <param name="lifeTime">Durée de vie.</param>
        /// <param name="value">Valeur initiale.</param>
        public TemporaryString(double lifeTime, string value)
        {
            if (lifeTime <= 0)
                throw new ArgumentOutOfRangeException("lifeTime", ExceptionMessages.NegativeLifeTime);
            if (value == null)
                throw new ArgumentNullException("value");

            this._timer = new Timer(lifeTime);
            this._value = new StringBuilder(value);
            this._timer.Elapsed += this._Timer_Elapsed;
            this._timer.Enabled = true;
            this._timer.AutoReset = false;
        }

        #endregion


        /// <summary>
        /// Elapsed timer event.
        /// </summary>
        /// <param name="sender">Source object.</param>
        /// <param name="e">Elapsed event arguments.</param>
        private void _Timer_Elapsed(object sender, ElapsedEventArgs e)
        {
            this._value.Length = 0;
            // Stop the timer :
            this._timer.Stop();

            EventHandler handler = Reset;
            // NOTE : Make a temporary copy of the event to avoid possibility of a race condition 
            // if the last subscriber unsubscribes immediately after the null check and before the event is raised.
            if (handler != null)
                handler(this, new EventArgs());
        }



#region Public methods

        /// <summary>
        /// Ajoute un caractère à la fin de la chaîne.
        /// </summary>
        /// <param name="value">Le caractère Unicode à ajouter.</param>
        public void Append(char value)
        {
            this._value.Append(value);
            // Reset the timer :
            this._timer.Stop();
            this._timer.Start();

            EventHandler handler = CharAdded;
            // NOTE : Make a temporary copy of the event to avoid possibility of a race condition 
            // if the last subscriber unsubscribes immediately after the null check and before the event is raised.
            if (handler != null)
                handler(this, new EventArgs());
        }


        /// <summary>
        /// Ajoute un tableau de caractères à la fin de cette instance.
        /// </summary>
        /// <param name="value">Le tableau de caractères Unicode à ajouter.</param>
        public void Append(char[] value)
        {
            foreach (var c in value)
                this.Append(c);
        }


        /// <summary>
        /// Ajoute une chaîne de caractères à la chaîne courante.
        /// </summary>
        /// <param name="value">Chaîne de caractères à ajouter à la chaîne courante.</param>
        public void Append(string value)
        {
            foreach (char c in value)
                this.Append(c);
        }


        /// <summary>
        /// Retourne une chaîne de caractères représentant l'instance courante.
        /// </summary>
        /// <returns>Une chaîne de caractères représentant l'instance courante.</returns>
        public override string ToString()
        {
            return this._value.ToString();
        }

        #endregion

    }
}
#endif