01: /*
02: * Copyright 2002-2007 the original author or authors.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16:
17: package org.springframework.beans.factory;
18:
19: /**
20: * Extension of the {@link FactoryBean} interface. Implementations may
21: * indicate whether they always return independent instances, for the
22: * case where their {@link #isSingleton()} implementation returning
23: * <code>false</code> does not clearly indicate independent instances.
24: *
25: * <p>Plain {@link FactoryBean} implementations which do not implement
26: * this extended interface are simply assumed to always return independent
27: * instances if their {@link #isSingleton()} implementation returns
28: * <code>false</code>.
29: *
30: * <p><b>NOTE:</b> This interface is a special purpose interface, mainly for
31: * internal use within the framework. In general, application-provided
32: * FactoryBeans should simply implement the plain {@link FactoryBean} interface.
33: *
34: * @author Juergen Hoeller
35: * @since 2.0.3
36: * @see #isPrototype()
37: * @see #isSingleton()
38: */
39: public interface SmartFactoryBean extends FactoryBean {
40:
41: /**
42: * Is the object managed by this factory a prototype? That is,
43: * will {@link #getObject()} always return an independent instance?
44: * <p>The prototype status of the FactoryBean itself will generally
45: * be provided by the owning {@link BeanFactory}; usually, it has to be
46: * defined as singleton there.
47: * <p>This method is supposed to strictly check for independent instances;
48: * it should not return <code>true</code> for scoped objects or other
49: * kinds of non-singleton, non-independent objects. For this reason,
50: * this is not simply the inverted form of {@link #isSingleton()}.
51: * @return if the exposed object is a prototype
52: * @see #getObject()
53: * @see #isSingleton()
54: */
55: boolean isPrototype();
56:
57: }
|