gov.nist.javax.sip.address

Class AddressFactoryImpl

java.lang.Object

gov.nist.javax.sip.address.AddressFactoryImpl

All Implemented Interfaces:

AddressFactoryEx, AddressFactory

public class AddressFactoryImpl
extends Object
implements AddressFactoryEx

Implementation of the JAIN-SIP address factory.

Version:

1.2 $Revision: 1.11 $ $Date: 2010-07-27 10:55:29 $

Author:

M. Ranganathan
IPv6 Support added by Emil Ivov (emil_ivov@yahoo.com)
Network Research Team (http://www-r2.u-strasbg.fr))
Louis Pasteur University - Strasbourg - France

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	SCHEME_PATTERN

Constructor Summary

Constructors

Constructor and Description
AddressFactoryImpl() Creates a new instance of AddressFactoryImpl

Method Summary

Methods

Modifier and Type	Method and Description
Address	createAddress() Create an empty address object.
Address	createAddress(String address) Creates an Address with the new address string value.
Address	createAddress(String displayName, URI uri) Creates an Address with the new display name and URI attribute values.
Address	createAddress(URI uri) Creates an Address with the new URI attribute value.
SipURI	createSipURI(String uri) create a sip uri.
SipURI	createSipURI(String user, String host) Create a SipURI
TelURL	createTelURL(String uri) Creates a TelURL based on given URI string.
URI	createURI(String uri) Creates a URI based on given URI string.

Methods inherited from class java.lang.Object

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

Field Detail

SCHEME_PATTERN

public static final Pattern SCHEME_PATTERN

Constructor Detail

AddressFactoryImpl

public AddressFactoryImpl()

Creates a new instance of AddressFactoryImpl

Method Detail

createAddress

public Address createAddress()

Create an empty address object. SPEC_REVISION

createAddress

public Address createAddress(String displayName,
                    URI uri)

Creates an Address with the new display name and URI attribute values.

Specified by:

createAddress in interface AddressFactory

Parameters:

displayName - - the new string value of the display name of the address. A null value does not set the display name.

uri - - the new URI value of the address.

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the displayName value.

createAddress

public Address createAddress(URI uri)

Description copied from interface: AddressFactory

Creates an Address with the new URI attribute value.

Specified by:

createAddress in interface AddressFactory

Parameters:

uri - - the URI value of the address.

createAddress

public Address createAddress(String address)
                      throws ParseException

Creates an Address with the new address string value. The address string is parsed in order to create the new Address instance. Create with a String value of "*" creates a wildcard address. The wildcard can be determined if ((SipURI)Address.getURI).getUser() == *;.

Specified by:

createAddress in interface AddressFactory

Parameters:

address - - the new string value of the address.

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the address value.

createSipURI

public SipURI createSipURI(String uri)
                    throws ParseException

create a sip uri.

Specified by:

createSipURI in interface AddressFactoryEx

Parameters:

uri - -- the uri to parse.

Throws:

ParseException - if the URI string is malformed.

createSipURI

public SipURI createSipURI(String user,
                  String host)
                    throws ParseException

Create a SipURI

Specified by:

createSipURI in interface AddressFactory

Parameters:

user - -- the user

host - -- the host.

Throws:

ParseException - if the URI string is malformed.

createTelURL

public TelURL createTelURL(String uri)
                    throws ParseException

Creates a TelURL based on given URI string. The '+' should not be included in the phoneNumber string argument. If scheme is not present, it will be added.

Specified by:

createTelURL in interface AddressFactory

Parameters:

uri - - the new string value of the phoneNumber.

Throws:

URISyntaxException - if the URI string is malformed.

ParseException - if the URI string is malformed.

createURI

public URI createURI(String uri)
              throws ParseException

Creates a URI based on given URI string. The URI string is parsed in order to create the new URI instance. Depending on the scheme the returned may or may not be a SipURI or TelURL cast as a URI.

Specified by:

createURI in interface AddressFactory

Parameters:

uri - - the new string value of the URI.

Throws:

URISyntaxException - if the URI string is malformed.

ParseException - if the URI string is malformed.