The resource manager takes care about the loaded resources, performs caching, if needed and is the central instance
when dealing with resources. Resource loading is a two-step process. In the first step, the
ResourceLoader
accesses the physical storage or network connection to read in the binary data. The loaded
ResourceData
carries versioning information with it an can be cached indendently from the produced result. Once the loading is
complete, a
ResourceFactory
interprets the binary data and produces a Java-Object from it.
Resources are identified by an Resource-Key and some optional loader parameters (which can be used to parametrize the
resource-factories).
createKey
public ResourceKey createKey(Object data,
Map parameters)
throws ResourceKeyCreationException
Creates a ResourceKey that carries the given Loader-Parameters contained in the optional map.
data
- the key-dataparameters
- an optional map of parameters.
- the generated resource-key, never null.
deriveKey
public ResourceKey deriveKey(ResourceKey parent,
String path)
throws ResourceKeyCreationException
Derives a new key from the given resource-key. Only keys for a hierarchical storage system (like file-systems or
URLs) can have derived keys. Since LibLoader 0.3.0 only hierarchical keys can be derived. For that, the deriving
path must be given as String.
Before trying to derive the key, the system tries to interpret the path as absolute key-value.
parent
- the parent key, must never be nullpath
- the relative path, that is used to derive the key.
deriveKey
public ResourceKey deriveKey(ResourceKey parent,
String path,
Map parameters)
throws ResourceKeyCreationException
Derives a new key from the given resource-key. Only keys for a hierarchical storage system (like file-systems or
URLs) can have derived keys. Since LibLoader 0.3.0 only hierarchical keys can be derived. For that, the deriving
path must be given as String.
The optional parameter-map will be applied to the derived key after the parent's parameters have been copied to
the new key.
Before trying to derive the key, the system tries to interpret the path as absolute key-value.
parent
- the parent key, or null to interpret the path as absolute key.path
- the relative path, that is used to derive the key.
getDataCache
public org.jfree.resourceloader.cache.ResourceDataCache getDataCache()
getFactoryCache
public org.jfree.resourceloader.cache.ResourceFactoryCache getFactoryCache()
setDataCache
public void setDataCache(org.jfree.resourceloader.cache.ResourceDataCache dataCache)
setFactoryCache
public void setFactoryCache(org.jfree.resourceloader.cache.ResourceFactoryCache factoryCache)
toURL
public URL toURL(ResourceKey key)
Tries to convert the resource-key into an URL. Not all resource-keys have an URL representation. This method
exists to make it easier to connect LibLoader to other resource-loading frameworks.
- the URL for the key, or null if there is no such key.