Package uk.num.numlib.internal.dns

Interface DNSServices

All Known Implementing Classes:

DNSServicesDefaultImpl

public interface DNSServices

This interface defines the contract for the DNS Service provider.

Method Summary

Modifier and Type	Method	Description
org.xbill.DNS.Record[]	getConfigFileTXTRecords(AppContext appContext, java.lang.String moduleId, int timeoutMillis)	Get the Module Configuration from DNS as an array of Records
org.xbill.DNS.Record[]	getRecordFromDnsNoCache(NonBlankString query, int timeoutMillis, boolean checkDnsSecValidity)	Get a NUM record from DNS.
java.lang.String	rebuildTXTRecordContent(org.xbill.DNS.Record[] records)	Concatenate an array of TXT record values to a single String

Method Detail

getConfigFileTXTRecords

org.xbill.DNS.Record[] getConfigFileTXTRecords(AppContext appContext,
                                               java.lang.String moduleId,
                                               int timeoutMillis)
                                        throws NumInvalidDNSQueryException,
                                               NumDNSQueryException

Get the Module Configuration from DNS as an array of Records

Parameters:

appContext - the AppContext

moduleId - The module Id String

timeoutMillis - The number of milliseconds to wait for a response.

Returns:

An array of Records

Throws:

NumInvalidDNSQueryException - on error

NumDNSQueryException - on error

rebuildTXTRecordContent

java.lang.String rebuildTXTRecordContent(org.xbill.DNS.Record[] records)
                                  throws RrSetNoHeadersException,
                                         RrSetHeaderFormatException,
                                         RrSetIncompleteException

Concatenate an array of TXT record values to a single String

Parameters:

records - The array of Records

Returns:

The concatenated result.

Throws:

RrSetNoHeadersException - on error

RrSetHeaderFormatException - on error

RrSetIncompleteException - on error

getRecordFromDnsNoCache

org.xbill.DNS.Record[] getRecordFromDnsNoCache(NonBlankString query,
                                               int timeoutMillis,
                                               boolean checkDnsSecValidity)
                                        throws NumNotImplementedException,
                                               NumInvalidDNSQueryException,
                                               NumNoRecordAvailableException

Get a NUM record from DNS.

Parameters:

query - The NUM formatted DNS query.

timeoutMillis - The number of milliseconds to wait for a response.

checkDnsSecValidity - true if the result should be checked for DNSSEC validity.

Returns:

An array of Records

Throws:

NumNotImplementedException - on error

NumInvalidDNSQueryException - on error

NumNoRecordAvailableException - if a CNAME or SPF record is received instead of a TXT record