using System;
#if !SILVERLIGHT && !NETFX_CORE
using System.Runtime.Serialization;
#endif

namespace Developpez.Dotnet
{
    /// <summary>
    /// Représente une référence faible fortement typée
    /// </summary>
    /// <typeparam name="T">Type de l'objet référencé</typeparam>
#if !SILVERLIGHT && !NETFX_CORE
    [Serializable]
#endif
    public class WeakReference<T> : WeakReference
        where T : class
    {
        /// <summary>
        /// Initialise une nouvelle instance de <see cref="WeakReference{T}"/> qui
        /// référence l'objet cible spécifié
        /// </summary>
        /// <param name="target">Objet cible</param>
        public WeakReference(T target)
            : base(target)
        {
        }

        /// <summary>
        /// Initialise une nouvelle instance de <see cref="WeakReference{T}"/> qui
        /// référence l'objet cible spécifié, en indiquant si l'objet doit
        /// continuer à être suivi après sa finalisation
        /// </summary>
        /// <param name="target">Objet cible</param>
        /// <param name="trackResurrection">true si l'objet doit être suivi
        /// après sa finalisation (référence faible "longue"), false sinon
        /// (référence faible "courte")</param>
        public WeakReference(T target, bool trackResurrection)
            : base(target, trackResurrection)
        {
        }

#if !SILVERLIGHT && !NETFX_CORE
        /// <summary>
        /// Initialise une nouvelle instance de <see cref="WeakReference{T}"/> en utilisant
        /// les données désérialisées
        /// </summary>
        /// <param name="info">Objet contenant toutes les données nécessaires pour sérialiser ou désérialiser l'objet WeakReference actuel.</param>
        /// <param name="context">Décrit la source et la destination du flux sérialisé spécifié par info.</param>
        public WeakReference(SerializationInfo info, StreamingContext context)
            : base(info, context)
        {
        }
#endif

        /// <summary>
        /// Renvoie l'objet cible de la référence faible
        /// </summary>
        public new T Target
        {
            get
            {
                return (T)base.Target;
            }
        }

        /// <summary>
        /// Tente d'obtenir l'objet cible de la référence faible
        /// </summary>
        /// <param name="target">Quand cette méthode retourne, contient une référence à l'objet cible s'il est disponible.</param>
        /// <returns>true si l'objet cible a été obtenu; sinon, false.</returns>
        public bool TryGetTarget(out T target)
        {
            target = Target;
            return IsAlive;
        }
    }
}