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

    Methods
    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

${project.version} - Copyright © 2003-2014 The Apache Software Foundation.