callcontrolterminal.java

Java Telephony API .java程序

   * @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 TerminalConnection pickup(TerminalConnection pickTermConn, Address terminalAddress)
    throws InvalidArgumentException, InvalidStateException,
           MethodNotSupportedException, PrivilegeViolationException,
           ResourceUnavailableException, PlatformException, Exception;

  /**
   * pickup() is analogous to TerminalConnection.answer(). The difference is that
   * for answer(), the Terminal that "answers" the Call is the one specified by
   * the TerminalConnection object. For pickup(), "this" Terminal is the one
   * answering the Call. pickup() picks a call from the specified Address and
   * pulls it to "this" Terminal using the specified Address. There must be at least
   * one Connection at the Address that is QUEUED or ALERTING. If there are multiple
   * Connections in those states, then the implementation will choose one of those
   * Connections (to pick a specific Connection, use the pickup(Connection, Address)
   * form of pickup()). Picking up a call changes
   * the state of the chosen Connection
   * from QUEUED or ALERTING to DISCONNECTED (if the Address specified
   * is different than the Address of the Connection) or CONNECTED (if the Address
   * specified is that same as the Address of the Connection). If the Addresses ARE
   * different, a new Connection (to the specified Address) is added to the Call in
   * the CONNECTED state.  The TerminalConnections from the original Connection are
   * placed into the DISCONNECTED state. The proper TerminalConnections in the new
   * Connection are created, including the
   * one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
   * is returned by pickup().
   * <p>
   * @param pickAddress The Address to be picked.
   * @param terminalAddress The Address associated with the Terminal.
   * @returns The new TerminalConnection associated with the Terminal.
   * @exception InvalidArgumentException One of the arguments provided is
   * not valid.
   * @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.
   * @exception Exception An implementation-specific exception occurred.
   */
  public TerminalConnection pickup(Address pickAddress, Address terminalAddress)
    throws InvalidArgumentException, InvalidStateException,
           MethodNotSupportedException, PrivilegeViolationException,
           ResourceUnavailableException, PlatformException, Exception;

  /**
   * pickupFromGroup() is analogous to TerminalConnection.answer(). The difference is that
   * for answer(), the Terminal that "answers" the Call is the one specified by
   * the TerminalConnection object. For pickupFromGroup(), "this" Terminal is the one
   * answering the Call. pickupFromGroup() picks a call from the specified pickup group and
   * pulls it to "this" Terminal using the specified Address. There must be at least
   * one Connection at the set of Addresses in the pickup group that is QUEUED or ALERTING.
   * If there are multiple
   * Connections in those states, then the implementation will choose one of those
   * Connections (to pick a specific Connection, use pickup(Connection, Address)). 
   * Picking up a call changes the state of the chosen Connection
   * from QUEUED or ALERTING to DISCONNECTED (if the Address specified
   * is different than the Address of the Connection) or CONNECTED (if the Address
   * specified is that same as the Address of the Connection). If the Addresses ARE
   * different, a new Connection (to the specified Address) is added to the Call in
   * the CONNECTED state.  The TerminalConnections from the original Connection are
   * placed into the DISCONNECTED state. The proper TerminalConnections in the new
   * Connection are created, including the
   * one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
   * is returned by pickupFromGroup().
   * <p>
   * @param pickupGroup The pickup group to be picked.
   * @param terminalAddress The Address associated with the Terminal.
   * @returns The new TerminalConnection associated with the Terminal.
   * @exception InvalidArgumentException One of the arguments provided is
   * not valid.
   * @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.
   * @exception Exception An implementation-specific exception occurred.
   */
  public TerminalConnection pickupFromGroup(String pickupGroup, Address terminalAddress)
    throws InvalidArgumentException, InvalidStateException,
           MethodNotSupportedException, PrivilegeViolationException,
           ResourceUnavailableException, PlatformException, Exception;

  /**
   * pickupFromGroup() is analogous to TerminalConnection.answer(). The difference is that
   * for answer(), the Terminal that "answers" the Call is the one specified by
   * the TerminalConnection object. For pickupFromGroup(), "this" Terminal is the one
   * answering the Call. pickupFromGroup() picks a call from a pickup group that the
   * specified Address is in and
   * pulls it to "this" Terminal using that Address. There must be at least
   * one Connection at the set of Addresses in the pickup group that is QUEUED or ALERTING.
   * If there are multiple
   * Connections in those states, then the implementation will choose one of those
   * Connections (to pick a specific Connection, use pickup(Connection, Address)). 
   * Picking up a call changes the state of the chosen Connection
   * from QUEUED or ALERTING to DISCONNECTED (if the Address specified
   * is different than the Address of the Connection) or CONNECTED (if the Address
   * specified is that same as the Address of the Connection). If the Addresses ARE
   * different, a new Connection (to the specified Address) is added to the Call in
   * the CONNECTED state.  The TerminalConnections from the original Connection are
   * placed into the DISCONNECTED state. The proper TerminalConnections in the new
   * Connection are created, including the
   * one to "this" Terminal. That TerminalConnection will be in the ACTIVE state and
   * is returned by pickupFromGroup().
   * <p>
   * @param terminalAddress The Address associated with the Terminal.
   * @returns The new TerminalConnection associated with the Terminal.
   * @exception InvalidArgumentException One of the arguments provided is
   * not valid.
   * @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.
   * @exception Exception An implementation-specific exception occurred.
   */
  public TerminalConnection pickupFromGroup(Address terminalAddress)
    throws InvalidArgumentException, InvalidStateException,
           MethodNotSupportedException, PrivilegeViolationException,
           ResourceUnavailableException, PlatformException, Exception;
  }