JCC
v0.9.2

JAIN(tm) JCC API Participant Draft (v0.9.2)

See:
          Description
Packages
jain.application.services.jcc This package contains JAIN Call Control API interfaces.
jain.application.services.jcp This package contains the classes and interfaces in the JAIN Core Package API that make up the common subset between JTAPI and JCC.

JAIN(tm) JCC API Participant Draft (0.9.2)

29 October 2000.

Confidential to JSPA Participants.


Contents

  1. The Java Community Process
  2. Change Log
  3. Submitting comments
  4. JCC contributors

The Java Community Process 1.0

This specification is being defined in accordance with the processes specified in the Java Community Process 1.0. This draft of the specification represents the Particpant Draft of the JCC API and is open to participant comments during the participant review period. This review period must last a minimum of 30 days and all comments received must be responded to. For more information on the Participant review period, read the Java Community Process 1.0.

Back to Top


Change Log

The following changes were incorporated into Draft 0.9, since Draft 0.8.4 of the API
  1. Typos that were causing the source files not to compile have been fixed.
  2. All addXXXListener() methods have been changed to throw the same exception.
  3. JcpConnection states are now found in JcpConnection.java.
  4. getMoreDialledDigits() changed to getMoreDialedDigits().
  5. callcreated() changed to callCreated().
  6. added getType() to ResourceUnavailableException.
  7. The description of the parameters originalCalledAddress and redirectingAddress of the JccCall.createConnection() method changed to mention that they are per call leg.
  8. EventIDs changed to make them unique.
  9. Added a method JccConnection.getDestinationAddress()
  10. Made it clear that adding a listener results in the delivering of event snapshots. This was done earlier for just some methods but this has now been specified for every concerned class explicitly.
  11. Removed the pre-condition on JccCall.addConnectionListener() and JccCall.addCallListener().
The following changes were incorporated into Draft 0.9.1, since Draft 0.9 of the API
  1. Reviewed all code and added/changed some:
  2. Changed JcpProvider.getAddress(String address) throw InvalidArgumentException in JcpProvider.getAddress(String address) throw InvalidPartyException.
  3. Removed JcpProviderEvent.getProvider(), as Event.getSource() does the same.
  4. Added exception to JccConnection methods as suggested by IBM
  5. The semantics of JccCall.createConnection() and JccCall.routeCall() were explained in more detail.
  6. Updated JavaDoc: removed typos, introduced links, etc.
  7. Introduced new packaging structure: jain.jcp became jain.application.services.jcp and jain.jcc became jain.application.services.jcp.jcc.
The following changes were incorporated into Draft 0.9.2, since Draft 0.9.1 of the API
  1. Changed the package structure of jain.application.services.jcp.jcc to jain.application.services.jcc.
  2. Changed the name of the interface jcp.Event to jcp.JcpEvent.
  3. Changed the return types of some methods on the Jcc interfaces to indicate that Jcc objects are being returned instead of the Jcp objects as was being done earlier.
  4. Changed the exceptions of JcpPeerFactory.getJcpPeer() to align with the exceptions thrown by Class.forName()
  5. Removed the JcpPeerUnavailableException, since the JcpPeerFactory.getJcpPeer() method no longer throws this exception.
  6. Added a transition from the Failed to the Disconnected state in the JccConnection FSM to make this FSM aligned with the FSM of the JcpConnection.
  7. Added language in the Events-Blocking and non-blocking subsection of the JccConnection so as to clarify the meaning of blocking as well as to clarify the behavior of the platform with respect to the generation of events.
  8. Clarified further the functioning of the different addXXXListener methods.
  9. Changed the input parameter types of the JccCall.addXXXListener from JcpXXXListener to JccXXXListener and JccCall.removeConnectionListener from JcpConnectionListener to JccConnectionListener.
  10. Changed the input parameter types of the JccProvider.addXXXListener(..,EventFilter)from JcpXXXListener to JccXXXListener.
  11. Added JcpProviderEvent.getProvider().
  12. Clarified the behavior in the presence of multiple listeners registered on the JccConnection object some of which might request the suspension of call processing.
  13. Clarified the result of invoking the JcpConnection.getAddress() on the JccConnection reference returned from JccCall.createConnection() or JccCall.routeCall().
  14. Added more explanation to all the call flows diagrams.
  15. Changed the signature of JccProvider. createEventFilterAddressRange(String lowAddress, String highAddress, int matchDisposition, int nomatchDisposition) from JccProvider.createEventFilterAddressRange(JcpAddress lowAddress, JcpAddress highAddress, int matchDisposition, int nomatchDisposition). This was based on the comments received which pointed out that addresses are passed as strings in all other places.
  16. Changed the pre and post conditions in JccCall.createConnection, JccCall.routeCall and JccConnection.route methods to make them consistent.
  17. Changed the semantics of JcpConnection.INPROGRESS state to make it consistent with the corresponding sub-states defined in JccConnection interface.
  18. Added ResourceUnavailableException to the createEventFilterxxx() methods on the JccProvider interface.
  19. Added the selectRoute(String[] addresses) method to the JccConnection interface.

Submitting Comments

This API is continually being reviewed and refined, with additional functionality added to the API on a regular basis. All comments received during the Participant review period must be responded to. A complete set of responses will be made available to all participants.

Please review this API and provide written comments to:

Back to Top

JCC contributors


JCC
v0.9.2

29 Oct 2000
If you have any comments or queries, please mail them to jcc@research.telcordia.com

 

 

Copyright-2000 Sun Microsystems