@UsesMappedConfiguration(value=AssetFactory.class) public interface AssetSource
Asset
with a given path.
Assets are defined with a domain, and the domain is indicated by a prefix. The two builtin domains are "context:"
(for files inside the web application context) and "classpath:" for files stored on the classpath (typically, inside
a JAR, such as a component library). Other domains can be defined via contributions to the AssetSource service.
Since 5.1.0.0, is is preferred that
AssetFactory.createAsset(org.apache.tapestry5.ioc.Resource)
return an instance
of Asset2
.Modifier and Type | Method and Description |
---|---|
Asset |
getAsset(Resource baseResource,
String path,
Locale locale)
Finds the asset.
|
Asset |
getClasspathAsset(String path)
Obtains a classpath alias in the current locale (as defined by the
ThreadLocale service). |
Asset |
getClasspathAsset(String path,
Locale locale)
Convienience for finding assets on the classpath.
|
Asset |
getContextAsset(String path,
Locale locale)
Convienience for finding assets in the context.
|
Asset |
getExpandedAsset(String path)
As with
getUnlocalizedAsset(String) , but symbols
in the path are expanded. |
Asset |
getUnlocalizedAsset(String path)
Find an asset but does not attempt to localize it.
|
Resource |
resourceForPath(String path)
Finds the asset, either on the classpath or (if prefixed), within the indicated domain.
|
Asset getAsset(Resource baseResource, String path, Locale locale)
baseResource
- base resource for computing relative paths, or null to search the classpathpath
- relative to the base resourcelocale
- locale to localize the final resource to, or null for the thread's current localeRuntimeException
- if the asset can not be foundResource resourceForPath(String path)
path
- to the resource to provide as an AssetAsset getClasspathAsset(String path, Locale locale)
path
- path to the base resource, relative to classpath rootlocale
- to localize the resource toRuntimeException
- if the asset can not be foundAsset getContextAsset(String path, Locale locale)
path
- path relative to the base resource (the context root)locale
- to localize the resource to, or null for the locale for the current requestRuntimeException
- if the asset can not be foundAsset getClasspathAsset(String path)
ThreadLocale
service).path
- relative to the classpath rootRuntimeException
- if the asset can not be foundAsset getUnlocalizedAsset(String path)
RuntimeException
- if the asset can not be foundAsset getExpandedAsset(String path)
getUnlocalizedAsset(String)
, but symbols
in the path are expanded.Copyright © 2003-2012 The Apache Software Foundation.