gov.nist.javax.sip

Class Utils

java.lang.Object

gov.nist.javax.sip.Utils

All Implemented Interfaces:

UtilsExt

public class Utils
extends Object
implements UtilsExt

A few utilities that are used in various places by the stack. This is used to convert byte arrays to hex strings etc. Generate tags and branch identifiers and odds and ends.

Version:

1.2 $Revision: 1.24 $ $Date: 2010-10-28 03:20:31 $

Author:

mranga

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Methods

Modifier and Type	Method and Description
String	generateBranchId() Generate a cryptographically random identifier that can be used to generate a branch identifier.
String	generateCallIdentifier(String address) Generate a call identifier.
String	generateTag() Generate a tag for a FROM header or TO header.
static Utils	getInstance()
static String	getQuotedString(String str) Put quotes around a string and return it.
static String	getSignature()
static void	main(String[] args)
protected static String	reduceString(String input) Squeeze out all white space from a string and return the reduced string.
boolean	responseBelongsToUs(SIPResponse response)
static String	toHexString(byte[] b) convert an array of bytes to an hexadecimal string
static String	toUpperCase(String str) Converts the characters in this String to upper case.

Methods inherited from class java.lang.Object

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

Constructor Detail

Utils

public Utils()

Method Detail

getInstance

public static Utils getInstance()

toHexString

public static String toHexString(byte[] b)

convert an array of bytes to an hexadecimal string

Parameters:

b - bytes array to convert to a hexadecimal string

Returns:

a string

getQuotedString

public static String getQuotedString(String str)

Put quotes around a string and return it. Any " characters appearing in str are escaped

Parameters:

str - string to be quoted

Returns:

a quoted string

reduceString

protected static String reduceString(String input)

Squeeze out all white space from a string and return the reduced string.

Parameters:

input - input string to sqeeze.

Returns:

String a reduced string.

toUpperCase

public static String toUpperCase(String str)

Converts the characters in this String to upper case.

Parameters:

str - the String to convert. Using english as default as header strings are in English. Resolves a bug in parsing and uppercase when default locale is set to Turkish.

Returns:

the String, converted to uppercase.

generateCallIdentifier

public String generateCallIdentifier(String address)

Generate a call identifier. This is useful when we want to generate a call identifier in advance of generating a message.

Specified by:

generateCallIdentifier in interface UtilsExt

generateTag

public String generateTag()

Generate a tag for a FROM header or TO header. Just return a random 4 digit integer (should be enough to avoid any clashes!) Tags only need to be unique within a call.

Specified by:

generateTag in interface UtilsExt

Returns:

a string that can be used as a tag parameter. synchronized: needed for access to 'rand', else risk to generate same tag twice

generateBranchId

public String generateBranchId()

Generate a cryptographically random identifier that can be used to generate a branch identifier.

Specified by:

generateBranchId in interface UtilsExt

Returns:

a cryptographically random gloablly unique string that can be used as a branch identifier.

responseBelongsToUs

public boolean responseBelongsToUs(SIPResponse response)

getSignature

public static String getSignature()

main

public static void main(String[] args)