Class DnsClient


  • public class DnsClient
    extends Object
    Provides a way to asynchronously lookup information from DNS servers.

    Please consult the documentation for more information on DNS clients.

    The client is thread safe and can be used from any thread.

    NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.

    • Constructor Detail

      • DnsClient

        public DnsClient​(DnsClient delegate)
      • DnsClient

        public DnsClient​(Object delegate)
    • Method Detail

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • getDelegate

        public DnsClient getDelegate()
      • lookup

        public DnsClient lookup​(String name,
                                Handler<AsyncResult<String>> handler)
        Try to lookup the A (ipv4) or AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        handler - the Handler to notify with the AsyncResult. The handler will get notified with the resolved address if a record was found. If non was found it will get notifed with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently
      • lookup

        public DnsClient lookup​(String name)
        Try to lookup the A (ipv4) or AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • rxLookup

        public io.reactivex.Maybe<String> rxLookup​(String name)
        Try to lookup the A (ipv4) or AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • lookup4

        public DnsClient lookup4​(String name,
                                 Handler<AsyncResult<String>> handler)
        Try to lookup the A (ipv4) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        handler - the to notify with the AsyncResult. The handler will get notified with the resolved Inet4Address if a record was found. If non was found it will get notifed with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently
      • lookup4

        public DnsClient lookup4​(String name)
        Try to lookup the A (ipv4) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • rxLookup4

        public io.reactivex.Maybe<String> rxLookup4​(String name)
        Try to lookup the A (ipv4) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • lookup6

        public DnsClient lookup6​(String name,
                                 Handler<AsyncResult<String>> handler)
        Try to lookup the AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        handler - the to notify with the . The handler will get notified with the resolved Inet6Address if a record was found. If non was found it will get notifed with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently
      • lookup6

        public DnsClient lookup6​(String name)
        Try to lookup the AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • rxLookup6

        public io.reactivex.Maybe<String> rxLookup6​(String name)
        Try to lookup the AAAA (ipv6) record for the given name. The first found will be used.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • resolveA

        public DnsClient resolveA​(String name,
                                  Handler<AsyncResult<List<String>>> handler)
        Try to resolve all A (ipv4) records for the given name.
        Parameters:
        name - the name to resolve
        handler - the Handler to notify with the AsyncResult. The handler will get notified with a List that contains all the resolved Inet4Addresses. If none was found an empty List will be used. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently
      • resolveA

        public DnsClient resolveA​(String name)
        Try to resolve all A (ipv4) records for the given name.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • rxResolveA

        public io.reactivex.Single<List<String>> rxResolveA​(String name)
        Try to resolve all A (ipv4) records for the given name.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • resolveAAAA

        public DnsClient resolveAAAA​(String name,
                                     Handler<AsyncResult<List<String>>> handler)
        Try to resolve all AAAA (ipv6) records for the given name.
        Parameters:
        name - the name to resolve
        handler - the Handler to notify with the AsyncResult. The handler will get notified with a List that contains all the resolved Inet6Addresses. If none was found an empty List will be used. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently
      • resolveAAAA

        public DnsClient resolveAAAA​(String name)
        Try to resolve all AAAA (ipv6) records for the given name.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • rxResolveAAAA

        public io.reactivex.Single<List<String>> rxResolveAAAA​(String name)
        Try to resolve all AAAA (ipv6) records for the given name.
        Parameters:
        name - the name to resolve
        Returns:
        a reference to this, so the API can be used fluently
      • resolveCNAME

        public DnsClient resolveCNAME​(String name,
                                      Handler<AsyncResult<List<String>>> handler)
        Try to resolve the CNAME record for the given name.
        Parameters:
        name - the name to resolve the CNAME for
        handler - the to notify with the . The handler will get notified with the resolved String if a record was found. If none was found it will get notified with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveCNAME

        public DnsClient resolveCNAME​(String name)
        Try to resolve the CNAME record for the given name.
        Parameters:
        name - the name to resolve the CNAME for
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolveCNAME

        public io.reactivex.Single<List<String>> rxResolveCNAME​(String name)
        Try to resolve the CNAME record for the given name.
        Parameters:
        name - the name to resolve the CNAME for
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveMX

        public DnsClient resolveMX​(String name,
                                   Handler<AsyncResult<List<MxRecord>>> handler)
        Try to resolve the MX records for the given name.
        Parameters:
        name - the name for which the MX records should be resolved
        handler - the Handler to notify with the 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 List. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveMX

        public DnsClient resolveMX​(String name)
        Try to resolve the MX records for the given name.
        Parameters:
        name - the name for which the MX records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolveMX

        public io.reactivex.Single<List<MxRecord>> rxResolveMX​(String name)
        Try to resolve the MX records for the given name.
        Parameters:
        name - the name for which the MX records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveTXT

        public DnsClient resolveTXT​(String name,
                                    Handler<AsyncResult<List<String>>> handler)
        Try to resolve the TXT records for the given name.
        Parameters:
        name - the name for which the TXT records should be resolved
        handler - the to notify with the . The handler will get notified with a List that contains all resolved Strings. If none was found it will get notified with an empty List. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveTXT

        public DnsClient resolveTXT​(String name)
        Try to resolve the TXT records for the given name.
        Parameters:
        name - the name for which the TXT records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolveTXT

        public io.reactivex.Single<List<String>> rxResolveTXT​(String name)
        Try to resolve the TXT records for the given name.
        Parameters:
        name - the name for which the TXT records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • resolvePTR

        public DnsClient resolvePTR​(String name,
                                    Handler<AsyncResult<String>> handler)
        Try to resolve the PTR record for the given name.
        Parameters:
        name - the name to resolve the PTR for
        handler - the to notify with the . The handler will get notified with the resolved String if a record was found. If none was found it will get notified with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolvePTR

        public DnsClient resolvePTR​(String name)
        Try to resolve the PTR record for the given name.
        Parameters:
        name - the name to resolve the PTR for
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolvePTR

        public io.reactivex.Maybe<String> rxResolvePTR​(String name)
        Try to resolve the PTR record for the given name.
        Parameters:
        name - the name to resolve the PTR for
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveNS

        public DnsClient resolveNS​(String name,
                                   Handler<AsyncResult<List<String>>> handler)
        Try to resolve the NS records for the given name.
        Parameters:
        name - the name for which the NS records should be resolved
        handler - the to notify with the . The handler will get notified with a List that contains all resolved Strings. If none was found it will get notified with an empty List. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveNS

        public DnsClient resolveNS​(String name)
        Try to resolve the NS records for the given name.
        Parameters:
        name - the name for which the NS records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolveNS

        public io.reactivex.Single<List<String>> rxResolveNS​(String name)
        Try to resolve the NS records for the given name.
        Parameters:
        name - the name for which the NS records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveSRV

        public DnsClient resolveSRV​(String name,
                                    Handler<AsyncResult<List<SrvRecord>>> handler)
        Try to resolve the SRV records for the given name.
        Parameters:
        name - the name for which the SRV records should be resolved
        handler - the to notify with the . The handler will get notified with a List that contains all resolved SrvRecords. If none was found it will get notified with an empty List. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • resolveSRV

        public DnsClient resolveSRV​(String name)
        Try to resolve the SRV records for the given name.
        Parameters:
        name - the name for which the SRV records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • rxResolveSRV

        public io.reactivex.Single<List<SrvRecord>> rxResolveSRV​(String name)
        Try to resolve the SRV records for the given name.
        Parameters:
        name - the name for which the SRV records should be resolved
        Returns:
        a reference to this, so the API can be used fluently.
      • reverseLookup

        public DnsClient reverseLookup​(String ipaddress,
                                       Handler<AsyncResult<String>> handler)
        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:
        ipaddress - the IP address to resolve the PTR for
        handler - the to notify with the . The handler will get notified with the resolved String if a record was found. If none was found it will get notified with null. If an error accours it will get failed.
        Returns:
        a reference to this, so the API can be used fluently.
      • reverseLookup

        public DnsClient reverseLookup​(String ipaddress)
        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:
        ipaddress - the IP address to resolve the PTR for
        Returns:
        a reference to this, so the API can be used fluently.
      • rxReverseLookup

        public io.reactivex.Maybe<String> rxReverseLookup​(String ipaddress)
        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:
        ipaddress - the IP address to resolve the PTR for
        Returns:
        a reference to this, so the API can be used fluently.
      • close

        public void close()
        Close the client.
      • rxClose

        public io.reactivex.Completable rxClose()
        Close the client.
        Returns: