io.pkts.packet.sip.address

Interface SipURI

All Superinterfaces:

URI

All Known Implementing Classes:

SipURIImpl

public interface SipURI
extends URI

Author:

[email protected]

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	SipURI.Builder

Method Summary

Modifier and Type	Method and Description
static SipURI.Builder	builder()
SipURI	clone()
SipURI.Builder	copy() All URIs are immutable so if you wish to change it you need to obtain a copy of it which will return a new builder that allows you to change and build a new URI.
boolean	equals(Object o) See rules for comparing URI's in RFC3261 section 19.1.4.
static SipURI	frame(Buffer buffer) Frame a sip or sips-uri, which according to RFC3261 is:
static SipURI	frame(String buffer)
Buffer	getHost() Get the host portion of this URI.
Buffer	getMAddrParam() Get the maddr parameter.
Buffer	getMethodParam() Get the method parameter.
Buffer	getParameter(Buffer name) Get the value of the named parameter.
Buffer	getParameter(String name) Same as getParameter(Buffer).
int	getPort() Get the port.
Buffer	getTransportParam() Same as #getParameter("transport")
int	getTTLParam() Get the ttl parameter.
Buffer	getUser() Get the user portion of this URI.
Buffer	getUserParam() Get the user parameter.
boolean	isSecure() Check whether this is a sips URI.
Buffer	toBuffer() Get the entire content of the SipURI as a Buffer.
default SipURI	toSipURI()
static SipURI.Builder	with()
static SipURI.Builder	withHost(Buffer host)
static SipURI.Builder	withHost(String host)
static SipURI.Builder	withParameters(Buffer params)
static SipURI.Builder	withTemplate(SipURI uri) Create a new SipURI.Builder based on the SipURI.
static SipURI.Builder	withUser(Buffer user)
static SipURI.Builder	withUser(String user) Create a new builder based where the user portion has been specified.

Methods inherited from interface io.pkts.packet.sip.address.URI

getBytes, getScheme, isSipURI

Method Detail

getUser

Buffer getUser()

Get the user portion of this URI.

Returns:

the user portion of this URI or an empty buffer if there is no user portion

getHost

Buffer getHost()

Get the host portion of this URI.

Returns:

getPort

int getPort()

Get the port. If the port isn't set then -1 (negative one) will be returned.

Returns:

toSipURI

default SipURI toSipURI()

Specified by:

toSipURI in interface URI

isSecure

boolean isSecure()

Check whether this is a sips URI.

Returns:

true if this indeed is a sips URI, false otherwise.

getTransportParam

Buffer getTransportParam()
                  throws SipParseException

Same as #getParameter("transport")

Returns:

Throws:

SipParseException

getUserParam

Buffer getUserParam()
             throws SipParseException

Get the user parameter. This is the same as #getParameter("user")

Returns:

Throws:

SipParseException

getTTLParam

int getTTLParam()
         throws SipParseException

Get the ttl parameter. This is the same as #getParameter("ttl")

Returns:

the value of the TTL parameter or -1 (negative one) if it is not set.

Throws:

SipParseException

getMAddrParam

Buffer getMAddrParam()
              throws SipParseException

Get the maddr parameter. This is the same as #getParameter("maddr")

Returns:

Throws:

SipParseException

getMethodParam

Buffer getMethodParam()
               throws SipParseException

Get the method parameter. This is the same as #getParameter("method")

Returns:

Throws:

SipParseException

getParameter

Buffer getParameter(Buffer name)
             throws SipParseException,
                    IllegalArgumentException

Get the value of the named parameter. If the named parameter is a so-called flag parameter, then the value returned will be an empty Buffer, which can be checked with Buffer.isEmpty() or Buffer.capacity(), which will return zero. As with any empty Buffer, if you do Buffer.toString() you will be getting an empty String back, which would be yet another way to check for a flag parameter.

Parameters:

name - the name of the parameter we are looking for.

Returns:

the value of the named parameter or null if there is no such parameter. If the named parameter is a flag parameter, then an empty buffer will be returned.

Throws:

SipParseException - in case anything goes wrong while extracting the parameter.

IllegalArgumentException - in case the name is null.

getParameter

Buffer getParameter(String name)
             throws SipParseException,
                    IllegalArgumentException

Same as getParameter(Buffer).

Parameters:

name -

Returns:

Throws:

SipParseException - in case anything goes wrong while extracting the parameter.

IllegalArgumentException - in case the name is null.

equals

boolean equals(Object o)

See rules for comparing URI's in RFC3261 section 19.1.4.

Overrides:

equals in class Object

Parameters:

o -

Returns:

toBuffer

Buffer toBuffer()

Get the entire content of the SipURI as a Buffer.

Returns:

clone

SipURI clone()

Specified by:

clone in interface URI

copy

SipURI.Builder copy()

Description copied from interface: URI

All URIs are immutable so if you wish to change it you need to obtain a copy of it which will return a new builder that allows you to change and build a new URI.

Specified by:

copy in interface URI

Returns:

frame

static SipURI frame(Buffer buffer)
             throws SipParseException,
                    IndexOutOfBoundsException,
                    IOException

Frame a sip or sips-uri, which according to RFC3261 is:

 SIP-URI          =  "sip:" [ userinfo ] hostport
                      uri-parameters [ headers ]
 SIPS-URI         =  "sips:" [ userinfo ] hostport
                      uri-parameters [ headers ]
 

Remember though that all these frame-functions will only do a basic verification that all things are ok so just because this function return without an exception doesn't mean that you actually framed a valid URI. Everything is done lazily so things may blow up later. Also note that this function assumes that someone else has already determined the boundaries for this sip(s)-uri and as such, this function does not expect '<' etc.

Specified by:

frame in interface URI

Parameters:

buffer -

Returns:

Throws:

SipParseException

IOException

IndexOutOfBoundsException

frame

static SipURI frame(String buffer)
             throws SipParseException,
                    IndexOutOfBoundsException,
                    IOException

Throws:

SipParseException

IndexOutOfBoundsException

IOException

with

static SipURI.Builder with()

builder

static SipURI.Builder builder()

withUser

static SipURI.Builder withUser(String user)

Create a new builder based where the user portion has been specified. Note, even though the user portion of a SIP URI isn't mandatory it will be checked for empty or null by this method. The reason for this is simply if you call a method called "withUser" then it is assumed you actually do want the user portion to be present. If this is not what you want, simply call another "withXXX" method.

Parameters:

user -

Returns:

withUser

static SipURI.Builder withUser(Buffer user)

withHost

static SipURI.Builder withHost(String host)

withParameters

static SipURI.Builder withParameters(Buffer params)

withHost

static SipURI.Builder withHost(Buffer host)

withTemplate

static SipURI.Builder withTemplate(SipURI uri)

Create a new SipURI.Builder based on the SipURI.

• user
• host
• port
• transport
• schema (sip or sips)

Any other parameter will be ignored.

Parameters:

uri -

Returns: