Package rs.baselib.io

Class FileFinder

java.lang.Object

rs.baselib.io.FileFinder

public class FileFinder
extends Object

Utility to find a file on disk.

Author:

RalphSchuster

See Also:

find(Class, String)

Constructor Summary

Constructors

Constructor	Description
FileFinder()

Method Summary

Modifier and Type	Method	Description
static URL	find(Class<?> clazz, String name)	Tries to find the file specified from filesystem or classpath.
static URL	find(String name)	Tries to find the file specified from filesystem or classpath.
static String	load(Class<?> clazz, String name)	Finds and loads a file.
static String	load(String name)	Finds and loads a file.
static InputStream	open(Class<?> clazz, String name)	Tries to find the file specified from filesystem or classpath.
static InputStream	open(String name)	Tries to find the file specified from filesystem or classpath.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileFinder

public FileFinder()

Method Detail

find

public static URL find(String name)

Tries to find the file specified from filesystem or classpath.

Parameters:

name - - name of file, can be fully qualified

Returns:

URL to the file

See Also:

find(Class, String)

find

public static URL find(Class<?> clazz,
                       String name)

Tries to find the file specified from filesystem or classpath.

The file will be searched based on the following procedure:

• Try to find the file in current working dir (unless absolute path is given).
• Try to fine the file in package of the class given as argument using the default class loader
• Try to find the file in parent packages of the class given as argument using the default class loader
• Try to fine the file in package of the class given as argument using the context class loader
• Try to find the file in parent packages of the class given as argument using the context class loader
• Repeat the procedure by trying to find the file with a prepended slash.

Parameters:

name - - name of file, can be fully qualified

clazz - class to get the class loader from

Returns:

URL to the file

open

public static InputStream open(String name)
                        throws IOException

Tries to find the file specified from filesystem or classpath.

Parameters:

name - - name of file, can be fully qualified

Returns:

stream to the file

Throws:

IOException - when file cannot be opened

open

public static InputStream open(Class<?> clazz,
                               String name)
                        throws IOException

Tries to find the file specified from filesystem or classpath.

Parameters:

name - - name of file, can be fully qualified

clazz - class to get the class loader from

Returns:

stream to the file

Throws:

IOException - when file cannot be opened

See Also:

find(Class, String)

load

public static String load(String name)
                   throws IOException

Finds and loads a file.

Parameters:

name - - name of file

Returns:

contents of file

Throws:

IOException - when file cannot be opened

See Also:

find(Class, String)

load

public static String load(Class<?> clazz,
                          String name)
                   throws IOException

Finds and loads a file.

Parameters:

name - - name of file

clazz - class to get the class loader from

Returns:

contents of file

Throws:

IOException - when file cannot be opened

See Also:

find(Class, String)