|
using System;
using System.Collections.Generic;
using System.Text;
namespace LumiSoft.Net.SIP.Message
{
/// <summary>
/// Implements SIP "warning-value" value. Defined in RFC 3261.
/// </summary>
/// <remarks>
/// <code>
/// RFC 3261 Syntax:
/// warning-value = warn-code SP warn-agent SP warn-text
/// warn-code = 3DIGIT
/// warn-agent = hostport / pseudonym
/// ; the name or pseudonym of the server adding
/// ; the Warning header, for use in debugging
/// warn-text = quoted-string
/// pseudonym = token
/// </code>
/// </remarks>
public class SIP_t_WarningValue : SIP_t_Value
{
private int m_Code = 0;
private string m_Agent = "";
private string m_Text = "";
/// <summary>
/// Default constructor.
/// </summary>
public SIP_t_WarningValue()
{
}
#region method Parse
/// <summary>
/// Parses "warning-value" from specified value.
/// </summary>
/// <param name="value">SIP "warning-value" value.</param>
/// <exception cref="ArgumentNullException">Raised when <b>reader</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("reader");
}
Parse(new StringReader(value));
}
/// <summary>
/// Parses "warning-value" 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)
{
/*
warning-value = warn-code SP warn-agent SP warn-text
warn-code = 3DIGIT
warn-agent = hostport / pseudonym
; the name or pseudonym of the server adding
; the Warning header, for use in debugging
warn-text = quoted-string
pseudonym = token
*/
if(reader == null){
throw new ArgumentNullException("reader");
}
string word = reader.ReadWord();
if(word == null){
throw new SIP_ParseException("Invalid 'warning-value' value, warn-code is missing !");
}
try{
this.Code = Convert.ToInt32(word);
}
catch{
throw new SIP_ParseException("Invalid 'warning-value' warn-code value, warn-code is missing !");
}
word = reader.ReadWord();
if(word == null){
throw new SIP_ParseException("Invalid 'warning-value' value, warn-agent is missing !");
}
this.Agent = word;
word = reader.ReadToEnd();
if(word == null){
throw new SIP_ParseException("Invalid 'warning-value' value, warn-text is missing !");
}
this.Agent = TextUtils.UnQuoteString(word);
}
#endregion
#region method ToStringValue
/// <summary>
/// Converts this to valid "warning-value" value.
/// </summary>
/// <returns>Returns "warning-value" value.</returns>
public override string ToStringValue()
{
return m_Code + " " + m_Agent + " " + TextUtils.QuoteString(m_Text);
}
#endregion
#region Properties Implementation
/// <summary>
/// Gets or sets warning code.
/// </summary>
public int Code
{
get{ return m_Code; }
set{
if(value < 100 || value > 999){
throw new ArgumentException("Property Code value must be 3 digit !");
}
m_Code = value;
}
}
/// <summary>
/// Gets or sets name or pseudonym of the server.
/// </summary>
public string Agent
{
get{ return m_Agent; }
set{
if(string.IsNullOrEmpty(value)){
throw new ArgumentException("Property Agent value may not be null or empty !");
}
m_Agent = value;
}
}
/// <summary>
/// Gets or sets warning text.
/// </summary>
public string Text
{
get{ return m_Text; }
set{
if(string.IsNullOrEmpty(value)){
throw new ArgumentException("Property Text value may not be null or empty !");
}
m_Text = 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 member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.