All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.skife.config.Bully Maven / Gradle / Ivy

/*
 * Copyright 2020-2021 Equinix, Inc
 * Copyright 2014-2021 The Billing Project, LLC
 *
 * The Billing Project 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 org.skife.config;

import java.lang.reflect.Array;
import java.lang.reflect.Constructor;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.lang.reflect.WildcardType;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

class Bully {

    /**
     * All explicit type conversions that config magic knows about. Every new bully will know about those.
     */
    private static final List> TYPE_COERCIBLES;

    /**
     * Catchall converters. These will be run if no specific type coercer was found.
     */
    private static final List> DEFAULT_COERCIBLES;

    static {
        final List> typeCoercibles = new ArrayList>();
        final List> defaultCoercibles = new ArrayList>();

        typeCoercibles.add(DefaultCoercibles.BOOLEAN_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.BYTE_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.SHORT_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.INTEGER_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.LONG_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.FLOAT_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.DOUBLE_COERCIBLE);
        typeCoercibles.add(DefaultCoercibles.STRING_COERCIBLE);

        // Look Brian, now it groks URIs. ;-)
        typeCoercibles.add(DefaultCoercibles.URI_COERCIBLE);

        defaultCoercibles.add(DefaultCoercibles.CASE_INSENSITIVE_ENUM_COERCIBLE);
        defaultCoercibles.add(DefaultCoercibles.VALUE_OF_COERCIBLE);
        defaultCoercibles.add(DefaultCoercibles.STRING_CTOR_COERCIBLE);
        defaultCoercibles.add(DefaultCoercibles.OBJECT_CTOR_COERCIBLE);

        TYPE_COERCIBLES = Collections.unmodifiableList(typeCoercibles);
        DEFAULT_COERCIBLES = Collections.unmodifiableList(defaultCoercibles);
    }

    /**
     * The instance specific mappings from a given type to its coercer. This needs to be two-level because the
     * catchall converters will generate specific instances of their coercers based on the type.
     */
    private final Map, Coercer> mappings = new HashMap, Coercer>();

    /**
     * All the coercibles that this instance knows about. This list can be extended with user mappings.
     */
    private final List> coercibles = new ArrayList>();

    public Bully() {
        coercibles.addAll(TYPE_COERCIBLES);
    }

    /**
     * Adds a new Coercible to the list of known coercibles. This also resets the current mappings in this bully.
     */
    public void addCoercible(final Coercible coercible) {
        coercibles.add(coercible);
        mappings.clear();
    }

    public synchronized Object coerce(final Type type, final String value, final Separator separator) {
        if (type instanceof Class) {
            final Class clazz = (Class) type;

            if (clazz.isArray()) {
                return coerceArray(clazz.getComponentType(), value, separator);
            } else if (Class.class.equals(clazz)) {
                return coerceClass(type, null, value);
            } else {
                return coerce(clazz, value);
            }
        } else if (type instanceof ParameterizedType) {
            final ParameterizedType parameterizedType = (ParameterizedType) type;
            final Type rawType = parameterizedType.getRawType();

            if (rawType instanceof Class) {
                final Type[] args = parameterizedType.getActualTypeArguments();

                if (args != null && args.length == 1) {
                    if (args[0] instanceof Class) {
                        return coerceCollection((Class) rawType, (Class) args[0], value, separator);
                    } else if (args[0] instanceof WildcardType) {
                        return coerceClass(type, (WildcardType) args[0], value);
                    }
                }
            }
        }
        throw new IllegalStateException(String.format("Don't know how to handle a '%s' type for value '%s'", type, value));
    }

    private boolean isAssignableFrom(final Type targetType, final Class assignedClass) {
        if (targetType instanceof Class) {
            return ((Class) targetType).isAssignableFrom(assignedClass);
        } else if (targetType instanceof WildcardType) {
            final WildcardType wildcardType = (WildcardType) targetType;

            // Class
            for (final Type upperBoundType : wildcardType.getUpperBounds()) {
                if (!Object.class.equals(upperBoundType)) {
                    if ((upperBoundType instanceof Class) && !((Class) upperBoundType).isAssignableFrom(assignedClass)) {
                        return false;
                    }
                }
            }
        }
        return true;
    }

    private Class coerceClass(final Type type, final WildcardType wildcardType, final String value) {
        if (value == null) {
            return null;
        } else {
            try {
                final Class clazz = Class.forName(value);

                if (!isAssignableFrom(wildcardType, clazz)) {
                    throw new IllegalArgumentException("Specified class " + clazz + " is not compatible with required type " + type);
                }
                return clazz;
            } catch (final Exception ex) {
                throw new IllegalArgumentException(ex);
            }
        }
    }

    private Object coerceArray(final Class elemType, final String value, final Separator separator) {
        if (value == null) {
            return null;
        } else if (value.length() == 0) {
            return Array.newInstance(elemType, 0);
        } else {
            final String[] tokens = value.split(separator == null ? Separator.DEFAULT : separator.value());
            final Object targetArray = Array.newInstance(elemType, tokens.length);

            for (int idx = 0; idx < tokens.length; idx++) {
                Array.set(targetArray, idx, coerce(elemType, tokens[idx]));
            }
            return targetArray;
        }
    }

    @SuppressWarnings({"rawtypes", "unchecked"})
    private Object coerceCollection(final Class containerType, final Class elemType, final String value, final Separator separator) {
        if (value == null) {
            return null;
        } else {
            Collection result = null;

            if (Set.class.equals(containerType)) {
                result = new LinkedHashSet();
            } else if (Collection.class.equals(containerType) || List.class.equals(containerType)) {
                result = new ArrayList();
            } else if (Collection.class.isAssignableFrom(containerType)) {
                try {
                    final Constructor ctor = containerType.getConstructor();

                    if (ctor != null) {
                        result = (Collection) ctor.newInstance();
                    }
                } catch (final Exception ex) {
                    // handled below
                }
            }
            if (result == null) {
                throw new IllegalStateException(String.format("Don't know how to handle a '%s' container type for value '%s'", containerType, value));
            }
            if (value.length() > 0) {
                for (final String token : value.split(separator == null ? Separator.DEFAULT : separator.value())) {
                    result.add(coerce(elemType, token));
                }
            }
            return result;
        }
    }

    private Object coerce(final Class clazz, final String value) {
        Coercer coercer = getCoercerFor(coercibles, clazz);
        if (coercer == null) {
            coercer = getCoercerFor(DEFAULT_COERCIBLES, clazz);

            if (coercer == null) {
                throw new IllegalStateException(String.format("Don't know how to handle a '%s' type for value '%s'", clazz, value));
            }
        }
        return coercer.coerce(value);
    }

    private Coercer getCoercerFor(final List> coercibles, final Class type) {
        Coercer typeCoercer = mappings.get(type);
        if (typeCoercer == null) {
            for (final Coercible coercible : coercibles) {
                final Coercer coercer = coercible.accept(type);
                if (coercer != null) {
                    mappings.put(type, coercer);
                    typeCoercer = coercer;
                    break;
                }
            }
        }
        return typeCoercer;
    }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy