javax.naming

Class LinkRef

Contents
  • All Implemented Interfaces:
    Serializable, Cloneable

    public class LinkRef
extends Reference
    This class represents a Reference whose contents is a name, called the link name, that is bound to an atomic name in a context.

    The name is a URL, or a name to be resolved relative to the initial context, or if the first character of the name is ".", the name is relative to the context in which the link is bound.

    Normal resolution of names in context operations always follow links. Resolution of the link name itself may cause resolution to pass through other links. This gives rise to the possibility of a cycle of links whose resolution could not terminate normally. As a simple means to avoid such non-terminating resolutions, service providers may define limits on the number of links that may be involved in any single operation invoked by the caller.

    A LinkRef contains a single StringRefAddr, whose type is "LinkAddress", and whose contents is the link name. The class name field of the Reference is that of this (LinkRef) class.

    LinkRef is bound to a name using the normal Context.bind()/rebind(), and DirContext.bind()/rebind(). Context.lookupLink() is used to retrieve the link itself if the terminal atomic name is bound to a link.

    Many naming systems support a native notion of link that may be used within the naming system itself. JNDI does not specify whether there is any relationship between such native links and JNDI links.

    A LinkRef instance is not synchronized against concurrent access by multiple threads. Threads that need to access a LinkRef instance concurrently should synchronize amongst themselves and provide the necessary locking.

    Since:
    1.3
    See Also:
    LinkException, LinkLoopException, MalformedLinkException, Context.lookupLink(javax.naming.Name), Serialized Form

    • Constructor Detail

      • LinkRef

        public LinkRef(Name linkName)
        Constructs a LinkRef for a name.
        Parameters:
        linkName - The non-null name for which to create this link.

      • LinkRef

        public LinkRef(String linkName)
        Constructs a LinkRef for a string name.
        Parameters:
        linkName - The non-null name for which to create this link.

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/naming/LinkRef.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut