01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */
17: package org.apache.wicket.util.convert.converters;
18:
19: import java.text.Format;
20: import java.text.ParsePosition;
21: import java.util.Locale;
22:
23: import org.apache.wicket.util.convert.ConversionException;
24: import org.apache.wicket.util.convert.IConverter;
25:
26: /**
27: * Base class for locale aware type converters.
28: *
29: * @author Eelco Hillenius
30: */
31: public abstract class AbstractConverter implements IConverter {
32: /**
33: * Parses a value using one of the java.util.text format classes.
34: *
35: * @param format
36: * The format to use
37: * @param value
38: * The object to parse
39: * @param locale
40: * The locale to use to parse.
41: * @return The object
42: * @throws ConversionException
43: * Thrown if parsing fails
44: */
45: protected Object parse(final Format format, final Object value,
46: Locale locale) {
47: final ParsePosition position = new ParsePosition(0);
48: final String stringValue = value.toString();
49: final Object result = format.parseObject(stringValue, position);
50: if (position.getIndex() != stringValue.length()) {
51: throw newConversionException(
52: "Cannot parse '" + value + "' using format "
53: + format, value, locale).setFormat(format);
54: }
55: return result;
56: }
57:
58: /**
59: * Creates a conversion exception for throwing
60: *
61: * @param message
62: * The message
63: * @param value
64: * The value that didn't convert
65: * @param locale
66: * The locale
67: * @return The ConversionException
68: */
69: protected ConversionException newConversionException(
70: final String message, final Object value, Locale locale) {
71: return new ConversionException(message).setSourceValue(value)
72: .setTargetType(getTargetType()).setConverter(this )
73: .setLocale(locale);
74: }
75:
76: /**
77: * @return The target type of this type converter
78: */
79: protected abstract Class getTargetType();
80:
81: /**
82: * @see org.apache.wicket.util.convert.IConverter#convertToString(java.lang.Object,
83: * Locale)
84: */
85: public String convertToString(Object value, Locale locale) {
86: if (value == null) {
87: return null;
88: }
89: return value.toString();
90: }
91:
92: }
|