org.apache.tapestry5.internal.services

Interface RequestPageCache

All Known Implementing Classes:

RequestPageCacheImpl

public interface RequestPageCache

Per-thread service that caches page instances for the duration of the request, and is also responsible for tracking the active page (the page which will ultimately render the response). Since Page is internal, most user-code should use the ComponentSource service instead. Starting in 5.2, page instances are shared (with externalized mutable state), not pooled, but the cache is still useful for managing the page's lifecycle.

Method Summary

Modifier and Type	Method and Description
Page	get(String pageName) Gets the page via its page name, in the current locale.

Method Detail

get

Page get(String pageName)

Gets the page via its page name, in the current locale. The logical page name is resolved to a class name, which is used to obtain the page (from the page pool). Note that under certain circumstances, a page may have multiple names (even beyond simple case-insensitivity), and RequestPageCache caches correctly.

Parameters:

pageName - the name of the page to retrieve (this is the logical page name, not the fully qualified class name)

Returns:

a page instance reserved for this request

Throws:

IllegalArgumentException - if the name can not be resolved to a page instance