org.hibernate.util
Class ConfigHelper

java.lang.Object
  org.hibernate.util.ConfigHelper

public final class ConfigHelper
extends Object

A simple class to centralize logic needed to locate config files on the system.

Author:

Steve

Method Summary

static URL	findAsResource(String path) Try to locate a local URL representing the incoming path.
static Properties	getConfigProperties(String path) Loads a properties instance based on the data at the incoming config location.
static InputStream	getConfigStream(String path) Open an InputStream to the URL represented by the incoming path.
static Reader	getConfigStreamReader(String path) Open an Reader to the URL represented by the incoming path.
static InputStream	getResourceAsStream(String resource)
static InputStream	getUserResourceAsStream(String resource)
static URL	locateConfig(String path) Try to locate a local URL representing the incoming path.

Methods inherited from class java.lang.Object

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

Method Detail

locateConfig

public static final URL locateConfig(String path)

Try to locate a local URL representing the incoming path. The first attempt assumes that the incoming path is an actual URL string (file://, etc). If this does not work, then the next attempts try to locate this UURL as a java system resource.

Parameters:

path - The path representing the config location.

Returns:

An appropriate URL or null.

findAsResource

public static final URL findAsResource(String path)

Try to locate a local URL representing the incoming path. This method only attempts to locate this URL as a java system resource.

Parameters:

path - The path representing the config location.

Returns:

An appropriate URL or null.

getConfigStream

public static final InputStream getConfigStream(String path)
                                         throws HibernateException

Open an InputStream to the URL represented by the incoming path. First makes a call to locateConfig(java.lang.String) in order to find an appropriate URL. URL.openStream() is then called to obtain the stream.

Parameters:

path - The path representing the config location.

Returns:

An input stream to the requested config resource.

Throws:

HibernateException - Unable to open stream to that resource.

getConfigStreamReader

public static final Reader getConfigStreamReader(String path)
                                          throws HibernateException

Open an Reader to the URL represented by the incoming path. First makes a call to locateConfig(java.lang.String) in order to find an appropriate URL. URL.openStream() is then called to obtain a stream, which is then wrapped in a Reader.

Parameters:

path - The path representing the config location.

Returns:

An input stream to the requested config resource.

Throws:

HibernateException - Unable to open reader to that resource.

getConfigProperties

public static final Properties getConfigProperties(String path)
                                            throws HibernateException

Loads a properties instance based on the data at the incoming config location.

Parameters:

path - The path representing the config location.

Returns:

The loaded properties instance.

Throws:

HibernateException - Unable to load properties from that resource.

getResourceAsStream

public static InputStream getResourceAsStream(String resource)

getUserResourceAsStream

public static InputStream getUserResourceAsStream(String resource)