JSR 32 - JSIP v1.2 Specification Final Change Log

JSR 32 - JSIP v1.2 Specification
Final Change Log

Author: Phelim O'Doherty (Sun), Ranganathan Mudumbai (NIST)

ACCEPTED CHANGES

General: Decoupled the transaction layer from the Dialog layer. Added support for RFC3903 and RFC3581.   Package javax.sip   SipProvider Updated architecture in SIP Provider on enhanced ListeningPoint/SipProvider Model. Change the 1-to-1 relationship between SipProvider and ListeningPoint, to 1-to-N.  Deprecated getListeningPoint and replaced with getListeningPoints method. Deprecated setListeningPoint method with addListeningPoint method. Added method to getListeningPoint for a specific transport. Added removeListeningPoint method. Added getNewDialog method for a specific transaction. Clarified addListener method.   SipStack Added new AUTOMATIC_DIALOG_SUPPORT config parameter to the SipStack properties documentation. Added new FORKABLE_EVENTS config parameter to the SipStack properties documentation. Added new USE_ROUTER_FOR_ALL_URIS config parameter to the SipStack properties documentation. Deprecated IP_ADDRESS config parameter in the SipStack properties documentation. Added createListeningPoint method to SipStack with IP address, Port and Transport. Deprecated createListeningPoint method with port and transport arguments. Add start and stop stack methods.   SipListener Added capability to process IOException, TransactionTerminated, and DialogTerminated events.   SipFactory Clarified model for stack creation. IPAddress is no longer a mandatory property for stack creation. IP Address should be configured via the enhanced ListeningPoint architecture. For backwards compatibility IP Address configuration properties is still supported.   ListeningPoint Added new getIPAddress method. Assigning IP Address to the ListeningPoint enables the stack to support multi-homed hosts. Added new getSentBy and setSentBy methods.   Dialog Clarified getState method - removed use of term pseudo dialogs and highlighted null. Deprecated getFirstTransaction method to avoid stack having to track additional state. Added createReliableProvisionalResponse and sendReliableProvisionalResponse methods. Added createAck and createPrack methods. Added terminateOnBye method.   DialogState Deprecated COMPLETED state. Added equals and hashcode methods.   TransactionState Added equals and hashcode methods.   ResponseEvent Added getDialog method.   RequestEvent Added getDialog method.   Transaction Added terminate method. Added getApplicationData and setApplicationData methods. Clarified getDialog method behaviour. Added equal and hashcode methods.   ClientTransaction Deprecated createAck method.   ServerTransaction Added enableRetransmissionAlerts method.   New Classes Added new IOExceptionEvent, DialogTerminatedEvent and TransactionTerminatedEvent.   New Exceptions DialogDoesNotExistException, ProviderDoesNotExistException and TransportAlreadySupportedException.   Package javax.sip.address   SipURI Didn't add equals method already overridden in Address. Allowable null in getUser method.   TelURL Added setPhoneContext and getPhoneContext methods.   Address Added hashcode and clone methods.   Router Updated general description of Router functionality. Deprecated getNextHops method and replaced with getNextHop method.   Package javax.sip.header   HeaderFactory Updated createToHeader method to allow null tag parameter. Added createSIPIfMatchHeader and createSIPETagHeader methods.   Header Added hashcode method.   ViaHeader Added getRPort and setRPort methods.   WWWAuthenticateHeader Deprecated getURI and setURI methods as they don't exist on this header.   New Headers SIPETagHeader and SIPIfMatchHeader for RFC 3909     Package javax.sip.message   Message Added removeFirst, addFirst, removeLast and addLast methods. Added hashcode method. Clarified getUnrecognizedHeaders() method behaviour clarified. Clarified Clone behaviour of message bodies.   MessageFactory Added createResponse method from a String argument. Clarified createRequest(String) method behaviour.   Request Added PUBLISH request type.   Response Added CONDITIONAL_REQUEST_FAILED response code. Added equals method to all mandatory headers.   ContactHeader Added setWildCard and isWilcard methods. Updated getExpires method.

REJECTED CHANGES - Not deemed necessary by Spec leads

Package javax.sip Limit the architecture to have a single SipProvider in the architecture.  Multiple SipProviders were supported in JSIPv1.1 to enable messaging over different transports. This can still be achieved by limiting a single SipProvider in the system and mandating that the SipProvider uses the same transport for sending responses that was used for sending the outbound request. SipProvider Add new method getNewClientDialog(Response). Add new method getNewServerDialog(Response). Deprecate setListeningPoint() and getListeningPoint() methods Documentation clarification on refined architecture object model. Dialog sendAck() method behaviour clarified. SipStack Add new NETWORK_LAYER_PATH property. Deprecate createSipProvider(ListeningPoint) method. Add new createSipProvider() method. Package javax.sip.address New Classes Add new interface NetworkLayer.java

DEFERRED CHANGES