Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  // Copyright 2006, 2007, 2008, 2009, 2010 The Apache Software Foundation
  //
  // Licensed under the Apache License, Version 2.0 (the "License");
  // you may not use this file except in compliance with the License.
  // You may obtain a copy of the License at
  //
  // http://www.apache.org/licenses/LICENSE-2.0
  //
  // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
 package org.apache.tapestry5.services;
 
 
Used to find or create an org.apache.tapestry5.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 org.apache.tapestry5.Asset2.

 
 public interface AssetSource
 {
    
Finds the asset. The path may either be a simple file name or a relative path (relative to the base resource) or it may have a prefix, such as "context:" or "classpath:", in which case it is treated as a complete path within the indicated domain. The resulting Resource is then localized (to the provided Locale) and returned as an Asset.

The AssetSource caches its results, so a single Asset instance may be shared among many different components.

Parameters:
baseResource base resource for computing relative paths, or null to search the classpath
path relative to the base resource
locale locale to localize the final resource to, or null for the thread's current locale
Returns:
the asset
Throws:
java.lang.RuntimeException if the asset can not be found
 
     Asset getAsset(Resource baseResourceString pathLocale locale);

    
Finds the asset, either on the classpath or (if prefixed), within the indicated domain. The result is not localized. The underlying Asset may not exist.

Parameters:
path to the resource to provide as an Asset
Returns:
Resource for the path (the Resource may not exist)
Since:
5.1.0.0
 
     Resource resourceForPath(String path);

    
Convienience for finding assets on the classpath.

Parameters:
path path to the base resource, relative to classpath root
locale to localize the resource to
Returns:
the asset
Throws:
java.lang.RuntimeException if the asset can not be found
 
     Asset getClasspathAsset(String pathLocale locale);

    
Convienience for finding assets in the context.

Parameters:
path path relative to the base resource (the context root)
locale to localize the resource to, or null for the locale for the current request
Returns:
the asset
Throws:
java.lang.RuntimeException if the asset can not be found
Since:
5.1.0.0
 
     Asset getContextAsset(String pathLocale locale);

    
Obtains a classpath alias in the current locale (as defined by the org.apache.tapestry5.ioc.services.ThreadLocale service).

Parameters:
path relative to the classpath root
Returns:
the asset
Throws:
java.lang.RuntimeException if the asset can not be found
    Asset getClasspathAsset(String path);

    
Find an asset but does not attempt to localize it. If the path has no prefix, it is assumed to be on the classpath.

Throws:
java.lang.RuntimeException if the asset can not be found
Since:
5.2.0
    Asset getUnlocalizedAsset(String path);

    
As with getUnlocalizedAsset(java.lang.String), but symbols in the path are expanded.

Since:
5.2.0
New to GrepCode? Check out our FAQ X