Configuration (ODPS SDK Commons for Mapreduce/Graph 0.17.3 API)

java.lang.Object
- com.aliyun.odps.conf.Configuration

所有已实现的接口:

Writable, Iterable<Map.Entry<String,String>>
```
public class Configuration
extends Object
implements Iterable<Map.Entry<String,String>>, Writable
```
配置类，提供读取和设置配置参数的方法.
配置文件

支持从配置文件中读取配置信息或写出配置信息，配置文件是标准的 XML，包含一组 name/value 对，示例如下：
```
 <configuration>
  <property>
   <name>com.mycomp.xxx</name>
   <value>xxx</value>
  </property>
  ... ...
 </configuration>
 
```
通过writeXml(OutputStream) 可以将配置信息输入到文件。

变量引用

配置项的值可以使用变量引用，例如：${user.name}，变量替换的规则：
1. 首先，检查变量名是否是 System.getProperties() 的系统参数，如果是，则使用系统参数的取值。
2. 如果变量名不是系统参数，检查是否已定义的配置项，如果是，则使用已定义配置项的取值。
变量引用示例：
```
  <property>
    <name>basedir</name>
    <value>/user/${user.name}</value>
  </property>

  <property>
    <name>tempdir</name>
    <value>${basedir}/tmp</value>
  </property>
 
```

构造器概要

构造器
构造器和说明
`Configuration()` 默认Configuration构造方法，这个方法会载入默认配置。
`Configuration(boolean loadDefaults)` Configuration构造方法，这个方法可以指定是否载入默认配置。
`Configuration(Configuration other)` Configuration的拷贝构造方法。

方法概要

方法
限定符和类型	方法和说明
`static void`	`addDefaultResource(String name)` 增加一个默认配置。
`void`	`addResource(InputStream in)` 增加一个配置。
`void`	`addResource(String name)` 增加一个配置。
`void`	`addResource(URL url)` 增加一个配置。
`void`	`clear()` 清除所有配置
`String`	`get(String name)` 获取参数`name`的值，如果不存在，返回`null`。
`String`	`get(String name, String defaultValue)` 获取参数`name`的值，如果不存在，返回`defaultValue`。
`boolean`	`getBoolean(String name, boolean defaultValue)` 获取参数`name`的布尔值，如果不存在，返回`defaultValue`。
`Class<?>`	`getClass(String name, Class<?> defaultValue)` 获取参数`name`指定的类对象，如果不存在，返回`defaultValue`。
`<U> Class<? extends U>`	`getClass(String name, Class<? extends U> defaultValue, Class<U> xface)` 获取参数`name`指定的类对象，这个类实现的接口由 `xface`指定。
`Class<?>`	`getClassByName(String name)` 根据类名载入Java类
`Class<?>[]`	`getClasses(String name, Class<?>... defaultValue)` 获取参数`name`指定的类对象数组，如果不存在，返回`defaultValue`。
`ClassLoader`	`getClassLoader()` 获取`ClassLoader`
`InputStream`	`getConfResourceAsInputStream(String name)` 获取一个指定配置文件的 `InputStream`
`Reader`	`getConfResourceAsReader(String name)` 获取一个指定配置文件的 `Reader`
`File`	`getFile(String dirsProp, String path)` 获取一个本地文件，其父目录由名称为 dirsProp 的参数指定，路径为 path.
`float`	`getFloat(String name, float defaultValue)` 获取参数`name`的浮点值，如果不存在，返回`defaultValue`。
`int`	`getInt(String name, int defaultValue)` 获取参数`name`的整形值，如果不存在，返回`defaultValue`。
`long`	`getLong(String name, long defaultValue)` 获取参数`name`的长整形值，如果不存在，返回`defaultValue`。
`com.aliyun.odps.conf.Configuration.IntegerRanges`	`getRange(String name, String defaultValue)` 获取参数`name`的值为一个区间，如果不存在，返回`defaultValue`指定的区间。
`String`	`getRaw(String name)` 获取参数`name`的值，不使用变量展开。
`URL`	`getResource(String name)` 获取指定配置文件的`URL`
`Collection<String>`	`getStringCollection(String name)` 获取参数`name`的字符值集合，如果不存在，返回`null`。
`String[]`	`getStrings(String name)` 获取参数`name`的字符数组值，如果不存在，返回`null`。
`String[]`	`getStrings(String name, String... defaultValue)` 获取参数`name`的字符数组值，如果不存在，返回`defaultValue`。
`Iterator<Map.Entry<String,String>>`	`iterator()` 所有配置的迭代器，格式为key/value。
`void`	`readFields(DataInput in)` 从 `DataInput` 读取
`void`	`reloadConfiguration()` 从已经添加的资源中重新载入`Configuration`。
`void`	`set(String name, String value)` 设置参数`name`的值 `value` 。
`void`	`setBoolean(String name, boolean value)` 设定参数 `name` 的布尔值
`void`	`setBooleanIfUnset(String name, boolean value)` 如果参数 `name` 未设定，设定它的布尔值
`void`	`setClass(String name, Class<?> theClass, Class<?> xface)` 设置`name`参数指定的类，这个类实现的接口由 `xface`指定。
`void`	`setClassLoader(ClassLoader classLoader)` 设置`ClassLoader`对象
`void`	`setFloat(String name, float value)` 设定参数 `name` 的浮点值
`void`	`setIfUnset(String name, String value)` 如果指定参数不存在则设定它
`void`	`setInt(String name, int value)` 设定参数 `name` 的整形值
`void`	`setLong(String name, long value)` 设定参数 `name` 的长整形值
`void`	`setQuietMode(boolean quietmode)` 设定quiet模式。
`void`	`setStrings(String name, String... values)` 设置参数`name` 的字符串数组值 `value` 。
`int`	`size()` 配置项的计数
`String`	`toString()`
`void`	`write(DataOutput out)` 输出到 `DataOutput`
`void`	`writeXml(OutputStream out)` 写出所有非默认的参数到一个 `OutputStream`

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - Configuration
```
public Configuration()
```
    默认Configuration构造方法，这个方法会载入默认配置。
  - Configuration
```
public Configuration(boolean loadDefaults)
```
    Configuration构造方法，这个方法可以指定是否载入默认配置。如果参数loadDefaults 是false，构造的实例不会从文件中载入默认配置。
    
    参数:
    loadDefaults - 指定是否载入默认配置
  - Configuration
```
public Configuration(Configuration other)
```
    Configuration的拷贝构造方法。
    
    参数:
    other - 拷贝的初始实例
- 方法详细资料
  - addDefaultResource
```
public static void addDefaultResource(String name)
```
    增加一个默认配置。默认配置是按照增加的顺序来读取的。
    
    参数:
    name - 配置文件名。这个文件必须在classpath中。
  - addResource
```
public void addResource(String name)
```
    增加一个配置。新配置会覆盖默认配置，除非配置参数被设定为 final.
    
    参数:
    name - 配置文件名。这个文件必须在classpath中。
  - addResource
```
public void addResource(URL url)
```
    增加一个配置。新配置会覆盖默认配置，除非配置参数被设定为 final.
    
    参数:
    url - 配置文件的url名。会从指定url的本地文件系统中获取配置文件。
  - addResource
```
public void addResource(InputStream in)
```
    增加一个配置。新配置会覆盖默认配置，除非配置参数被设定为 final.
    
    参数:
    in - 配置文件的输入流。
  - reloadConfiguration
```
public void reloadConfiguration()
```
    从已经添加的资源中重新载入Configuration。这个方法会清空所有配置，并从配置文件重新载入一份新的配置。
  - get
```
public String get(String name)
```
    获取参数name的值，如果不存在，返回null。参数值会使用变量展开。
    
    参数:
    name - 参数名
    
    返回:
    参数name的字符串值, 如果不存在，返回null。
  - getRaw
```
public String getRaw(String name)
```
    获取参数name的值，不使用变量展开。
    
    参数:
    name - 参数名
    
    返回:
    参数name的值, 如果不存在，返回null。
  - set
```
public void set(String name,
       String value)
```
    设置参数name的值 value 。
    
    参数:
    name - 参数名
    value - 参数值
  - setIfUnset
```
public void setIfUnset(String name,
              String value)
```
    如果指定参数不存在则设定它
    
    参数:
    name - 参数名
    value - 参数值
  - get
```
public String get(String name,
         String defaultValue)
```
    获取参数name的值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的字符串值，如果不存在，返回defaultValue。
  - getInt
```
public int getInt(String name,
         int defaultValue)
```
    获取参数name的整形值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的整形值，如果不存在，返回defaultValue。
  - setInt
```
public void setInt(String name,
          int value)
```
    设定参数 name 的整形值
    
    参数:
    name - 参数名
    value - 整形的参数值
  - getLong
```
public long getLong(String name,
           long defaultValue)
```
    获取参数name的长整形值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的长整型值，如果不存在，返回defaultValue。
  - setLong
```
public void setLong(String name,
           long value)
```
    设定参数 name 的长整形值
    
    参数:
    name - 参数名
    value - 长整形的参数值
  - getFloat
```
public float getFloat(String name,
             float defaultValue)
```
    获取参数name的浮点值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的浮点值，如果不存在，返回defaultValue。
  - setFloat
```
public void setFloat(String name,
            float value)
```
    设定参数 name 的浮点值
    
    参数:
    name - 参数名
    value - 浮点形的参数值
  - getBoolean
```
public boolean getBoolean(String name,
                 boolean defaultValue)
```
    获取参数name的布尔值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的布尔值，如果不存在，返回defaultValue。
  - setBoolean
```
public void setBoolean(String name,
              boolean value)
```
    设定参数 name 的布尔值
    
    参数:
    name - 参数名
    value - 布尔形的参数值
  - setBooleanIfUnset
```
public void setBooleanIfUnset(String name,
                     boolean value)
```
    如果参数 name 未设定，设定它的布尔值
    
    参数:
    name - 参数名
    value - 布尔形的参数值
  - getRange
```
public com.aliyun.odps.conf.Configuration.IntegerRanges getRange(String name,
                                                        String defaultValue)
```
    获取参数name的值为一个区间，如果不存在，返回defaultValue指定的区间。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的数字区间
  - getStringCollection
```
public Collection<String> getStringCollection(String name)
```
    获取参数name的字符值集合，如果不存在，返回null。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的字符数组值，如果不存在，返回null。
  - getStrings
```
public String[] getStrings(String name)
```
    获取参数name的字符数组值，如果不存在，返回null。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的字符数组值，如果不存在，返回null。
  - getStrings
```
public String[] getStrings(String name,
                  String... defaultValue)
```
    获取参数name的字符数组值，如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name的字符数组值，如果不存在，返回defaultValue。
  - setStrings
```
public void setStrings(String name,
              String... values)
```
    设置参数name 的字符串数组值 value 。
    
    参数:
    name - 参数名
    values - 参数值
  - getClassByName
```
public Class<?> getClassByName(String name)
                        throws ClassNotFoundException
```
    根据类名载入Java类
    
    参数:
    name - 类名
    
    返回:
    载入类的实例
    
    抛出:
    
    ClassNotFoundException - 如果找不到指定的Java类
  - getClasses
```
public Class<?>[] getClasses(String name,
                    Class<?>... defaultValue)
```
    获取参数name指定的类对象数组，如果不存在，返回defaultValue。如果类未能找到，则会抛出RuntimeException。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name指定的类对象数组，如果参数未指定，返回defaultValue
  - getClass
```
public Class<?> getClass(String name,
                Class<?> defaultValue)
```
    获取参数name指定的类对象，如果不存在，返回defaultValue。如果类未能找到，则会抛出RuntimeException。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    
    返回:
    参数name指定的类对象，如果参数未指定，返回defaultValue
  - getClass
```
public <U> Class<? extends U> getClass(String name,
                              Class<? extends U> defaultValue,
                              Class<U> xface)
```
    获取参数name指定的类对象，这个类实现的接口由 xface指定。如果不存在，返回defaultValue。
    
    参数:
    name - 参数名
    defaultValue - 默认值
    xface - 指定类实现的接口
    
    返回:
    参数name指定的类对象, 如果参数未指定，返回 defaultValue
  - setClass
```
public void setClass(String name,
            Class<?> theClass,
            Class<?> xface)
```
    设置name参数指定的类，这个类实现的接口由 xface指定。
    
    参数:
    name - 参数名
    theClass - 参数值
    xface - 指定的类实现的接口
  - getFile
```
public File getFile(String dirsProp,
           String path)
             throws IOException
```
    获取一个本地文件，其父目录由名称为 dirsProp 的参数指定，路径为 path. 如果 dirsProp 包含多个目录, 则返回其中的一个文件。如果指定的文件不存在则创建它。
    
    参数:
    dirsProp - directory in which to locate the file.
    path - file-path.
    
    返回:
    local file under the directory with the given path.
    
    抛出:
    
    IOException
  - getResource
```
public URL getResource(String name)
```
    获取指定配置文件的URL
    
    参数:
    name - 配置文件名
    
    返回:
    指定配置文件的URL
  - getConfResourceAsInputStream
```
public InputStream getConfResourceAsInputStream(String name)
```
    获取一个指定配置文件的 InputStream
    
    参数:
    name - 配置文件名
    
    返回:
    指定配置文件的InputStream
  - getConfResourceAsReader
```
public Reader getConfResourceAsReader(String name)
```
    获取一个指定配置文件的 Reader
    
    参数:
    name - 配置文件名
    
    返回:
    指定配置文件的Reader
  - size
```
public int size()
```
    配置项的计数
    
    返回:
    配置项的计数
  - clear
```
public void clear()
```
    清除所有配置
  - iterator
```
public Iterator<Map.Entry<String,String>> iterator()
```
    所有配置的迭代器，格式为key/value。key和value的类型都为string。
    
    指定者:
    
    iterator 在接口中 Iterable<Map.Entry<String,String>>
    
    返回:
    配置的迭代器
  - writeXml
```
public void writeXml(OutputStream out)
              throws IOException
```
    写出所有非默认的参数到一个 OutputStream
    
    参数:
    out - 输出的OutputStream
    
    抛出:
    
    IOException
  - getClassLoader
```
public ClassLoader getClassLoader()
```
    获取ClassLoader
    
    返回:
    ClassLoader对象
  - setClassLoader
```
public void setClassLoader(ClassLoader classLoader)
```
    设置ClassLoader对象
    
    参数:
    classLoader - 新的ClassLoader对象
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object
  - setQuietMode
```
public void setQuietMode(boolean quietmode)
```
    设定quiet模式。quiet模式下，错误等信息不会记录在日志里。
    
    参数:
    quietmode - true 打开， false 关闭。
  - readFields
```
public void readFields(DataInput in)
                throws IOException
```
    从 DataInput 读取
    
    指定者:
    
    readFields 在接口中 Writable
    
    抛出:
    
    IOException
  - write
```
public void write(DataOutput out)
           throws IOException
```
    输出到 DataOutput
    
    指定者:
    
    write 在接口中 Writable
    
    抛出:
    
    IOException

类 Configuration

配置文件

变量引用

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Configuration

Configuration

Configuration

方法详细资料

addDefaultResource

addResource

addResource

addResource

reloadConfiguration

get

getRaw

set

setIfUnset

get

getInt

setInt

getLong

setLong

getFloat

setFloat

getBoolean

setBoolean

setBooleanIfUnset

getRange

getStringCollection

getStrings

getStrings

setStrings

getClassByName

getClasses

getClass

getClass

setClass

getFile

getResource

getConfResourceAsInputStream

getConfResourceAsReader

size

clear

iterator

writeXml

getClassLoader

setClassLoader

toString

setQuietMode

readFields

write