Table of Contents

See: Description

Packages 
Package Description
com.verisign.getdns  

Table of Contents

Introduction

getdns Java bindings is an implementation of Java language bindings for the getdns API, built on top of the getdns implementation. getdns is a modern, asynchronous DNS API that simplifies access to advanced DNS features, including DNSSEC. The API specification was developed by Paul Hoffman. getdns is built on top of the getdns implementation developed as a joint project between Verisign Labs and NLnet Labs. To explore further, refer GetDnsFactory

Dependencies

This has been built and tested with Java 1.7 and 1.8

Currently building against the getdns 0.1.7 release. getdns external dependencies include:

Note that getdns MUST be built with the --with-libevent flag to configure.

Building

The code repository for getdns is available at: https://github.com/getdnsapi/getdns-java-bindings

Pre-configuration

The file gradle.properties needs to be edited to customize java home property.

Running gradle build 

./gradlew clean assemble buildJniLib

Using getdns

Libraries

As per gradle standard libraries will be available in the folder build/libs.
  • libgetdnsconnector.so is used to connect to getdns and dependent libraries from Java layer. This needs to be placed at location that can be passed as java.library.path parameter during java invocation
  • getdns-java-0.1.jar should be placed in the classpath.

Examples

In this example, we do a simple address lookup and dump the results to the screen:

import java.util.HashMap;

import com.verisign.getdns.ContextOptionName;
import com.verisign.getdns.GetDNSFactory;
import com.verisign.getdns.GetDNSUtil;
import com.verisign.getdns.IGetDNSContextSync;
import com.verisign.getdns.RRType;

/*
 * Given a DNS name and type, return the records in the DNS answer section
 */

public class GetDNSGeneralSync {

    public static void main(String[] args) {
        final IGetDNSContextSync context = GetDNSFactory.createSync(1, null);  
        try {
            HashMap info = context.generalSync("getdnsapi.net", RRType.A, null);
            if (info != null) {
                if (Integer.parseInt(info.get("status").toString()) == 900) {
                    System.out.println(GetDNSUtil.printReadable(info));
                    System.out.println(GetDNSUtil.getdnsStatus(info));
                } else if (Integer.parseInt(info.get("status").toString()) == 901)
                    System.out.println("no such name: ");
                else
                    System.out.println("Error in query GETDNS Status =" + info.get("status").toString());
            } else
                System.out.println("No response form DNS SERVER");
        } finally {
            context.close();
        }
        System.exit(0); 
    }
}

Known issues

On some machines some test cases might fail because of timeout issues.