org.ow2.jonas.lib.loader.locator
Class Locator

java.lang.Object
  org.ow2.jonas.lib.loader.locator.Locator

Direct Known Subclasses:

DirLocator, JarFileLocator

public abstract class Locator
extends Object

A Locator is used to hide System specific when looking for a file.

Author:

Guillaume Sauthier

Constructor Summary

Locator()

Method Summary

static Locator	getLocator(URL url) Return a new Locator in function of the URL type.
abstract boolean	hasDirectory(String path) Returns true when directory was found.
abstract boolean	hasFile(String path) Returns true when file was found.
abstract List	listContent(String path) Returns a list of filename stored in path.

Methods inherited from class java.lang.Object

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

Constructor Detail

Locator

public Locator()

Method Detail

hasFile

public abstract boolean hasFile(String path)

Returns true when file was found.

Parameters:

path - the path to the file to look up

Returns:

true when file was found, otherwise false.

hasDirectory

public abstract boolean hasDirectory(String path)

Returns true when directory was found.

Parameters:

path - the path to the directory to look up

Returns:

true when directory was found, otherwise false.

listContent

public abstract List listContent(String path)

Returns a list of filename stored in path.

Parameters:

path - the path to the directory where looking for files

Returns:

a list of filename stored in path.

getLocator

public static Locator getLocator(URL url)
                          throws IOException

Return a new Locator in function of the URL type. an URL pointing to a jar file will return a JarFileLocator and an URL pointing to a directory file will return a DirFileLocator.

Parameters:

url - the base URL

Returns:

a new Locator in function of the URL type.

Throws:

IOException - when cannot find a specialized locator for the given URL.