io

Class ResourceFinder

java.lang.Object

io.ResourceFinder

public class ResourceFinder
extends java.lang.Object

A ResourceFinder is used to find a "resource" either in a .jar file or in the local file system. It uses a ClassLoader to find the "resource".

Version:

1.0

Author:

Prof. David Bernstein, James Madison University

See Also:

"The Design and Implementation of Multimedia Software © 2011"

Method Summary

Modifier and Type	Method and Description
static ResourceFinder	createInstance() Construct a ResourceFinder that will search "locally".
static ResourceFinder	createInstance(java.lang.Class<?> c) Construct a ResourceFinder that will search "near" a particular Class.
static ResourceFinder	createInstance(java.lang.Object o) Construct a ResourceFinder that will search "near" a particular Object.
java.io.InputStream	findInputStream(java.lang.String name) Find a resource.
java.net.URL	findURL(java.lang.String name) Find a resource.
java.lang.String[]	loadResourceNames(java.lang.String listName) Load a list of resource names from a list (e.g., file).

Methods inherited from class java.lang.Object

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

Method Detail

createInstance

public static ResourceFinder createInstance()

Construct a ResourceFinder that will search "locally".

Returns:

A ResourceFinder that will search "locally"

createInstance

public static ResourceFinder createInstance(java.lang.Object o)

Construct a ResourceFinder that will search "near" a particular Object.

Parameters:

o - The Object that defines the location of the search

Returns:

A ResourceFinder that will search "near" o

createInstance

public static ResourceFinder createInstance(java.lang.Class<?> c)

Construct a ResourceFinder that will search "near" a particular Class.

Parameters:

c - The Class that defines the location of the search

Returns:

A ResourceFinder that will search "near" o

findInputStream

public java.io.InputStream findInputStream(java.lang.String name)

Find a resource.

Returns:

The InputStream of the resource (or null)

findURL

public java.net.URL findURL(java.lang.String name)

Find a resource.

Returns:

The URL of the resource (or null)

loadResourceNames

public java.lang.String[] loadResourceNames(java.lang.String listName)

Load a list of resource names from a list (e.g., file). Note: This method does not return an array of InputStream objects to conserver resources.

Parameters:

listName - The name of the list

Returns:

The resource names