SIP Stack with SIP Proxy - (VOIP)

using System;
using System.Collections.Generic;
using System.Text;

namespace LumiSoft.Net.SIP.Message
{
    /// <summary>
    /// Implements same multi value header fields group. Group can contain one type header fields only.
    /// This is class is used by Via:,Route:, ... .
    /// </summary>
    public class SIP_MVGroupHFCollection<T> where T : SIP_t_Value,new()
    {
        private SIP_Message               m_pMessage  = null;
        private string                    m_FieldName = "";
        private List<SIP_MultiValueHF<T>> m_pFields   = null;

        /// <summary>
        /// Default constructor.
        /// </summary>
        /// <param name="owner">Owner message that owns this group.</param>
        /// <param name="fieldName">Header field name what group holds.</param>
        public SIP_MVGroupHFCollection(SIP_Message owner,string fieldName)
        {
            m_pMessage  = owner;
            m_FieldName = fieldName;

            m_pFields = new List<SIP_MultiValueHF<T>>();

            Refresh();
        }


        #region mehtod Refresh

        /// <summary>
        /// Refreshes header fields in group from actual header.
        /// </summary>
        private void Refresh()
        {
            m_pFields.Clear();
           
            foreach(SIP_HeaderField h in m_pMessage.Header){
                if(h.Name.ToLower() == m_FieldName.ToLower()){                
                    m_pFields.Add((SIP_MultiValueHF<T>)h);
                }
            }
        }

        #endregion


        #region method AddToTop

        /// <summary>
        /// Add new header field on the top of the whole header.
        /// </summary>
        /// <param name="value">Header field value.</param>
        public void AddToTop(string value)
        {            
            m_pMessage.Header.Insert(0,m_FieldName,value);
            Refresh();
        }

        #endregion

        #region method Add

        /// <summary>
        /// Add new header field on the bottom of the whole header.
        /// </summary>
        /// <param name="value">Header field value.</param>
        public void Add(string value)
        {            
            m_pMessage.Header.Add(m_FieldName,value);
            Refresh();
        }

        #endregion

        #region method RemoveAll

        /// <summary>
        /// Removes all specified header fields with their values.
        /// </summary>
        public void RemoveAll()
        {
            m_pMessage.Header.RemoveAll(m_FieldName);
            m_pFields.Clear();
        }

        #endregion

        #region mehtod GetTopMostValue

        /// <summary>
        /// Gets top most header field first value. 
        /// </summary>
        public T GetTopMostValue()
        {
            if(m_pFields.Count > 0){
                return m_pFields[0].Values[0];
            }

            return null;
        }

        #endregion
                
        #region method RemoveTopMostValue

        /// <summary>
        /// Removes top most header field first value. If value is the last value, 
        /// the whole header field will be removed.
        /// </summary>
        public void RemoveTopMostValue()
        {
            if(m_pFields.Count > 0){                
                SIP_MultiValueHF<T> h = m_pFields[0];
                if(h.Count > 1){
                    h.Remove(0);
                }
                else{
                    m_pMessage.Header.Remove(m_pFields[0]);
                    m_pFields.Remove(m_pFields[0]);
                }
            }
        }

        #endregion

        #region method GetAllValues

        /// <summary>
        /// Gets all header field values.
        /// </summary>
        /// <returns></returns>
        public T[] GetAllValues()
        {
            List<T> retVal = new List<T>();
            foreach(SIP_MultiValueHF<T> h in m_pFields){
                foreach(SIP_t_Value v in h.Values){
                    retVal.Add((T)v);
                }
            }

            return retVal.ToArray();
        }

        #endregion


        #region Properties Implementation

        /// <summary>
        /// Gets header field name what this group holds.
        /// </summary>
        public string FieldName
        {
            get{ return m_FieldName; }
        }

        /// <summary>
        /// Gets number of header fields in this group.
        /// </summary>
        public int Count
        {
            get{ return m_pFields.Count; }
        }

        /// <summary>
        /// Gets header fields what are in this group.
        /// </summary>
        public SIP_MultiValueHF<T>[] HeaderFields
        {
            get{ return m_pFields.ToArray(); }
        }

        #endregion

    }
}