callcontrolconnection.java

Java Telephony API .java程序

   */
  public void accept()
    throws InvalidStateException,
      MethodNotSupportedException, PrivilegeViolationException,
      ResourceUnavailableException, PlatformException;


  /**
   * Rejects a telephone call. This method is associated most commonly
   * with ISDN-type protocols which support the OFFERING state. Incoming
   * telephony calls are sometimes first "offered" to an address for
   * acceptance. Only after a call is accepted does the standard notions
   * of alerting take place. A call may also be rejected, where the call
   * does not proceed to the alerting stage. This method returns when
   * this Connection successfully moves into the DISCONNECTED state, otherwise,
   * an exception is thrown to signal an error.
   * <p>
   * This Connection object must be in OFFERING state. The Provider must
   * also be IN_SERVICE. These pre-conditions are given below:
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == OFFERING.
   * </OL>
   * <p>
   * The post-conditions are given below:
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == DISCONNECTED.
   * </OL>
   * <p>
   * @exception InvalidStateException The state of some object is not valid
   * as designated by the pre-conditions for this method.
   * @exception MethodNotSupportedException This method is not supported by
   * the implementation.
   * @exception PrivilegeViolationException The application does not have
   * the proper authority to invoke this method.
   * @exception ResourceUnavailableException An internal resource neccessary
   * for the successful invocation of this method is not available.
   * @exception PlatformException A platform-specific exception occurred.
   */
  public void reject()
    throws InvalidStateException,
      MethodNotSupportedException, PrivilegeViolationException,
      ResourceUnavailableException, PlatformException;

 
  /**
   * Redirects a telephone call to another telephone number. This feature
   * is very similar to a transfer feature, however, the application may
   * use the redirect() method when the Connection is either in the ALERTING
   * or OFFERING CallControlConnection states. The telephone address provided
   * must be valid and complete.
   * <p>
   * The Connection must be in the OFFERING or ALERTING state.
   * The first argument, destinationAddress, must be a valid telephone number
   * to dial. The Connection must also be associated with this Address
   * object and the Provider must be IN_SERVICE. These pre-conditions are given
   * below:
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == OFFERING or ALERTING
   * <LI>destinationAddress must be a valid telephone number.
   * </OL>
   * <p>
   * If successful, this method creates a new Connection associated with the
   * Address object, as given by the destinationAddress string. This new
   * Connection is in the IDLE state and is returned by this method. The
   * Connection given as an argument moves to the DISCONNECTED state when
   * this method returns. All of its TerminalConnections move to the DROPPED
   * state as well. These post-conditions are given as follows, where
   * 'connection' is the argument, and 'newconnection' is the return value.
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == DISCONNECTED.
   * <LI>newconnection.getCallControlState() == IDLE
   * <LI>Let TerminalConnection tc[] = this.getTerminalConnections()
   * <LI>For all i, tc[i].getCallControlState() == DROPPED
   * </OL>
   * <p>
   * The newconnection object acts similar to a destination connection when
   * a telephone call is first placed. The Call.connect() method provides the
   * scenarios for this destination Connection and the possible state changes
   * it may undergo.
   * <p>
   * @param desintationAddress The Connection is rerouted to this address
   * @return The new Connection associated with the Address object of the
   * new address.
   * @exception InvalidStateException The state of some object is not valid
   * as designated by the pre-conditions for this method.
   * @exception InvalidPartyException The party to which this call is
   * redirected is not valid.
   * @exception MethodNotSupportedException This method is not supported by
   * the implementation.
   * @exception PrivilegeViolationException The application does not have
   * the proper authority to invoke this method.
   * @exception ResourceUnavailableException An internal resource neccessary
   * for the successful invocation of this method is not available.
   * @exception PlatformException A platform-specific exception occurred.
   * @exception Exception An implementation-specific exception occurred.
   */
  public CallControlConnection redirect(String destinationAddress)
    throws InvalidStateException,
      InvalidPartyException, MethodNotSupportedException,
      PrivilegeViolationException, ResourceUnavailableException,
      PlatformException;


  /**
   * Appends additional address information onto an existing Connection.
   * This method is used when part of a telephone number has been dialed
   * and the application may complete the address with this method.
   * <p>
   * This Connection must be in the DIALING or INITIATED state and the 
   * Provider must also
   * be IN_SERVICE. These pre-conditions are given below:
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == DIALING | INITIATED.
   * </OL>
   * <p>
   * The post-conditions of this method depend upon whether the provided
   * additional addressing information is enough to complete the address.
   * This is determined by the switch. If the additional addressing information
   * is enough, the Connection moves from the DIALING state into the
   * ESTABLISHED state. If not, the Connection remains in the DIALING state.
   * The following post-conditions reflect this:
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == DIALING if the addressing information was
   * not enough as determined by the switch.
   * <LI>this.getCallControlState() == ESTABLISHED if the addressing information was
   * sufficient to complete the address, determined by the switch
   * </OL>
   * <p>
   * @param additionalAddress The additional addressing information.
   * @exception InvalidStateException The state of some object is not valid
   * as designated by the pre-conditions for this method.
   * @exception MethodNotSupportedException This method is not supported by
   * the implementation.
   * @exception PrivilegeViolationException The application does not have
   * the proper authority to invoke this method.
   * @exception ResourceUnavailableException An internal resource neccessary
   * for the successful invocation of this method is not available.
   * @exception PlatformException A platform-specific exception occurred.
   */
  public void addToAddress(String additionalAddress)
    throws InvalidStateException,
      MethodNotSupportedException, PrivilegeViolationException,
      ResourceUnavailableException, PlatformException;


  /**
   * Parks an active Connection to another Address. "Parking" a Connection
   * transfers that Connection to another address and drops it from the current
   * telephone call. The Call Parking feature is very much like transfering
   * a telephone call except the new address does not alert. The new Connection
   * is in a special QUEUED state. Applications may then use the pickup()
   * method to "unpark" this call. The telephone address provided must be
   * valid and complete.
   * <p>
   * This Connection must be in the ESTABLISHED state.
   * The destAddress parameter must be a complete, valid telephone number
   * which can be dialed. The Provider must also be IN_SERVICE. These pre-
   * conditions are given below:
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>this.getCallControlState() == ESTABLISHED
   * <LI>destAddress must be a valid and complete telephone number.
   * </OL>
   * <p>
   * This method moves the connection into the
   * DISCONNECTED state and creates a new connection attached to an Address
   * object which corresponds to the destAddress argument. This new connection
   * is in the CallControlConnection QUEUED state and is returned by this
   * method. ALl of the TerminalConnections which are part of this Connection
   * move to the DROPPED state.
   * The post conditions for this method are given below, where
   * 'newconnection' is the Connection returned by this method.
   * <p>
   * <OL>
   * <LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
   * <LI>newconnection.getCallControlState() == QUEUED
   * <LI>this.getCallControlState() == DISCONNECTED
   * <LI>For all termconn = this.getTerminalConnections(),
   * termconn.getState() == DROPPED
   * </OL>
   * <p>
   * @param destAddress The address at which this connection is to be parked.
   * @return The new Connection.
   * @exception InvalidStateException The state of some object is not valid
   * as designated by the pre-conditions for this method.
   * @exception MethodNotSupportedException This method is not supported by
   * the implementation.
   * @exception InvalidPartyException The party to which to party the
   * Connection is invalid.
   * @exception PrivilegeViolationException The application does not have
   * the proper authority to invoke this method.
   * @exception ResourceUnavailableException An internal resource neccessary
   * for the successful invocation of this method is not available.
   * @exception PlatformException A platform-specific exception occurred.
   */
  public CallControlConnection park(String destAddress)
    throws InvalidStateException,
      MethodNotSupportedException, PrivilegeViolationException,
      InvalidPartyException, ResourceUnavailableException, PlatformException;
}