org.apache.tapestry.asset
Interface AssetSource

All Known Implementing Classes:

AssetSourceImpl

public interface AssetSource

Used to create an IAsset instance for a particular asset path. The path may have a prefix that indicates its type, or it may be relative to some existing resource.

Since:

4.0

Author:

Howard M. Lewis Ship

Method Summary

IAsset

findAsset(Resource base, String path, Locale locale, Location location) Finds an asset relative to some existing resource (typically, a page, component or library specification).

Method Detail

findAsset

IAsset findAsset(Resource base,
                 String path,
                 Locale locale,
                 Location location)

Finds an asset relative to some existing resource (typically, a page, component or library specification).

Parameters:

base - the base resource used for resolving the asset

path - the path relative to the base resource; alternately, the path may include a prefix that defines a domain (such as "classpath:" or "context:") in which case the base resource is ignored and the resource resolved within that domain

locale - used to find a localized version of the asset, may be null to indicate no localization

location - used to report errors (such as missing resources)

Returns:

the asset, possibly localized

Throws:

ApplicationRuntimeException - if the asset does not exist