Package javax.sip

This package contains the main interfaces that model the JAIN SIP architectute from both an application developer and a stack vendor view.

See:
Description

Interface Summary

ClientTransaction	A client transaction is used by a User Agent Client application to send Request messages to a User Agent Server application.
Dialog	A dialog represents a peer-to-peer SIP relationship between two user agents that persists for some time.
ListeningPoint	This interface represents a unique IP network listening point, which consists of port and transport.
ServerTransaction	A server transaction is used by a SipProvider to handle incoming Request messages to fire Request events to the SipListener on a specific server transaction and by a User Agent Server application to send Response messages to a User Agent Client application.
SipListener	This interface represents the application view to a SIP stack therefore defines the application's communication channel to the SIP stack.
SipProvider	This interface represents the messaging entity of a SIP stack and as such is the interface that defines the messaging and transactional component view of the SIP stack.
SipStack	This interface represents the management interface of a SIP stack implementing this specification and as such is the interface that defines the management/architectural view of the SIP stack.
Transaction	Transactions are a fundamental component of SIP.

Class Summary

DialogState	This class contains the enumerations that define the underlying state of an existing dialog.
RequestEvent	This class represents an Request event that is passed from a SipProvider to its SipListener.
ResponseEvent	This class represents a Response event that is passed from a SipProvider to its SipListener.
SipFactory	The SipFactory is a singleton class which applications can use a single access point to obtain proprietary implementations of this specification.
Timeout	This class contains the enumerations that define whether a timeout has occured in the underlying implementation.
TimeoutEvent	This class represents an Timeout event that is passed from a SipProvider to its SipListener.
TransactionState	This class contains the enumerations that define the underlying state of an existing transaction.

Exception Summary

InvalidArgumentException	This exception class is thrown by an implementation when given an invalid argument such as a invalid numerical value.
ObjectInUseException	This exception is thrown by a method that is unable to delete a specified Object because the Object is still in use by the underlying implementation.
PeerUnavailableException	The PeerUnavailableException indicates that a vendor's implementation of a JAIN SIP interface could not be created for some reason.
SipException	A SipException is thrown when a general SIP exception is encountered, when no other specialized exception defined in this specification can handle the error.
TransactionAlreadyExistsException	This Exception is thrown when a user attempts to get a transaction to handle a message when infact a transaction is already handling this message.
TransactionDoesNotExistException	This Exception is thrown when a user attempts to reference a client or server transaction that does currently not exist in the underlying SipProvider
TransactionUnavailableException	The TransactionUnavailableException indicates that a vendor's implementation could not create a Transaction for some reason.
TransportNotSupportedException	The TransportNotSupportedException indicates that a specific transport is not supported by a vendor's implementation of this specification.

Package javax.sip Description

This package contains the main interfaces that model the JAIN SIP architectute from both an application developer and a stack vendor view.

• Application Developer View:
  The application developer is concerned with implementing the SipListener interface. This Interface defines the methods required by applications to receive and process messages from a vendors SIP stack. A SipProvider receives messages from the underlying SIP network, which in turn encapsulates these messages as Events and passes them to its registered SipListener. An application must register with a SipProvider to listen for Events by implementing the SipListener interface. A single SipListener interface is mandated in the JAIN SIP architecture.
  
  
• Stack Vendors View:
  The stack vendor implements all the interfaces in the JAIN SIP specification excluding the SIPListener interface, however the two most important interfaces from the architecture point of view are the SipStack and the SipProvider interfaces.

• SipStack - This interface can be viewed as the management interface of the JAIN SIP architecture and as such only one may exist per IP address. The SipStack interface encapsulates the dynamic management characteristics of the SIP stack, such as ListeningPoints which encapsulate port and transport. As well as the central point for the creation and querying of SipProviders in the architecture.

• SipProvider - This interface can be viewed as the messaging interface of the JAIN SIP architecture. Multiple SipProviders are allowed within the architecture. This interface defines the methods that allow an application implementing the SipListener to register with the SipProvider to recieve incoming requests and responses. The methods defined to send SIP messages are also defined within the SipProvider interface.
  

Messaging model:
The JAIN SIP architecture specifies that outgoing messages are sent via the SipProvider and can either be of type Request or Response. This action is initiated by the application. Incoming messages on the other hand are passed to an application registered to the SipProvider and can either be of type RequestEvent or ResponseEvent, each containing a Request or Response message respectively. This architecture follows the Listener/Provider event model, which is suitable for applications that are unsure when the next event will arrive i.e. the applications listens for it.