Class DialogOpenRequestEvent


  • public class DialogOpenRequestEvent
    extends DialogMessageEvent
    Event fired when a dialog-creating network message is received from the network. This event is used only in the component-oriented event APIs.

    Services should ensure that they process the DialogOpenRequestEvent on a dialog for application contexts they support, and avoid processing open request events of other dialogs, through use of an initial event selector method. This allows the resource adaptor to determine when an incoming application context is unsupported, and correctly refuse the dialog: it will refuse any dialog where no service processes the first event on a dialog. By using an initial event selector to decide which dialogs to process, many services handling different application contexts may coexist in the same SLEE instance.

    Additionally, the resource adaptor implementation uses processing of the first event as an optimization to determine whether to use the message-oriented or component-oriented event API for a particular dialog. If the first component-based event (an OpenRequestEvent) is not processed, subsequent network messages will not generate component-based events. Similarly, if the first message-based event (a DialogMessageEvent) is not processed, subsequent network messages will not generate message-based events.

    • Field Detail

      • ID

        public static final EventTypeID ID
        Common event type used when firing a DialogOpenRequestEvent to the SLEE when using the component-oriented event API.
        • Name: com.opencloud.slee.resources.cgin.DialogOpenRequest
        • Vendor: OpenCloud
        • Version: 3.0.0
    • Constructor Detail

      • DialogOpenRequestEvent

        public DialogOpenRequestEvent​(Dialog dialog,
                                      DialogMessageType messageType,
                                      SccpAddress originatingAddress,
                                      SccpAddress destinationAddress,
                                      boolean hasLayer3OriginatingPointCode,
                                      int layer3OriginatingPointCode,
                                      boolean hasLayer3DestinationPointCode,
                                      int layer3DestinationPointCode,
                                      Object[] userInformation,
                                      ComponentEvent[] componentEvents)
        Construct a new Open Request event
        Parameters:
        dialog - the newly created dialog
        messageType - the network message type that initiated the dialog
        originatingAddress - the TC originating address (SCCP calling party address) of the dialogue
        destinationAddress - the TC destination address (SCCP called party address) of the dialogue
        hasLayer3OriginatingPointCode - true if layer3OriginatingPointCode contains a valid L3 point code
        layer3OriginatingPointCode - the originating point code in the layer3 message that this TC-BEGIN arrived in
        hasLayer3DestinationPointCode - true if layer3DestinationPointCode contains a valid L3 point code
        layer3DestinationPointCode - the destination point code in the layer3 message that this TC-BEGIN arrived in
        userInformation - user information, if present in the response
        componentEvents - the component events received in the TC-BEGIN that will be fired after this event