io.jsync.dns.DnsClient Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jsync.io Show documentation
Show all versions of jsync.io Show documentation
jsync.io is a non-blocking, event-driven networking framework for Java
/*
* Copyright (c) 2011-2013 The original author or authors
* ------------------------------------------------------
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Apache License v2.0 which accompanies this distribution.
*
* The Eclipse Public License is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* The Apache License v2.0 is available at
* http://www.opensource.org/licenses/apache2.0.php
*
* You may elect to redistribute this code under either of these licenses.
*/
package io.jsync.dns;
import io.jsync.AsyncResult;
import io.jsync.Handler;
import java.net.Inet4Address;
import java.net.Inet6Address;
import java.net.InetAddress;
import java.util.List;
/**
* Provides a way to asynchronous lookup informations from DNS-Servers.
*
* @author Norman Maurer
*/
public interface DnsClient {
/**
* Try to lookup the A (ipv4) or AAAA (ipv6) record for the given name. The first found will be used.
*
* @param name The name to resolve
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link InetAddress} if a record was found. If non was found it will
* get notifed with {@code null}.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient lookup(String name, Handler> handler);
/**
* Try to lookup the A (ipv4) record for the given name. The first found will be used.
*
* @param name The name to resolve
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link 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.
* @return itself for method-chaining.
*/
DnsClient lookup4(String name, Handler> handler);
/**
* Try to lookup the AAAA (ipv6) record for the given name. The first found will be used.
*
* @param name The name to resolve
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link 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.
* @return itself for method-chaining.
*/
DnsClient lookup6(String name, Handler> handler);
/**
* Try to resolve all A (ipv4) records for the given name.
*
* @param name The name to resolve
* @param handler the {@link io.jsync.Handler} to notify with the {@link io.jsync.AsyncResult}. The {@link io.jsync.AsyncResult} will get
* notified with a {@link List} that contains all the resolved {@link Inet4Address}es. If non was found
* and empty {@link List} will be used.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveA(String name, Handler>> handler);
/**
* Try to resolve all AAAA (ipv6) records for the given name.
*
* @param name The name to resolve
* @param handler the {@link io.jsync.Handler} to notify with the {@link io.jsync.AsyncResult}. The {@link io.jsync.AsyncResult} will get
* notified with a {@link List} that contains all the resolved {@link Inet6Address}es. If non was found
* and empty {@link List} will be used.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveAAAA(String name, Handler>> handler);
/**
* Try to resolve the CNAME record for the given name.
*
* @param name The name to resolve the CNAME for
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link String} if a record was found. If non was found it will
* get notified with {@code null}.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveCNAME(String name, Handler>> handler);
/**
* Try to resolve the MX records for the given name.
*
* @param name The name for which the MX records should be resolved
* @param handler the {@link io.jsync.Handler} to notify with the {@link io.jsync.AsyncResult}. The {@link io.jsync.AsyncResult} will get
* notified with a List that contains all resolved {@link io.jsync.dns.MxRecord}s, sorted by their
* {@link io.jsync.dns.MxRecord#priority()}. If non was found it will get notified with an empty {@link List}
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveMX(String name, Handler>> handler);
/**
* Try to resolve the TXT records for the given name.
*
* @param name The name for which the TXT records should be resolved
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with a List that contains all resolved {@link String}s. If non was found it will
* get notified with an empty {@link List}
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveTXT(String name, Handler>> handler);
/**
* Try to resolve the PTR record for the given name.
*
* @param name The name to resolve the PTR for
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link String} if a record was found. If non was found it will
* get notified with {@code null}.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolvePTR(String name, Handler> handler);
/**
* Try to resolve the NS records for the given name.
*
* @param name The name for which the NS records should be resolved
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with a List that contains all resolved {@link String}s. If non was found it will
* get notified with an empty {@link List}
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveNS(String name, Handler>> handler);
/**
* Try to resolve the SRV records for the given name.
*
* @param name The name for which the SRV records should be resolved
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with a List that contains all resolved {@link SrvRecord}s. If non was found it will
* get notified with an empty {@link List}
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient resolveSRV(String name, Handler>> handler);
/**
* Try to do a reverse lookup of an ipaddress. This is basically the same as doing trying to resolve a PTR record
* but allows you to just pass in the ipaddress and not a valid ptr query string.
*
* @param ipaddress The ipaddress to resolve the PTR for
* @param handler the {@link Handler} to notify with the {@link AsyncResult}. The {@link AsyncResult} will get
* notified with the resolved {@link String} if a record was found. If non was found it will
* get notified with {@code null}.
* If an error accours it will get failed.
* @return itself for method-chaining.
*/
DnsClient reverseLookup(String ipaddress, Handler> handler);
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy