01: // Copyright 2006, 2007 The Apache Software Foundation
02: //
03: // Licensed under the Apache License, Version 2.0 (the "License");
04: // you may not use this file except in compliance with the License.
05: // You may obtain a copy of the License at
06: //
07: // http://www.apache.org/licenses/LICENSE-2.0
08: //
09: // Unless required by applicable law or agreed to in writing, software
10: // distributed under the License is distributed on an "AS IS" BASIS,
11: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12: // See the License for the specific language governing permissions and
13: // limitations under the License.
14:
15: package org.apache.tapestry.internal.services;
16:
17: import org.apache.tapestry.internal.structure.Page;
18:
19: /**
20: * Provides access to pages, creating them as necessary, and pooling them between requests.
21: */
22: public interface PagePool {
23: /**
24: * Obtains a page instance from the pool via a logical page name. A page instance is created if
25: * no such page is currently available.
26: *
27: * @param logicalPageName
28: * logical name used to identify the page
29: * @return a page instance
30: */
31: Page checkout(String logicalPageName);
32:
33: /**
34: * @param page
35: * a previously checked-out page
36: */
37: void release(Page page);
38: }
|