Top Description Constructors Methods
org.apache.tomcat.util.digester

public Class EnvironmentPropertySource

extends Object
implements SecurePropertySource
Class Inheritance
All Implemented Interfaces
org.apache.tomcat.util.IntrospectionUtils.SecurePropertySource, org.apache.tomcat.util.IntrospectionUtils.PropertySource
Imports
java.security.Permission, org.apache.tomcat.util.IntrospectionUtils, org.apache.tomcat.util.security.PermissionCheck
A org.apache.tomcat.util.IntrospectionUtils.SecurePropertySource that uses environment variables to resolve expressions.

Usage example:

Configure the certificate with environment variables. 
  <SSLHostConfig>
          <Certificate certificateKeyFile="${CERTIFICATE_KEY_FILE}"
                       certificateFile="${CERTIFICATE_FILE}"
                       certificateChainFile="${CERTIFICATE_CHAIN_FILE}"
                       type="RSA" />
    </SSLHostConfig>
How to configure: 
echo "org.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.util.digester.EnvironmentPropertySource" >> conf/catalina.properties
or add this to CATALINA_OPTS 
-Dorg.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.util.digester.EnvironmentPropertySource

Note

When configured the PropertySource for resolving expressions from system properties is still active.

See Also
Digester, Tomcat Configuration Reference System Properties

Constructor Summary

AccessConstructor and Description
public
EnvironmentPropertySource()

Method Summary

Modifier and TypeMethod and Description
public String
getProperty(String key)

Implements org.apache.tomcat.util.IntrospectionUtils.PropertySource.getProperty.

public String
getProperty(String
The key of the requested property
key, ClassLoader
The class loader associated with the code that trigger the property lookup
classLoader)

Implements org.apache.tomcat.util.IntrospectionUtils.SecurePropertySource.getProperty.

Obtain a property value, checking that code associated with the provided class loader has permission to access the property.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

EnvironmentPropertySourceback to summary
public EnvironmentPropertySource()

Method Detail

getPropertyback to summary
public String getProperty(String key)

Implements org.apache.tomcat.util.IntrospectionUtils.PropertySource.getProperty.

Annotations
@Override
getPropertyback to summary
public String getProperty(String key, ClassLoader classLoader)

Implements org.apache.tomcat.util.IntrospectionUtils.SecurePropertySource.getProperty.

Doc from org.apache.tomcat.util.IntrospectionUtils.SecurePropertySource.getProperty.

Obtain a property value, checking that code associated with the provided class loader has permission to access the property. If the classLoader is null or if classLoader does not implement PermissionCheck then the property value will be looked up without a call to PermissionCheck#check(java.security.Permission)

Parameters
key:String

The key of the requested property

classLoader:ClassLoader

The class loader associated with the code that trigger the property lookup

Returns:String

The property value or null if it could not be found or if PermissionCheck#check(java.security.Permission) fails

Annotations
@Override