| java.lang.Object java.util.EventObject javax.sip.IOExceptionEvent
IOExceptionEvent | public class IOExceptionEvent extends EventObject (Code) | | This object is used to signal to the application that an IO Exception has
occured. The transaction state machine requires to report asynchronous IO Exceptions to
the application immediately (according to RFC 3261).
This class represents an IOExceptionEvent that is passed from a SipProvider to its SipListener.
This event enables an implementation to propagate the asynchronous handling
of IO Exceptions to the application. An application (SipListener) will
register with the SIP protocol stack (SipProvider) and listen for
IO Exceptions from the SipProvider.
In many cases, when sending a SIP message, the sending function will return before
the message was actually sent.
This will happen for example if there is a need to wait for a response from a DNS server
or to perform other asynchronous actions such as connecting a TCP connection.
Later on if the message sending fails an IO exception event will be given to the application.
IO Exception events may also be reported asynchronously when the Transaction State machine
attempts to resend a pending request. Note that synchronous IO Exceptions
are presented to the caller as SipException.
author: BEA Systems, NIST since: v1.2 |
Constructor Summary | |
public | IOExceptionEvent(Object source, String remoteHost, int port, String transport) Constructor
Parameters: source - -- the object that is logically deemed to have caused the IO Exception (dialog/transaction/provider). Parameters: remoteHost - -- host where the request/response was heading Parameters: port - -- port where the request/response was heading Parameters: transport - -- transport ( i.e. |
Method Summary | |
public String | getHost() Return the host where Socket was pointing. | public int | getPort() Returns the port where the socket was trying to send amessage. | public String | getTransport() Return transport used for the failed write attempt. |
IOExceptionEvent | public IOExceptionEvent(Object source, String remoteHost, int port, String transport)(Code) | | Constructor
Parameters: source - -- the object that is logically deemed to have caused the IO Exception (dialog/transaction/provider). Parameters: remoteHost - -- host where the request/response was heading Parameters: port - -- port where the request/response was heading Parameters: transport - -- transport ( i.e. UDP/TCP/TLS). |
getHost | public String getHost()(Code) | | Return the host where Socket was pointing.
host |
getPort | public int getPort()(Code) | | Returns the port where the socket was trying to send amessage.
port associated with the IOException |
getTransport | public String getTransport()(Code) | | Return transport used for the failed write attempt.
the transaction associated with the IOException |
|
|