org.apache.brooklyn.config.ConfigMap Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of brooklyn-utils-common Show documentation

Utility classes and methods developed for Brooklyn but not dependendent on Brooklyn or much else

There is a newer version: 1.1.0

Show newest version

/*
 * 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 org.apache.brooklyn.config;

import java.util.Map;

import org.apache.brooklyn.config.ConfigKey.HasConfigKey;
import org.apache.brooklyn.util.guava.Maybe;

import com.google.common.base.Predicate;

public interface ConfigMap {
    
    /** @see #getConfig(ConfigKey, Object), with default value as per the key, or null */
    public  T getConfig(ConfigKey key);
    
    /** @see #getConfig(ConfigKey, Object), with default value as per the key, or null */
    public  T getConfig(HasConfigKey key);
    
    /**
     * @see #getConfig(ConfigKey, Object), with provided default value if not set
     * @deprecated since 0.7.0; use {@link #getConfig(HasConfigKey)}
     */
    @Deprecated
    public  T getConfig(HasConfigKey key, T defaultValue);
    
    /**
     * Returns value stored against the given key,
     * resolved (if it is a Task, possibly blocking), and coerced to the appropriate type, 
     * or given default value if not set, 
     * unless the default value is null in which case it returns the default.
     * 
     * @deprecated since 0.7.0; use {@link #getConfig(ConfigKey)}
     */
    @Deprecated
    public  T getConfig(ConfigKey key, T defaultValue);

    /** as {@link #getConfigRaw(ConfigKey)} but returning null if not present 
     * @deprecated since 0.7.0 use {@link #getConfigRaw(ConfigKey)} */
    @Deprecated
    public Object getRawConfig(ConfigKey key);
    
    /** returns the value stored against the given key, 
     * not any default,
     * not resolved (and guaranteed non-blocking),
     * and not type-coerced.
     * @param key  key to look up
     * @param includeInherited  for {@link ConfigMap} instances which have an inheritance hierarchy, 
     *        whether to traverse it or not; has no effects where there is no inheritance 
     * @return raw, unresolved, uncoerced value of key in map,  
     *         but not any default on the key
     */
    public Maybe