Package org.apache.jmeter.protocol.http.control

# Class DNSCacheManager

java.lang.Object
org.apache.jmeter.testelement.AbstractTestElement
org.apache.jmeter.config.ConfigTestElement
org.apache.jmeter.protocol.http.control.DNSCacheManager

All Implemented Interfaces:
  `Serializable`, `Cloneable`, `org.apache.http.conn.DnsResolver`, `ConfigElement`, `Searchable`, `org.apache.jmeter.testelement.TestElement`, `TestIterationListener`

public class DNSCacheManager extends ConfigTestElement implements TestIterationListener, Serializable, org.apache.http.conn.DnsResolver
This config element provides ability to have flexible control over DNS caching function. Depending on option from @see `DNSCachePanel`, either system or custom resolver can be used. Custom resolver uses dnsjava library, and gives ability to bypass both OS and JVM cache. It allows to use paradigm "1 virtual user - 1 DNS cache" in performance tests.

Since:
  2.12
See Also:
  - Serialized Form

## Nested Class Summary

## Nested classes/interfaces inherited from interface org.apache.jmeter.testelement.TestElement

`org.apache.jmeter.testelement.TestElement.Companion`

## Field Summary

Fields
Modifier and Type
Field
Description
`static final boolean`
`DEFAULT_CLEAR_CACHE_EACH_ITER`

### Fields inherited from class org.apache.jmeter.config.ConfigTestElement

`PASSWORD, USERNAME`

### Fields inherited from interface org.apache.jmeter.testelement.TestElement

`COMMENTS, Companion, ENABLED, GUI_CLASS, NAME, TEST_CLASS`

## Constructor Summary

Constructors
Constructor
Description
`DNSCacheManager()`

## Method Summary

Modifier and Type
Method
Description
`void`
`addHost(String dnsHost, String addresses)`
Add static host
`void`
`addServer(String dnsServer)`
Add DNS Server
`void`
`clear()`
`Object`
`clone()`
`CollectionProperty`
`getHosts()`
`CollectionProperty`
`getServers()`
`boolean`
`isClearEachIteration()`
Clean DNS cache each iteration
`boolean`
`isCustomResolver()`
`InetAddress[]`
`resolve(String host)`
Resolves address using system or custom DNS resolver
`void`
`setClearEachIteration(boolean clear)`
Clean DNS cache each iteration
`void`
`setCustomResolver(boolean isCustomResolver)`
`void`
`testIterationStart(LoopIterationEvent event)`
Each time through a Thread Group's test script, an iteration event is fired for each thread.

### Methods inherited from class org.apache.jmeter.config.ConfigTestElement

`addConfigElement, addTestElement, expectsModification, getProps, getSchema`

### Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement

`addPropertiesValues, addProperty, addProperty, canRemove, clearTemporary, clearTestElementChildren, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getPropertyOrNull, getSearchableTokens, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse, traverseCollection, traverseMap, traverseProperty`

### Methods inherited from class java.lang.Object

`finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

### Methods inherited from interface org.apache.jmeter.testelement.TestElement

`get, get, get, get, get, get, get, get, get, getOrCreate, getOrCreate, getOrNull, getOrNull, getOrNull, getPropertyOrNull, getString, removed, removeProperty, set, set, set, set, set, set, set, set, set`

## Field Details

### DEFAULT_CLEAR_CACHE_EACH_ITER

public static final boolean DEFAULT_CLEAR_CACHE_EACH_ITER

See Also:
  - Constant Field Values

## Constructor Details

### DNSCacheManager

public DNSCacheManager()

## Method Details

### clone

public Object clone()

Specified by:
  `clone` in interface `ConfigElement`
Specified by:
  `clone` in interface `org.apache.jmeter.testelement.TestElement`
Overrides:
  `clone` in class `AbstractTestElement`

### resolve

public InetAddress[] resolve(String host) throws UnknownHostException
Resolves address using system or custom DNS resolver

Specified by:
  `resolve` in interface `org.apache.http.conn.DnsResolver`
Throws:
  `UnknownHostException`

### testIterationStart

public void testIterationStart(LoopIterationEvent event)
Each time through a Thread Group's test script, an iteration event is fired for each thread. This will be after the test elements have been cloned, so in general the instance will not be the same as the ones the start/end methods call. Clean DNS cache if appropriate check-box was selected

Specified by:
  `testIterationStart` in interface `TestIterationListener`
Parameters:
  `event` - the iteration event

### clear

public void clear()

Specified by:
  `clear` in interface `org.apache.jmeter.testelement.TestElement`
Overrides:
  `clear` in class `AbstractTestElement`

### addServer

public void addServer(String dnsServer)
Add DNS Server

Parameters:
  `dnsServer` - DNS Server

### getServers

public CollectionProperty getServers()

Returns:
  DNS Servers

### addHost

public void addHost(String dnsHost, String addresses)
Add static host

Parameters:
  `dnsHost` - DNS host
  `addresses` - Comma separated list of addresses

### getHosts

public CollectionProperty getHosts()

### isClearEachIteration

public boolean isClearEachIteration()
Clean DNS cache each iteration

Returns:
  boolean

### setClearEachIteration

public void setClearEachIteration(boolean clear)
Clean DNS cache each iteration

Parameters:
  `clear` - flag whether DNS cache should be cleared on each iteration

### isCustomResolver

public boolean isCustomResolver()

### setCustomResolver

public void setCustomResolver(boolean isCustomResolver)