gov.nist.javax.sip.parser.chars

Class CharsMsgParser

java.lang.Object

gov.nist.javax.sip.parser.chars.CharsMsgParser

All Implemented Interfaces:

gov.nist.javax.sip.parser.MessageParser

Direct Known Subclasses:

SelectiveCharParser

public class CharsMsgParser
extends Object
implements gov.nist.javax.sip.parser.MessageParser

Parse SIP message and parts of SIP messages such as URI's etc from memory and return a structure. Intended use: UDP message processing. This class is used when you have an entire SIP message or SIPHeader or SIP URL in memory and you want to generate a parsed structure from it. For SIP messages, the payload can be binary or String. If you have a binary payload, use parseSIPMessage(byte[]) else use parseSIPMessage(String) The payload is accessible from the parsed message using the getContent and getContentBytes methods provided by the SIPMessage class. If SDP parsing is enabled using the parseContent method, then the SDP body is also parsed and can be accessed from the message using the getSDPAnnounce method. Currently only eager parsing of the message is supported (i.e. the entire message is parsed in one feld swoop).

Version:

1.2 $Revision: 1.27 $ $Date: 2010/03/15 17:01:21 $

Author:

M. Ranganathan

Field Summary

Fields

Modifier and Type	Field and Description
protected static Charset	charset
protected static boolean	computeContentLengthFromMessage
protected static char[]	SIP_VERSION_CHAR

Constructor Summary

Constructors

Constructor and Description
CharsMsgParser()

Method Summary

Methods

Modifier and Type	Method and Description
static void	main(String[] args) Test code.
gov.nist.javax.sip.address.AddressImpl	parseAddress(char[] address) Parse an address (nameaddr or address spec) and return and address structure.
gov.nist.core.Host	parseHost(char[] host) Parse a host name and return a parsed structure.
gov.nist.javax.sip.message.SIPMessage	parseSIPMessage(byte[] msgBuffer, boolean readBody, boolean strict, gov.nist.javax.sip.parser.ParseExceptionListener exhandler) Parse a buffer containing a single SIP Message where the body is an array of un-interpreted bytes.
gov.nist.javax.sip.header.RequestLine	parseSIPRequestLine(char[] requestLine) Parse the SIP Request Line
gov.nist.javax.sip.header.StatusLine	parseSIPStatusLine(char[] statusLine) Parse the SIP Response message status line
gov.nist.javax.sip.address.SipUri	parseSIPUrl(char[] url) Parse a SIP url from a string and return a URI structure for it.
gov.nist.javax.sip.address.TelephoneNumber	parseTelephoneNumber(char[] telephone_number) Parse a telephone number return a parsed structure.
gov.nist.javax.sip.address.GenericURI	parseUrl(char[] url) Parse a uri from a string and return a URI structure for it.
protected gov.nist.javax.sip.message.SIPMessage	processFirstLine(char[] firstLine, gov.nist.javax.sip.parser.ParseExceptionListener parseExceptionListener, byte[] msgBuffer)
protected void	processHeader(char[] header, gov.nist.javax.sip.message.SIPMessage message, gov.nist.javax.sip.parser.ParseExceptionListener parseExceptionListener, byte[] msgBuffer)
static void	setComputeContentLengthFromMessage(boolean computeContentLengthFromMessage)
protected static char[]	trimEndOfLine(char[] line)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

computeContentLengthFromMessage

protected static boolean computeContentLengthFromMessage

charset

protected static final Charset charset

SIP_VERSION_CHAR

protected static final char[] SIP_VERSION_CHAR

Constructor Detail

CharsMsgParser

public CharsMsgParser()

Since:

v0.9

Method Detail

parseSIPMessage

public gov.nist.javax.sip.message.SIPMessage parseSIPMessage(byte[] msgBuffer,
                                                    boolean readBody,
                                                    boolean strict,
                                                    gov.nist.javax.sip.parser.ParseExceptionListener exhandler)
                                                      throws ParseException

Parse a buffer containing a single SIP Message where the body is an array of un-interpreted bytes. This is intended for parsing the message from a memory buffer when the buffer. Incorporates a bug fix for a bug that was noted by Will Sullin of Callcast

Specified by:

parseSIPMessage in interface gov.nist.javax.sip.parser.MessageParser

Parameters:

msgBuffer - a byte buffer containing the messages to be parsed. This can consist of multiple SIP Messages concatenated together.

Returns:

a SIPMessage[] structure (request or response) containing the parsed SIP message.

Throws:

ParseException - is thrown when an illegal message has been encountered (and the rest of the buffer is discarded).

See Also:

ParseExceptionListener

trimEndOfLine

protected static char[] trimEndOfLine(char[] line)

processFirstLine

protected gov.nist.javax.sip.message.SIPMessage processFirstLine(char[] firstLine,
                                                     gov.nist.javax.sip.parser.ParseExceptionListener parseExceptionListener,
                                                     byte[] msgBuffer)
                                                          throws ParseException

Throws:

ParseException

processHeader

protected void processHeader(char[] header,
                 gov.nist.javax.sip.message.SIPMessage message,
                 gov.nist.javax.sip.parser.ParseExceptionListener parseExceptionListener,
                 byte[] msgBuffer)
                      throws ParseException

Throws:

ParseException

parseAddress

public gov.nist.javax.sip.address.AddressImpl parseAddress(char[] address)
                                                    throws ParseException

Parse an address (nameaddr or address spec) and return and address structure.

Parameters:

address - is a String containing the address to be parsed.

Returns:

a parsed address structure.

Throws:

ParseException - when the address is badly formatted.

Since:

v1.0

parseHost

public gov.nist.core.Host parseHost(char[] host)
                             throws ParseException

Parse a host name and return a parsed structure.

Parameters:

host - is a String containing the host name to be parsed

Returns:

a parsed address structure.

Throws:

ParseException - a ParseException when the hostname is badly formatted.

Since:

v1.0

parseTelephoneNumber

public gov.nist.javax.sip.address.TelephoneNumber parseTelephoneNumber(char[] telephone_number)
                                                                throws ParseException

Parse a telephone number return a parsed structure.

Parameters:

telephone_number - is a String containing the telephone # to be parsed

Returns:

a parsed address structure.

Throws:

ParseException - a ParseException when the address is badly formatted.

Since:

v1.0

parseSIPUrl

public gov.nist.javax.sip.address.SipUri parseSIPUrl(char[] url)
                                              throws ParseException

Parse a SIP url from a string and return a URI structure for it.

Parameters:

url - a String containing the URI structure to be parsed.

Returns:

A parsed URI structure

Throws:

ParseException - if there was an error parsing the message.

parseUrl

public gov.nist.javax.sip.address.GenericURI parseUrl(char[] url)
                                               throws ParseException

Parse a uri from a string and return a URI structure for it.

Parameters:

url - a String containing the URI structure to be parsed.

Returns:

A parsed URI structure

Throws:

ParseException - if there was an error parsing the message.

parseSIPRequestLine

public gov.nist.javax.sip.header.RequestLine parseSIPRequestLine(char[] requestLine)
                                                          throws ParseException

Parse the SIP Request Line

Parameters:

requestLine - a String containing the request line to be parsed.

Returns:

a RequestLine structure that has the parsed RequestLine

Throws:

ParseException - if there was an error parsing the requestLine.

parseSIPStatusLine

public gov.nist.javax.sip.header.StatusLine parseSIPStatusLine(char[] statusLine)
                                                        throws ParseException

Parse the SIP Response message status line

Parameters:

statusLine - a String containing the Status line to be parsed.

Returns:

StatusLine class corresponding to message

Throws:

ParseException - if there was an error parsing

See Also:

StatusLine

setComputeContentLengthFromMessage

public static void setComputeContentLengthFromMessage(boolean computeContentLengthFromMessage)

main

public static void main(String[] args)
                 throws ParseException

Test code.

Throws:

ParseException