Skip to content

Commit da0d353

Browse files
committed
update readme
1 parent dd3e070 commit da0d353

File tree

3 files changed

+30
-8
lines changed

3 files changed

+30
-8
lines changed

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,20 @@
11
Java Dns Cache Manipulator(DCM)
22
=======================================
33

4-
包含2部分:
4+
[![Build Status](https://travis-ci.org/alibaba/java-dns-cache-manipulator.svg?branch=master)](https://travis-ci.org/alibaba/java-dns-cache-manipulator)
5+
[![Windows Build Status](https://img.shields.io/appveyor/ci/oldratlee/java-dns-cache-manipulator/master.svg?label=windows%20build)](https://ci.appveyor.com/project/oldratlee/java-dns-cache-manipulator)
6+
[![Coverage Status](https://coveralls.io/repos/alibaba/java-dns-cache-manipulator/badge.svg?branch=master)](https://coveralls.io/r/alibaba/java-dns-cache-manipulator?branch=master)
7+
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.alibaba/dns-cache-manipulator/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.alibaba/dns-cache-manipulator/)
8+
[![GitHub release](https://img.shields.io/github/release/alibaba/java-dns-cache-manipulator.svg)](https://github.com/alibaba/java-dns-cache-manipulator/releases)
9+
[![Dependency Status](https://www.versioneye.com/user/projects/553a2f981d2989f7ee0000a7/badge.svg?style=flat)](https://www.versioneye.com/user/projects/553a2f981d2989f7ee0000a7)
10+
[![GitHub issues](https://img.shields.io/github/issues/alibaba/java-dns-cache-manipulator.svg)](https://github.com/alibaba/java-dns-cache-manipulator/issues)
11+
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
12+
13+
包含子工程:
514

615
- [Java Dns Cache Manipulator Library](library)
716
通过代码直接设置`Java``DNS`(实际上设置的是`DNS Cache`),支持`JDK 6+`
817
- [Java Dns Cache Manipulator Tool](tool)
918
用于修改/查看 运行中`JVM`进程的`DNS Cache`
19+
20+
使用文档参见子工程文档。

library/README.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,11 @@ Java Dns Cache Manipulator(DCM) Library
3737
- 可以动态修改`DNS`缓存,无需修改`host`文件和`http`链接等不灵活的方式。
3838
- 一个`JVM`进程可以对应一套域名绑定,相互之间不影响,可以实现多场景,多域名绑定的需求压测。
3939
1. 打开`Java`中的`SecurityManager`时(如在`Web`容器`Tomcat`中的`Web`应用),`Java``DNS`缺省是不会失效的。
40-
如果域名绑定的`IP`变了,可以通过这个库重置`DNS`,作为一个临时的手段(***强烈不推荐***)。
41-
当然往往进行要先有能执行入口,比如远程调用或是[`jvm-ssh-groovy-shell`](https://github.com/palominolabs/jvm-ssh-groovy-shell)
40+
如果域名绑定的`IP`变了,可以通过这个库重置`DNS`,作为一个临时的手段(***强烈不推荐***)。
41+
- 通过[`Java Dns Cache Manipulator Tool`](tool)修改运行中`JVM DNS Cache`
42+
**无需**应用包含了`Java Dns Cache Manipulator Library`依赖(即`Jar`)。
43+
- 或通过执行入口调用`Java Dns Cache Manipulator Library`的方法,比如远程调用或是[`jvm-ssh-groovy-shell`](https://github.com/palominolabs/jvm-ssh-groovy-shell)
44+
***需要***应用已经包含了`Java Dns Cache Manipulator Library`依赖(即`Jar`)。
4245

4346
:busts_in_silhouette: User Guide
4447
=====================================
@@ -110,12 +113,12 @@ System.out.println(dnsCache);
110113
```java
111114
// 查看缓存时间,单位秒。-1表示永远缓存,0表示不缓存
112115
int cachePolicy = DnsCacheManipulator.getDnsCachePolicy();
113-
// 查看缓存时间
116+
// 设置缓存时间
114117
DnsCacheManipulator.setDnsCachePolicy(2);
115118

116119
// 查看未命中条目的缓存时间
117120
DnsCacheManipulator.getDnsNegativeCachePolicy()
118-
// 修改未命中条目的缓存时间
121+
// 设置未命中条目的缓存时间
119122
DnsCacheManipulator.setDnsNegativeCachePolicy(0);
120123
```
121124

@@ -167,7 +170,7 @@ oraclejdk8 64-Bit | windows server 2012 r2 | appveyor
167170
oraclejdk8 32-Bit | windows server 2012 r2 | appveyor
168171

169172
PS:
170-
多谢 [travis-ci](https://travis-ci.org/)[appveyor](https://ci.appveyor.com) 免费提供持续集成环境。
173+
感谢 [travis-ci](https://travis-ci.org/)[appveyor](https://ci.appveyor.com) 免费提供持续集成环境。
171174

172175
:electric_plug: Java API Docs
173176
=====================================
@@ -183,7 +186,7 @@ PS:
183186
<dependency>
184187
<groupId>com.alibaba</groupId>
185188
<artifactId>dns-cache-manipulator</artifactId>
186-
<version>1.2.0</version>
189+
<version>1.3.0</version>
187190
</dependency>
188191
```
189192

@@ -247,7 +250,7 @@ private static void cacheAddresses(String hostname,
247250
- `JDK 8`[`InetAddress`](http://grepcode.com/file/repository.grepcode.com/java/root/jdk/openjdk/8-b132/java/net/InetAddress.java#InetAddress.CacheEntry)
248251
- [`JVM Networking Properties` - `java docs`](http://docs.oracle.com/javase/8/docs/technotes/guides/net/properties.html)
249252
- [`java dns`解析缓存之源码解析](http://rongmayisheng.com/post/java-dns%E7%BC%93%E5%AD%98%E6%BA%90%E7%A0%81%E8%A7%A3%E6%9E%90),写得很完整,源码解析。给出值得注意的结论:
250-
- 打开`Java`中的`SecurityManager``DNS`缓存将不会生效
253+
- 打开`Java`中的`SecurityManager``DNS`缓存将不会失效
251254
- 否则,可访问的`DNS`解析缺省缓存30秒,不可访问的`DNS`解析缺省缓存10秒。
252255
- [关于`jvm dns cache`(域名缓存时间)](http://www.piao2010.com/%E5%85%B3%E4%BA%8Ejvm-dns-cache-%E5%9F%9F%E5%90%8D%E7%BC%93%E5%AD%98%E6%97%B6%E9%97%B4),给出“对于多条A记录是采用什么策略返回`IP`”的结论:
253256
- 在缓存有效期内,取到的`IP`永远是缓存中全部A记录的第一条,并没有轮循之类的策略。

tool/README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,14 @@
11
Java Dns Cache Manipulator Tool
22
=================================
33

4+
[![Build Status](https://travis-ci.org/alibaba/java-dns-cache-manipulator.svg?branch=master)](https://travis-ci.org/alibaba/java-dns-cache-manipulator)
5+
[![Windows Build Status](https://img.shields.io/appveyor/ci/oldratlee/java-dns-cache-manipulator/master.svg?label=windows%20build)](https://ci.appveyor.com/project/oldratlee/java-dns-cache-manipulator)
6+
[![Coverage Status](https://coveralls.io/repos/alibaba/java-dns-cache-manipulator/badge.svg?branch=master)](https://coveralls.io/r/alibaba/java-dns-cache-manipulator?branch=master)
7+
[![GitHub release](https://img.shields.io/github/release/alibaba/java-dns-cache-manipulator.svg)](https://github.com/alibaba/java-dns-cache-manipulator/releases)
8+
[![Dependency Status](https://www.versioneye.com/user/projects/553a2f981d2989f7ee0000a7/badge.svg?style=flat)](https://www.versioneye.com/user/projects/553a2f981d2989f7ee0000a7)
9+
[![GitHub issues](https://img.shields.io/github/issues/alibaba/java-dns-cache-manipulator.svg)](https://github.com/alibaba/java-dns-cache-manipulator/issues)
10+
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
11+
412
:point_right: 修改/查看 运行中`JVM`进程的`DNS Cache`
513

614
:wrench: 功能

0 commit comments

Comments
 (0)