OpenJDK 1.23 · com.sun.jndi.dns.DnsContext · APIdia, the JavaDoc alternative

Field Summary

Modifier and Type	Field and Description
private static final int	ANY
private boolean	authoritative
private static final boolean	debug Hides com.sun.jndi.toolkit.ctx.AtomicContext.debug.
private static final int	DEFAULT_INIT_TIMEOUT
private static final int	DEFAULT_RETRIES
pack-priv DnsName	domain
pack-priv Hashtable<Object, Object>	environment
private boolean	envShared
private static final String	INIT_TIMEOUT
private static final String	LOOKUP_ATTR
private CT	lookupCT
pack-priv static final NameParser	nameParser
private boolean	parentIsDns
private boolean	recursion
private static final String	RECURSION
private Resolver	resolver
private int	retries
private static final String	RETRIES
private String[]	servers
private int	timeout
private static final ZoneNode	zoneTree

Constructor Summary

Access	Constructor and Description
public	DnsContext(String domain, String[] servers, Hashtable<?, ?> environment) Returns a DNS context for a given domain and servers.
pack-priv	DnsContext(DnsContext ctx, DnsName domain)
private	DnsContext(DnsContext ctx)

Method Summary

Modifier and Type	Method and Description
public Object	addToEnvironment(String the name of the environment property to add; may not be null propName, Object the value of the property to add; may not be null propVal) Implements javax.naming.Context.addToEnvironment. Adds a new environment property to the environment of this context.
private static CT[]	attrIdsToClassesAndTypes(String[] attrIds)
public void	c_bind(Name name, Object obj, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_bind.
public void	c_bind(Name name, Object obj, Attributes attrs, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_bind.
public Context	c_createSubcontext(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_createSubcontext.
public DirContext	c_createSubcontext(Name name, Attributes attrs, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_createSubcontext.
public void	c_destroySubcontext(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_destroySubcontext.
public Attributes	c_getAttributes(Name name, String[] attrIds, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getAttributes.
public NameParser	c_getNameParser(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_getNameParser.
public DirContext	c_getSchema(Name name, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getSchema.
public DirContext	c_getSchemaClassDefinition(Name name, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getSchemaClassDefinition.
public NamingEnumeration<NameClassPair>	c_list(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_list.
public NamingEnumeration<Binding>	c_listBindings(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_listBindings.
public Object	c_lookup(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_lookup.
public Object	c_lookupLink(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_lookupLink.
public void	c_modifyAttributes(Name name, int mod_op, Attributes attrs, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_modifyAttributes.
public void	c_modifyAttributes(Name name, ModificationItem[] mods, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_modifyAttributes.
public void	c_rebind(Name name, Object obj, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_rebind.
public void	c_rebind(Name name, Object obj, Attributes attrs, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_rebind.
public void	c_rename(Name oldname, Name newname, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_rename.
public NamingEnumeration<SearchResult>	c_search(Name name, Attributes matchingAttributes, String[] attributesToReturn, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.
public NamingEnumeration<SearchResult>	c_search(Name name, String filter, SearchControls cons, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.
public NamingEnumeration<SearchResult>	c_search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons, Continuation cont) Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.
public void	c_unbind(Name name, Continuation cont) Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_unbind.
private static boolean	classAndTypeMatch(int rrclass, int rrtype, CT[] cts)
public void	close() Implements javax.naming.Context.close. Closes this context.
public Name	composeName(Name a name relative to this context name, Name the name of this context relative to one of its ancestors prefix) Overrides com.sun.jndi.toolkit.ctx.PartialCompositeContext.composeName. Implements javax.naming.Context.composeName. Composes the name of this context with a name relative to this context.
private static final void	dprint(String msg)
private static CT	fromAttrId(String attrId)
pack-priv DnsName	fullyQualify(Name name)
private static CT	getClassAndTypeToQuery(CT[] cts)
public Hashtable<?, ?>	getEnvironment() Implements javax.naming.Context.getEnvironment. Retrieves the environment in effect for this context.
private CT	getLookupCT(String attrId)
public String	getNameInNamespace() Implements javax.naming.Context.getNameInNamespace. Retrieves the full name of this context within its own namespace.
private NameNode	getNameNode(DnsName fqdn)
private synchronized Resolver	getResolver()
private void	initFromEnvironment()
private boolean	isZoneCurrent(ZoneNode znode, DnsName zone)
protected Hashtable<?, ?>	p_getEnvironment() Overrides com.sun.jndi.toolkit.ctx.PartialCompositeContext.p_getEnvironment. A cheap way of getting the environment.
private NameNode	populateZone(ZoneNode znode, DnsName zone)
public Object	removeFromEnvironment(String the name of the environment property to remove; may not be null propName) Implements javax.naming.Context.removeFromEnvironment. Removes an environment property from the environment of this context.
private static Attributes	rrsToAttrs(ResourceRecords rrs, CT[] cts)
pack-priv void	setProviderUrl(String url)
private static String	toAttrId(int rrclass, int rrtype)

Field Detail

ANY	back to summary
private static final int ANY

authoritative	back to summary
private boolean authoritative

debug	back to summary
private static final boolean debug Hides com.sun.jndi.toolkit.ctx.AtomicContext.debug.

DEFAULT_INIT_TIMEOUT	back to summary
private static final int DEFAULT_INIT_TIMEOUT

DEFAULT_RETRIES	back to summary
private static final int DEFAULT_RETRIES

domain	back to summary
pack-priv DnsName domain

environment	back to summary
pack-priv Hashtable<Object, Object> environment

envShared	back to summary
private boolean envShared

INIT_TIMEOUT	back to summary
private static final String INIT_TIMEOUT

LOOKUP_ATTR	back to summary
private static final String LOOKUP_ATTR

lookupCT	back to summary
private CT lookupCT

nameParser	back to summary
pack-priv static final NameParser nameParser

parentIsDns	back to summary
private boolean parentIsDns

recursion	back to summary
private boolean recursion

RECURSION	back to summary
private static final String RECURSION

resolver	back to summary
private Resolver resolver

retries	back to summary
private int retries

RETRIES	back to summary
private static final String RETRIES

servers	back to summary
private String[] servers

timeout	back to summary
private int timeout

zoneTree	back to summary
private static final ZoneNode zoneTree

Constructor Detail

DnsContext	back to summary
public DnsContext(String domain, String[] servers, Hashtable<?, ?> environment) throws NamingException Returns a DNS context for a given domain and servers. Each server is of the form "server[:port]". IPv6 literal host names include delimiting brackets. There must be at least one server. The environment must not be null; it is cloned before being stored. Annotations @SuppressWarnings:unchecked

DnsContext

back to summary

public DnsContext(String domain, String[] servers, Hashtable<?, ?> environment) throws NamingException

Returns a DNS context for a given domain and servers. Each server is of the form "server[:port]". IPv6 literal host names include delimiting brackets. There must be at least one server. The environment must not be null; it is cloned before being stored.

Annotations

@SuppressWarnings:unchecked

DnsContext	back to summary
pack-priv DnsContext(DnsContext ctx, DnsName domain)

DnsContext	back to summary
private DnsContext(DnsContext ctx)

Method Detail

addToEnvironment	back to summary
public Object addToEnvironment(String propName, Object propVal) throws NamingException Implements javax.naming.Context.addToEnvironment. Doc from javax.naming.Context.addToEnvironment. Adds a new environment property to the environment of this context. If the property already exists, its value is overwritten. See class description for more details on environment properties. Parameters propName:String the name of the environment property to add; may not be null propVal:Object the value of the property to add; may not be null Returns:Object the previous value of the property, or null if the property was not in the environment before Annotations @SuppressWarnings:unchecked Exceptions NamingException: if a naming exception is encountered

addToEnvironment

back to summary

public Object addToEnvironment(String propName, Object propVal) throws NamingException

Implements javax.naming.Context.addToEnvironment.

Doc from javax.naming.Context.addToEnvironment.

Adds a new environment property to the environment of this context. If the property already exists, its value is overwritten. See class description for more details on environment properties.

Parameters

propName:String: the name of the environment property to add; may not be null
propVal:Object: the value of the property to add; may not be null

Returns:Object

the previous value of the property, or null if the property was not in the environment before

Annotations

@SuppressWarnings:unchecked

Exceptions

NamingException:: if a naming exception is encountered

attrIdsToClassesAndTypes	back to summary
private static CT[] attrIdsToClassesAndTypes(String[] attrIds) throws InvalidAttributeIdentifierException

c_bind	back to summary
public void c_bind(Name name, Object obj, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_bind.

c_bind	back to summary
public void c_bind(Name name, Object obj, Attributes attrs, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_bind.

c_createSubcontext	back to summary
public Context c_createSubcontext(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_createSubcontext.

c_createSubcontext	back to summary
public DirContext c_createSubcontext(Name name, Attributes attrs, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_createSubcontext.

c_destroySubcontext	back to summary
public void c_destroySubcontext(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_destroySubcontext.

c_getAttributes	back to summary
public Attributes c_getAttributes(Name name, String[] attrIds, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getAttributes.

c_getNameParser	back to summary
public NameParser c_getNameParser(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_getNameParser.

c_getSchema	back to summary
public DirContext c_getSchema(Name name, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getSchema.

c_getSchemaClassDefinition	back to summary
public DirContext c_getSchemaClassDefinition(Name name, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_getSchemaClassDefinition.

c_list	back to summary
public NamingEnumeration<NameClassPair> c_list(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_list.

c_listBindings	back to summary
public NamingEnumeration<Binding> c_listBindings(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_listBindings.

c_lookup	back to summary
public Object c_lookup(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_lookup.

c_lookupLink	back to summary
public Object c_lookupLink(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_lookupLink.

c_modifyAttributes	back to summary
public void c_modifyAttributes(Name name, int mod_op, Attributes attrs, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_modifyAttributes.

c_modifyAttributes	back to summary
public void c_modifyAttributes(Name name, ModificationItem[] mods, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_modifyAttributes.

c_rebind	back to summary
public void c_rebind(Name name, Object obj, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_rebind.

c_rebind	back to summary
public void c_rebind(Name name, Object obj, Attributes attrs, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_rebind.

c_rename	back to summary
public void c_rename(Name oldname, Name newname, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_rename.

c_search	back to summary
public NamingEnumeration<SearchResult> c_search(Name name, Attributes matchingAttributes, String[] attributesToReturn, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.

c_search	back to summary
public NamingEnumeration<SearchResult> c_search(Name name, String filter, SearchControls cons, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.

c_search	back to summary
public NamingEnumeration<SearchResult> c_search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons, Continuation cont) throws NamingException Implements abstract com.sun.jndi.toolkit.ctx.ComponentDirContext.c_search.

c_unbind	back to summary
public void c_unbind(Name name, Continuation cont) throws NamingException Overrides com.sun.jndi.toolkit.ctx.AtomicContext.c_unbind.

classAndTypeMatch	back to summary
private static boolean classAndTypeMatch(int rrclass, int rrtype, CT[] cts)

back to summary

public void close()

Implements javax.naming.Context.close.

Doc from javax.naming.Context.close.

Closes this context. This method releases this context's resources immediately, instead of waiting for them to be released automatically by the garbage collector.

This method is idempotent: invoking it on a context that has already been closed has no effect. Invoking any other method on a closed context is not allowed, and results in undefined behaviour.

composeName back to summary

public Name composeName(Name name, Name prefix) throws NamingException

Overrides com.sun.jndi.toolkit.ctx.PartialCompositeContext.composeName.

Implements javax.naming.Context.composeName.

Doc from javax.naming.Context.composeName.

Composes the name of this context with a name relative to this context. Given a name (name) relative to this context, and the name (prefix) of this context relative to one of its ancestors, this method returns the composition of the two names using the syntax appropriate for the naming system(s) involved. That is, if name names an object relative to this context, the result is the name of the same object, but relative to the ancestor context. None of the names may be null.

For example, if this context is named "wiz.com" relative to the initial context, then

 composeName("east", "wiz.com")

might return "east.wiz.com". If instead this context is named "org/research", then

 composeName("user/jane", "org/research")

might return "org/research/user/jane" while

 composeName("user/jane", "research")

returns "research/user/jane".

Parameters

name:Name: a name relative to this context
prefix:Name: the name of this context relative to one of its ancestors

Returns:Name

the composition of prefix and name

Exceptions

NamingException:: if a naming exception is encountered

dprint	back to summary
private static final void dprint(String msg)

fromAttrId	back to summary
private static CT fromAttrId(String attrId) throws InvalidAttributeIdentifierException

fullyQualify	back to summary
pack-priv DnsName fullyQualify(Name name) throws NamingException

getClassAndTypeToQuery	back to summary
private static CT getClassAndTypeToQuery(CT[] cts)

getEnvironment back to summary

public Hashtable<?, ?> getEnvironment() throws NamingException

Implements javax.naming.Context.getEnvironment.

Doc from javax.naming.Context.getEnvironment.

Retrieves the environment in effect for this context. See class description for more details on environment properties.

The caller should not make any changes to the object returned: their effect on the context is undefined. The environment of this context may be changed using addToEnvironment() and removeFromEnvironment().

Returns:Hashtable<?, ?>

the environment of this context; never null

Exceptions

NamingException:: if a naming exception is encountered

getLookupCT	back to summary
private CT getLookupCT(String attrId) throws InvalidAttributeIdentifierException

getNameInNamespace back to summary

public String getNameInNamespace()

Implements javax.naming.Context.getNameInNamespace.

Doc from javax.naming.Context.getNameInNamespace.

Retrieves the full name of this context within its own namespace.

Many naming services have a notion of a "full name" for objects in their respective namespaces. For example, an LDAP entry has a distinguished name, and a DNS record has a fully qualified name. This method allows the client application to retrieve this name. The string returned by this method is not a JNDI composite name and should not be passed directly to context methods. In naming systems for which the notion of full name does not make sense, OperationNotSupportedException is thrown.

Returns:String: this context's name in its own namespace; never null

getNameNode	back to summary
private NameNode getNameNode(DnsName fqdn) throws NamingException

getResolver	back to summary
private synchronized Resolver getResolver() throws NamingException

initFromEnvironment	back to summary
private void initFromEnvironment() throws InvalidAttributeIdentifierException

isZoneCurrent	back to summary
private boolean isZoneCurrent(ZoneNode znode, DnsName zone) throws NamingException

p_getEnvironment

back to summary

protected Hashtable<?, ?> p_getEnvironment()

Overrides com.sun.jndi.toolkit.ctx.PartialCompositeContext.p_getEnvironment.

Doc from com.sun.jndi.toolkit.ctx.PartialCompositeContext.p_getEnvironment.

A cheap way of getting the environment. Default implementation is NOT cheap because it simply calls getEnvironment(), which most implementations clone before returning. Subclass should ALWAYS override this with the cheapest possible way. The toolkit knows to clone when necessary.

Returns:Hashtable<?, ?>: The possibly null environment of the context.

populateZone	back to summary
private NameNode populateZone(ZoneNode znode, DnsName zone) throws NamingException

removeFromEnvironment

back to summary

public Object removeFromEnvironment(String propName) throws NamingException

Implements javax.naming.Context.removeFromEnvironment.

Doc from javax.naming.Context.removeFromEnvironment.

Removes an environment property from the environment of this context. See class description for more details on environment properties.

Parameters

propName:String: the name of the environment property to remove; may not be null

Returns:Object

the previous value of the property, or null if the property was not in the environment

Annotations

@SuppressWarnings:unchecked

Exceptions

NamingException:: if a naming exception is encountered

rrsToAttrs	back to summary
private static Attributes rrsToAttrs(ResourceRecords rrs, CT[] cts)

setProviderUrl	back to summary
pack-priv void setProviderUrl(String url)

toAttrId	back to summary
private static String toAttrId(int rrclass, int rrtype)

public Class DnsContext

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail