new DnsClient()
Provides a way to asynchronously lookup information from DNS servers.
Please consult the documentation for more information on DNS clients.
- Source:
Methods
-
lookup(name, handler) → {DnsClient}
-
Try to lookup the A (ipv4) or AAAA (ipv6) record for the given name. The first found will be used.
Parameters:
Name Type Description name
string the name to resolve handler
function the io.vertx.core.Handler to notify with the io.vertx.core.AsyncResult. The handler will get notified with the resolved address if a record was found. If non was found it will get notifed with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently- Type
- DnsClient
-
lookup4(name, handler) → {DnsClient}
-
Try to lookup the A (ipv4) record for the given name. The first found will be used.
Parameters:
Name Type Description name
string the name to resolve handler
function the Handler to notify with the io.vertx.core.AsyncResult. The handler will get notified with the resolved java.net.Inet4Address if a record was found. If non was found it will get notifed with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently- Type
- DnsClient
-
lookup6(name, handler) → {DnsClient}
-
Try to lookup the AAAA (ipv6) record for the given name. The first found will be used.
Parameters:
Name Type Description name
string the name to resolve handler
function the Handler to notify with the AsyncResult. The handler will get notified with the resolved java.net.Inet6Address if a record was found. If non was found it will get notifed with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently- Type
- DnsClient
-
resolveA(name, handler) → {DnsClient}
-
Try to resolve all A (ipv4) records for the given name.
Parameters:
Name Type Description name
string the name to resolve handler
function the io.vertx.core.Handler to notify with the io.vertx.core.AsyncResult. The handler will get notified with a java.util.List that contains all the resolved java.net.Inet4Addresses. If none was found an empty java.util.List will be used. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently- Type
- DnsClient
-
resolveAAAA(name, handler) → {DnsClient}
-
Try to resolve all AAAA (ipv6) records for the given name.
Parameters:
Name Type Description name
string the name to resolve handler
function the io.vertx.core.Handler to notify with the io.vertx.core.AsyncResult. The handler will get notified with a java.util.List that contains all the resolved java.net.Inet6Addresses. If none was found an empty java.util.List will be used. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently- Type
- DnsClient
-
resolveCNAME(name, handler) → {DnsClient}
-
Try to resolve the CNAME record for the given name.
Parameters:
Name Type Description name
string the name to resolve the CNAME for handler
function the Handler to notify with the AsyncResult. The handler will get notified with the resolved String if a record was found. If none was found it will get notified with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
resolveMX(name, handler) → {DnsClient}
-
Try to resolve the MX records for the given name.
Parameters:
Name Type Description name
string the name for which the MX records should be resolved handler
function the io.vertx.core.Handler to notify with the io.vertx.core.AsyncResult. The handler will get notified with a List that contains all resolved MxRecords, sorted by their MxRecord#priority(). If non was found it will get notified with an empty java.util.List. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
resolveNS(name, handler) → {DnsClient}
-
Try to resolve the NS records for the given name.
Parameters:
Name Type Description name
string the name for which the NS records should be resolved handler
function the Handler to notify with the AsyncResult. The handler will get notified with a List that contains all resolved Strings. If none was found it will get notified with an empty java.util.List. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
resolvePTR(name, handler) → {DnsClient}
-
Try to resolve the PTR record for the given name.
Parameters:
Name Type Description name
string the name to resolve the PTR for handler
function the Handler to notify with the AsyncResult. The handler will get notified with the resolved String if a record was found. If none was found it will get notified with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
resolveSRV(name, handler) → {DnsClient}
-
Try to resolve the SRV records for the given name.
Parameters:
Name Type Description name
string the name for which the SRV records should be resolved handler
function the Handler to notify with the AsyncResult. The handler will get notified with a List that contains all resolved SrvRecords. If none was found it will get notified with an empty java.util.List. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
resolveTXT(name, handler) → {DnsClient}
-
Try to resolve the TXT records for the given name.
Parameters:
Name Type Description name
string the name for which the TXT records should be resolved handler
function the Handler to notify with the AsyncResult. The handler will get notified with a List that contains all resolved Strings. If none was found it will get notified with an empty java.util.List. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient
-
reverseLookup(ipaddress, handler) → {DnsClient}
-
Try to do a reverse lookup of an IP address. This is basically the same as doing trying to resolve a PTR record but allows you to just pass in the IP address and not a valid ptr query string.
Parameters:
Name Type Description ipaddress
string the IP address to resolve the PTR for handler
function the Handler to notify with the AsyncResult. The handler will get notified with the resolved String if a record was found. If none was found it will get notified with {@code null}. If an error accours it will get failed. - Source:
Returns:
a reference to this, so the API can be used fluently.- Type
- DnsClient