rocks.xmpp.extensions.httpbind

Class BoshConnection

java.lang.Object

rocks.xmpp.core.net.AbstractConnection

rocks.xmpp.extensions.httpbind.BoshConnection

All Implemented Interfaces:

java.lang.AutoCloseable, Connection

public final class BoshConnection
extends AbstractConnection

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
java.util.concurrent.CompletionStage<java.lang.Void>	closeFuture()
long	detach() Detaches this BOSH session without closing (aka terminating) it.
void	flush()
java.net.InetSocketAddress	getRemoteAddress()
java.lang.String	getRoute() Gets the route.
java.lang.String	getSessionId() Gets the session id of this BOSH connection.
boolean	isSecure()
boolean	isUsingAcknowledgements()
java.util.concurrent.CompletionStage<java.lang.Void>	open(SessionOpen sessionOpen)
java.util.concurrent.CompletableFuture<java.lang.Void>	send(StreamElement element)
java.lang.String	toString()
java.util.concurrent.CompletableFuture<java.lang.Void>	write(StreamElement streamElement)

Methods inherited from class rocks.xmpp.core.net.AbstractConnection

close, closeAsync, closeAsync, getConfiguration, getStreamId

Methods inherited from class java.lang.Object

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

Method Detail

open

public final java.util.concurrent.CompletionStage<java.lang.Void> open(SessionOpen sessionOpen)

isSecure

public final boolean isSecure()

closeFuture

public final java.util.concurrent.CompletionStage<java.lang.Void> closeFuture()

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 java.util.concurrent.CompletableFuture<java.lang.Void> send(StreamElement element)

write

public final java.util.concurrent.CompletableFuture<java.lang.Void> write(StreamElement streamElement)

flush

public final void flush()

getSessionId

public final java.lang.String getSessionId()

Gets the session id of this BOSH connection.

Returns:

The session id.

getRemoteAddress

public final java.net.InetSocketAddress getRemoteAddress()

isUsingAcknowledgements

public final boolean isUsingAcknowledgements()

Specified by:

isUsingAcknowledgements in interface Connection

Overrides:

isUsingAcknowledgements in class AbstractConnection

getRoute

public final java.lang.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 java.lang.String toString()

Overrides:

toString in class java.lang.Object