org.restlet.ext.sip
Class SipRequest

java.lang.Object
  extended by org.restlet.Message
      extended by org.restlet.Request
          extended by org.restlet.ext.sip.SipRequest

public class SipRequest
extends Request

Request part of a SIP transaction.

Author:
Jerome Louvel

Constructor Summary
SipRequest()
          Constructor.
SipRequest(Method method, Reference resourceRef)
          Constructor.
SipRequest(Method method, Reference resourceRef, Representation entity)
          Constructor.
SipRequest(Method method, String resourceUri)
          Constructor.
SipRequest(Method method, String resourceUri, Representation entity)
          Constructor.
SipRequest(SipRequest request)
          Copy constructor.
 
Method Summary
 Address getAlertInfo()
          Returns the alternative ring tone for the UAS.
 List<EventType> getAllowedEventTypes()
          Returns the list of supported event packages.
 List<Address> getCallerInfo()
          Returns the description of the current caller.
 String getCallId()
          Returns the identifier of the call.
 String getCommandSequence()
          Returns the identifier of the command.
 List<ContactInfo> getContacts()
          Returns the data about the contacts.
 long getCreation()
          Returns the creation time.
 Event getEvent()
          Returns the description of an event notification.
 Address getFrom()
          Returns the description of the request's initiator.
 List<String> getInReplyTo()
          Returns The list of references to call-ids.
 long getLastActivity()
          Returns the date of last activity on this transaction object.
 int getMaxIdleTimeMs()
          Returns the timeout in milliseconds.
 String getMimeVersion()
          Returns the version of the MIME protocol used to construct the message.
 String getOrganization()
          Returns the name of the organization to which the SIP element issuing the message belongs.
 Priority getPriority()
          Returns the urgency of the request as perceived by the client.
 List<OptionTag> getProxyRequires()
          Returns the proxy-sensitive features that the proxy must support.
 List<Address> getRecordedRoutes()
          Returns the list of routes completed by proxies to force future requests to go through the proxy.
 Address getReferTo()
          Returns the reference that the recipient of a SipMethod.REFER method should contact.
 Address getReplyTo()
          Returns a logical return URI.
 List<OptionTag> getRequires()
          Returns the sensitive features that the server must support.
 List<Address> getRoutes()
          Returns the set of proxies used to force routing for a request.
 Tag getSipIfMatch()
          Returns the identifier of the specific event state that the request is refreshing.
 List<SipRecipientInfo> getSipRecipientsInfo()
          Returns the intermediary recipients information.
 String getSubject()
          Returns the subject of the call.
 Subscription getSubscriptionState()
          Returns the state of the subscription.
 List<OptionTag> getSupported()
          Returns the extensions supported by the UAC.
 Address getTo()
          Returns the logical recipient of the request.
 String getTransaction()
          Returns the transaction identifier.
 boolean hasTimedOut()
          Indicates if the transaction has timed out due to lack of activity.
 boolean isHandled()
          Indicates that the request has been handled, typically after receiving a final response.
 void setAlertInfo(Address alertInfo)
          Sets the alternative ring tone for the UAS.
 void setAllowedEventTypes(List<EventType> allowedEventTypes)
          Sets the list of supported event packages.
 void setCallerInfo(List<Address> callerInfo)
          Sets the description of the current caller.
 void setCallId(String callId)
          Sets the identifier of the call.
 void setCommandSequence(String commandSequence)
          Sets the identifier of the command.
 void setContacts(List<ContactInfo> contact)
          Sets the data about the contacts.
 void setEvent(Event event)
          Sets the description of an event notification.
 void setFrom(Address from)
          Sets the description of the request's initiator.
 void setHandled(boolean handled)
          Indicates that the request has been handled, typically after receiving a final response.
 void setInReplyTo(List<String> inReplyTo)
          Sets the list of references to call-ids.
 void setMimeVersion(String mimeVersion)
          Sets the version of the MIME protocol used to construct the message.
 void setOrganization(String organization)
          Sets the name of the organization to which the SIP element issuing the message belongs.
 void setPriority(Priority priority)
          Sets the urgency of the request as perceived by the client.
 void setProxyRequires(List<OptionTag> proxyRequires)
          Sets the proxy-sensitive features that the proxy must support.
 void setRecordedRoutes(List<Address> recordedRoutes)
          Sets the list of routes completed by proxies to force future requests to go through the proxy.
 void setReferTo(Address referTo)
          Sets the reference that the recipient of a SipMethod.REFER method should contact.
 void setReplyTo(Address replyTo)
          Sets a logical return URI.
 void setRequires(List<OptionTag> requires)
          Sets the sensitive features that the server must support.
 void setRoutes(List<Address> routes)
          Sets the set of proxies used to force routing for a request.
 void setSipIfMatch(Tag sipIfMatch)
          Sets the identifier of the specific event state that the request is refreshing.
 void setSipRecipientsInfo(List<SipRecipientInfo> recipientsInfo)
          Sets the intermediary recipients information.
 void setSubject(String subject)
          Sets the subject of the call.
 void setSubscriptionState(Subscription subscription)
          Sets the state of the subscription.
 void setSupported(List<OptionTag> supported)
          Sets the extensions supported by the UAC.
 void setTo(Address to)
          Sets the logical recipient of the request.
 void updateLastActivity()
          Indicates that a new activity on this transaction has been detected.
 
Methods inherited from class org.restlet.Request
abort, commit, getChallengeResponse, getClientInfo, getConditions, getCookies, getCurrent, getHostRef, getMaxForwards, getMethod, getOnResponse, getOriginalRef, getProtocol, getProxyChallengeResponse, getRanges, getReferrerRef, getResourceRef, getRootRef, isAsynchronous, isConfidential, isEntityAvailable, isExpectingResponse, isLoggable, isSynchronous, setChallengeResponse, setClientInfo, setConditions, setCookies, setHostRef, setHostRef, setLoggable, setMaxForwards, setMethod, setOnResponse, setOriginalRef, setProtocol, setProxyChallengeResponse, setRanges, setReferrerRef, setReferrerRef, setResourceRef, setResourceRef, setRootRef, toString
 
Methods inherited from class org.restlet.Message
getAttributes, getCacheDirectives, getDate, getEntity, getEntityAsText, getOnError, getOnSent, getRecipientsInfo, getWarnings, release, setAttributes, setCacheDirectives, setDate, setEntity, setEntity, setOnError, setOnSent, setRecipientsInfo, setWarnings
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

SipRequest

public SipRequest()
Constructor.


SipRequest

public SipRequest(Method method,
                  Reference resourceRef)
Constructor.

Parameters:
method - The call's method.
resourceRef - The resource reference.

SipRequest

public SipRequest(Method method,
                  Reference resourceRef,
                  Representation entity)
Constructor.

Parameters:
method - The call's method.
resourceRef - The resource reference.
entity - The entity.

SipRequest

public SipRequest(Method method,
                  String resourceUri)
Constructor.

Parameters:
method - The call's method.
resourceUri - The resource URI.

SipRequest

public SipRequest(Method method,
                  String resourceUri,
                  Representation entity)
Constructor.

Parameters:
method - The call's method.
resourceUri - The resource URI.
entity - The entity.

SipRequest

public SipRequest(SipRequest request)
Copy constructor.

Parameters:
request - The request to copy.
Method Detail

getAlertInfo

public Address getAlertInfo()
Returns the alternative ring tone for the UAS.

Returns:
The alternative ring tone for the UAS.

getAllowedEventTypes

public List<EventType> getAllowedEventTypes()
Returns the list of supported event packages.

Returns:
The list of supported event packages.

getCallerInfo

public List<Address> getCallerInfo()
Returns the description of the current caller.

Returns:
The description of the current caller.

getCallId

public String getCallId()
Returns the identifier of the call.

Returns:
The identifier of the call.

getCommandSequence

public String getCommandSequence()
Returns the identifier of the command.

Returns:
The identifier of the command.

getContacts

public List<ContactInfo> getContacts()
Returns the data about the contacts.

Returns:
The data about the contacts.

getCreation

public long getCreation()
Returns the creation time.

Returns:
The creation time.

getEvent

public Event getEvent()
Returns the description of an event notification.

Returns:
The description of an event notification.

getFrom

public Address getFrom()
Returns the description of the request's initiator.

Returns:
The description of the request's initiator.

getInReplyTo

public List<String> getInReplyTo()
Returns The list of references to call-ids.

Returns:
The list of references to call-ids.

getLastActivity

public long getLastActivity()
Returns the date of last activity on this transaction object.

Returns:
The date of last activity on this transaction object.

getMaxIdleTimeMs

public int getMaxIdleTimeMs()
Returns the timeout in milliseconds.

Returns:
The timeout in milliseconds.

getMimeVersion

public String getMimeVersion()
Returns the version of the MIME protocol used to construct the message.

Returns:
The version of the MIME protocol used to construct the message.

getOrganization

public String getOrganization()
Returns the name of the organization to which the SIP element issuing the message belongs.

Returns:
The name of the organization to which the SIP element issuing the message belongs.

getPriority

public Priority getPriority()
Returns the urgency of the request as perceived by the client.

Returns:
The urgency of the request as perceived by the client.

getProxyRequires

public List<OptionTag> getProxyRequires()
Returns the proxy-sensitive features that the proxy must support.

Returns:
The proxy-sensitive features that the proxy must support.

getRecordedRoutes

public List<Address> getRecordedRoutes()
Returns the list of routes completed by proxies to force future requests to go through the proxy.

Returns:
The list of routes completed by proxies to force future requests to go through the proxy.

getReferTo

public Address getReferTo()
Returns the reference that the recipient of a SipMethod.REFER method should contact.

Returns:
The reference that the recipient of a SipMethod.REFER method should contact.

getReplyTo

public Address getReplyTo()
Returns a logical return URI.

Returns:
A logical return URI.

getRequires

public List<OptionTag> getRequires()
Returns the sensitive features that the server must support.

Returns:
The sensitive features that the server must support.

getRoutes

public List<Address> getRoutes()
Returns the set of proxies used to force routing for a request.

Returns:
The set of proxies used to force routing for a request.

getSipIfMatch

public Tag getSipIfMatch()
Returns the identifier of the specific event state that the request is refreshing.

Returns:
The identifier of the specific event state that the request is refreshing.

getSipRecipientsInfo

public List<SipRecipientInfo> getSipRecipientsInfo()
Returns the intermediary recipients information.

Returns:
The intermediary recipients information.

getSubject

public String getSubject()
Returns the subject of the call.

Returns:
The subject of the call.

getSubscriptionState

public Subscription getSubscriptionState()
Returns the state of the subscription.

Returns:
The state of the subscription.

getSupported

public List<OptionTag> getSupported()
Returns the extensions supported by the UAC.

Returns:
The extensions supported by the UAC.

getTo

public Address getTo()
Returns the logical recipient of the request.

Returns:
The logical recipient of the request.

getTransaction

public String getTransaction()
Returns the transaction identifier. It uses the "branch" parameter of the Via header if possible or a hash of several other fields.

Returns:
The transaction identifier.

hasTimedOut

public boolean hasTimedOut()
Indicates if the transaction has timed out due to lack of activity.

Returns:
True if the transaction has timed out due to lack of activity.

isHandled

public boolean isHandled()
Indicates that the request has been handled, typically after receiving a final response.

Returns:
True if the request has been handled.

setAlertInfo

public void setAlertInfo(Address alertInfo)
Sets the alternative ring tone for the UAS.

Parameters:
alertInfo - The alternative ring tone for the UAS.

setAllowedEventTypes

public void setAllowedEventTypes(List<EventType> allowedEventTypes)
Sets the list of supported event packages.

Parameters:
allowedEventTypes - The list of supported event packages.

setCallerInfo

public void setCallerInfo(List<Address> callerInfo)
Sets the description of the current caller.

Parameters:
callerInfo - The description of the current caller.

setCallId

public void setCallId(String callId)
Sets the identifier of the call.

Parameters:
callId - The identifier of the call.

setCommandSequence

public void setCommandSequence(String commandSequence)
Sets the identifier of the command.

Parameters:
commandSequence - The identifier of the command.

setContacts

public void setContacts(List<ContactInfo> contact)
Sets the data about the contacts.

Parameters:
contact - The data about the contacts.

setEvent

public void setEvent(Event event)
Sets the description of an event notification.

Parameters:
event - The description of an event notification.

setFrom

public void setFrom(Address from)
Sets the description of the request's initiator.

Parameters:
from - The description of the request's initiator.

setHandled

public void setHandled(boolean handled)
Indicates that the request has been handled, typically after receiving a final response.

Parameters:
handled - True if the request has been handled.

setInReplyTo

public void setInReplyTo(List<String> inReplyTo)
Sets the list of references to call-ids.

Parameters:
inReplyTo - The list of references to call-ids.

setMimeVersion

public void setMimeVersion(String mimeVersion)
Sets the version of the MIME protocol used to construct the message.

Parameters:
mimeVersion - The version of the MIME protocol used to construct the message.

setOrganization

public void setOrganization(String organization)
Sets the name of the organization to which the SIP element issuing the message belongs.

Parameters:
organization - The name of the organization to which the SIP element issuing the message belongs.

setPriority

public void setPriority(Priority priority)
Sets the urgency of the request as perceived by the client.

Parameters:
priority - The urgency of the request as perceived by the client.

setProxyRequires

public void setProxyRequires(List<OptionTag> proxyRequires)
Sets the proxy-sensitive features that the proxy must support.

Parameters:
proxyRequires - The proxy-sensitive features that the proxy must support.

setRecordedRoutes

public void setRecordedRoutes(List<Address> recordedRoutes)
Sets the list of routes completed by proxies to force future requests to go through the proxy.

Parameters:
recordedRoutes - The list of routes completed by proxies to force future requests to go through the proxy.

setReferTo

public void setReferTo(Address referTo)
Sets the reference that the recipient of a SipMethod.REFER method should contact.

Parameters:
referTo - The reference that the recipient of a SipMethod.REFER method should contact.

setReplyTo

public void setReplyTo(Address replyTo)
Sets a logical return URI.

Parameters:
replyTo - A logical return URI.

setRequires

public void setRequires(List<OptionTag> requires)
Sets the sensitive features that the server must support.

Parameters:
requires - The sensitive features that the server must support.

setRoutes

public void setRoutes(List<Address> routes)
Sets the set of proxies used to force routing for a request.

Parameters:
routes - The set of proxies used to force routing for a request.

setSipIfMatch

public void setSipIfMatch(Tag sipIfMatch)
Sets the identifier of the specific event state that the request is refreshing.

Parameters:
sipIfMatch - The identifier of the specific event state that the request is refreshing.

setSipRecipientsInfo

public void setSipRecipientsInfo(List<SipRecipientInfo> recipientsInfo)
Sets the intermediary recipients information.

Parameters:
recipientsInfo - The intermediary recipients information.

setSubject

public void setSubject(String subject)
Sets the subject of the call.

Parameters:
subject - the subject of the call.

setSubscriptionState

public void setSubscriptionState(Subscription subscription)
Sets the state of the subscription.

Parameters:
subscription - The state of the subscription.

setSupported

public void setSupported(List<OptionTag> supported)
Sets the extensions supported by the UAC.

Parameters:
supported - The extensions supported by the UAC.

setTo

public void setTo(Address to)
Sets the logical recipient of the request.

Parameters:
to - The logical recipient of the request.

updateLastActivity

public void updateLastActivity()
Indicates that a new activity on this transaction has been detected.



Copyright © 2005-2013 Restlet.