org.apache.velocity.runtime.resource
Interface ResourceManager

All Known Implementing Classes:

ResourceManagerImpl

public interface ResourceManager

Class to manage the text resource for the Velocity Runtime.

Version:

$Id: ResourceManager.java,v 1.32 2001/11/06 03:22:00 geirm Exp $

Author:

Jason van Zyl, Paulo Gaspar, Geir Magnusson Jr.

Field Summary

static int	RESOURCE_CONTENT A static content resource.
static int	RESOURCE_TEMPLATE A template resources.

Method Summary

java.lang.String	getLoaderNameForResource(java.lang.String resourceName) Determines is a template exists, and returns name of the loader that provides it.
Resource	getResource(java.lang.String resourceName, int resourceType, java.lang.String encoding) Gets the named resource.
void	initialize(RuntimeServices rs) Initialize the ResourceManager.

Field Detail

RESOURCE_TEMPLATE

public static final int RESOURCE_TEMPLATE

A template resources.

RESOURCE_CONTENT

public static final int RESOURCE_CONTENT

A static content resource.

Method Detail

initialize

public void initialize(RuntimeServices rs)
                throws java.lang.Exception

Initialize the ResourceManager. It is assumed that assembleSourceInitializers() has been called before this is run.

getResource

public Resource getResource(java.lang.String resourceName,
                            int resourceType,
                            java.lang.String encoding)
                     throws ResourceNotFoundException,
                            ParseErrorException,
                            java.lang.Exception

Gets the named resource. Returned class type corresponds to specified type (i.e. Template to RESOURCE_TEMPLATE).

Parameters:

resourceName - The name of the resource to retrieve.

resourceType - The type of resource (RESOURCE_TEMPLATE, RESOURCE_CONTENT, etc.).

encoding - The character encoding to use.

Returns:

Resource with the template parsed and ready.

Throws:

ResourceNotFoundException - if template not found from any available source.

ParseErrorException - if template cannot be parsed due to syntax (or other) error.

java.lang.Exception - if a problem in parse

getLoaderNameForResource

public java.lang.String getLoaderNameForResource(java.lang.String resourceName)

Determines is a template exists, and returns name of the loader that provides it. This is a slightly less hokey way to support the Velocity.templateExists() utility method, which was broken when per-template encoding was introduced. We can revisit this.

Parameters:

resourceName - Name of template or content resource

Returns:

class name of loader than can provide it