org.apache.guacamole.net.auth

Interface ActiveConnection

All Superinterfaces:

Identifiable, Shareable<SharingProfile>

All Known Implementing Classes:

AbstractActiveConnection

public interface ActiveConnection
extends Identifiable, Shareable<SharingProfile>

A pairing of username and GuacamoleTunnel representing an active usage of a particular connection.

Method Summary

Modifier and Type	Method and Description
String	getConnectionIdentifier() Returns the identifier of the connection being actively used.
String	getRemoteHost() Returns the hostname or IP address of the remote host that initiated the connection, if known.
String	getSharingProfileIdentifier() Returns the identifier of the sharing profile being actively used.
Date	getStartDate() Returns the date and time the connection began.
org.apache.guacamole.net.GuacamoleTunnel	getTunnel() Returns the connected GuacamoleTunnel being used.
String	getUsername() Returns the name of the user who is using this connection.
void	setConnectionIdentifier(String connnectionIdentifier) Sets the identifier of the connection being actively used.
void	setRemoteHost(String remoteHost) Sets the hostname or IP address of the remote host that initiated the connection.
void	setSharingProfileIdentifier(String sharingProfileIdentifier) Sets the identifier of the sharing profile being actively used.
void	setStartDate(Date startDate) Sets the date and time the connection began.
void	setTunnel(org.apache.guacamole.net.GuacamoleTunnel tunnel) Sets the connected GuacamoleTunnel being used.
void	setUsername(String username) Sets the name of the user who is using this connection.

Methods inherited from interface org.apache.guacamole.net.auth.Identifiable

getIdentifier, setIdentifier

Methods inherited from interface org.apache.guacamole.net.auth.Shareable

getSharingCredentials

Method Detail

getConnectionIdentifier

String getConnectionIdentifier()

Returns the identifier of the connection being actively used. Unlike the other information stored in this object, the connection identifier must be present and MAY NOT be null.

Returns:

The identifier of the connection being actively used.

setConnectionIdentifier

void setConnectionIdentifier(String connnectionIdentifier)

Sets the identifier of the connection being actively used.

Parameters:

connnectionIdentifier - The identifier of the connection being actively used.

getSharingProfileIdentifier

String getSharingProfileIdentifier()

Returns the identifier of the sharing profile being actively used. If the connection is being accessed directly, this will be null.

Returns:

The identifier of the sharing profile being actively used.

setSharingProfileIdentifier

void setSharingProfileIdentifier(String sharingProfileIdentifier)

Sets the identifier of the sharing profile being actively used.

Parameters:

sharingProfileIdentifier - The identifier of the sharing profile being actively used.

getStartDate

Date getStartDate()

Returns the date and time the connection began.

Returns:

The date and time the connection began, or null if this information is not available.

setStartDate

void setStartDate(Date startDate)

Sets the date and time the connection began.

Parameters:

startDate - The date and time the connection began, or null if this information is not available.

getRemoteHost

String getRemoteHost()

Returns the hostname or IP address of the remote host that initiated the connection, if known. If the hostname or IP address is not known, null is returned.

Returns:

The hostname or IP address of the remote host, or null if this information is not available.

setRemoteHost

void setRemoteHost(String remoteHost)

Sets the hostname or IP address of the remote host that initiated the connection.

Parameters:

remoteHost - The hostname or IP address of the remote host, or null if this information is not available.

getUsername

String getUsername()

Returns the name of the user who is using this connection.

Returns:

The name of the user who is using this connection, or null if this information is not available.

setUsername

void setUsername(String username)

Sets the name of the user who is using this connection.

Parameters:

username - The name of the user who is using this connection, or null if this information is not available.

getTunnel

org.apache.guacamole.net.GuacamoleTunnel getTunnel()

Returns the connected GuacamoleTunnel being used. This may be null if access to the underlying tunnel is denied.

Returns:

The connected GuacamoleTunnel, or null if permission is denied.

setTunnel

void setTunnel(org.apache.guacamole.net.GuacamoleTunnel tunnel)

Sets the connected GuacamoleTunnel being used.

Parameters:

tunnel - The connected GuacamoleTunnel, or null if permission is denied.