通过代码直接设置Java的DNS - Java Dns Cache Manipulator

n6xb 10年前

通过代码直接设置Java的DNS - Java Dns Cache Manipulator 通过代码直接设置Java的DNS（实际上设置的是DNS Cache），支持JDK 6+。

功能

设置/重置DNS（不会再去Lookup DNS）
- 可以设置单条
- 或是通过Properties文件批量设置
查看DNS Cache内容
删除一条DNS Cache（即重新Lookup DNS）
清空DNS Cache（即所有的域名重新Lookup DNS）

需求场景

一些库中写死了连接域名，需要通过修改host文件绑定才能做测试。结果是：
- 自动持续集成的机器上一般同学是没有权限去修改host文件的，导致项目不能持续集成。
  实际上是因为这点，催生这个库的需求。
- 单元测试需要每个开发都在开发机上做绑定，增加了依赖的配置操作且繁琐重复。
Java的DNS缺省是不会失效的。
如果域名绑定的IP变了，可以通过这个库重置DNS，作为一个临时的手段（强烈不推荐）。
当然往往进行要先有能执行入口，比如远程调用或是jvm-ssh-groovy-shell。

User Guide

通过类DnsCacheManipulator设置DNS。

直接设置

DnsCacheManipulator.setDnsCache("www.hello-world.com", "192.168.10.113");    // 之后Java代码中使用到域名都会解析成上面指定的IP。   // 下面是一个简单获取域名对应的IP，演示一下：    String ip = InetAddress.getByName("www.hello-world.com").getHostAddress(); // ip = "192.168.10.113"

通过dns-cache.properties文件批量配置

在代码测试中，会期望把域名绑定写在配置文件。

使用方式如下：

在ClassPath上，提供文件dns-cache.properties：

# 配置格式： # <host> = <ip> www.hello-world.com=192.168.10.113  www.foo.com=192.168.10.2

然后通过下面的一行代码完成批量设置：

DnsCacheManipulator.loadDnsCacheConfig();

在单元测试中，往往会写在测试类的setUp方法中，如：

@BeforeClass public void beforeClass() throws Exception {  DnsCacheManipulator.loadDnsCacheConfig();  }

更多详细功能参见类DnsCacheManipulator的文档说明。

Java API Docs

Java API文档地址： http://alibaba.github.io/java-dns-cache-manipulator/apidocs

依赖

Maven示例：

<dependency>      <groupId>com.alibaba</groupId>      <artifactId>dns-cache-manipulator</artifactId>      <version>1.0.0</version>  </dependency>

可以在search.maven.org查看可用的版本。

Developer Guide

如何修改JVM的DNS Cache

JVM的DNS Cache维护在类InetAddress的addressCache私有字段中，通过反射来修改，具体参见InetAddressCacheUtil。

注意修改JVM的DNS Cache的线程安全问题

JVM的DNS Cache显然是全局共用的，所以修改需要同步以保证没有并发问题。

通过查看类InetAddress的实现可以确定：通过以addressCache字段为锁的synchronized块来保证线程安全。

其中关键代码（JDK 7）如下：

/*  * Cache the given hostname and addresses.    */  private static void cacheAddresses(String hostname, InetAddress[] addresses, boolean success) {      hostname = hostname.toLowerCase();  synchronized (addressCache) {              cacheInitIfNeeded();  if (success) {              addressCache.put(hostname, addresses);          } else {              negativeCache.put(hostname, addresses);          }      }  }

InetAddressCacheUtil类中对DNS Cache的读写也一致地加了以addressCache为锁的synchronized块，以保证线程安全。