Package org.apache.hadoop.util

Class ConfigurationHelper

java.lang.Object

org.apache.hadoop.util.ConfigurationHelper

@Private
public final class ConfigurationHelper
extends java.lang.Object

Configuration Helper class to provide advanced configuration parsing. Private; external code MUST use Configuration instead

Method Summary

Modifier and Type	Method	Description
static <E extends java.lang.Enum<E>> java.util.Map<java.lang.String,E>	mapEnumNamesToValues(java.lang.String prefix, java.lang.Class<E> enumClass)	Given an enum class, build a map of lower case names to values.
static <E extends java.lang.Enum<E>> java.util.EnumSet<E>	parseEnumSet(java.lang.String key, java.lang.String valueString, java.lang.Class<E> enumClass, boolean ignoreUnknown)	Given a comma separated list of enum values, trim the list, map to enum values in the message (case insensitive) and return the set.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseEnumSet

public static <E extends java.lang.Enum<E>> java.util.EnumSet<E> parseEnumSet(java.lang.String key,
                                                                              java.lang.String valueString,
                                                                              java.lang.Class<E> enumClass,
                                                                              boolean ignoreUnknown)
                                                                       throws java.lang.IllegalArgumentException

Given a comma separated list of enum values, trim the list, map to enum values in the message (case insensitive) and return the set. Special handling of "*" meaning: all values.

Type Parameters:

E - enum type

Parameters:

key - Configuration object key -used in error messages.

valueString - value from Configuration

enumClass - class of enum

ignoreUnknown - should unknown values be ignored?

Returns:

a mutable set of enum values parsed from the valueString, with any unknown matches stripped if ignoreUnknown is true.

Throws:

java.lang.IllegalArgumentException - if one of the entries was unknown and ignoreUnknown is false, or there are two entries in the enum which differ only by case.

mapEnumNamesToValues

public static <E extends java.lang.Enum<E>> java.util.Map<java.lang.String,E> mapEnumNamesToValues(java.lang.String prefix,
                                                                                                         java.lang.Class<E> enumClass)

Given an enum class, build a map of lower case names to values.

Type Parameters:

E - enum type

Parameters:

prefix - prefix (with trailing ".") for path capabilities probe

enumClass - class of enum

Returns:

a mutable map of lower case names to enum values

Throws:

java.lang.IllegalArgumentException - if there are two entries which differ only by case.