## 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)

Copyright © 2001-2010 Red Hat, Inc. All Rights Reserved.