Package 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

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `Page` | `get​(java.lang.String pageName)` | Gets the page via its page name, in the current locale.

- - ### Method Detail

    - #### get

          Page get​(java.lang.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:
        `java.lang.IllegalArgumentException` - if the name can not be resolved to a page instance