org.lsst.ccs.bootstrap.resources

Class BootstrapResourceUtils

java.lang.Object

org.lsst.ccs.bootstrap.resources.BootstrapResourceUtils

public abstract class BootstrapResourceUtils
extends Object

Utility methods for loading Bootstrap Resources.

The utility methods provided in this class are meant to be used throughout the CCS environment to load resources in the Bootstrap environment.

For a description on how to control the Bootstrap environment please refer to the following manual.

Author:

The LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
BootstrapResourceUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static Properties	getBootstrapProperties(String fileName, boolean includeSystem) Utility function to fetch Properties in the Bootstrap environment.
static Properties	getBootstrapProperties(String fileName, boolean includeSystem, Class clazz) Utility function to fetch Properties in the Bootstrap environment.
static Properties	getBootstrapProperties(String fileName, boolean includeSystem, ClassLoader classLoader) Utility function to fetch Properties in the Bootstrap environment.
static InputStream	getBootstrapPropertiesInputStream(String fileName, boolean includeSystem, Class clazz) Get an InputStream corresponding to the Bootstrap Properties object.
static InputStream	getBootstrapResource(String resourceName) Utility functions to look for resources (excluding Properties) in the Bootstrap environment.
static InputStream	getBootstrapResource(String resourceName, Class clazz) Utility functions to look for resources (excluding Properties) in the Bootstrap environment.
static InputStream	getBootstrapResource(String resourceName, ClassLoader classLoader) Utility functions to look for resources (excluding properties) in the Bootstrap environment.
static Properties	getBootstrapSystemProperties() Return the Bootstrap System Properties object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BootstrapResourceUtils

public BootstrapResourceUtils()

Method Detail

getBootstrapSystemProperties

public static Properties getBootstrapSystemProperties()

Return the Bootstrap System Properties object.

This function builds a Properties object by searching and chaining properties according to the following search criteria

• System Properties: System Properties are the first Properties to be added to the merge chain.
• Bootstrap Resources search : The Bootstrap Resources directories (defined by the environment variable CCS_RESOURCE_PATH) are searched in the reversed order. In each directory properties are merged by searching for application and global properties files (these files are loaded from the file system).
• Command line : Properties specified from the command line with the -D option are added to the top of the Properties chain.

Returns:

The merged Properties object.

getBootstrapProperties

public static Properties getBootstrapProperties(String fileName,
                                boolean includeSystem,
                                Class clazz)

Utility function to fetch Properties in the Bootstrap environment.

This function builds a Properties object by searching and chaining properties according to the following search criteria

• Classpath search: getResourceAsStream is invoked on the provided class. The method is first invoked for fileName. If not input stream is found it is then invoked for "/"+fileName
• System Properties: if the parameter includeSystem is set to true, System Properties are added to the chain
• Bootstrap Resources search: The Bootstrap Resources directories (defined by the environment variable CCS_RESOURCE_PATH) are searched in the reversed order. In each directory properties are merged by searching for application, global and topic (defined by fileName) properties files (these files are loaded from the file system). If fileName is a path to a properties file, two searches are performed for each resource directory: the first one is for the fully qualified path; if this yields no result, the properties file is then searched at the root of each resource directory.
• Command line: Properties specified from the command line with the -D option are added to the top of the Properties chain.

Parameters:

fileName - The name of the properties file to load. This can be a path.

includeSystem - If true System Properties are chained after the classpath search.

clazz - The class on which getResourceAsStream is invoked for the classpath search. If null BootstrapResourceUtils.class is used.

Returns:

The merged Properties object.

getBootstrapProperties

public static Properties getBootstrapProperties(String fileName,
                                boolean includeSystem)

Utility function to fetch Properties in the Bootstrap environment.

This function is similar to getBootstrapProperties(java.lang.String, boolean, java.lang.Class). In this case the Class object is set to null and it defaults to BootstrapResourceUtils.class.

Parameters:

fileName - The name of the properties file to load. This can be a path.

includeSystem - If true System Properties are chained after the classpath search.

Returns:

The merged Properties object.

See Also:

getBootstrapProperties(java.lang.String, boolean, java.lang.Class)

getBootstrapProperties

public static Properties getBootstrapProperties(String fileName,
                                boolean includeSystem,
                                ClassLoader classLoader)

Utility function to fetch Properties in the Bootstrap environment.

This function is similar to getBootstrapProperties(java.lang.String, boolean, java.lang.Class) but for the fact that a ClassLoader is used for the Classpath search, rather than a Class.

Parameters:

fileName - The name of the properties file to load. This can be a path.

includeSystem - If true System Properties are chained after the classpath search.

classLoader - The classLoader on which getResourceAsStream is invoked for the classpath search.

Returns:

The merged Properties object.

See Also:

getBootstrapProperties(java.lang.String, boolean, java.lang.Class)

getBootstrapPropertiesInputStream

public static InputStream getBootstrapPropertiesInputStream(String fileName,
                                            boolean includeSystem,
                                            Class clazz)

Get an InputStream corresponding to the Bootstrap Properties object.

This function is similar to getBootstrapProperties(java.lang.String, boolean, java.lang.Class). Rather than a Properties object it returns the InputStream corresponsing to that Properties object. This is done by invoking Properties.store(java.io.OutputStream, java.lang.String) on a ByteArrayOutputStream and then returning an ByteArrayInputStream.

Parameters:

fileName - The name of the properties file to load. This can be a path.

includeSystem - If true System Properties are chained after the classpath search.

clazz - The class on which getResourceAsStream is invoked for the classpath search. If null BootstrapResourceUtils.class is used.

Returns:

See Also:

getBootstrapProperties(java.lang.String, boolean, java.lang.Class)

getBootstrapResource

public static InputStream getBootstrapResource(String resourceName,
                               Class clazz)

Utility functions to look for resources (excluding Properties) in the Bootstrap environment.

This function will search for the desired resource following the search criteria described below. It will return an InputStream for the first resource found.

Search Criteria:

• Bootstrap Resources search: The Bootstrap Resources directories (defined by the environment variable CCS_RESOURCE_PATH) are searched in the defined order. If fileName is a path to a resource, two searches are performed for each resource directory: the first one is for the fully qualified path; if this yields no result, the resource file is then searched at the root of each resource directory.
• Classpath search: getResourceAsStrean is invoked on the provided clazz. The method is first invoked for fileName. If not input stream is found it is then invoked for "/"+fileName

For Properties refer to {@link #getBootstrapProperties(java.lang.String, boolean,java.lang.Class).

Parameters:

fileName - The name of the resource. This can be a path.

clazz - The class on which getResourceAsStream is invoked for the classpath search. If null BootstrapResourceUtils.class is used.

Returns:

The InputStream of the first found resource.

getBootstrapResource

public static InputStream getBootstrapResource(String resourceName)

Utility functions to look for resources (excluding Properties) in the Bootstrap environment.

Internally it invokes getBootstrapResource(java.lang.String,java.lang.Class) with Class set to BootstrapResourceUtils.class.

Parameters:

fileName - The name of the resource. This can be a path.

Returns:

The InputStream of the first found resource.

See Also:

getBootstrapResource(java.lang.String, java.lang.Class)

getBootstrapResource

public static InputStream getBootstrapResource(String resourceName,
                               ClassLoader classLoader)

Utility functions to look for resources (excluding properties) in the Bootstrap environment.

This function is similar to getBootstrapResource(java.lang.String, java.lang.Class) but for the fact that a ClassLoader is used for the Classpath search, rather than a Class.

Parameters:

fileName - The name of the resource. This can be a path.

classLoader - The classLoader on which getResourceAsStream is invoked for the classpath search.

Returns:

The InputStream of the first found resource.

See Also:

getBootstrapResource(java.lang.String, java.lang.Class)