01: /*
02: * (c) Copyright 2006 by Volker Bergmann. All rights reserved.
03: *
04: * Redistribution and use in source and binary forms, with or without
05: * modification, is permitted under the terms of the
06: * GNU General Public License.
07: *
08: * For redistributing this software or a derivative work under a license other
09: * than the GPL-compatible Free Software License as defined by the Free
10: * Software Foundation or approved by OSI, you must first obtain a commercial
11: * license to this software product from Volker Bergmann.
12: *
13: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
14: * WITHOUT A WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS,
15: * REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
16: * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE
17: * HEREBY EXCLUDED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
18: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24: * POSSIBILITY OF SUCH DAMAGE.
25: */
26:
27: package org.databene.benerator;
28:
29: /**
30: * Abstract generator class that wraps another generator object (in a <i>source</i> property)
31: * and delegates life cycle control to it.<br/>
32: * <br/>
33: * Created: 12.12.2006 19:13:55
34: * @author Volker Bergmann
35: */
36: public abstract class GeneratorWrapper<S, P> implements Generator<P> {
37:
38: protected Generator<S> source;
39: protected boolean dirty;
40:
41: public GeneratorWrapper(Generator<S> source) {
42: this .source = source;
43: this .dirty = true;
44: }
45:
46: // config properties -----------------------------------------------------------------------------------------------
47:
48: /** Returns the source generator */
49: public Generator<S> getSource() {
50: return source;
51: }
52:
53: /** Sets the source generator */
54: public void setSource(Generator<S> source) {
55: this .source = source;
56: dirty = true;
57: }
58:
59: // Generator interface ---------------------------------------------------------------------------------------------
60:
61: public void validate() {
62: if (dirty) {
63: if (source == null)
64: throw new InvalidGeneratorSetupException("source",
65: "is null");
66: source.validate();
67: dirty = false;
68: }
69: }
70:
71: public void reset() {
72: if (dirty)
73: validate();
74: source.reset();
75: }
76:
77: public void close() {
78: if (dirty)
79: validate();
80: source.close();
81: }
82:
83: public boolean available() {
84: if (dirty)
85: validate();
86: return source.available();
87: }
88:
89: public String toString() {
90: return getClass().getSimpleName() + '[' + source + ']';
91: }
92: }
|