org.hibernate.engine.config.spi.ConfigurationService.java Source code

Introduction

Here is the source code for org.hibernate.engine.config.spi.ConfigurationService.java

Source

/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.engine.config.spi;

import java.util.Map;

import org.hibernate.service.Service;

/**
 * Provides access to the initial user-provided configuration values.  Generally speaking
 * these values come from:<ul>
 *     <li>Calls to {@link org.hibernate.boot.registry.StandardServiceRegistryBuilder#loadProperties}</li>
 *     <li>Calls to {@link org.hibernate.boot.registry.StandardServiceRegistryBuilder#applySetting}</li>
 *     <li>Calls to {@link org.hibernate.boot.registry.StandardServiceRegistryBuilder#applySettings}</li>
 *     <li>Calls to {@link org.hibernate.boot.registry.StandardServiceRegistryBuilder#configure}</li>
 * </ul>
 *
 * @author Steve Ebersole
 */
public interface ConfigurationService extends Service {
    /**
     * Access to the complete map of config settings.  The returned map is immutable
     *
     * @return The immutable map of config settings.
     */
    public Map getSettings();

    /**
     * Get the named setting, using the specified converter.
     *
     * @param name The name of the setting to get.
     * @param converter The converter to apply
     * @param <T> The Java type of the conversion
     *
     * @return The converted (typed) setting.  May return {@code null} (see {@link #getSetting(String, Class, Object)})
     */
    public <T> T getSetting(String name, Converter<T> converter);

    /**
     * Get the named setting, using the specified converter and default value.
     *
     * @param name The name of the setting to get.
     * @param converter The converter to apply
     * @param defaultValue If no setting with that name is found, return this default value as the result.
     * @param <T> The Java type of the conversion
     *
     * @return The converted (typed) setting.  Will be the defaultValue if no such setting was defined.
     */
    public <T> T getSetting(String name, Converter<T> converter, T defaultValue);

    /**
     * Get the named setting.  Differs from the form taking a Converter in that here we expect to have a simple
     * cast rather than any involved conversion.
     *
     * @param name The name of the setting to get.
     * @param expected The expected Java type.
     * @param defaultValue If no setting with that name is found, return this default value as the result.
     * @param <T> The Java type of the conversion
     *
     * @return The converted (typed) setting.  Will be the defaultValue if no such setting was defined.
     */
    public <T> T getSetting(String name, Class<T> expected, T defaultValue);

    /**
     * Cast <tt>candidate</tt> to the instance of <tt>expected</tt> type.
     *
     * @param expected The type of instance expected to return.
     * @param candidate The candidate object to be casted.
     * @param <T> The java type of the expected return
     *
     * @return The instance of expected type or null if this cast fail.
     *
     * @deprecated No idea why this is exposed here...
     */
    @Deprecated
    public <T> T cast(Class<T> expected, Object candidate);

    /**
     * Simple conversion contract for converting an untyped object to a specified type.
     *
     * @param <T> The Java type of the converted value
     */
    public static interface Converter<T> {
        /**
         * Convert an untyped Object reference to the Converter's type.
         *
         * @param value The untyped value
         *
         * @return The converted (typed) value.
         */
        public T convert(Object value);
    }
}