Package javax.csapi.cc.jcc
This package contains Java Call Control API interfaces.
See:
Description
Class Summary |
JccPeerFactory |
The JccPeerFactory class is a class by which applications
obtain a JccProvider object. |
Exception Summary |
InvalidArgumentException |
This Exception indicates that an invalid argument is passed into a method. |
InvalidPartyException |
This exception indicates that a party given as an argument to the method call was invalid. |
InvalidStateException |
An InvalidStateException indicates that that current state of an object involved in the
method invocation does not meet the acceptable pre-conditions for the method. |
MethodNotSupportedException |
This Exception indicates that the method which was invoked is not supported by the
implementation. |
PlatformException |
A PlatformException indicates an implementation specific exception. |
PrivilegeViolationException |
This exception indicates that an action pertaining to a certain object failed because
the application did not have the proper security permissions to execute that command. |
ProviderUnavailableException |
This exception indicates that the JccProvider is currently not available to the application. |
ResourceUnavailableException |
This exception indicates that a resource inside the system is not available to complete
an operation. |
Package javax.csapi.cc.jcc Description
This package contains Java Call Control API interfaces.
The following shows tables give an overview of side effects of the JccCall and
JccConnection methods. These tables are here given for convenience, for more details
read the actual method description.
Table 1: JccConnection state to acronym mapping
Table 1 gives a numbers the JccConnection's states S1 to S9. This shorthand is introduced
to reduce the size of the columns in the subsequent tables.
Table 2: method invocation
† The answer()
method can only be successfully invoked on a Terminating Connection; invoking it on an Originating Connection will not cause a transition to the CONNECTED
state.
Table 2 contains a list of methods and 3 different types of columns. The first column,
labeled " implicit resumption of processing" denotes is invocation of that methods
causes the blocked processing to be resumed. The second column, labeled "invoke when
not blocked" lists if a methods can be invoked if the processing is not blocked. The
third type lists all states and whether a methods can be successfully invoked in these
state.
Table 3: Terminating and Originating connection states
| S1 | S2 | S3 | S4 | S5 | S6 | S7 | S8 | S9 |
Originating Connection states | X | X | X | X | X | | X | X | X |
Terminating Connection states | X | X | | | X | X | X | X | X |
Table 3 shows all valid states for either originating or terminating connections.
Table 4: state change relationships
If this connection changes state | then this connection also changes state |
| |
Originating connection | Terminating connection |
| |
Terminating connection | Originating connection |
| |
Either connection | Other connection |
| |
Either connection | Other connection |
| |
All of the transitions sketched in the table 4 only apply in case of a two-party call.
The table demonstrates what a state change has for effect on other connections in the call.
Table 5: method results
In table 5, X denotes that the methods returns null
, and O denotes that
the method returns a valid value if possible. The table shows the in what states a return
value can be expected.
August, 2003
If you have any comments or queries, please mail them to JSR-122-EG@JCP.ORGCopyright - 2001, 2003 Sun Microsystems