rocks.xmpp.extensions.component.accept

Class ExternalComponent

java.lang.Object

rocks.xmpp.core.session.XmppSession

rocks.xmpp.extensions.component.accept.ExternalComponent

All Implemented Interfaces:

java.lang.AutoCloseable, StreamHandler

public final class ExternalComponent
extends XmppSession

An external component session which connects to an XMPP server using the “Jabber Component Protocol”.

See Also:

XEP-0114: Jabber Component Protocol

Nested Class Summary

Nested classes/interfaces inherited from class rocks.xmpp.core.session.XmppSession

XmppSession.Status

Method Summary

Modifier and Type	Method and Description
void	connect(Jid from)
static ExternalComponent	create(java.lang.String componentName, java.lang.String sharedSecret, java.lang.String hostname, int port) Creates a new external component using a default configuration.
static ExternalComponent	create(java.lang.String componentName, java.lang.String sharedSecret, XmppSessionConfiguration xmppSessionConfiguration, ClientConnectionConfiguration connectionConfiguration) Creates a new external component using a default configuration.
static ExternalComponent	create(java.lang.String componentName, java.lang.String sharedSecret, XmppSessionConfiguration configuration, java.lang.String hostname, int port) Creates a new external component.
Jid	getConnectedResource() The connected resource, which is assigned by the server.
boolean	handleElement(java.lang.Object element) Handles an XMPP element.
void	notifyException(java.lang.Throwable e) Called if any unhandled exception is thrown during reading or writing.

Methods inherited from class rocks.xmpp.core.session.XmppSession

addConnectionListener, addCreationListener, addInboundIQListener, addInboundMessageListener, addInboundPresenceListener, addIQHandler, addIQHandler, addMessageAcknowledgedListener, addOutboundIQListener, addOutboundMessageListener, addOutboundPresenceListener, addSendFailedListener, addSendSucceededListener, addSessionStatusListener, close, connect, createMarshaller, createUnmarshaller, disableFeature, disableFeature, enableFeature, enableFeature, getActiveConnection, getConfiguration, getConnections, getDebugger, getDomain, getEnabledFeatures, getManager, getStatus, getUnacknowledgedStanzas, isAuthenticated, isConnected, isSupported, markAcknowledged, query, query, query, removeConnectionListener, removeCreationListener, removeInboundIQListener, removeInboundMessageListener, removeInboundPresenceListener, removeIQHandler, removeMessageAcknowledgedListener, removeOutboundIQListener, removeOutboundMessageListener, removeOutboundPresenceListener, removeSendFailedListener, removeSendSucceededListener, removeSessionStatusListener, send, sendAndAwaitMessage, sendAndAwaitPresence, sendIQ, sendMessage, sendPresence

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static ExternalComponent create(java.lang.String componentName,
                                       java.lang.String sharedSecret,
                                       java.lang.String hostname,
                                       int port)

Creates a new external component using a default configuration. Any registered creation listeners are triggered.

Parameters:

componentName - The component name.

sharedSecret - The shared secret (password).

hostname - The hostname to connect to.

port - The port to connect to.

Returns:

The external component.

create

public static ExternalComponent create(java.lang.String componentName,
                                       java.lang.String sharedSecret,
                                       XmppSessionConfiguration configuration,
                                       java.lang.String hostname,
                                       int port)

Creates a new external component. Any registered creation listeners are triggered.

Parameters:

componentName - The component name.

sharedSecret - The shared secret (password).

configuration - The configuration.

hostname - The hostname to connect to.

port - The port to connect to.

Returns:

The external component.

create

public static ExternalComponent create(java.lang.String componentName,
                                       java.lang.String sharedSecret,
                                       XmppSessionConfiguration xmppSessionConfiguration,
                                       ClientConnectionConfiguration connectionConfiguration)

Creates a new external component using a default configuration. Any registered creation listeners are triggered.

Parameters:

componentName - The component name.

sharedSecret - The shared secret (password).

xmppSessionConfiguration - The XMPP configuration.

connectionConfiguration - The connection configuration.

Returns:

The external component.

connect

public final void connect(Jid from)
                   throws XmppException

Specified by:

connect in class XmppSession

Throws:

XmppException

handleElement

public final boolean handleElement(java.lang.Object element)
                            throws XmppException

Description copied from class: XmppSession

Handles an XMPP element.

This method should be called on the reader thread.

Specified by:

handleElement in interface StreamHandler

Overrides:

handleElement in class XmppSession

Parameters:

element - The XMPP element.

Returns:

True, if the stream needs to be restarted; otherwise false.

Throws:

StreamErrorException - If the element is a stream error.

StreamNegotiationException - If any exception occurred during stream feature negotiation.

XmppException - If any other XMPP exception occurs.

notifyException

public final void notifyException(java.lang.Throwable e)

Description copied from class: XmppSession

Called if any unhandled exception is thrown during reading or writing.

This method will close the stream.

Overrides:

notifyException in class XmppSession

Parameters:

e - The exception. If an unrecoverable XMPP stream error occurred, the exception is a StreamError.

getConnectedResource

public final Jid getConnectedResource()

Description copied from class: XmppSession

The connected resource, which is assigned by the server.

Specified by:

getConnectedResource in class XmppSession

Returns:

The connected resource.