org.xbill.DNS
public final class Lookup extends java.lang.Object
Cache
,
Resolver
,
ResolverConfig
Modifier and Type | Field and Description |
---|---|
static int |
HOST_NOT_FOUND
The host does not exist.
|
static int |
SUCCESSFUL
The lookup was successful.
|
static int |
TRY_AGAIN
The lookup failed due to a network error.
|
static int |
TYPE_NOT_FOUND
The host exists, but has no records associated with the queried type.
|
static int |
UNRECOVERABLE
The lookup failed due to a data or server error.
|
Constructor and Description |
---|
Lookup(Name name)
Create a Lookup object that will find records of type A at the given name
in the IN class.
|
Lookup(Name name,
int type)
Create a Lookup object that will find records of the given name and type
in the IN class.
|
Lookup(Name name,
int type,
int dclass)
Create a Lookup object that will find records of the given name, type,
and class.
|
Lookup(java.lang.String name)
Create a Lookup object that will find records of type A at the given name
in the IN class.
|
Lookup(java.lang.String name,
int type)
Create a Lookup object that will find records of the given name and type
in the IN class.
|
Lookup(java.lang.String name,
int type,
int dclass)
Create a Lookup object that will find records of the given name, type,
and class.
|
Modifier and Type | Method and Description |
---|---|
Name[] |
getAliases()
Returns all known aliases for this name.
|
Record[] |
getAnswers()
Returns the answers from the lookup.
|
static Cache |
getDefaultCache(int dclass)
Gets the Cache that will be used as the default for the specified
class by future Lookups.
|
static Resolver |
getDefaultResolver()
Gets the Resolver that will be used as the default by future Lookups.
|
static Name[] |
getDefaultSearchPath()
Gets the search path that will be used as the default by future Lookups.
|
java.lang.String |
getErrorString()
Returns an error string describing the result code of this lookup.
|
int |
getResult()
Returns the result code of the lookup.
|
static void |
refreshDefault() |
Record[] |
run()
Performs the lookup, using the specified Cache, Resolver, and search path.
|
void |
setCache(Cache cache)
Sets the cache to use when performing this lookup.
|
void |
setCredibility(int credibility)
Sets the minimum credibility level that will be accepted when performing
the lookup.
|
static void |
setDefaultCache(Cache cache,
int dclass)
Sets the Cache to be used as the default for the specified class by future
Lookups.
|
static void |
setDefaultResolver(Resolver resolver)
Sets the default Resolver to be used as the default by future Lookups.
|
static void |
setDefaultSearchPath(Name[] domains)
Sets the search path to be used as the default by future Lookups.
|
static void |
setDefaultSearchPath(java.lang.String[] domains)
Sets the search path that will be used as the default by future Lookups.
|
void |
setNdots(int ndots)
Sets ndots to use when performing this lookup, overriding the default value.
|
void |
setResolver(Resolver resolver)
Sets the resolver to use when performing this lookup.
|
void |
setSearchPath(Name[] domains)
Sets the search path to use when performing this lookup.
|
void |
setSearchPath(java.lang.String[] domains)
Sets the search path to use when performing this lookup.
|
public static final int SUCCESSFUL
public static final int UNRECOVERABLE
public static final int TRY_AGAIN
public static final int HOST_NOT_FOUND
public static final int TYPE_NOT_FOUND
public Lookup(Name name, int type, int dclass)
public Lookup(Name name, int type)
name
- The name of the desired recordstype
- The type of the desired recordsjava.lang.IllegalArgumentException
- The type is a meta type other than ANY.Lookup(Name,int,int)
public Lookup(Name name)
name
- The name of the desired recordsLookup(Name,int,int)
public Lookup(java.lang.String name, int type, int dclass) throws TextParseException
name
- The name of the desired recordstype
- The type of the desired recordsdclass
- The class of the desired recordsTextParseException
- The name is not a valid DNS namejava.lang.IllegalArgumentException
- The type is a meta type other than ANY.Lookup(Name,int,int)
public Lookup(java.lang.String name, int type) throws TextParseException
name
- The name of the desired recordstype
- The type of the desired recordsTextParseException
- The name is not a valid DNS namejava.lang.IllegalArgumentException
- The type is a meta type other than ANY.Lookup(Name,int,int)
public Lookup(java.lang.String name) throws TextParseException
name
- The name of the desired recordsTextParseException
- The name is not a valid DNS nameLookup(Name,int,int)
public static void refreshDefault()
public static Resolver getDefaultResolver()
public static void setDefaultResolver(Resolver resolver)
resolver
- The default resolver.public static Cache getDefaultCache(int dclass)
dclass
- The class whose cache is being retrieved.public static void setDefaultCache(Cache cache, int dclass)
cache
- The default cache for the specified class.dclass
- The class whose cache is being set.public static Name[] getDefaultSearchPath()
public static void setDefaultSearchPath(Name[] domains)
domains
- The default search path.public static void setDefaultSearchPath(java.lang.String[] domains) throws TextParseException
domains
- The default search path.TextParseException
- A name in the array is not a valid DNS name.public void setResolver(Resolver resolver)
resolver
- The resolver to use.public void setSearchPath(Name[] domains)
domains
- An array of names containing the search path.public void setSearchPath(java.lang.String[] domains) throws TextParseException
domains
- An array of names containing the search path.TextParseException
- A name in the array is not a valid DNS name.public void setCache(Cache cache)
cache
- The cache to use.public void setNdots(int ndots)
ndots
- The ndots value to use, which must be greater than or equal to
0.public void setCredibility(int credibility)
credibility
- The minimum credibility level.public Record[] run()
public Record[] getAnswers()
java.lang.IllegalStateException
- The lookup has not completed.public Name[] getAliases()
java.lang.IllegalStateException
- The lookup has not completed.public int getResult()
java.lang.IllegalStateException
- The lookup has not completed.public java.lang.String getErrorString()
java.lang.IllegalStateException
- The lookup has not completed.