JNDI

Besoin

Définir une API Java standard d'accès aux annuaires et services de nommage.

Conception

JNDI est structurée en :

• une API, utilisée par les développeurs Java souhaitant accéder à tel ou tel annuaire ou service de nommage ;
• une SPI, utilisée par les fournisseurs désirant implémenter un pilote JNDI pour leur annuaire ou service de nommage.

JNDI est donc indépendante du véritable annuaire ou service de nommage sous-jaçent. Afin de trouver ce service et communiquer avec celui-ci, elle a besoin d'au moins 2 informations :

• l'URL du fournisseur (provider url) du service de nommage (généralement distant, dans un serveur)
• la fabrique de contexte de nommage initial (initial context factory). Cette classe est typiquement propriétaire (fournie avec le service de nommage) car elle implémente le protocole de communication avec le service en question (potentiellement via un protocole propriétaire).

JNDI est incluse dans J2SE depuis J2SE 1.3.

Implémentation

JNDI utilise le package standard javax.naming.

Les noeuds dans l'arbre de nommage sont représentés par l'interface Context. Une implémentation particulière d'un contexte est l'InitialContext, responsable d'établir la communication initiale avec le service en question. A son instanciation, ce contexte initial va rechercher les propriétés java.naming.factory.initial et java.naming.provider.url dans des propriétés Java :

1. fournies en argument du constructeur
2. à défaut, les propriétés système Java (initialisées au démarrage de la JVM via java -Djava.naming.factory.initial=<em>telleValeur</em> -Djava.naming.provider.url=<em>telleAutreValeur</em>ou par programmation via System.setProperty())
3. à défaut lues depuis un fichier jndi.properties accessible dans le classpath

Exemples

Un exemple de connexion à un annuaire LDAP de Sun est :

Properties namingProperties = new Properties();<br> namingProperties.put (<strong>Context</strong>.<strong><strong>INITIAL_CONTEXT_FACTORY</strong>, </strong><span class="codeString">"com.sun.jndi.ldap.LdapCtxFactory<strong>"</strong></span>);<br> namingProperties.put (<strong>Context</strong>.<strong>PROVIDER_URL, </strong><span class="codeString">"ldap://myldaphost:389/o=javaromeCorp"</span>);<br> InitialContext namingContext = new InitialContext(namingProperties);

Notes

• 		Version	1			Commentaire
  		Release	0	1	2
  Couche	Technologie	Fixpack			1
  		port				900 par défaut pour RMI/IIOP, réservé sur Solaris (> 1024)
  Propriétés systèmes	Standard	Fabrique de contexte initiale	java.naming.factory.initial			valeur com.sun.jndi.cosnaming.CNCtxFactory non supportée avant JNDI 1.2
  		URL du service de nommage	java.naming.provider.url			iiop://<hostname>:900
  	Propriétaire

Limitations

• Non transactionnel
• Peu adapté aux mises à jour fréquentes (optimisé pour la lecture)
• Peu adapté aux relations
• Pas de clustering

Exemples

Des exemples de pilotes JNDI sont :

• LDAP
• COS Naming
• DNS
• RMI Registry

Voir aussi

• JNDI Tutorial de Sun