01: /*
02: * Copyright 2001-2004 The Apache Software Foundation
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: package org.apache.commons.collections.functors;
17:
18: import java.io.Serializable;
19:
20: import org.apache.commons.collections.Factory;
21:
22: /**
23: * Factory implementation that returns the same constant each time.
24: * <p>
25: * No check is made that the object is immutable. In general, only immutable
26: * objects should use the constant factory. Mutable objects should
27: * use the prototype factory.
28: *
29: * @since Commons Collections 3.0
30: * @version $Revision: 348444 $ $Date: 2005-11-23 14:06:56 +0000 (Wed, 23 Nov 2005) $
31: *
32: * @author Stephen Colebourne
33: */
34: public class ConstantFactory implements Factory, Serializable {
35:
36: /** Serial version UID */
37: private static final long serialVersionUID = -3520677225766901240L;
38:
39: /** Returns null each time */
40: public static final Factory NULL_INSTANCE = new ConstantFactory(
41: null);
42:
43: /** The closures to call in turn */
44: private final Object iConstant;
45:
46: /**
47: * Factory method that performs validation.
48: *
49: * @param constantToReturn the constant object to return each time in the factory
50: * @return the <code>constant</code> factory.
51: */
52: public static Factory getInstance(Object constantToReturn) {
53: if (constantToReturn == null) {
54: return NULL_INSTANCE;
55: }
56: return new ConstantFactory(constantToReturn);
57: }
58:
59: /**
60: * Constructor that performs no validation.
61: * Use <code>getInstance</code> if you want that.
62: *
63: * @param constantToReturn the constant to return each time
64: */
65: public ConstantFactory(Object constantToReturn) {
66: super ();
67: iConstant = constantToReturn;
68: }
69:
70: /**
71: * Always return constant.
72: *
73: * @return the stored constant value
74: */
75: public Object create() {
76: return iConstant;
77: }
78:
79: /**
80: * Gets the constant.
81: *
82: * @return the constant
83: * @since Commons Collections 3.1
84: */
85: public Object getConstant() {
86: return iConstant;
87: }
88:
89: }
|