|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface defines the methods required to represent a proprietary
JAIN TCAP protocol stack, the implementation of which will be vendor specific.
Each vendor's protocol stack will have an object
that implements this interface to control the creation/deletion of proprietary
JainTcapProviders
and the attaching/detaching of those
JainTcapProviders
to this JainTcapStack implementation.
It must be noted that under the JAIN Naming Convention the lower-level package structure and classname of a proprietary implementation of the jain.protocol.ss7.tcap.JainTcapStack interface must be jain.protocol.ss7.tcap.JainTcapStackImpl.
Under the JAIN naming convention, the upper-level package structure (pathname) can be used to differentiate between proprietary implementations from different SS7 Vendors. The pathname used by each SS7 Vendor must be the domain name assigned to the Vendor in reverse order, e.g. Sun Microsystem's would be 'com.sun'
It follows that a proprietary implementation of a JainTcapStack will be located
at:
Where:
pathname = reverse domain name, e.g. com.sun'
The resulting Peer JAIN SS7 Object would be located at: com.sun.jain.protocol.ss7.tcap.JainTcapStackImpl
An application may create a JainTcapStackImpl by invoking the
JainSs7Factory.createJainSS7Object()
method. The PathName of the vendor specific implementation of which you want to
instantiate can be set before calling this method or the default or current pathname may be used.
For applications that require some means to identify multiple stacks (with multiple SPCs)
setStackName() can be used. An application can choose to supply any identifier to this method.
Note that a JainTcapStack represents a single SPC.
JainTcapProvider
Method Summary | |
void |
attach(JainTcapProvider jainTcapProvider)
Attaches the specified vendor specific Peer JAIN TCAP Provider to this JainTcapStackImpl. |
JainTcapProvider |
createAttachedProvider()
Creates a new Peer (vendor specific) JainTcapProvider
that is attached to this JainTcapStackImpl and returns a reference to it. |
JainTcapProvider |
createDetachedProvider()
Creates a new Peer (vendor specific) Provider that is detached from this JainTcapStackImpl and returns a reference to it. |
void |
deleteProvider(JainTcapProvider providerToBeDeleted)
Deletes the specified Peer JAIN TCAP Provider attached to this JainTcapStackImpl. |
void |
detach(JainTcapProvider jainTcapProvider)
Detaches the specified vendor specific Peer JAIN TCAP Provider from this JainTcapStackImpl. |
int |
getProtocolVersion()
Gets the Protocol Version that this Stack is currently supporting. |
java.util.Vector |
getProviderList()
Returns the vector of Peer JAIN TCAP Provider s that have been created by this JainTcapStackImpl. |
byte[] |
getSignalingPointCode()
The Signaling Point Code will uniquely identify the JainTcapStack. |
java.lang.String |
getStackName()
Gets the Stack Name. |
void |
setProtocolVersion(int protocolVersion)
Sets the Protocol Version that this Stack is to support. |
void |
setStackName(java.lang.String stackProtocol)
Sets the Name of this Stack. |
Method Detail |
public byte[] getSignalingPointCode()
public JainTcapProvider createAttachedProvider() throws SS7PeerUnavailableException, ProviderNotAttachedException
JainTcapProvider
that is attached to this JainTcapStackImpl and returns a reference to it.
Note to developers: The implementation of this method should add
the newly created JainTcapProvider
to the
providerList once the JainTcapProvider
has been successfully created.public JainTcapProvider createDetachedProvider() throws SS7PeerUnavailableException
JainTcapProvider
to the
providerList once the Peer JAIN TCAP Provider
has been successfully created.public void deleteProvider(JainTcapProvider providerToBeDeleted) throws UnableToDeleteProviderException
providerToBeDeleted
- the Peer JAIN TCAP Provider to be deleted from this JainTcapStackImpl.public void attach(JainTcapProvider jainTcapProvider) throws ProviderNotAttachedException
jainTcapProvider
- the Peer JAIN TCAP Provider to be attached to this JainTcapStackpublic void detach(JainTcapProvider jainTcapProvider) throws ProviderNotAttachedException
jainTcapProvider
- the JainTcapStackImpl to be detached from this JainTcapStackImpl.public java.util.Vector getProviderList()
public java.lang.String getStackName()
public void setStackName(java.lang.String stackProtocol)
stackProtocol
- the stack name.public int getProtocolVersion()
public void setProtocolVersion(int protocolVersion) throws TcapException
protocolVersion
- the Protocol Version of this Stack.
This may be one of the following values:
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |