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.store.bean;
31:
32: import java.io.OutputStream;
33:
34: import com.jeta.forms.gui.beans.JETABean;
35: import com.jeta.forms.gui.common.FormException;
36: import com.jeta.forms.store.memento.PropertiesMemento;
37:
38: /**
39: * This interface defines how to store the JETABean properties to a
40: * PropertiesMemento object. See
41: * {@link com.jeta.forms.store.memento.PropertiesMemento}
42: *
43: * @author Jeff Tassin
44: */
45: public interface BeanSerializer {
46: /**
47: * Writes the bean state to an output stream as a PropertiesMemento object.
48: *
49: * @param ostream
50: * the output stream to write to.
51: * @param jbean
52: * the JETABean whose state to persist.
53: */
54: void writeBean(OutputStream ostream, JETABean jbean)
55: throws FormException;
56:
57: /**
58: * Writes the bean state (properties) to a PropertiesMemento
59: *
60: * @param jbean
61: * the JETABean whose state to persist.
62: * @return a properties memento that contains the property values for the
63: * bean.
64: */
65: PropertiesMemento writeBean(JETABean jbean) throws FormException;
66: }
|