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.annotations;
16:
17: import static java.lang.annotation.ElementType.METHOD;
18: import static java.lang.annotation.ElementType.TYPE;
19: import static java.lang.annotation.RetentionPolicy.RUNTIME;
20:
21: import java.lang.annotation.Documented;
22: import java.lang.annotation.Retention;
23: import java.lang.annotation.Target;
24:
25: import org.apache.tapestry.ioc.ServiceBinder;
26: import org.apache.tapestry.ioc.ServiceLifecycle;
27: import org.apache.tapestry.ioc.services.ServiceLifecycleSource;
28:
29: /**
30: * An optional annotation that may be placed on a service building method of a module. The
31: * annotation overrides the default scope for services (the default being a global singleton that is
32: * instantiated on demand) for an alternate lifecycle. Alternate lifecycles are typically used to
33: * bind a service implementation to a single thread or request. Modules may define new scopes. Each
34: * scope should have a corresponding {@link ServiceLifecycle} implementation. The linkage from scope
35: * name to service lifecycle occurs via a contribution to the {@link ServiceLifecycleSource} service
36: * configuration.
37: * <p>
38: * The annotation may also be placed directly on a service implementation class, when using service
39: * autobuilding (via the {@link ServiceBinder}.
40: */
41: @Target({TYPE,METHOD})
42: @Retention(RUNTIME)
43: @Documented
44: public @interface Scope {
45: /** An identifier used to look up a non-default lifecycle. */
46: String value();
47: }
|