|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectorg.xbill.DNS.Lookup
public final class Lookup
The Lookup object issues queries to caching DNS servers. The input consists of a name, an optional type, and an optional class. Caching is enabled by default and used when possible to reduce the number of DNS requests. A Resolver, which defaults to an ExtendedResolver initialized with the resolvers located by the ResolverConfig class, performs the queries. A search path of domain suffixes is used to resolve relative names, and is also determined by the ResolverConfig class. A Lookup object may be reused, but should not be used by multiple threads.
Cache,
Resolver,
ResolverConfig| Field Summary | |
|---|---|
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 Summary | |
|---|---|
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(String name)
Create a Lookup object that will find records of type A at the given name in the IN class. |
|
Lookup(String name,
int type)
Create a Lookup object that will find records of the given name and type in the IN class. |
|
Lookup(String name,
int type,
int dclass)
Create a Lookup object that will find records of the given name, type, and class. |
|
| Method Summary | |
|---|---|
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. |
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(String[] domains)
Sets the search path that will be used as the default by future Lookups. |
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(String[] domains)
Sets the search path to use when performing this lookup. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
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
| Constructor Detail |
|---|
public Lookup(Name name,
int type,
int dclass)
name - The name of the desired recordstype - The type of the desired recordsdclass - The class of the desired records
IllegalArgumentException - The type is a meta type other than ANY.Cache,
Resolver,
Credibility,
Name,
Type,
DClass
public Lookup(Name name,
int type)
name - The name of the desired recordstype - The type of the desired records
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(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 records
TextParseException - The name is not a valid DNS name
IllegalArgumentException - The type is a meta type other than ANY.Lookup(Name,int,int)
public Lookup(String name,
int type)
throws TextParseException
name - The name of the desired recordstype - The type of the desired records
TextParseException - The name is not a valid DNS name
IllegalArgumentException - The type is a meta type other than ANY.Lookup(Name,int,int)
public Lookup(String name)
throws TextParseException
name - The name of the desired records
TextParseException - The name is not a valid DNS nameLookup(Name,int,int)| Method Detail |
|---|
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(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(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 setCredibility(int credibility)
credibility - The minimum credibility level.public Record[] run()
public Record[] getAnswers()
IllegalStateException - The lookup has not completed.public Name[] getAliases()
IllegalStateException - The lookup has not completed.public int getResult()
IllegalStateException - The lookup has not completed.public String getErrorString()
IllegalStateException - The lookup has not completed.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||