01: // Copyright 2006 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: /**
18: * Allows certain types of lifecycles to control exactly how services are instantiated.
19: *
20: *
21: */
22: public interface ServiceLifecycle {
23: /**
24: * Returns the same creator, or a new one, that encapsulates the creation of the core service
25: * implementation.
26: *
27: * @param resources
28: * source of information about the service to be created, and source of additional
29: * services or other resources that may be needed when constructing the core service
30: * implementation
31: * @param creator
32: * object capable of creating the service implementation on demand. This is a wrapper
33: * around the service's builder method.
34: * @return the service or equivalent service proxy
35: */
36: Object createService(ServiceResources resources,
37: ObjectCreator creator);
38: }
|