com.google.gwt.dev.resource

Interface ResourceOracle

All Known Implementing Classes:

AbstractResourceOracle, CombinedResourceOracle, LibraryGroupBuildResourceOracle, LibraryGroupPublicResourceOracle, MockResourceOracle, ResourceOracleImpl

public interface ResourceOracle

An abstraction for finding and retrieving Resources by abstract path name. Intuitively, it works like a jar in that each URL is uniquely located somewhere in an abstract namespace. The abstract names must be constructed from a series of zero or more valid Java identifiers followed by the '/' character and finally ending in a valid filename, for example, com/google/gwt/blah.txt.

The identity of the returned sets and maps will change when the underlying module is refreshed.

Method Summary

Modifier and Type	Method and Description
void	clear() Frees up all existing resources and transient internal state.
Set<String>	getPathNames() Returns an unmodifiable set of unique abstract path names with constant lookup time.
Resource	getResource(String pathName) Returns the resource for the given path name or null if there is no such resource.
InputStream	getResourceAsStream(String pathName) Returns the resource input stream for the given path name or null if there is no such resource.
Map<String,Resource>	getResourceMap() Deprecated. use getResource(String pathName), getResources(), and getPathNames() instead so that access to specific resources can be tracked.
Set<Resource>	getResources() Returns an unmodifiable set of unique resources with constant lookup time.

Method Detail

clear

void clear()

Frees up all existing resources and transient internal state. All returned collections will be empty after this call until this ResourceOracle is refreshed.

getPathNames

Set<String> getPathNames()

Returns an unmodifiable set of unique abstract path names with constant lookup time.

getResource

Resource getResource(String pathName)

Returns the resource for the given path name or null if there is no such resource.

getResourceAsStream

InputStream getResourceAsStream(String pathName)

Returns the resource input stream for the given path name or null if there is no such resource.

getResourceMap

@Deprecated
Map<String,Resource> getResourceMap()

Deprecated. use getResource(String pathName), getResources(), and getPathNames() instead so that access to specific resources can be tracked.

Returns an unmodifiable map of abstract path name to resource.

getResources

Set<Resource> getResources()

Returns an unmodifiable set of unique resources with constant lookup time.