DNSCacheManager (Apache JMeter API)

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, 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

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CLEAR_CACHE_EACH_ITER`
`static boolean`	`DEFAULT_CLEAR_CACHE_EACH_ITER`
`static boolean`	`DEFAULT_IS_CUSTOM_RESOLVER`
`static String`	`DEFAULT_SERVERS`
`static String`	`IS_CUSTOM_RESOLVER`
`static String`	`SERVERS`

Fields inherited from class org.apache.jmeter.config.ConfigTestElement
PASSWORD, USERNAME

Fields inherited from interface org.apache.jmeter.testelement.TestElement
COMMENTS, ENABLED, GUI_CLASS, NAME, TEST_CLASS

Constructor Summary

Constructors
Constructor and Description

DNSCacheManager()

Constructors
Constructor and Description
`DNSCacheManager()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addServer(String dnsServer)`
`void`	`clear()` Clear the TestElement of all data.
`Object`	`clone()`
`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

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, 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

- Field Detail
  - CLEAR_CACHE_EACH_ITER
```
public static final String CLEAR_CACHE_EACH_ITER
```
    See Also:
    Constant Field Values
  - SERVERS
```
public static final String SERVERS
```
    See Also:
    Constant Field Values
  - IS_CUSTOM_RESOLVER
```
public static final String IS_CUSTOM_RESOLVER
```
    See Also:
    Constant Field Values
  - DEFAULT_CLEAR_CACHE_EACH_ITER
```
public static final boolean DEFAULT_CLEAR_CACHE_EACH_ITER
```
    See Also:
    Constant Field Values
  - DEFAULT_SERVERS
```
public static final String DEFAULT_SERVERS
```
    See Also:
    Constant Field Values
  - DEFAULT_IS_CUSTOM_RESOLVER
```
public static final boolean DEFAULT_IS_CUSTOM_RESOLVER
```
    See Also:
    Constant Field Values
- Constructor Detail
  - DNSCacheManager
```
public DNSCacheManager()
```
- Method Detail
  - clone
```
public Object clone()
```
    Specified by:
    
    clone in interface ConfigElement
    
    Specified by:
    
    clone in interface 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()
```
    Clear the TestElement of all data.
    
    Specified by:
    
    clear in interface TestElement
    
    Overrides:
    
    clear in class AbstractTestElement
  - addServer
```
public void addServer(String dnsServer)
```
  - getServers
```
public CollectionProperty getServers()
```
  - 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)
```

Class DNSCacheManager

Field Summary

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

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

Constructor Summary

Method Summary

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

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

Methods inherited from class java.lang.Object

Field Detail

CLEAR_CACHE_EACH_ITER

SERVERS

IS_CUSTOM_RESOLVER

DEFAULT_CLEAR_CACHE_EACH_ITER

DEFAULT_SERVERS

DEFAULT_IS_CUSTOM_RESOLVER

Constructor Detail

DNSCacheManager

Method Detail

clone

resolve

testIterationStart

clear

addServer

getServers

isClearEachIteration

setClearEachIteration

isCustomResolver

setCustomResolver