Interface CCDialog

  • All Superinterfaces:
    Dialog
    All Known Subinterfaces:
    CAP1Dialog, CAP2Dialog, CAP3Dialog, CAP4Dialog, CS1Dialog

    public interface CCDialog
    extends Dialog
    Protocol-specific extension interface for callcontrol dialogs. Contains typesafe convenience methods for sending operation invokes, results, and errors.
    • Method Detail

      • sendActivityTest

        int sendActivityTest​(long timeout)
                      throws TooManyInvokesException,
                             ProtocolException
        Issues an activityTest operation request on the dialog.
        Parameters:
        timeout - invoke timeout, in milliseconds; 0 uses the RA default
        Returns:
        TCAP invoke ID allocated for this operation
        Throws:
        TooManyInvokesException - if no free invoke id is available on this dialog
        ProtocolException - if the RA was unable to send the invoke for some reason
      • sendActivityTestResponse

        void sendActivityTestResponse​(int invokeId)
                               throws ProtocolException
        Issues a (last) response to an activityTest operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the response for some reason
      • sendActivityTestResponse

        void sendActivityTestResponse​(int invokeId,
                                      boolean isLast)
                               throws ProtocolException
        Issues a response to an activityTest operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        isLast - if true, will be sent in a ResultLast, if false will be sent in a ResultNotLast
        Throws:
        ProtocolException - if the RA was unable to send the response for some reason
      • sendCancelFailedError

        void sendCancelFailedError​(int invokeId,
                                   CCCancelFailedArg error)
                            throws ProtocolException
        Issues a cancelFailed error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        error - parameter value
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendCancelledError

        void sendCancelledError​(int invokeId)
                         throws ProtocolException
        Issues a cancelled error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendDisconnectForwardConnection

        int sendDisconnectForwardConnection()
                                     throws TooManyInvokesException,
                                            ProtocolException
        Issues a disconnectForwardConnection operation request on the dialog.
        Returns:
        TCAP invoke ID allocated for this operation
        Throws:
        TooManyInvokesException - if no free invoke id is available on this dialog
        ProtocolException - if the RA was unable to send the invoke for some reason
      • sendETCFailedError

        void sendETCFailedError​(int invokeId)
                         throws ProtocolException
        Issues an eTCFailed error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendImproperCallerResponseError

        void sendImproperCallerResponseError​(int invokeId)
                                      throws ProtocolException
        Issues an improperCallerResponse error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendMissingCustomerRecordError

        void sendMissingCustomerRecordError​(int invokeId)
                                     throws ProtocolException
        Issues a missingCustomerRecord error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendMissingParameterError

        void sendMissingParameterError​(int invokeId)
                                throws ProtocolException
        Issues a missingParameter error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendParameterOutOfRangeError

        void sendParameterOutOfRangeError​(int invokeId)
                                   throws ProtocolException
        Issues a parameterOutOfRange error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendPlayAnnouncement

        int sendPlayAnnouncement​(long timeout,
                                 CCPlayAnnouncementArg argument)
                          throws TooManyInvokesException,
                                 ProtocolException
        Issues a playAnnouncement operation request on the dialog.
        Parameters:
        timeout - invoke timeout, in milliseconds; 0 uses the RA default
        argument - argument value
        Returns:
        TCAP invoke ID allocated for this operation
        Throws:
        TooManyInvokesException - if no free invoke id is available on this dialog
        ProtocolException - if the RA was unable to send the invoke for some reason
      • sendPromptAndCollectUserInformation

        int sendPromptAndCollectUserInformation​(long timeout,
                                                CCPromptAndCollectUserInformationArg argument)
                                         throws TooManyInvokesException,
                                                ProtocolException
        Issues a promptAndCollectUserInformation operation request on the dialog.
        Parameters:
        timeout - invoke timeout, in milliseconds; 0 uses the RA default
        argument - argument value
        Returns:
        TCAP invoke ID allocated for this operation
        Throws:
        TooManyInvokesException - if no free invoke id is available on this dialog
        ProtocolException - if the RA was unable to send the invoke for some reason
      • sendPromptAndCollectUserInformationResponse

        void sendPromptAndCollectUserInformationResponse​(int invokeId,
                                                         CCReceivedInformationArg result)
                                                  throws ProtocolException
        Issues a (last) response to a promptAndCollectUserInformation operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        result - result value
        Throws:
        ProtocolException - if the RA was unable to send the response for some reason
      • sendPromptAndCollectUserInformationResponse

        void sendPromptAndCollectUserInformationResponse​(int invokeId,
                                                         CCReceivedInformationArg result,
                                                         boolean isLast)
                                                  throws ProtocolException
        Issues a response to a promptAndCollectUserInformation operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        result - result value
        isLast - if true, will be sent in a ResultLast, if false will be sent in a ResultNotLast
        Throws:
        ProtocolException - if the RA was unable to send the response for some reason
      • sendRequestedInfoErrorError

        void sendRequestedInfoErrorError​(int invokeId,
                                         CCRequestedInfoErrorArg error)
                                  throws ProtocolException
        Issues a requestedInfoError error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        error - parameter value
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendSystemFailureError

        void sendSystemFailureError​(int invokeId,
                                    CCUnavailableNetworkResource error)
                             throws ProtocolException
        Issues a systemFailure error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        error - parameter value
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendTaskRefusedError

        void sendTaskRefusedError​(int invokeId,
                                  CCTaskRefusedArg error)
                           throws ProtocolException
        Issues a taskRefused error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        error - parameter value
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendUnavailableResourceError

        void sendUnavailableResourceError​(int invokeId)
                                   throws ProtocolException
        Issues an unavailableResource error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendUnexpectedComponentSequenceError

        void sendUnexpectedComponentSequenceError​(int invokeId)
                                           throws ProtocolException
        Issues an unexpectedComponentSequence error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendUnexpectedDataValueError

        void sendUnexpectedDataValueError​(int invokeId)
                                   throws ProtocolException
        Issues an unexpectedDataValue error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendUnexpectedParameterError

        void sendUnexpectedParameterError​(int invokeId)
                                   throws ProtocolException
        Issues an unexpectedParameter error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason
      • sendUnknownLegIDError

        void sendUnknownLegIDError​(int invokeId)
                            throws ProtocolException
        Issues an unknownLegID error response for an operation on the dialog.
        Parameters:
        invokeId - TCAP invoke ID for the operation
        Throws:
        ProtocolException - if the RA was unable to send the error response for some reason