using System;
using System.Collections.Generic;
using Chernobyl.Event;

namespace Chernobyl.Collections.Generic.Event
{
    /// <summary>
    /// An <see cref="ICollection{T}"/> type that extends an 
    /// <see cref="ICollection{T}"/> using the decorator pattern 
    /// (http://en.wikipedia.org/wiki/Decorator_pattern) by giving it add and 
    /// removal events.
    /// </summary>
    /// <typeparam name="T">The type that is to be held within this 
    /// <see cref="ICollection{T}"/>.</typeparam>
    public class DecoratingEventCollection<T> : EventCollection<T>
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="DecoratingEventCollection{T}"/> 
        /// class.
        /// </summary>
        /// <param name="collectionDecorated">The <see cref="ICollection{T}"/> 
        /// being decorated or extended with event capabilities.</param>
        public DecoratingEventCollection(ICollection<T> collectionDecorated)
        {
            _collectionDecorated = collectionDecorated;
        }

        /// <summary>
        /// The <see cref="ICollection{T}"/> being decorated or extended with
        /// event capabilities.
        /// </summary>
        protected override ICollection<T> CollectionDecorated
        {
            get { return _collectionDecorated; }
        }

        /// <summary>
        /// The backing field to <see cref="CollectionDecorated"/>.
        /// </summary>
        readonly ICollection<T> _collectionDecorated;
    }
}