summaryrefslogtreecommitdiffstats
path: root/sandbox/kgoodson/mappingFramework/sdo-snapshot/src/main/java/com/agfa/hap/sdo/impl/TypeConverter.java
blob: 973266e5251a2c29a17d62daa7496cc55594c5f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
/**
 *
 *  Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you under the Apache License, Version 2.0 (the
 *  "License"); you may not use this file except in compliance
 *  with the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing,
 *  software distributed under the License is distributed on an
 *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 *  KIND, either express or implied.  See the License for the
 *  specific language governing permissions and limitations
 *  under the License.
 */
package com.agfa.hap.sdo.impl;

import java.io.Serializable;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

import com.agfa.hap.sdo.Type;

/**
 * Class that provides
 * an implementation to convert instances from and to a string. This is typically
 * used in sdo xml conversions and snapshots.
 * <P>
 * A custom sdo basic type can register an appropriate typeConverter. 
 */
public abstract class TypeConverter<T> {

    /**
     * Parse the string and return an instance of the implementation class
     * with a value that is represented by the string parameter.
     */
    public abstract T parse(String str);
    
    /**
     * Convert the instance to a string. The instance is guaranteed to be of type
     * T.
     */
    public abstract String toString(T instance);
    
    /**
     * @return The type converter instance registered with that name or null if nothing
     * is found.
     */
    @SuppressWarnings("unchecked")
    public static <U> TypeConverter<U> get(Type type) {
        return registry.get(type);
    }
    
    public static void register(Type type, TypeConverter converter) {
        registry.put(type, converter);
    }
    
    /**
     * Returns the default TypeConverter for the given clazz. Checks for Enums 
     * and classes that implement {@link Serializable}.
     */
    public static <T> TypeConverter<T> getDefaultConverter(Class<T> clazz) {
    	if (clazz.isEnum()) {
    		return new EnumTypeConverter(clazz);
    	}
    	if (Serializable.class.isAssignableFrom(clazz)) {
    		return (TypeConverter<T>) new SerializableTypeConverter();
    	}
    	return null;
    }
    
    private static Map<Type, TypeConverter> registry = new ConcurrentHashMap<Type, TypeConverter>();
}