org.apache.hadoop.net

类 AbstractDNSToSwitchMapping

java.lang.Object

org.apache.hadoop.net.AbstractDNSToSwitchMapping

所有实现的接口：

Configurable, DNSToSwitchMapping

直接已知子类：

CachedDNSToSwitchMapping

@InterfaceAudience.Public
 @InterfaceStability.Evolving
public abstract class AbstractDNSToSwitchMapping
extends Object
implements DNSToSwitchMapping, Configurable

这是DNS到交换机映射的基类。

虽然不强制要求从该类派生DNSToSwitchMapping实现，但强烈建议这样做，因为这使得Hadoop开发者可以轻松地向该基类添加新方法，这些方法会被所有实现自动继承。

该类不继承Configured基类，也不应修改为继承，因为这会导致子类出现问题。Configured的构造函数会调用setConf(Configuration)方法，该方法会在子类完全构造之前就调用它们。

构造函数摘要

修饰符	构造函数和描述
protected	AbstractDNSToSwitchMapping() 创建一个未配置的实例
protected	AbstractDNSToSwitchMapping(Configuration conf) 创建一个实例，缓存配置文件。

方法摘要

修饰符和类型	方法和描述
String	dumpTopology() 生成一个字符串，列出交换机映射实现、每个已知节点的映射以及已知节点和唯一交换机的数量 - 每个条目单独一行。
配置	获取配置() 返回该对象使用的配置。
Map<String,String>	getSwitchMap() 获取地图副本（用于诊断）
static boolean	isMappingSingleSwitch(DNSToSwitchMapping mapping) Query for a DNSToSwitchMapping instance being on a single switch.
boolean	是否为单交换机() 谓词，表示已知交换映射为单交换。
protected boolean	isSingleSwitchByScriptPolicy()
void	setConf(配置 conf) 设置此对象要使用的配置。

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

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

从接口org.apache.hadoop.net.DNSToSwitchMapping继承的方法

reloadCachedMappings, reloadCachedMappings, resolve

构造函数详情

AbstractDNSToSwitchMapping

protected AbstractDNSToSwitchMapping()

创建一个未配置的实例

AbstractDNSToSwitchMapping

protected AbstractDNSToSwitchMapping(Configuration conf)

创建一个实例，缓存配置文件。 此构造函数不会调用setConf(Configuration)；如果 子类在该方法中提取信息，则必须显式调用它。

参数：

conf - 配置

方法详情

getConf

public Configuration getConf()

从接口复制的描述: Configurable

返回此对象使用的配置。

指定者:

getConf 在接口中 Configurable

返回:

Configuration

setConf

public void setConf(Configuration conf)

从接口复制的描述: Configurable

设置此对象要使用的配置。

指定者:

setConf 在接口中 Configurable

参数:

conf - 要使用的配置

isSingleSwitch

public boolean isSingleSwitch()

用于判断交换机映射是否为单交换机的谓词。基类默认返回false：它假设所有映射都是多机架的。子类可以通过更了解其拓扑结构的方法来覆盖此行为。

当Hadoop需要确定是应用单机架还是多机架策略时（例如在块放置期间），会使用此方法。这类算法在多重交换机系统上的行为会有所不同。

返回值：

如果映射认为处于单交换机环境则返回true

getSwitchMap

public Map<String,String> getSwitchMap()

获取映射的副本（用于诊断）

返回：

映射的克隆，如果未知则返回null

dumpTopology

public String dumpTopology()

生成一个字符串，列出交换机映射实现、每个已知节点的映射信息以及已知节点数量和唯一交换机数量 - 每个条目单独一行。

返回:

可用于呈现给运维团队或用于调试消息的字符串。

isSingleSwitchByScriptPolicy

protected boolean isSingleSwitchByScriptPolicy()

isMappingSingleSwitch

public static boolean isMappingSingleSwitch(DNSToSwitchMapping mapping)

查询DNSToSwitchMapping实例是否位于单一交换机上。

此谓词简单地假设所有非从此类派生的映射都是多交换机的。

参数：

mapping - 要查询的映射

返回值：

如果基类声明其为单交换机，或映射非从此类派生，则返回true。