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"
Fonctions qui activent cette fonction
- Distributed Map interface for Dynamic Caching
- Enterprise JavaBeans Lite 3.1
- Enterprise JavaBeans Lite 3.2
- Java Database Connectivity 4.0
- Java Persistence API 2.0
- Java Persistence API 2.1
- Java EE Managed Bean 1.0
- OSGi Java Persistence API
- Database Session Persistence
- Java EE Web Profile 6.0
- Java EE Web Profile 7.0
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 : falseType 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 : falseType 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 : falseType 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 : falseType 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 : falseType 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 : falseType 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 : falseType 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 : falseType 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 : falseType 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.
- 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 : falseType 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 : falseType 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 : falseType 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.