Java Naming and Directory Interface

Cette fonction permet d'utiliser l'interface Java Naming and Directory Interface (JNDI) pour accéder aux ressources configurées du serveur telles que les sources de données ou les fabriques de connexions JMS. Elle permet également d'accéder aux primitives configurées dans le serveur sous forme d'une entrée JNDI.

Activation de cette fonction

Pour activer la fonction Java Naming and Directory Interface, ajoutez la déclaration d'élément suivante dans l'élément featureManager de votre fichier server.xml :
<feature>jndi-1.0</feature>

Versions de Java™ prises en charge

  • JavaSE-1.6
  • JavaSE-1.7
  • JavaSE-1.8

Développement d'une fonction qui dépend de cette fonction

Si vous développez une fonction qui dépend de la fonction Java Naming and Directory Interface, incluez l'élément suivant dans l'en-tête Subsystem-Content du fichier manifeste de fonction pour votre nouvelle fonction :
com.ibm.websphere.appserver.jndi-1.0; type="osgi.subsystem.feature"

Eléments de configuration de la fonction

Vous pouvez utiliser les éléments suivants dans votre fichier server.xml pour configurer la fonction Java Naming and Directory Interface :

classloading
Chargement de classes global
Nom de l'attribut Type de données Valeur par défaut Description
useJarUrls boolean false Indique s'il convient d'utiliser les URL jar: ou wsjar: pour faire référence à des fichiers dans des archives
jndiEntry
Entrée unique dans l'espace de nom par défaut JNDI.
Nom de l'attribut Type de données Valeur par défaut Description
id string   ID de configuration unique.
jndiName string   Nom JNDI à utiliser pour cette entrée.
value string   Valeur JNDI à associer au nom.
jndiObjectFactory
Fabrique d'objets qui doit être utilisée par une entrée de référence JNDI.
Nom de l'attribut Type de données Valeur par défaut Description
className string   Nom de classe d'implémentation de la fabrique d'objets.
id string   ID de configuration unique.
libraryRef Référence à lélément {0} de niveau supérieur (chaîne).   Bibliothèque contenant la classe d'implémentation de fabrique.
objectClassName string java.lang.Object Type d'objet renvoyé de la fabrique.
jndiObjectFactory > library
Description : Bibliothèque contenant la classe d'implémentation de fabrique.
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
apiTypeVisibility string spec,ibm-api,api Types de package d'API que ce chargeur de classe de bibliothèque pourra voir, sous forme de liste d'éléments spec, ibm-api, api et third-party dans laquelle les éléments sont séparés par des virgules.
description string   Description de la bibliothèque partagée (pour les administrateurs)
filesetRef Liste de références aux éléments fileset de niveau supérieur (chaîne dans laquelle les éléments sont séparés par des virgules).   ID de l'ensemble de fichiers référencé
name string   Nom de la bibliothèque partagée (pour les administrateurs)
jndiObjectFactory > library > file
Description : ID du fichier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
id string   ID de configuration unique.
name Chemin vers un fichier   Nom de fichier complet
jndiObjectFactory > library > fileset
Description : ID de l'ensemble de fichiers référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
caseSensitive boolean true Booléen indiquant si la recherche doit se faire en tenant compte de la casse des caractères (valeur par défaut : true).
dir Chemin vers un répertoire ${server.config.dir} Répertoire de base dans lequel rechercher les fichiers.
excludes string   Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à exclure des résultats de la recherche. Par défaut, aucun fichier n'est exclu.
id string   ID de configuration unique.
includes string * Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à inclure dans les résultats de la recherche (valeur par défaut : *).
scanInterval Période avec une précision à la milliseconde près 0 Intervalle entre chaque balayage de l'ensemble de fichiers pour déterminer s'il a subi des changements. Sa valeur est un entier long suivi de l'abréviation de l'unité de temps choisie : h pour les heures, m pour les minutes, s pour les secondes, ms pour les millisecondes. Par exemple, 2ms ou 5s. Désactivé par défaut (scanInterval=0). Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.
jndiObjectFactory > library > folder
Description : ID du dossier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
dir Chemin vers un répertoire   Répertoire ou dossier à inclure dans le chemin d'accès aux classes de la bibliothèque afin de trouver les fichiers de ressources
id string   ID de configuration unique.
jndiReferenceEntry
Entrée de référence dans l'espace de nom par défaut JNDI.
Nom de l'attribut Type de données Valeur par défaut Description
factoryRef Référence à lélément {0} de niveau supérieur (chaîne).   Fabrique d'objets pour l'entrée de référence.
id string   ID de configuration unique.
jndiName string   Nom JNDI pour l'entrée de référence.
jndiReferenceEntry > factory
Description : Fabrique d'objets pour l'entrée de référence.
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
className string   Nom de classe d'implémentation de la fabrique d'objets.
libraryRef Référence à lélément {0} de niveau supérieur (chaîne).   Bibliothèque contenant la classe d'implémentation de fabrique.
objectClassName string java.lang.Object Type d'objet renvoyé de la fabrique.
jndiReferenceEntry > factory > library
Description : Bibliothèque contenant la classe d'implémentation de fabrique.
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
apiTypeVisibility string spec,ibm-api,api Types de package d'API que ce chargeur de classe de bibliothèque pourra voir, sous forme de liste d'éléments spec, ibm-api, api et third-party dans laquelle les éléments sont séparés par des virgules.
description string   Description de la bibliothèque partagée (pour les administrateurs)
filesetRef Liste de références aux éléments fileset de niveau supérieur (chaîne dans laquelle les éléments sont séparés par des virgules).   ID de l'ensemble de fichiers référencé
name string   Nom de la bibliothèque partagée (pour les administrateurs)
jndiReferenceEntry > factory > library > file
Description : ID du fichier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
id string   ID de configuration unique.
name Chemin vers un fichier   Nom de fichier complet
jndiReferenceEntry > factory > library > fileset
Description : ID de l'ensemble de fichiers référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
caseSensitive boolean true Booléen indiquant si la recherche doit se faire en tenant compte de la casse des caractères (valeur par défaut : true).
dir Chemin vers un répertoire ${server.config.dir} Répertoire de base dans lequel rechercher les fichiers.
excludes string   Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à exclure des résultats de la recherche. Par défaut, aucun fichier n'est exclu.
id string   ID de configuration unique.
includes string * Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à inclure dans les résultats de la recherche (valeur par défaut : *).
scanInterval Période avec une précision à la milliseconde près 0 Intervalle entre chaque balayage de l'ensemble de fichiers pour déterminer s'il a subi des changements. Sa valeur est un entier long suivi de l'abréviation de l'unité de temps choisie : h pour les heures, m pour les minutes, s pour les secondes, ms pour les millisecondes. Par exemple, 2ms ou 5s. Désactivé par défaut (scanInterval=0). Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.
jndiReferenceEntry > factory > library > folder
Description : ID du dossier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
dir Chemin vers un répertoire   Répertoire ou dossier à inclure dans le chemin d'accès aux classes de la bibliothèque afin de trouver les fichiers de ressources
id string   ID de configuration unique.
jndiReferenceEntry > properties
Description : Propriétés pour l'entrée de référence.
Obligatoire : false
Type de données
jndiURLEntry
Entrée unique dans l'espace de nom par défaut utilisée pour la liaison des entrées java.net.URL.
Nom de l'attribut Type de données Valeur par défaut Description
id string   ID de configuration unique.
jndiName string   Nom JNDI à utiliser pour cette entrée.
value string   Valeur de l'URL JNDI à associer au nom.
library
Bibliothèque partagée
Nom de l'attribut Type de données Valeur par défaut Description
apiTypeVisibility string spec,ibm-api,api Types de package d'API que ce chargeur de classe de bibliothèque pourra voir, sous forme de liste d'éléments spec, ibm-api, api et third-party dans laquelle les éléments sont séparés par des virgules.
description string   Description de la bibliothèque partagée (pour les administrateurs)
filesetRef Liste de références aux éléments fileset de niveau supérieur (chaîne dans laquelle les éléments sont séparés par des virgules).   ID de l'ensemble de fichiers référencé
id string   ID de configuration unique.
name string   Nom de la bibliothèque partagée (pour les administrateurs)
library > file
Description : ID du fichier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
id string   ID de configuration unique.
name Chemin vers un fichier   Nom de fichier complet
library > fileset
Description : ID de l'ensemble de fichiers référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
caseSensitive boolean true Booléen indiquant si la recherche doit se faire en tenant compte de la casse des caractères (valeur par défaut : true).
dir Chemin vers un répertoire ${server.config.dir} Répertoire de base dans lequel rechercher les fichiers.
excludes string   Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à exclure des résultats de la recherche. Par défaut, aucun fichier n'est exclu.
id string   ID de configuration unique.
includes string * Liste (séparée par des virgules ou des espaces) de masques de nom de fichier à inclure dans les résultats de la recherche (valeur par défaut : *).
scanInterval Période avec une précision à la milliseconde près 0 Intervalle entre chaque balayage de l'ensemble de fichiers pour déterminer s'il a subi des changements. Sa valeur est un entier long suivi de l'abréviation de l'unité de temps choisie : h pour les heures, m pour les minutes, s pour les secondes, ms pour les millisecondes. Par exemple, 2ms ou 5s. Désactivé par défaut (scanInterval=0). Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.
library > folder
Description : ID du dossier référencé
Obligatoire : false
Type de données
Nom de l'attribut Type de données Valeur par défaut Description
dir Chemin vers un répertoire   Répertoire ou dossier à inclure dans le chemin d'accès aux classes de la bibliothèque afin de trouver les fichiers de ressources
id string   ID de configuration unique.

Icône indiquant le type de rubrique Rubrique de référence

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_jndi-1.0
Nom du fichier : rwlp_feature_jndi-1.0.html