Package org.apache.guacamole.environment

Class DelegatingEnvironment

java.lang.Object
org.apache.guacamole.environment.DelegatingEnvironment
All Implemented Interfaces:
Environment
public class DelegatingEnvironment extends Object implements Environment
Environment implementation which simply delegates all function calls to a wrapped Environment instance.

  • Constructor Details

    • DelegatingEnvironment

      public DelegatingEnvironment(Environment environment)
      Creates a new DelegatingEnvironment which delegates all function calls to the given Environment.
      Parameters:
      environment - The Environment that all function calls should be delegated to.

  • Method Details

    • getGuacamoleHome

      public File getGuacamoleHome()
      Description copied from interface: Environment
      Returns the Guacamole home directory as determined when this Environment object was created. The Guacamole home directory is found by checking, in order: the guacamole.home system property, the GUACAMOLE_HOME environment variable, and finally the .guacamole directory in the home directory of the user running the servlet container.
      Specified by:
      getGuacamoleHome in interface Environment
      Returns:
      The File representing the Guacamole home directory, which may or may not exist, and may turn out to not be a directory.

    • getProtocols

      public Map<String,ProtocolInfo> getProtocols()
      Description copied from interface: Environment
      Returns a map of all available protocols, where each key is the name of that protocol as would be passed to guacd during connection.
      Specified by:
      getProtocols in interface Environment
      Returns:
      A map of all available protocols.

    • getProtocol

      public ProtocolInfo getProtocol(String name)
      Description copied from interface: Environment
      Returns the protocol having the given name. The name must be the protocol name as would be passed to guacd during connection.
      Specified by:
      getProtocol in interface Environment
      Parameters:
      name - The name of the protocol.
      Returns:
      The protocol having the given name, or null if no such protocol is registered.

    • getProperty

      public <Type> Type getProperty(GuacamoleProperty<Type> property) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns the value set for that property in guacamole.properties, if any.
      Specified by:
      getProperty in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      Returns:
      The parsed value of the property as read from guacamole.properties.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties.

    • getProperty

      public <Type> Type getProperty(GuacamoleProperty<Type> property, Type defaultValue) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns the value set for that property in guacamole.properties, if any. If no value is found, the provided default value is returned.
      Specified by:
      getProperty in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      defaultValue - The value to return if no value was given in guacamole.properties.
      Returns:
      The parsed value of the property as read from guacamole.properties, or the provided default value if no value was found.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties.

    • getPropertyCollection

      public <Type> Collection<Type> getPropertyCollection(GuacamoleProperty<Type> property) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns a sorted Collection of the value set for that property in guacamole.properties, if any. The implementation of parsing and returning a collection of multiple values is up to the individual property implementations, and not all implementations will support reading and returning multiple values.
      Specified by:
      getPropertyCollection in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      Returns:
      A sorted collection of the the parsed values of the property as read from guacamole.properties.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties.

    • getPropertyCollection

      public <Type> Collection<Type> getPropertyCollection(GuacamoleProperty<Type> property, Type defaultValue) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns the value set for that property in guacamole.properties, if any. If no value is found, a Collection is returned with the provided default value. The implementation of parsing and returning a collection of multiple values is up to the individual property implementations, and not all implementations will support reading and returning multiple values.
      Specified by:
      getPropertyCollection in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      defaultValue - The single value to return in the Collection if no value was given in guacamole.properties.
      Returns:
      A sorted collection of the the parsed values of the property as read from guacamole.properties, or a Collection with the single default value provided.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties.

    • getPropertyCollection

      public <Type> Collection<Type> getPropertyCollection(GuacamoleProperty<Type> property, Collection<Type> defaultValue) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns the value set for that property in guacamole.properties, if any. If no value is found, the provided Collection of default values is returned. The implementation of parsing and returning a collection of multiple values is up to the individual property implementations, and not all implementations will support reading and returning multiple values.
      Specified by:
      getPropertyCollection in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      defaultValue - The Collection of values to return in the Collection if no value was given in guacamole.properties.
      Returns:
      A sorted collection of the the parsed values of the property as read from guacamole.properties, or a Collection with the single default value provided.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties.

    • getRequiredProperty

      public <Type> Type getRequiredProperty(GuacamoleProperty<Type> property) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns the value set for that property in guacamole.properties. An exception is thrown if the value is not provided.
      Specified by:
      getRequiredProperty in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      Returns:
      The parsed value of the property as read from guacamole.properties.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties, or if the property is not specified.

    • getRequiredPropertyCollection

      public <Type> Collection<Type> getRequiredPropertyCollection(GuacamoleProperty<Type> property) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Given a GuacamoleProperty, parses and returns a sorted Collection of values for that property in guacamole.properties. An exception is thrown if the value is not provided. The implementation of parsing and returning a collection of multiple values is up to the individual property implementations, and not all implementations will support reading and returning multiple values.
      Specified by:
      getRequiredPropertyCollection in interface Environment
      Type Parameters:
      Type - The type that the given property is parsed into.
      Parameters:
      property - The property to read from guacamole.properties.
      Returns:
      A sorted Collection of the property as read from guacamole.properties.
      Throws:
      org.apache.guacamole.GuacamoleException - If an error occurs while parsing the value for the given property in guacamole.properties, or if the property is not specified.

    • getDefaultGuacamoleProxyConfiguration

      public GuacamoleProxyConfiguration getDefaultGuacamoleProxyConfiguration() throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Returns the connection information which should be used, by default, to connect to guacd when establishing a remote desktop connection.
      Specified by:
      getDefaultGuacamoleProxyConfiguration in interface Environment
      Returns:
      The connection information which should be used, by default, to connect to guacd.
      Throws:
      org.apache.guacamole.GuacamoleException - If the connection information for guacd cannot be retrieved.

    • addGuacamoleProperties

      public void addGuacamoleProperties(GuacamoleProperties properties) throws org.apache.guacamole.GuacamoleException
      Description copied from interface: Environment
      Adds another possible source of Guacamole configuration properties to this Environment. Properties not already defined by other sources of Guacamole configuration properties will alternatively be read from the given GuacamoleProperties.
      Specified by:
      addGuacamoleProperties in interface Environment
      Parameters:
      properties - The GuacamoleProperties to add to this Environment.
      Throws:
      org.apache.guacamole.GuacamoleException - If the given GuacamoleProperties cannot be added, or if this Environment does not support this operation.

    • getCaseSensitivity

      public CaseSensitivity getCaseSensitivity()
      Description copied from interface: Environment
      Returns the case sensitivity configuration for Guacamole as defined in guacamole.properties, or the default of enabling case sensitivity for both usernames and group names.
      Specified by:
      getCaseSensitivity in interface Environment
      Returns:
      The case sensitivity setting as configured in guacamole.properties, or the default of enabling case sensitivity.