Harvesting Web Content into MHTML Archive

using System;
using System.Collections;
using System.Collections.Specialized;
using Rilling.MhtmlLib.Media.Handlers;
using Rilling.Web.Mhtml.Exceptions;

namespace Rilling.MhtmlLib.Collections
{
	/// <summary>
	///		A collection containing all registered <see cref="ContentHandlerBase"/>
	///		objects.
	/// </summary>
	public class MimeHandlerCollection : NameObjectCollectionBase
	{
		/// <summary>
        ///		Adds a new <see cref="ContentHandlerBase"/> object.
		/// </summary>
		/// <param name="handler">
        ///		The <see cref="ContentHandlerBase"/> to add to the collection.
		/// </param>
		/// <param name="mimePattern">
		///		The pattern that the specified handler will accept.
		/// </param>
		/// <exception cref="DuplicateHandlerRegistrationException">
		///		Exception thrown when a handler with the same mime pattern
		///		is already registered.  A mime pattern can only be handled
        ///		by a single <see cref="ContentHandlerBase"/> object.
		/// </exception>
		public void Add(IContentFactory handler, string mimePattern)
		{
            if (handler == null)
                throw (new ArgumentNullException("handler"));
            if (mimePattern == null)
                throw (new ArgumentNullException("mimePattern"));

			MimeHandlerInfo handlerInfo = new MimeHandlerInfo(handler, mimePattern);

			Add(handlerInfo);
		}

		/// <summary>
        ///		Adds a new <see cref="ContentHandlerBase"/> object.
		/// </summary>
		/// <param name="handlerInfo">
        ///		Structure containing the <see cref="ContentHandlerBase"/> to add to 
		///		the collection.
		/// </param>
		/// <exception cref="DuplicateHandlerRegistrationException">
		///		Exception thrown when a handler with the same mime pattern
		///		is already registered.  A mime pattern can only be handled
        ///		by a single <see cref="ContentHandlerBase"/> object.
		/// </exception>
		public void Add(MimeHandlerInfo handlerInfo)
		{
			string mimePattern = handlerInfo.Pattern;
			int patternIdx = Array.IndexOf(base.BaseGetAllKeys(), handlerInfo.Pattern);

			if(patternIdx != -1)
				throw(new DuplicateHandlerRegistrationException(handlerInfo.Pattern));

			// Add the handler to the collection.
			BaseAdd(handlerInfo.Pattern, handlerInfo);
		}

		/// <summary>
		///		Gets or sets an object in the collection based on the mime pattern.
		/// </summary>
		public MimeHandlerInfo this[string mimePattern]
		{
			get{
				object mh = BaseGet(mimePattern);

				if(mh == null)
					throw(new ArgumentOutOfRangeException("mimePattern", mimePattern));

				return (MimeHandlerInfo)mh;
			}
			set{BaseSet(mimePattern, value);}
		}

		/// <summary>
		///		Gets or sets an object in the collection based on its position.
		/// </summary>
		public MimeHandlerInfo this[int index]
		{
			get{return (MimeHandlerInfo)BaseGet(index);}
			set{BaseSet(index, value);}
		}

		/// <summary>
		///		Removes the specified <see cref="MimeHandlerInfo"/> object.
		/// </summary>
		/// <param name="mimePattern">
		///		The pattern to remove.
		/// </param>
		public void Remove(string mimePattern)
		{
            if (mimePattern == null)
                throw (new ArgumentNullException("mimePattern"));

			BaseRemove(mimePattern);
		}

		/// <summary>
		///		Removes the specified <see cref="MimeHandlerInfo"/> object.
		/// </summary>
		/// <param name="index">
		///		The index in the collection.
		/// </param>
		public void RemoveAt(int index)
		{
			BaseRemoveAt(index);
		}

		/// <summary>
		///		Removes all objects from the collection.
		/// </summary>
		public void Clear()
		{
			 BaseClear();
		}
	}
}