org.mobicents.protocols.api

Interface Association

public interface Association

A protocol relationship between endpoints

The implementation of this interface is actual wrapper over Socket that know's how to communicate with peer. The user of Association shouldn't care if the underlying Socket is client or server side

Author:

amit bhayani

Method Summary

Methods

Modifier and Type	Method and Description
void	acceptAnonymousAssociation(AssociationListener associationListener) Use this method only for accepting anonymous connections from the ServerListener.onNewRemoteConnection() invoking
AssociationListener	getAssociationListener() The AssociationListener set for this Association
AssociationType	getAssociationType() Return the type of Association CLIENT or SERVER
java.lang.String[]	getExtraHostAddresses() When SCTP multi-homing configuration extra IP addresses are here
java.lang.String	getHostAddress() The host address that underlying socket is bound to
int	getHostPort() The host port that underlying socket is bound to
IpChannelType	getIpChannelType() Return the Association channel type TCP or SCTP
java.lang.String	getName() Each association has unique name
java.lang.String	getPeerAddress() The peer address that the underlying socket connects to
int	getPeerPort() The peer port that the underlying socket is connected to
java.lang.String	getServerName() Server name if the association is for Server
boolean	isConnected() If this association up (connection is established)
boolean	isStarted() If this association is started by management
void	rejectAnonymousAssociation() Use this method only for rejecting anonymous connections from the ServerListener.onNewRemoteConnection() invoking
void	send(PayloadData payloadData) Send the PayloadData to the peer
void	setAssociationListener(AssociationListener associationListener) The AssociationListener to be registered for this Association
void	stopAnonymousAssociation() Stop the anonymous association.

Method Detail

getIpChannelType

IpChannelType getIpChannelType()

Return the Association channel type TCP or SCTP

Returns:

getAssociationType

AssociationType getAssociationType()

Return the type of Association CLIENT or SERVER

Returns:

getName

java.lang.String getName()

Each association has unique name

Returns:

name of association

isStarted

boolean isStarted()

If this association is started by management

Returns:

isConnected

boolean isConnected()

If this association up (connection is established)

Returns:

getAssociationListener

AssociationListener getAssociationListener()

The AssociationListener set for this Association

Returns:

setAssociationListener

void setAssociationListener(AssociationListener associationListener)

The AssociationListener to be registered for this Association

Parameters:

associationListener -

getHostAddress

java.lang.String getHostAddress()

The host address that underlying socket is bound to

Returns:

getHostPort

int getHostPort()

The host port that underlying socket is bound to

Returns:

getPeerAddress

java.lang.String getPeerAddress()

The peer address that the underlying socket connects to

Returns:

getPeerPort

int getPeerPort()

The peer port that the underlying socket is connected to

Returns:

getServerName

java.lang.String getServerName()

Server name if the association is for Server

Returns:

getExtraHostAddresses

java.lang.String[] getExtraHostAddresses()

When SCTP multi-homing configuration extra IP addresses are here

Returns:

send

void send(PayloadData payloadData)
          throws java.lang.Exception

Send the PayloadData to the peer

Parameters:

payloadData -

Throws:

java.lang.Exception

acceptAnonymousAssociation

void acceptAnonymousAssociation(AssociationListener associationListener)
                                throws java.lang.Exception

Use this method only for accepting anonymous connections from the ServerListener.onNewRemoteConnection() invoking

Parameters:

associationListener -

Throws:

java.lang.Exception

rejectAnonymousAssociation

void rejectAnonymousAssociation()

Use this method only for rejecting anonymous connections from the ServerListener.onNewRemoteConnection() invoking

stopAnonymousAssociation

void stopAnonymousAssociation()
                              throws java.lang.Exception

Stop the anonymous association. The connection will be closed and we will not reuse this association This can be applied only for anonymous association, other associations must be stopped by Management.stopAssociation(String assocName)

Throws:

java.lang.Exception