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.ioc;
16:
17: import org.apache.tapestry.ioc.annotations.EagerLoad;
18:
19: /**
20: * Public access to the IoC service registry.
21: */
22: public interface Registry extends ObjectLocator {
23: /**
24: * Invoked at the end of a request to discard any thread-specific information accumulated during
25: * the current request.
26: *
27: * @see org.apache.tapestry.ioc.services.ThreadCleanupHub
28: * @see org.apache.tapestry.ioc.services.ThreadCleanupListener
29: */
30: void cleanupThread();
31:
32: /**
33: * Shuts down a Registry instance. Notifies all listeners that the registry has shutdown.
34: * Further method invocations on the Registry are no longer allowed, and the Registry instance
35: * should be discarded.
36: *
37: * @see org.apache.tapestry.ioc.services.RegistryShutdownHub
38: * @see org.apache.tapestry.ioc.services.RegistryShutdownListener
39: */
40: void shutdown();
41:
42: /**
43: * Invoked to eagerly load services marked with the {@link EagerLoad} annotation.
44: */
45: void eagerLoadServices();
46: }
|