• Home
• io.helidon.config
• helidon-config
• 2.0.0-M2
• source code
• AbstractConfigSourceBuilder.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

io.helidon.config.AbstractConfigSourceBuilder Maven / Gradle / Ivy

/*
 * Copyright (c) 2020 Oracle and/or its affiliates.
 *
 * Licensed 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 io.helidon.config;

import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.function.Function;

import io.helidon.config.spi.ConfigParser;
import io.helidon.config.spi.Source;

/**
 * Common ancestor for config source builders, taking care of configurable options understood by the config
 * module.
 *
 * @param  Type of the builder implementation
 * @param  Type of a target if this builder supports change watching, use {@code Void} if not
 */
public abstract class AbstractConfigSourceBuilder, U>
        extends AbstractSourceBuilder
        implements Source.Builder {

    private ConfigParser parser;
    private String mediaType;
    private Function> mediaTypeMapping;
    private Function> parserMapping;

    @SuppressWarnings("unchecked")
    private B me = (B) this;

    /**
     * {@inheritDoc}
     *
     * 
     * 
     * 
     *      
     *      
     *      
     * 
     * 
     *     
     *     
     *     
     * 
     * 
Media type and type mapping
media-type
Media type from loaded data is used by default for parsable config sources
Explicit media type to use, such as when a file has invalid suffix, or when we need to explicitly mark
     *      the media type.
media-type-mapping
No media type mapping is done by default
A mapping of key to a media type, allowing us to have a key that contains a sub-tree (e.g. a key that contains
     *     json data)
     *      - when we configure a mapping of the key to {@code application/json}, the data would be expanded into config
     *      as a proper tree structure
     * @param metaConfig meta configuration of this source
     * @return updated builder instance
     */
    protected B config(Config metaConfig) {
        super.config(metaConfig);

        metaConfig.get("media-type").asString().ifPresent(this::mediaType);
        metaConfig.get("media-type-mapping").detach().asMap()
                .ifPresent(this::mediaTypeMappingConfig);
        return me;
    }

    private void mediaTypeMappingConfig(Map mappingMap) {
        mediaTypeMapping(key -> Optional.ofNullable(mappingMap.get(key.toString())));
    }

    /**
     * Sets a function that maps keys to media type.
     * This supports parsing of values using a {@link io.helidon.config.spi.ConfigParser} to expand an inlined
     * configuration.
     *
     * @param mediaTypeMapping a mapping function
     * @return a modified builder
     */
    public B mediaTypeMapping(Function> mediaTypeMapping) {
        Objects.requireNonNull(mediaTypeMapping, "mediaTypeMapping cannot be null");

        this.mediaTypeMapping = mediaTypeMapping;
        return me;
    }

    /**
     * Sets a function that maps keys to a parser.
     * This supports parsing of specific values using a custom parser to expand an inlined configuration.
     *
     * @param parserMapping a mapping function
     * @return a modified builder
     */
    public B parserMapping(Function> parserMapping) {
        Objects.requireNonNull(parserMapping, "parserMapping cannot be null");

        this.parserMapping = parserMapping;
        return me;
    }

    /**
     * A parser if this is a {@link io.helidon.config.spi.ParsableSource} and explicit parser
     * is configured.
     *
     * @param parser parser configured for this source
     * @return updated builder instance
     */
    protected B parser(ConfigParser parser) {
        this.parser = parser;
        return me;
    }

    Optional>> mediaTypeMapping() {
        return Optional.ofNullable(mediaTypeMapping);
    }

    /**
     * Parser mapping function.
     * @return parser mapping
     */
    Optional>> parserMapping() {
        return Optional.ofNullable(parserMapping);
    }

    /**
     * Media type if this is a {@link io.helidon.config.spi.ParsableSource} and explicit media type
     * is configured.
     *
     * @param mediaType media type configured for this source
     * @return updated builder instance
     */
    protected B mediaType(String mediaType) {
        this.mediaType = mediaType;
        return me;
    }

    Optional parser() {
        return Optional.ofNullable(parser);
    }

    Optional mediaType() {
        return Optional.ofNullable(mediaType);
    }
}