KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > inversoft > beans > ConversionListener


1 /*
2  * Copyright (c) 2003, Inversoft
3  *
4  * This software is distribuable under the GNU Lesser General Public License.
5  * For more information visit gnu.org.
6  */
7 package com.inversoft.beans;
8
9
10 import java.util.EventListener JavaDoc;
11
12
13 /**
14  * <p>
15  * This interface is the event listener interface for
16  * conversion events. These events occur when a BeanProperty
17  * or similar class is setting a property value and
18  * automatically converting the property value to the
19  * correct type for the property.
20  * </p>
21  *
22  * <p>
23  * The different types of events that this listener watchs are:<br>
24  * <ul>
25  * <li>Before property value conversion when the property is being set</li>
26  * <li>After property value conversion when the property is being set</li>
27  * <li>After property value conversion when the conversion failed</li>
28  * </ul>
29  * </p>
30  *
31  * @author Brian Pontarelli
32  */
33 public interface ConversionListener extends EventListener JavaDoc {
34
35     /**
36      * This handle method is called when the property value being set is going
37      * to be auto-converted but has not been converted yet.
38      */
39     void handlePreConversion(ConversionEvent event);
40
41     /**
42      * This handle method is called when the property value being set has just been
43      * successfully auto-converted
44      */
45     void handlePostConversion(ConversionEvent event);
46
47     /**
48      * This handle method is called when the property value being set has been
49      * converted and the conversion failed
50      */
51     void handleFailedConversion(ConversionEvent event);
52 }
53
Popular Tags