01: /**
02: * Copyright 2006 Webmedia Group Ltd.
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: **/package org.araneaframework.uilib.list.util;
16:
17: import org.araneaframework.uilib.list.util.converter.ConversionException;
18:
19: /**
20: * Data converter between <code>source</code> and <code>destination</code>
21: * types.
22: */
23: public interface Converter {
24: /**
25: * Converts data from source type into destination type.
26: *
27: * @param data
28: * Source typed data.
29: * @return Destination typed data.
30: * @throws ConversionException
31: * when convertion fails.
32: */
33: Object convert(Object data) throws ConversionException;
34:
35: /**
36: * Converts data from destination type into source type.
37: *
38: * @param data
39: * Destination typed data.
40: * @return Source typed data.
41: * @throws ConversionException
42: * when convertion fails.
43: */
44: Object reverseConvert(Object data) throws ConversionException;
45:
46: /**
47: * Returns the source data type.
48: *
49: * @return the source data type.
50: */
51: Class getSourceType();
52:
53: /**
54: * Returns the destination data type.
55: *
56: * @return the destination data type.
57: */
58: Class getDestinationType();
59: }
|