- java.lang.Object
-
- javax.naming.Reference
-
- javax.naming.LinkRef
-
- 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
-
-
Field Summary
-
Fields inherited from class javax.naming.Reference
addrs, classFactory, classFactoryLocation, className
-
-
Constructor Summary
Constructors Constructor and Description LinkRef(Name linkName)
Constructs a LinkRef for a name.LinkRef(String linkName)
Constructs a LinkRef for a string name.
-
Method Summary
Methods Modifier and Type Method and Description String
getLinkName()
Retrieves the name of this link.-
Methods inherited from class javax.naming.Reference
add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString
-
-
-
-
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.
-
-
Method Detail
-
getLinkName
public String getLinkName() throws NamingException
Retrieves the name of this link.- Returns:
- The non-null name of this link.
- Throws:
MalformedLinkException
- If a link name could not be extractedNamingException
- If a naming exception was encountered.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/naming/linkref.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.