|
using System;
using System.Collections.Generic;
using System.Text;
namespace LumiSoft.Net.SIP.Message
{
/// <summary>
/// Implements SIP "Referred-By" value. Defined in RFC 3892.
/// </summary>
/// <remarks>
/// <code>
/// RFC 3892 Syntax:
/// Referred-By = referrer-uri *( SEMI (referredby-id-param / generic-param) )
/// referrer-uri = ( name-addr / addr-spec )
/// referredby-id-param = "cid" EQUAL sip-clean-msg-id
/// sip-clean-msg-id = LDQUOT dot-atom "@" (dot-atom / host) RDQUOT
/// </code>
/// </remarks>
public class SIP_t_ReferredBy : SIP_t_ValueWithParams
{
private SIP_t_NameAddress m_pAddress = null;
/// <summary>
/// Default constructor.
/// </summary>
/// <param name="value">SIP 'Referred-By' value.</param>
public SIP_t_ReferredBy(string value)
{
m_pAddress = new SIP_t_NameAddress();
Parse(value);
}
#region method Parse
/// <summary>
/// Parses "Referred-By" from specified value.
/// </summary>
/// <param name="value">SIP "Referred-By" value.</param>
/// <exception cref="ArgumentNullException">Raised when <b>value</b> is null.</exception>
/// <exception cref="SIP_ParseException">Raised when invalid SIP message.</exception>
public void Parse(string value)
{
if(value == null){
throw new ArgumentNullException("value");
}
Parse(new StringReader(value));
}
/// <summary>
/// Parses "Referred-By" from specified reader.
/// </summary>
/// <param name="reader">Reader from where to parse.</param>
/// <exception cref="ArgumentNullException">Raised when <b>reader</b> is null.</exception>
/// <exception cref="SIP_ParseException">Raised when invalid SIP message.</exception>
public override void Parse(StringReader reader)
{
/*
Referred-By = referrer-uri *( SEMI (referredby-id-param / generic-param) )
referrer-uri = ( name-addr / addr-spec )
referredby-id-param = "cid" EQUAL sip-clean-msg-id
sip-clean-msg-id = LDQUOT dot-atom "@" (dot-atom / host) RDQUOT
*/
if(reader == null){
throw new ArgumentNullException("reader");
}
// referrer-uri
m_pAddress.Parse(reader);
// Parse parameters
ParseParameters(reader);
}
#endregion
#region method ToStringValue
/// <summary>
/// Converts this to valid "Referred-By" value.
/// </summary>
/// <returns>Returns "Referred-By" value.</returns>
public override string ToStringValue()
{
/*
Referred-By = referrer-uri *( SEMI (referredby-id-param / generic-param) )
referrer-uri = ( name-addr / addr-spec )
referredby-id-param = "cid" EQUAL sip-clean-msg-id
sip-clean-msg-id = LDQUOT dot-atom "@" (dot-atom / host) RDQUOT
*/
StringBuilder retVal = new StringBuilder();
// referrer-uri
retVal.Append(m_pAddress.ToStringValue());
// Add parameters
retVal.Append(ParametersToString());
return retVal.ToString();
}
#endregion
#region Properties Implementation
/// <summary>
/// Gets or sets address.
/// </summary>
/// <exception cref="ArgumentNullException">Is raised when null value is passed.</exception>
public SIP_t_NameAddress Address
{
get{ return m_pAddress; }
set{
if(value == null){
throw new ArgumentNullException("Address");
}
m_pAddress = value;
}
}
/// <summary>
/// Gets or sets 'cid' parameter value. Value null means not specified.
/// </summary>
public string CID
{
get{
SIP_Parameter parameter = this.Parameters["cid"];
if(parameter != null){
return parameter.Value;
}
else{
return null;
}
}
set{
if(string.IsNullOrEmpty(value)){
this.Parameters.Remove("cid");
}
else{
this.Parameters.Set("cid",value);
}
}
}
#endregion
}
}
|
By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.
If a file you wish to view isn't highlighted, and is a text file (not binary), please
let us know and we'll add colourisation support for it.
This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.
A list of licenses authors might use can be found here
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.