ConfigKey (jolokia-core 1.3.3 API)

java.lang.Object
- java.lang.Enum<ConfigKey>
- - org.jolokia.config.ConfigKey

All Implemented Interfaces:

Serializable, Comparable<ConfigKey>
```
public enum ConfigKey
extends Enum<ConfigKey>
```
Enumeration defining the various configuration constant names which can be used to configure the agent globally (e.g. in web.xml) or as processing parameters (e.g. as query params).

Since:

Jan 1, 2010

Author:

roland

Enum Constant Summary

Enum Constants
Enum Constant and Description
`AGENT_CONTEXT` Context used for agent, used e.g.
`AGENT_DESCRIPTION` A description which can be used to describe the agent further.
`AGENT_ID` The ID to uniquely identify this agent within a JVM.
`AGENT_TYPE` The agent type holds the information which kind of agent (war,jvm,osgi,mule) is in use.
`ALLOW_DNS_REVERSE_LOOKUP` Whether a reverse DNS lookup is allowed or not.
`ALLOW_ERROR_DETAILS` Whether expose extended error information like stacktraces or serialized exception at all.
`AUTH_CLASS` Custom authenticator to be used instead of default user/password one (JVM agent)
`AUTH_IGNORE_CERTS` Whether to ignore CERTS when doing a dispatching authentication (authMode == delegate)
`AUTH_MODE` What authentication to use.
`AUTH_PRINCIPAL_SPEC` Extractor specification for getting the principal (authMode == delegate)
`AUTH_URL` URL used for a dispatcher authentication (authMode == delegate)
`CALLBACK` Option which can be given to a request to specify a JSONP callback.
`CANONICAL_NAMING` Whether property keys of ObjectNames should be ordered in the canonical way or in the way that they are created.
`DEBUG` Whether debug is switched on or not
`DEBUG_MAX_ENTRIES` Maximum number of debug entries to hold
`DETECTOR_OPTIONS` Extra options passed to a server handle after it has been detected.
`DISCOVERY_AGENT_URL` Specify the agent URL to return for an discovery multicast request.
`DISCOVERY_ENABLED` Whether to enable listening and responding to discovery multicast requests for discovering agent details.
`DISPATCHER_CLASSES` Request Dispatcher to use in addition to the local dispatcher.
`HISTORY_MAX_ENTRIES` Maximum number of history entries to keep
`HTTP_SERVICE_FILTER` By default, the OSGi Agent will bind to all HttpService implementations.
`IF_MODIFIED_SINCE` For LIST requests, this option can be used to return the result only if they set of registered MBeans has been changed since the timestamp given in this option.
`IGNORE_ERRORS` Runtime configuration (i.e.
`INCLUDE_STACKTRACE` Whether to include a stack trace in the response when an error occurs.
`LISTEN_FOR_HTTP_SERVICE` By default, the OSGi Agent listens for an OSGi HttpService to which it will register an agent servlet.
`LOGHANDLER_CLASS` Log handler class to use, which must have an empty constructor.
`MAX_COLLECTION_SIZE` Maximum size of collections returned during serialization.
`MAX_DEPTH` Maximum traversal depth for serialization of complex objects.
`MAX_OBJECTS` Maximum number of objects returned by serialization
`MBEAN_PLUGIN_OPTIONS` Extra options which are passed to `MBeanPlugin`.
`MBEAN_QUALIFIER` Optional domain name for registering own MBeans
`MIME_TYPE` Mime Type to use for the response value.
`PASSWORD` Password for authentication purposes.
`POLICY_LOCATION` Init parameter for the location of the policy file.
`REALM` The security realm used for login
`RESTRICTOR_CLASS` Custom restrictor to be used instead of default one
`SERIALIZE_EXCEPTION` Whether to include a JSON serialized version of the exception.
`USE_RESTRICTOR_SERVICE` For OSGi, if set to true, the agent uses a restrictor service when it kicks in, but denies access otherwise.
`USER` User for authentication purposes.

Field Summary

Fields
Modifier and Type Field and Description

static String JAAS_SUBJECT_REQUEST_ATTRIBUTE
JAAS Subject to attach to an HTTP request as attribute if JAAS based authentication is in use.

Fields
Modifier and Type	Field and Description
`static String`	`JAAS_SUBJECT_REQUEST_ATTRIBUTE` JAAS Subject to attach to an HTTP request as attribute if JAAS based authentication is in use.

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`getDefaultValue()` Get the default value
`static ConfigKey`	`getGlobalConfigKey(String pKeyS)` Get the configuration key for a global configuration
`String`	`getKeyValue()` Get the string value of a key
`static ConfigKey`	`getRequestConfigKey(String pKeyS)` Get the configuration key for a request configuration
`boolean`	`isGlobalConfig()` Whether this key is a global configuration key
`boolean`	`isRequestConfig()` Whether this key is a request configuration key
`String`	`toString()`
`static ConfigKey`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static ConfigKey[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - HISTORY_MAX_ENTRIES
```
public static final ConfigKey HISTORY_MAX_ENTRIES
```
    Maximum number of history entries to keep
  - DEBUG
```
public static final ConfigKey DEBUG
```
    Whether debug is switched on or not
  - DEBUG_MAX_ENTRIES
```
public static final ConfigKey DEBUG_MAX_ENTRIES
```
    Maximum number of debug entries to hold
  - DISPATCHER_CLASSES
```
public static final ConfigKey DISPATCHER_CLASSES
```
    Request Dispatcher to use in addition to the local dispatcher.
  - LOGHANDLER_CLASS
```
public static final ConfigKey LOGHANDLER_CLASS
```
    Log handler class to use, which must have an empty constructor. If not set, then a default logging mechanism is used.
  - MAX_DEPTH
```
public static final ConfigKey MAX_DEPTH
```
    Maximum traversal depth for serialization of complex objects.
  - MAX_COLLECTION_SIZE
```
public static final ConfigKey MAX_COLLECTION_SIZE
```
    Maximum size of collections returned during serialization. If larger, the collection is truncated
  - MAX_OBJECTS
```
public static final ConfigKey MAX_OBJECTS
```
    Maximum number of objects returned by serialization
  - RESTRICTOR_CLASS
```
public static final ConfigKey RESTRICTOR_CLASS
```
    Custom restrictor to be used instead of default one
  - POLICY_LOCATION
```
public static final ConfigKey POLICY_LOCATION
```
    Init parameter for the location of the policy file. This should be an URL pointing to the policy file. If this URL uses a scheme classpath then do a class lookup. The URL given can contain also placeholders which gets replaced:
    - $host or ${host} : Host name (if possible), otherwise address
    - $ip or ${ip} : IP Address
    - ${prop:foo} : System property foo
    - ${env:FOO} : Environment variable FOO
  - ALLOW_DNS_REVERSE_LOOKUP
```
public static final ConfigKey ALLOW_DNS_REVERSE_LOOKUP
```
    Whether a reverse DNS lookup is allowed or not. Reverse DNS lookups might happen for checking host based restrictions, but might be costly.
  - IGNORE_ERRORS
```
public static final ConfigKey IGNORE_ERRORS
```
    Runtime configuration (i.e. must come in with a request) for ignoring errors during JMX operations and JSON serialization. This works only for certain operations like pattern reads.
  - INCLUDE_STACKTRACE
```
public static final ConfigKey INCLUDE_STACKTRACE
```
    Whether to include a stack trace in the response when an error occurs. The allowed values are "true" for inclusion, "false" if no stacktrace should be included or "runtime" if only RuntimeExceptions should be included. Default is "true"
  - SERIALIZE_EXCEPTION
```
public static final ConfigKey SERIALIZE_EXCEPTION
```
    Whether to include a JSON serialized version of the exception. If set to "true", the exception is added under the key "error_value" in the response. Default is false.
  - ALLOW_ERROR_DETAILS
```
public static final ConfigKey ALLOW_ERROR_DETAILS
```
    Whether expose extended error information like stacktraces or serialized exception at all. INCLUDE_STACKTRACE and SERIALIZE_EXCEPTION take effect only when ALLOW_ERROR_DETAILS is set to true. This could be set to false to avoid exposure of internal data.
  - CANONICAL_NAMING
```
public static final ConfigKey CANONICAL_NAMING
```
    Whether property keys of ObjectNames should be ordered in the canonical way or in the way that they are created. The allowed values are either "true" in which case the canonical key order (== alphabetical sorted) is used or "false" for getting the keys as registered. Default is "true"
  - MBEAN_QUALIFIER
```
public static final ConfigKey MBEAN_QUALIFIER
```
    Optional domain name for registering own MBeans
  - CALLBACK
```
public static final ConfigKey CALLBACK
```
    Option which can be given to a request to specify a JSONP callback. The generated answer will be of type text/javascript and it will contain a Javascript function to be called.
  - MIME_TYPE
```
public static final ConfigKey MIME_TYPE
```
    Mime Type to use for the response value. By default, this is text/plain, but it could be useful to return application/json, too. A request parameter overrides a global configuration.
  - IF_MODIFIED_SINCE
```
public static final ConfigKey IF_MODIFIED_SINCE
```
    For LIST requests, this option can be used to return the result only if they set of registered MBeans has been changed since the timestamp given in this option. The timestamp has to be given in seconds since 1.1.1970 (epoch time).
  - DISCOVERY_ENABLED
```
public static final ConfigKey DISCOVERY_ENABLED
```
    Whether to enable listening and responding to discovery multicast requests for discovering agent details.
  - DISCOVERY_AGENT_URL
```
public static final ConfigKey DISCOVERY_AGENT_URL
```
    Specify the agent URL to return for an discovery multicast request. If this option is given DISCOVERY_ENABLED is set to true automatically. The URL given can contain placeholders:
    - $host or ${host} : Host name (if possible), otherwise address
    - $ip or ${ip} : IP Address
    - ${prop:foo} : System property foo
    - ${env:FOO} : Environment variable FOO
  - USER
```
public static final ConfigKey USER
```
    User for authentication purposes. Used by OSGi and JDK agent.
  - PASSWORD
```
public static final ConfigKey PASSWORD
```
    Password for authentication purposes. Used by OSGi and JDK agent
  - REALM
```
public static final ConfigKey REALM
```
    The security realm used for login
  - AUTH_MODE
```
public static final ConfigKey AUTH_MODE
```
    What authentication to use. Support values: "basic" for basic authentication, "jaas" for JaaS authentication.
  - AUTH_CLASS
```
public static final ConfigKey AUTH_CLASS
```
    Custom authenticator to be used instead of default user/password one (JVM agent)
  - AUTH_URL
```
public static final ConfigKey AUTH_URL
```
    URL used for a dispatcher authentication (authMode == delegate)
  - AUTH_PRINCIPAL_SPEC
```
public static final ConfigKey AUTH_PRINCIPAL_SPEC
```
    Extractor specification for getting the principal (authMode == delegate)
  - AUTH_IGNORE_CERTS
```
public static final ConfigKey AUTH_IGNORE_CERTS
```
    Whether to ignore CERTS when doing a dispatching authentication (authMode == delegate)
  - AGENT_CONTEXT
```
public static final ConfigKey AGENT_CONTEXT
```
    Context used for agent, used e.g. in the OSGi activator (but not for the servlet, this is done in web.xml)
  - USE_RESTRICTOR_SERVICE
```
public static final ConfigKey USE_RESTRICTOR_SERVICE
```
    For OSGi, if set to true, the agent uses a restrictor service when it kicks in, but denies access otherwise.
  - LISTEN_FOR_HTTP_SERVICE
```
public static final ConfigKey LISTEN_FOR_HTTP_SERVICE
```
    By default, the OSGi Agent listens for an OSGi HttpService to which it will register an agent servlet. Set this to false if you want to instantiate the servlet on your own (either declaratively within another war or programmatically)
  - HTTP_SERVICE_FILTER
```
public static final ConfigKey HTTP_SERVICE_FILTER
```
    By default, the OSGi Agent will bind to all HttpService implementations. Set this to control which of the implementations of HttpService are bound to.
    The syntax is that of the standard OSGi Filter.
```
     (VirtualServer=__asadmin)  - Glassfish 3+ administration server
 
```
    Note this will be combined with the objectClass filter for HttpService with the and (&) operator.
  - DETECTOR_OPTIONS
```
public static final ConfigKey DETECTOR_OPTIONS
```
    Extra options passed to a server handle after it has been detected. The value must be a JSON object with the product name as key and another JSON object as value containing the specific handle configuration. E.g.
```
     {
         "glassfish" : { "bootAmx" : true},
         "jboss" : { "disableWorkaround" : true}
     }
 
```
  - MBEAN_PLUGIN_OPTIONS
```
public static final ConfigKey MBEAN_PLUGIN_OPTIONS
```
    Extra options which are passed to MBeanPlugin. As for DETECTOR_OPTIONS, the value must be a JSON object in string representation where the keys are MBean plugin ids and the values are JSON objects whith the plugin specific configuration.
  - AGENT_ID
```
public static final ConfigKey AGENT_ID
```
    The ID to uniquely identify this agent within a JVM. There can be multiple agents registered a JVM. This id is e.g. used to uniquely create MBean names.
  - AGENT_TYPE
```
public static final ConfigKey AGENT_TYPE
```
    The agent type holds the information which kind of agent (war,jvm,osgi,mule) is in use. This configuration cannot be set from the outside but is written by the agent itself
  - AGENT_DESCRIPTION
```
public static final ConfigKey AGENT_DESCRIPTION
```
    A description which can be used to describe the agent further. Typically this can be used by clients to provide additional information to the user.
- Field Detail
  - JAAS_SUBJECT_REQUEST_ATTRIBUTE
```
public static final String JAAS_SUBJECT_REQUEST_ATTRIBUTE
```
    JAAS Subject to attach to an HTTP request as attribute if JAAS based authentication is in use. This constant can only be used programtically
    
    See Also:
    Constant Field Values
- Method Detail
  - values
```
public static ConfigKey[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (ConfigKey c : ConfigKey.values())
    System.out.println(c);
```
    Returns:
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static ConfigKey valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    name - the name of the enum constant to be returned.
    
    Returns:
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Enum<ConfigKey>
  - getGlobalConfigKey
```
public static ConfigKey getGlobalConfigKey(String pKeyS)
```
    Get the configuration key for a global configuration
    
    Parameters:
    pKeyS - the key to lookup
    
    Returns:
    the key or null if the key is not known or is not a global key
  - getRequestConfigKey
```
public static ConfigKey getRequestConfigKey(String pKeyS)
```
    Get the configuration key for a request configuration
    
    Parameters:
    pKeyS - the key to lookup
    
    Returns:
    the key or null if the key is not known or is not a request key
  - getKeyValue
```
public String getKeyValue()
```
    Get the string value of a key
    
    Returns:
    string value of a key
  - getDefaultValue
```
public String getDefaultValue()
```
    Get the default value
    
    Returns:
    the default value of a key
  - isGlobalConfig
```
public boolean isGlobalConfig()
```
    Whether this key is a global configuration key
    
    Returns:
    true if this is a global configuration key
  - isRequestConfig
```
public boolean isRequestConfig()
```
    Whether this key is a request configuration key
    
    Returns:
    true if this is a request configuration key

Enum ConfigKey

Enum Constant Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

HISTORY_MAX_ENTRIES

DEBUG

DEBUG_MAX_ENTRIES

DISPATCHER_CLASSES

LOGHANDLER_CLASS

MAX_DEPTH

MAX_COLLECTION_SIZE

MAX_OBJECTS

RESTRICTOR_CLASS

POLICY_LOCATION

ALLOW_DNS_REVERSE_LOOKUP

IGNORE_ERRORS

INCLUDE_STACKTRACE

SERIALIZE_EXCEPTION

ALLOW_ERROR_DETAILS

CANONICAL_NAMING

MBEAN_QUALIFIER

CALLBACK

MIME_TYPE

IF_MODIFIED_SINCE

DISCOVERY_ENABLED

DISCOVERY_AGENT_URL

USER

PASSWORD

REALM

AUTH_MODE

AUTH_CLASS

AUTH_URL

AUTH_PRINCIPAL_SPEC

AUTH_IGNORE_CERTS

AGENT_CONTEXT

USE_RESTRICTOR_SERVICE

LISTEN_FOR_HTTP_SERVICE

HTTP_SERVICE_FILTER

DETECTOR_OPTIONS

MBEAN_PLUGIN_OPTIONS

AGENT_ID

AGENT_TYPE

AGENT_DESCRIPTION

Field Detail

JAAS_SUBJECT_REQUEST_ATTRIBUTE

Method Detail

values

valueOf

toString

getGlobalConfigKey

getRequestConfigKey

getKeyValue

getDefaultValue

isGlobalConfig

isRequestConfig