org.apache.brooklyn.config.ConfigKey Maven / Gradle / Ivy
Show all versions of brooklyn-utils-common Show documentation
/*
* 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.Collection;
import java.util.Map;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import org.apache.brooklyn.config.ConfigInheritance.ConfigInheritanceContext;
import com.google.common.annotations.Beta;
import com.google.common.base.Predicate;
import com.google.common.reflect.TypeToken;
/**
* Represents the name of a piece of typed configuration data for an entity.
*
* Two ConfigKeys should be considered equal if they have the same FQN.
*/
public interface ConfigKey {
/**
* Returns the description of the configuration parameter, for display.
*/
String getDescription();
/**
* Returns the name of the configuration parameter, in a dot-separated namespace (FQN).
*/
String getName();
/**
* Returns deprecated names that will could also be used, but that are discouraged and will
* likely not be supported for the given config key in future versions.
*/
Collection getDeprecatedNames();
/**
* Returns the constituent parts of the configuration parameter name as a {@link Collection}.
*
* @deprecated since 0.12.0; use {@link #getName()}
*/
@Deprecated
Collection getNameParts();
/**
* Returns the Guava TypeToken, including info on generics.
*/
TypeToken getTypeToken();
/**
* Returns the type of the configuration parameter data.
*
* This returns a "super" of T only in the case where T is generified,
* and in such cases it returns the Class instance for the unadorned T ---
* i.e. for List<String> this returns Class<List> ---
* this is of course because there is no actual Class<List<String>> instance.
*/
Class getType();
/**
* Returns the name of of the configuration parameter data type, as a {@link String}.
*/
String getTypeName();
/**
* Returns the default value of the configuration parameter.
*/
T getDefaultValue();
/**
* Returns true if a default configuration value has been set.
*/
boolean hasDefaultValue();
/**
* @return True if the configuration can be changed at runtime.
*/
boolean isReconfigurable();
/**
* @return The sub-typing inheritance model, or null
for the default in any context.
* @deprecated since 0.10.0 use {@link #getInheritanceByContext()} */
@Deprecated @Nullable
ConfigInheritance getTypeInheritance();
/**
* @return The inheritance-from-parent-entities model, or null
for the default in any context.
* @deprecated since 0.10.0 use {@link #getInheritanceByContext()} */
@Deprecated @Nullable
ConfigInheritance getParentInheritance();
/**
* @return The inheritance model, or null
for the default in any context.
* @deprecated since 0.10.0 use {@link #getInheritanceByContext()} */
@Deprecated @Nullable
ConfigInheritance getInheritance();
/** @return The inheritance model for this key in the given {@link ConfigInheritanceContext} */
@Nullable ConfigInheritance getInheritanceByContext(ConfigInheritanceContext context);
/** @return A summary of the inheritance models for this key in various {@link ConfigInheritanceContext} instances.
* Implementations may have a simple map, whereas others could be more sophisticated.
* {@link #getInheritanceByContext(ConfigInheritanceContext)} may be preferred if inheritance contexts are complex
* (but usually, and in brooklyn, they aren't). */
Map getInheritanceByContext();
/**
* @return The predicate constraining the key's value.
*/
@Beta
@Nonnull
Predicate getConstraint();
/**
* @param value The value to test
* @return True if the given value is acceptable per the {@link #getConstraint constraints} on this key.
*/
@Beta
boolean isValueValid(T value);
/** Interface for elements which want to be treated as a config key without actually being one
* (e.g. config attribute sensors).
*/
public interface HasConfigKey {
public ConfigKey getConfigKey();
}
}