Package org.jivesoftware.openfire.session

Interface OutgoingServerSession

All Superinterfaces:

ChannelHandler<org.xmpp.packet.Packet>, RoutableChannelHandler, ServerSession, Session

All Known Implementing Classes:

LocalOutgoingServerSession

public interface OutgoingServerSession
extends ServerSession

Server-to-server communication is done using two TCP connections between the servers. One connection is used for sending packets while the other connection is used for receiving packets. The OutgoingServerSession represents the connection to a remote server that will only be used for sending packets.

Once the connection has been established with the remote server and at least a domain has been authenticated then a new route will be added to the routing table for this connection. For optimization reasons the same outgoing connection will be used even if the remote server has several hostnames. However, different routes will be created in the routing table for each hostname of the remote server.

Author:

Gaston Dombiak

Field Summary

Fields inherited from interface org.jivesoftware.openfire.session.Session

MAJOR_VERSION, MINOR_VERSION, STATUS_AUTHENTICATED, STATUS_CLOSED, STATUS_CONNECTED

Method Summary

Modifier and Type	Method	Description
void	addOutgoingDomainPair(String local, String remote)	Marks a domain pair as being authenticated.
boolean	authenticateSubdomain(String domain, String hostname)	Authenticates a subdomain of this server with the specified remote server over an exsiting outgoing connection.
boolean	checkOutgoingDomainPair(String local, String remote)	Checks to see if a pair of domains has previously been authenticated.
Collection<DomainPair>	getOutgoingDomainPairs()	Obtains all authenticated domain pairs.

Methods inherited from interface org.jivesoftware.openfire.session.ServerSession

isUsingServerDialback

Methods inherited from interface org.jivesoftware.openfire.session.Session

close, deliverRawText, getAddress, getCipherSuiteName, getCreationDate, getHostAddress, getHostName, getLanguage, getLastActiveDate, getNumClientPackets, getNumServerPackets, getPeerCertificates, getServerName, getSoftwareVersion, getStatus, getStreamID, isClosed, isSecure, process, validate

Method Detail

authenticateSubdomain

boolean authenticateSubdomain(String domain,
                              String hostname)

Authenticates a subdomain of this server with the specified remote server over an exsiting outgoing connection. If the existing session was using server dialback then a new db:result is going to be sent to the remote server. But if the existing session was TLS+SASL based then just assume that the subdomain was authenticated by the remote server.

Parameters:

domain - the locally domain to authenticate with the remote server.

hostname - the domain of the remote server.

Returns:

True if the domain was authenticated by the remote server.

checkOutgoingDomainPair

boolean checkOutgoingDomainPair(String local,
                                String remote)

Checks to see if a pair of domains has previously been authenticated. Since domains are authenticated as pairs, authenticating A->B does not imply anything about A-->C or D->B.

Parameters:

local - the local domain (previously: authenticated domain)

remote - the remote domain (previous: hostname)

Returns:

True if the pair of domains has been authenticated.

addOutgoingDomainPair

void addOutgoingDomainPair(String local,
                           String remote)

Marks a domain pair as being authenticated.

Parameters:

local - the locally hosted domain.

remote - the remote domain.

getOutgoingDomainPairs

Collection<DomainPair> getOutgoingDomainPairs()

Obtains all authenticated domain pairs. Most callers should avoid accessing this and use a simple check as above.

Returns:

collection of authenticated DomainPairs