Class HttpSession.HttpVirtualConnection
- java.lang.Object
-
- org.jivesoftware.openfire.net.VirtualConnection
-
- org.jivesoftware.openfire.http.HttpSession.HttpVirtualConnection
-
- All Implemented Interfaces:
Closeable,AutoCloseable,Connection
- Enclosing class:
- HttpSession
public static class HttpSession.HttpVirtualConnection extends VirtualConnection
A virtual server connection relates to a http session which its self can relate to many http connections.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.jivesoftware.openfire.Connection
Connection.ClientAuth, Connection.CompressionPolicy, Connection.State, Connection.TLSPolicy
-
-
Field Summary
-
Fields inherited from class org.jivesoftware.openfire.net.VirtualConnection
session
-
-
Constructor Summary
Constructors Constructor Description HttpVirtualConnection(InetAddress address)HttpVirtualConnection(InetAddress address, ConnectionType connectionType)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidcloseVirtualConnection()Closes the virtual connection.voiddeliver(org.xmpp.packet.Packet packet)Delivers the packet to this connection without checking the recipient.voiddeliverRawText(String text)Delivers raw text to this connection.byte[]getAddress()Returns the raw IP address of thisInetAddressobject.ConnectionConfigurationgetConfiguration()Returns a representation of the desired state for this connection.StringgetHostAddress()Returns the IP address string in textual presentation.StringgetHostName()Gets the host name for this IP address.Certificate[]getPeerCertificates()Returns the underlyingX509Certificatefor the connection of the peer.voidsystemShutdown()Notification message indicating that the server is being shutdown.-
Methods inherited from class org.jivesoftware.openfire.net.VirtualConnection
addCompression, close, getCompressionPolicy, getLocalCertificates, getMajorXMPPVersion, getMinorXMPPVersion, getPacketDeliverer, getTlsPolicy, init, isClosed, isCompressed, isFlashClient, isSecure, isUsingSelfSignedCertificate, registerCloseListener, reinit, removeCloseListener, setCompressionPolicy, setFlashClient, setTlsPolicy, setUsingSelfSignedCertificate, setXMPPVersion, startCompression, startTLS, validate
-
-
-
-
Constructor Detail
-
HttpVirtualConnection
public HttpVirtualConnection(InetAddress address)
-
HttpVirtualConnection
public HttpVirtualConnection(InetAddress address, ConnectionType connectionType)
-
-
Method Detail
-
closeVirtualConnection
public void closeVirtualConnection()
Description copied from class:VirtualConnectionCloses the virtual connection. Subsclasses should indicate what closing a virtual connection means. At this point the session has a CLOSED state.- Specified by:
closeVirtualConnectionin classVirtualConnection
-
getAddress
public byte[] getAddress() throws UnknownHostExceptionDescription copied from interface:ConnectionReturns the raw IP address of thisInetAddressobject. The result is in network byte order: the highest order byte of the address is ingetAddress()[0].- Returns:
- the raw IP address of this object.
- Throws:
UnknownHostException- if IP address of host could not be determined.
-
getHostAddress
public String getHostAddress() throws UnknownHostException
Description copied from interface:ConnectionReturns the IP address string in textual presentation.- Returns:
- the raw IP address in a string format.
- Throws:
UnknownHostException- if IP address of host could not be determined.
-
getHostName
public String getHostName() throws UnknownHostException
Description copied from interface:ConnectionGets the host name for this IP address.If this InetAddress was created with a host name, this host name will be remembered and returned; otherwise, a reverse name lookup will be performed and the result will be returned based on the system configured name lookup service. If a lookup of the name service is required, call
getCanonicalHostName.If there is a security manager, its
checkConnectmethod is first called with the hostname and-1as its arguments to see if the operation is allowed. If the operation is not allowed, it will return the textual representation of the IP address.- Returns:
- the host name for this IP address, or if the operation is not allowed by the security check, the textual representation of the IP address.
- Throws:
UnknownHostException- if IP address of host could not be determined.- See Also:
InetAddress.getCanonicalHostName(),SecurityManager.checkConnect(java.lang.String, int)
-
systemShutdown
public void systemShutdown()
Description copied from interface:ConnectionNotification message indicating that the server is being shutdown. Implementors should send a stream error whose condition is system-shutdown before closing the connection.
-
deliver
public void deliver(org.xmpp.packet.Packet packet) throws UnauthorizedExceptionDescription copied from interface:ConnectionDelivers the packet to this connection without checking the recipient. The method essentially callssocket.send(packet.getWriteBuffer()). Use with caution! This code is unlikely to be called directly. Instead, ensure that data sent to the entities is sent through the appropriate LocalSession object. For clients, this prevents, for example, synchronisation issues with stanza counts related to Stream Management (XEP-0198).- Parameters:
packet- the packet to deliver.- Throws:
UnauthorizedException- if a permission error was detected.
-
deliverRawText
public void deliverRawText(String text)
Description copied from interface:ConnectionDelivers raw text to this connection. This is a very low level way for sending XML stanzas to the client. This method should not be used unless you have very good reasons for not usingConnection.deliver(org.xmpp.packet.Packet).This method avoids having to get the writer of this connection and mess directly with the writer. Therefore, this method ensures a correct delivery of the stanza even if other threads were sending data concurrently.
- Parameters:
text- the XML stanzas represented kept in a String.
-
getConfiguration
public ConnectionConfiguration getConfiguration()
Description copied from interface:ConnectionReturns a representation of the desired state for this connection. Note that this is different from the current state of the connection. For example, TLS can be required by configuration, but while the connection has yet to be fully initialized, the current state might not be TLS-encrypted.- Returns:
- The desired configuration for the connection (never null).
-
getPeerCertificates
public Certificate[] getPeerCertificates()
Description copied from interface:ConnectionReturns the underlyingX509Certificatefor the connection of the peer.- Specified by:
getPeerCertificatesin interfaceConnection- Overrides:
getPeerCertificatesin classVirtualConnection- Returns:
- an ordered array of peer certificates, with the peer's own certificate first followed by any certificate authorities.
-
-