Package uk.num.numlib.service

Class IndependentRecordLookupService

java.lang.Object

uk.num.numlib.service.IndependentRecordLookupService

public class IndependentRecordLookupService
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IndependentRecordLookupService.LoadRecordResponse

Field Summary

Fields

Modifier and Type	Field	Description
static int	MAX_SANE_NUMID_LENGTH

Constructor Summary

Constructors

Constructor	Description
IndependentRecordLookupService()

Method Summary

Modifier and Type	Method	Description
IndependentRecordLookupService.LoadRecordResponse	loadRecordFromIndependentZone(@NonNull java.lang.String numIdName, @NonNull java.lang.String path, int module, int timeoutMs)	Loads a record content from the independent zone of the DNS.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAX_SANE_NUMID_LENGTH

public static final int MAX_SANE_NUMID_LENGTH

See Also:

Constant Field Values

Constructor Detail

IndependentRecordLookupService

public IndependentRecordLookupService()

Method Detail

loadRecordFromIndependentZone

public IndependentRecordLookupService.LoadRecordResponse loadRecordFromIndependentZone(@NonNull
                                                                                       @NonNull java.lang.String numIdName,
                                                                                       @NonNull
                                                                                       @NonNull java.lang.String path,
                                                                                       int module,
                                                                                       int timeoutMs)
                                                                                throws NumInvalidParameterException,
                                                                                       NumInvalidDNSQueryException,
                                                                                       RrSetIncompleteException,
                                                                                       RrSetNoHeadersException,
                                                                                       RrSetHeaderFormatException

Loads a record content from the independent zone of the DNS. A null value is returned when the record is not available.

Parameters:

numIdName - NUM id name for the record (for example domain name)

path - path of the record in the DNS

module - module for the record to retrieve

timeoutMs - maximum time allowed to retrieve the record

Returns:

a LoadRecordResponse or null

Throws:

NumInvalidParameterException - if any of the supplied parameters are out of an acceptable range (catch NumException to handle oll exceptions)

NumInvalidDNSQueryException - if the parameters cannot be used to generated a valid DNS query (catch NumException to handle oll exceptions)

RrSetIncompleteException - if the NUM record is invalid (catch NumException to handle oll exceptions)

RrSetNoHeadersException - if the NUM record is invalid (catch NumException to handle oll exceptions)

RrSetHeaderFormatException - if the NUM record is invalid (catch NumException to handle oll exceptions)