Package jain.protocol.ss7.tcap

This package contains the main interfaces required to represent JAIN TCAP protocol stacks, JAIN TCAP applications, as well as the classes and exceptions needed to send and receive JAIN TCAP messages.

See:
          Description

Interface Summary
JainTcapListener This interface defines the methods required by all TCAP user applications to receive and process JAIN TCAP Events that are emitted by an object implementing the JainTcapProvider interface.
JainTcapProvider This interface must be implemented by any Object representing the JAIN TCAP layer of any SS7 stack that interacts directly with a proprietary (stack vendor specific) implementation of the TCAP layer.
JainTcapStack This interface defines the methods required to represent a proprietary JAIN TCAP protocol stack, the implementation of which will be vendor specific.
 

Class Summary
ComponentIndEvent A ComponentIndEvent is the superclass of all Component Indication primitives, which represent TCAP Component Indications sent from a JainTcapProvider to a JainTcapListener.
ComponentReqEvent A ComponentReqEvent is the superclass of all Component request primitives, which represent TCAP Component requests sent from a JainTcapListener to a JainTcapProvider.
DialogueIndEvent A DialogueIndEvent is the superclass of all Dialogue Indication primitives, which represent TCAP Dialogue Indications sent from a JainTcapProvider to a JainTcapListener.
DialogueReqEvent A DialogueReqEvent is the superclass of all Dialogue Request primitives, which represent TCAP Dialogue Requests sent from a JainTcapProvider to a JainTcapListener.
GlobalTitle When instantiated this class represents a Global Title format which informs the user that the GlobalTitle is not included, its Global Title Indicator is of value '0000'.
GTIndicator0001 This class represents a Global Title Indicator-0001, it can be used to store, create and retrieve GlobalTitle-0001 entries.
GTIndicator0010 This class represents a Global Title Indicator-0010, it can be used to store, create and retrieve GlobalTitle-0010 entries.
GTIndicator0011 This class represents a Global Title Indicator-0011, it can be used to store, create and retrieve GlobalTitle-0011 entries.
GTIndicator0100 This class represents a Global Title Indicator-0100, it can be used to store, create and retrieve GlobalTitle-0100 entries.
TcapConstants Constants used in package jain.tcap
TcapErrorEvent This Event may be emitted by a JainTcapProvider if the Provider encounters an Error that cannot be passed to all registered JainTcapListeners through normal TCAP error handling mechanisms.
TcapUserAddress TcapUserAddress represents an address of a TCAP User application.
A TCAP User application may handle a number of User Addresses and will register as an Event Listener of a JainTcapProvider for that User Address.
 

Exception Summary
IdNotAvailableException This Exception is thrown to indicate that there are no more free Dialogue Ids or InvokeId
InvalidUserAddressException This JAIN InvalidUserAddressException is a run time exception thrown if a listener with a user-address whose point-code does not match that of the stack that owns the provider the listener is registered on (i.e.
MandatoryParameterNotSetException This Exception is thrown as a result of the following two situations: if all of the mandatory parameters required by an implementation of a JainTcapProvider to send either a ComponentReqEvent or a DialogueReqEvent have not been set or if an attempt is made to access a JAIN TCAP Mandatory parameter that has not been set within either a ComponentReqEvent or a DialogueReqEvent.
ParameterNotSetException This Exception is thrown when an attempt is made to access a parameter of a JAIN TCAP primitive when the value of the primitive has not yet been set.
ProviderNotAttachedException This Exception is thrown when an attempt is made to detach a Provider Peer from the underlying stack, or retrieve a Stack attached to a Provider Peer when the Provider Peer is not already attached to a Stack.
TcapException This Exception is thrown when a general TCAP error is encountered.
UnableToDeleteProviderException This exception is thrown if the deleteProvider() method of a JainTcapStack is invoked to delete a JainTcapProvider but the deletion is not allowed.
 

Package jain.protocol.ss7.tcap Description

This package contains the main interfaces required to represent JAIN TCAP protocol stacks, JAIN TCAP applications, as well as the classes and exceptions needed to send and receive JAIN TCAP messages. The implementation of the two stack vendor specific interfaces, namely JainTcapStack and JainTcapProvider will be vendor specific, however the naming of these proprietory implementations is mandated. The class name of the vendor specific implementations must be the JAIN TCAP "InterfaceName" of which that class implements with "Impl" appended to the end of it. For example a vendor implementation of the JainTcapStack Interface must be called "JainTcapStackImpl". Therefore once each vendor has implemented the JAIN TCAP API specification they must has two proprietary classes called JainTcapStackImpl.class and JainTcapProviderImpl.class. The characteristics of the three main interfaces are listed below:

Note:

 The cardinality of the relationship between JainTcapListeners and JainTcapProviders is not restricted in any way. The restriction of this cardinality is dependent on a vendors specific implementation of the JAIN TCAP API, were the necessary exceptions are thrown if the specificied cardinality is violated. However it is mandated that there may only be one JainTcapstack Object for the TCAP Layer of an SS7 protocol stack.



28 June 2000
If you have any comments or queries, please mail them to JainTcapApiFeedback@AePONA.Com

Copyright - 2000 Sun Microsystems