01: /*
02: * Copyright (c) 2004 JETA Software, Inc. All rights reserved.
03: *
04: * Redistribution and use in source and binary forms, with or without modification,
05: * are permitted provided that the following conditions are met:
06: *
07: * o Redistributions of source code must retain the above copyright notice,
08: * this list of conditions and the following disclaimer.
09: *
10: * o Redistributions in binary form must reproduce the above copyright notice,
11: * this list of conditions and the following disclaimer in the documentation
12: * and/or other materials provided with the distribution.
13: *
14: * o Neither the name of JETA Software nor the names of its contributors may
15: * be used to endorse or promote products derived from this software without
16: * specific prior written permission.
17: *
18: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21: * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
22: * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23: * INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
24: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
25: * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26: * INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28: */
29:
30: package com.jeta.forms.gui.beans.factories;
31:
32: import com.jeta.forms.gui.beans.JETABean;
33: import com.jeta.forms.gui.common.FormException;
34:
35: /**
36: * Defines an interface for creating a JETABean, it's associated Java Bean, and
37: * any custom properties. The BeanFactories are responsible for instantiating
38: * all Swing components and defining custom properties and default values for
39: * each type of Swing component.
40: *
41: * @author Jeff Tassin
42: */
43: public interface BeanFactory {
44: /**
45: * Instantiates a JETABean and assigns any custom properties needed by the
46: * application.
47: *
48: * @param compName
49: * the name to assign to this component by calling
50: * Component.setName
51: * @param instantiateBean
52: * set to true if the underlying Java Bean should be instantiated
53: * as well. During deserialization we don't want to do this
54: * because the BeanDeserializer will create the JavaBean for us.
55: * @param setDefaults
56: * sets default properties for the bean. If false, no properties
57: * will be set (e.g. the text for a JButton)
58: * @return the newly instantiated JETABean
59: */
60: public JETABean createBean(String compName,
61: boolean instantiateBean, boolean setDefaults)
62: throws FormException;
63:
64: }
|