org.apache.tapestry
Interface IAsset

All Superinterfaces:

org.apache.hivemind.Locatable

All Known Implementing Classes:

AbstractAsset, ContextAsset, ExternalAsset, PrivateAsset

public interface IAsset
extends org.apache.hivemind.Locatable

Representation of a asset (GIF, JPEG, etc.) that may be owned by a IComponent.

Assets may be completely external (i.e., on some other web site), contained by the ServletContext, or stored somewhere in the classpath.

In the latter two cases, the resource may be localized.

Author:

Howard Lewis Ship

Method Summary

String	buildURL() Returns a URL for the asset, ready to be inserted into the output HTML.
InputStream	getResourceAsStream() Accesses the localized version of the resource (if possible) and returns it as an input stream.
org.apache.hivemind.Resource	getResourceLocation() Returns the underlying location of the asset.

Methods inherited from interface org.apache.hivemind.Locatable

getLocation

Method Detail

buildURL

String buildURL()

Returns a URL for the asset, ready to be inserted into the output HTML. If the asset can be localized, the localized version (matching the Localeof the current page) is returned.

Throws:

org.apache.hivemind.ApplicationRuntimeException - if the asset does not exist.

getResourceAsStream

InputStream getResourceAsStream()

Accesses the localized version of the resource (if possible) and returns it as an input stream. A version of the resource localized to the current pageis returned.

Throws:

org.apache.hivemind.ApplicationRuntimeException - if the asset does not exist, or can't be read.

getResourceLocation

org.apache.hivemind.Resource getResourceLocation()

Returns the underlying location of the asset.