com.opencloud.slee.resources.cgin

Class DialogOpenRequestEvent

java.lang.Object

Event

DialogEvent

DialogOpenRequestEvent

public class DialogOpenRequestEvent
extends DialogEvent

Defines the dialog Open request indication that may be received from the network. An Open request is the first event on an incoming dialogue, triggered by receipt of a TC-BEGIN.

Services should ensure that they process the DialogOpenRequest event for application contexts they support, and avoid processing other open request events at all, 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 the DialogOpenRequest event is processed by no SBBs at all. 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.

Included with the DialogOpenRequestEvent is a (possibly empty) list of component events that will be fired after the Open Request event and before the Delimiter. This corresponds to the components contained in the TC-BEGIN network message, and can be used in initial event selection logic.

Field Summary

Fields

Modifier and Type	Field and Description
static EventTypeID	ID Common event type used when firing DialogOpenAcceptEvent instances to the SLEE.

Constructor Summary

Constructors

Constructor and Description
DialogOpenRequestEvent(Dialog dialog, SccpAddress originatingAddress, SccpAddress destinationAddress, boolean hasOriginatingL3PointCode, int originatingL3PointCode, boolean hasDestinationL3PointCode, int destinationL3PointCode, TcapApplicationContext applicationContext, Object[] userInformation, ComponentEvent[] componentEvents) Construct a new Open Request event

Method Summary

Methods

Modifier and Type	Method and Description
TcapApplicationContext	getApplicationContext() Get the requested application context contained in the dialogue portion of the TC-BEGIN
ComponentEvent[]	getComponentEvents() Get the component events associated with this Open Request.
SccpAddress	getDestinationAddress() Get the destination SCCP address of the open request.
int	getLayer3DestinationPointCode() Get the layer3 destination point code for the message.
int[]	getLayer3DestinationPointCodeMemberClusterNetwork() Get the layer3 destination point code for the message using the ANSI member/cluster/network format (8/8/8 bit fields).
int[]	getLayer3DestinationPointCodeZoneAreaSignalPoint() Get the layer3 destination point code for the message using the ITU-T zone/area/signal-point format (3/8/3 bit fields).
int	getLayer3OriginatingPointCode() Get the layer3 originating point code for the message.
int[]	getLayer3OriginatingPointCodeMemberClusterNetwork() Get the layer3 originating point code for the message using the ANSI member/cluster/network format (8/8/8 bit fields).
int[]	getLayer3OriginatingPointCodeZoneAreaSignalPoint() Get the layer3 originating point code for the message using the ITU-T zone/area/signal-point format (3/8/3 bit fields).
SccpAddress	getOriginatingAddress() Get the originating SCCP address of the open request.
boolean	hasLayer3DestinationPointCode() Determine if a layer3 destination point code is available for this message.
boolean	hasLayer3OriginatingPointCode() Determine if a layer3 originating point code is available for this message.
boolean	isApplicationContextSupported() Return true if the application context offered in this open request is supported by the underlying resource adaptor.
String	toString()

Methods inherited from class DialogEvent

getUserInformation

Methods inherited from class 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 DialogOpenAcceptEvent instances to the SLEE.

• Name: com.opencloud.slee.resources.cgin.DialogOpenAccept
• Vendor: OpenCloud
• Version: 1.5.2

Constructor Detail

DialogOpenRequestEvent

public DialogOpenRequestEvent(Dialog dialog,
                      SccpAddress originatingAddress,
                      SccpAddress destinationAddress,
                      boolean hasOriginatingL3PointCode,
                      int originatingL3PointCode,
                      boolean hasDestinationL3PointCode,
                      int destinationL3PointCode,
                      TcapApplicationContext applicationContext,
                      Object[] userInformation,
                      ComponentEvent[] componentEvents)

Construct a new Open Request event

Parameters:

dialog - the newly created dialogue

originatingAddress - the TC originating address (SCCP calling party address) of the dialogue

destinationAddress - the TC destination address (SCCP called party address) of the dialogue

applicationContext - the requested application context for this dialogue

userInformation - user information, if present in the response

componentEvents - the component events received in the TC-BEGIN that will be fired after this event

Method Detail

getOriginatingAddress

public SccpAddress getOriginatingAddress()

Get the originating SCCP address of the open request.

Returns:

the originating SCCP address of the open request.

getDestinationAddress

public SccpAddress getDestinationAddress()

Get the destination SCCP address of the open request. Typically this should be SCCP address of the local Provider.

Returns:

the destination SCCP address of the open request.

hasLayer3OriginatingPointCode

public boolean hasLayer3OriginatingPointCode()

Determine if a layer3 originating point code is available for this message.

Returns:

true if a layer3 originating point code is available

getLayer3OriginatingPointCode

public int getLayer3OriginatingPointCode()

Get the layer3 originating point code for the message.

Returns:

the originating layer3 point code of the message

getLayer3OriginatingPointCodeZoneAreaSignalPoint

public int[] getLayer3OriginatingPointCodeZoneAreaSignalPoint()

Get the layer3 originating point code for the message using the ITU-T zone/area/signal-point format (3/8/3 bit fields).

Returns:

an array of length 3 with values { zone, area, signal-point }, or null if the originating layer3 point code was not available.

getLayer3OriginatingPointCodeMemberClusterNetwork

public int[] getLayer3OriginatingPointCodeMemberClusterNetwork()

Get the layer3 originating point code for the message using the ANSI member/cluster/network format (8/8/8 bit fields).

Returns:

an array of length 3 with values { member, cluster, network }, or null if the originating layer3 point code was not available.

hasLayer3DestinationPointCode

public boolean hasLayer3DestinationPointCode()

Determine if a layer3 destination point code is available for this message.

Returns:

true if a layer3 destination point code is available

getLayer3DestinationPointCode

public int getLayer3DestinationPointCode()

Get the layer3 destination point code for the message.

Returns:

the destination layer3 point code of the message

getLayer3DestinationPointCodeZoneAreaSignalPoint

public int[] getLayer3DestinationPointCodeZoneAreaSignalPoint()

Get the layer3 destination point code for the message using the ITU-T zone/area/signal-point format (3/8/3 bit fields).

Returns:

an array of length 3 with values { zone, area, signal-point }, or null if the destination layer3 point code was not available.

getLayer3DestinationPointCodeMemberClusterNetwork

public int[] getLayer3DestinationPointCodeMemberClusterNetwork()

Get the layer3 destination point code for the message using the ANSI member/cluster/network format (8/8/8 bit fields).

Returns:

an array of length 3 with values { member, cluster, network }, or null if the destination layer3 point code was not available.

getApplicationContext

public TcapApplicationContext getApplicationContext()

Get the requested application context contained in the dialogue portion of the TC-BEGIN

Returns:

an application TcapApplicationContext corresponding to the ACN of the dialogue portion

isApplicationContextSupported

public boolean isApplicationContextSupported()

Return true if the application context offered in this open request is supported by the underlying resource adaptor. If false, this dialog only exists for the purposes of allowing an application to select an appropriate alternative ACN to include in the open rejection.

Returns:

true iff the application context in use is supported

getComponentEvents

public ComponentEvent[] getComponentEvents()

Get the component events associated with this Open Request.

toString

public String toString()

Overrides:

toString in class Object