rocks.xmpp.extensions.httpbind

Class BoshConnection

java.lang.Object

rocks.xmpp.core.session.Connection

rocks.xmpp.extensions.httpbind.BoshConnection

All Implemented Interfaces:

AutoCloseable

public final class BoshConnection
extends Connection

The implementation of XEP-0124: Bidirectional-streams Over Synchronous HTTP (BOSH) and XEP-0206: XMPP Over BOSH.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the session as described in Terminating the HTTP Session.
void	connect() Deprecated.
void	connect(Jid from) Connects to the BOSH server.
long	detach() Detaches this BOSH session without closing (aka terminating) it.
String	getRoute() Gets the route.
String	getSessionId() Gets the session id of this BOSH connection.
String	getStreamId() Gets the stream id of this connection.
boolean	isSecure() Indicates whether this connection is secured by TLS/SSL.
void	send(ClientStreamElement element) Sends an element.
String	toString()

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

getHostname, getPort, getProxy, getXmppSession, initialize

Methods inherited from class java.lang.Object

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

Method Detail

connect

@Deprecated
public final void connect()
                               throws IOException

Deprecated.

Description copied from class: Connection

Connects to the server.

Specified by:

connect in class Connection

Throws:

IOException - If no connection could be established, e.g. due to unknown host.

connect

public final void connect(Jid from)
                   throws IOException

Connects to the BOSH server.

Specified by:

connect in class Connection

Parameters:

from - The optional 'from' attribute in the initial BOSH session creation request.

Throws:

IOException - If a connection could not be established.

isSecure

public final boolean isSecure()

Description copied from class: Connection

Indicates whether this connection is secured by TLS/SSL.

Specified by:

isSecure in class Connection

Returns:

True, if this connection is secured.

close

public final void close()
                 throws Exception

Closes the session as described in Terminating the HTTP Session.

This method can be called from different threads:

1. The application thread.
2. The reader thread, which closes the BOSH session after seeing an error from the connection manager.
3. The writer thread.

Throws:

InterruptedException - If the current thread is interrupted.

Exception

detach

public final long detach()

Detaches this BOSH session without closing (aka terminating) it. This way the BOSH session is still alive on the server and can be ported over to a web page, but new BOSH requests are no longer sent by this connection.

Returns:

The current request ID (RID) which was used for the last BOSH request.

See Also:

https://conversejs.org/docs/html/#prebinding-and-single-session-support

send

public final void send(ClientStreamElement element)

Description copied from class: Connection

Sends an element.

Specified by:

send in class Connection

Parameters:

element - The element.

getSessionId

public final String getSessionId()

Gets the session id of this BOSH connection.

Returns:

The session id.

getStreamId

public final String getStreamId()

Description copied from class: Connection

Gets the stream id of this connection.

Specified by:

getStreamId in class Connection

Returns:

The stream id.

getRoute

public final String getRoute()

Gets the route.

A connection manager MAY be configured to enable sessions with more than one server in different domains. When requesting a session with such a "proxy" connection manager, a client SHOULD include a 'route' attribute that specifies the protocol, hostname, and port of the server with which it wants to communicate, formatted as "proto:host:port" (e.g., "xmpp:example.com:9999").

Returns:

The route.

toString

public final String toString()

Overrides:

toString in class Object