Package com.opencloud.slee.resources.cgin

Class DialogOpenRequestEvent

java.lang.Object

Event

DialogEvent

DialogMessageEvent

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 Summary

Fields

Modifier and Type	Field	Description
static EventTypeID	ID	Common event type used when firing a DialogOpenRequestEvent to the SLEE when using the component-oriented event API.

Constructor Summary

Constructors

Constructor	Description
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

Method Summary

Methods inherited from class com.opencloud.slee.resources.cgin.DialogMessageEvent

getApplicationContext, getComponentEvents, getDestinationAddress, getLayer3DestinationPointCode, getLayer3DestinationPointCodeMemberClusterNetwork, getLayer3DestinationPointCodeZoneAreaSignalPoint, getLayer3OriginatingPointCode, getLayer3OriginatingPointCodeMemberClusterNetwork, getLayer3OriginatingPointCodeZoneAreaSignalPoint, getMessageType, getOriginatingAddress, hasLayer3DestinationPointCode, hasLayer3OriginatingPointCode, isApplicationContextSupported, isFirstResponse, toString

Methods inherited from class com.opencloud.slee.resources.cgin.DialogEvent

getUserInformation

Methods inherited from class com.opencloud.slee.resources.cgin.Event

getDialog, getName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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.1

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