Package net.ontopia.utils

Class StreamUtils

java.lang.Object

net.ontopia.utils.StreamUtils

public class StreamUtils
extends Object

INTERNAL: Utilities for working with streams and readers.

Since:

1.3.3

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CLASSPATH_PREFIX
static final String	FILE_PREFIX

Constructor Summary

Constructors

Constructor	Description
StreamUtils()

Method Summary

Modifier and Type	Method	Description
static InputStream	getInputStream(File basedir, String name)	INTERNAL: Returns an input stream for the given url.
static InputStream	getInputStream(String name)	INTERNAL: Same as getInputStream(null, name);
static URL	getResource(String name)	INTERNAL: Returns an URL for the given resource name.

Methods inherited from class java.lang.Object

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

Field Details

CLASSPATH_PREFIX

public static final String CLASSPATH_PREFIX

See Also:

• Constant Field Values

FILE_PREFIX

public static final String FILE_PREFIX

See Also:

• Constant Field Values

Constructor Details

StreamUtils

public StreamUtils()

Method Details

getInputStream

public static InputStream getInputStream(String name)
                                  throws IOException

INTERNAL: Same as getInputStream(null, name);

Throws:

IOException

Since:

3.4.3

getInputStream

public static InputStream getInputStream(File basedir,
 String name)
                                  throws IOException

INTERNAL: Returns an input stream for the given url. Supports file: and classpath:. If no scheme given then file system will be checked before classpath. Exception will be thrown if resource is not found when scheme is given. If no scheme was given null is returned. File references will be interpreted relative to basedir. If basedir is null, it will be ignored.

Throws:

IOException

Since:

5.1.1

getResource

public static URL getResource(String name)
                       throws IOException

INTERNAL: Returns an URL for the given resource name. The order of resolving is:

1. If name starts with 'classpath:' a resource on the classpath will be resolved. If the resource cannot be found, a 'FileNotFoundException' is thrown
2. If name starts with 'file:' a resource on the filesystem will be resolved. If the file cannot be found, a 'FileNotFoundException' is thrown
3. if name starts with 'jar:' a jar-URL will be created and returned. Only fails if name is not a valid URL
4. name is treated as a file system path, if a file exists an URL to it will be returned
5. name is treated as a classpath resource, if it is a valid URL and the resource exists, it will be returned.
6. null is returned

Throws:

IOException

Since:

3.4.3