It may be distributed (eg using a ResourceStoreStub in the client, but
providing access to a server-side resource store.).
public abstract Resource loadResource(String identifier,
Hashtable defs) throws InvalidResourceException
- Restore the resource whose name is given.
This method doesn't assume that the resource will actually be restored,
it can be kept in a cache by the ResourceStore object, and the cached
version of the resource may be returned.
- Parameters:
- identifier - The identifier of the resource to restore.
- defs - Default attribute values. If the resource needs to be
restored from its pickled version, this Hashtable provides
a set of default values for some of the attributes.
- Returns:
- A Resource instance, or null.
- Throws: InvalidResourceException
- If the resource could not
be restored from the store.
lookupResource
public abstract Resource lookupResource(String identifier)
- Get this resource, but only if already loaded.
The resource store may (recommended) maintain a cache of the resource
it loads from its store. If the resource having this identifier
has already been loaded, return it, otherwise, return
null.
- Parameters:
- identifier - The resource identifier.
- Returns:
- A Resource instance, or null.
saveResource
public abstract void saveResource(String identifier) throws UnknownResourceException
- Stabilize the resource having the given identifier.
- Parameters:
- identifier - The resource identifier.
- Throws: UnknownResourceException
- If the resource is unknown.
lockResource
public abstract boolean lockResource(ResourceLocker locker,
String identifier)
- Lock the given resource in the cache.
- Parameters:
- identifier - The identifier of the resource to be locked in cache.
- Returns:
- A boolean true if locking succeeded.
unlockResource
public abstract void unlockResource(ResourceLocker locker,
String identifier)
- Unlock the given resource in the cache.
- Parameters:
- identifier - The identifier of the resource to be unlocked.
addResource
public abstract void addResource(Resource resource)
- Add this resource to this resource store.
- Parameters:
- resource - The resource to be added.
removeResource
public abstract void removeResource(String identifier)
- Remove this resource from the repository.
- Parameters:
- identifier - The identifier of the resource to be removed.
renameResource
public abstract void renameResource(String oldid,
String newid)
- Rename a given resource.
- Parameters:
- oldid - The olde resource identifier.
- newid - The new resource identifier.
markModified
public abstract void markModified(String identifier)
- Mark this resource as modified.
- Parameters:
- identifier - The identifier of the modified resource.
shutdown
public abstract void shutdown()
- Shutdown this store.
save
public abstract void save()
- Save this store.
enumerateResourceIdentifiers
public abstract Enumeration enumerateResourceIdentifiers()
- Enumerate all the resources saved in this store.
- Returns:
- An enumeration of Strings, giving the identifier for all
the resources that this store knows about.
hasResource
public abstract boolean hasResource(String identifier)
- Check for the existence of a resource in this store.
- Parameters:
- identifier - The identifier of the resource to check.
- Returns:
- A boolean true if the resource exists
in this store, false otherwise.
initialize
public abstract void initialize(ResourceStoreManager manager,
File repository)
- This resource store is being built, initialize it with the given arg.
- Parameters:
- repository - A file, giving the location of the associated
repository.
All Packages Class Hierarchy This Package Previous Next Index