org.jfree.resourceloader
Interface ResourceLoader

public interface ResourceLoader

A resource loader knows how to get binary rawdata from a location specified by an resource key. A resource key is a wrapper around any kind of data that is suitable to identify a resource location. The resource key can also hold configuration data for the factory. If the storage system is hierarchical, a new resource key can be derived from a given path-string.

Author:

Thomas Morgner

Method Summary

ResourceKey	createKey(java.lang.Object value, java.util.Map factoryKeys) Creates a new resource key from the given object and the factory keys.
ResourceKey	deriveKey(ResourceKey parent, java.lang.String path, java.util.Map factoryKeys) Derives a new resource key from the given key.
boolean	isSupportedKey(ResourceKey key) Checks, whether this resource loader implementation was responsible for creating this key.
ResourceData	load(ResourceKey key) Loads the binary data represented by this key.
void	setResourceManager(ResourceManager manager)
java.net.URL	toURL(ResourceKey key)

Method Detail

isSupportedKey

boolean isSupportedKey(ResourceKey key)

Checks, whether this resource loader implementation was responsible for creating this key.

Parameters:

key -

Returns:

createKey

ResourceKey createKey(java.lang.Object value,
                      java.util.Map factoryKeys)
                      throws ResourceKeyCreationException

Creates a new resource key from the given object and the factory keys.

Parameters:

value -

factoryKeys -

Returns:

the created key or null, if the format was not recognized.

Throws:

ResourceKeyCreationException - if creating the key failed.

deriveKey

ResourceKey deriveKey(ResourceKey parent,
                      java.lang.String path,
                      java.util.Map factoryKeys)
                      throws ResourceKeyCreationException

Derives a new resource key from the given key. If neither a path nor new factory-keys are given, the parent key is returned.

Parameters:

parent - the parent

path - the derived path (can be null).

factoryKeys - the optional factory keys (can be null).

Returns:

the derived key.

Throws:

ResourceKeyCreationException - if the key cannot be derived for any reason.

load

ResourceData load(ResourceKey key)
                  throws ResourceLoadingException

Loads the binary data represented by this key.

Parameters:

key -

Returns:

Throws:

ResourceLoadingException

setResourceManager

void setResourceManager(ResourceManager manager)

toURL

java.net.URL toURL(ResourceKey key)