org.apache.hivemind
Interface Resource

All Known Implementing Classes:
AbstractResource, ClasspathResource, ContextResource, FileResource, URLResource

public interface Resource

Describes the location of a resource, such as a module deployment descriptor, or a messages file.

Resources may be either base or localized. A localized version of a base resource may be obtained via getLocalization(Locale).

Resource locations are used as Map keys, they must implement Object.hashCode() and Object.equals(java.lang.Object) properly.

Resource locations are valid even if the corresponding resource doesn't exist. To verify if a localization actually exists, use getResourceURL(), which returns null if the resource doesn't exist. getLocalization(Locale) returns only real resource locations, where the resource exists.

Folders must be represented with a trailing slash.

Author:
Howard Lewis Ship

Method Summary
 java.util.Locale getLocale()
          Returns the locale for which this resource has been localized or null if the resource has not been localized.
 Resource getLocalization(java.util.Locale locale)
          Returns a localized version of this resource (or this resource, if no appropriate localization is found).
 java.lang.String getName()
          Returns the file name portion of the resource location.
 java.lang.String getPath()
          Returns the path that represents the resource.
 Resource getRelativeResource(java.lang.String name)
          Returns at a relative location to this resource.
 java.net.URL getResourceURL()
          Returns a URL for the resource.
 

Method Detail

getResourceURL

java.net.URL getResourceURL()
Returns a URL for the resource.

Returns:
the URL for the resource if it exists, or null if it does not

getName

java.lang.String getName()
Returns the file name portion of the resource location.


getLocalization

Resource getLocalization(java.util.Locale locale)
Returns a localized version of this resource (or this resource, if no appropriate localization is found). Should only be invoked on a base resource.

Parameters:
locale - to localize for, or null for no localization.
Returns:
a localized version of this resource, of null if the resource itself does not exist.

getRelativeResource

Resource getRelativeResource(java.lang.String name)
Returns at a relative location to this resource. The new resource may or may not exist; this can be determined via getResourceURL().

Parameters:
name - name of new resource, possibly as a relative path, or as an absolute path (starting with a slash).

getPath

java.lang.String getPath()
Returns the path that represents the resource. This should only be used when the type of resource is known.


getLocale

java.util.Locale getLocale()
Returns the locale for which this resource has been localized or null if the resource has not been localized. This should only be used when the type of resource is known. This locale is the same or more general than the locale for which localization was requested. For example, if the requested locale was en_US, but only the file Home_en was found, this locale returned would be en.



Copyright © 2003-2007 Apache Software Foundation. All Rights Reserved.