Configuration des ressources par défaut Java EE

Vous pouvez utiliser la console d'administration ou les commandes wsadmin afin de configurer les liaisons pour les ressources par défaut Java™ Platform Enterprise Edition (Java EE).

Pourquoi et quand exécuter cette tâche

Nouvelle fonction Nouvelle fonction:
La spécification Java EE définit six ressources par défaut, fournies par le produit dans sa configuration par défaut. Vous configurez un fournisseur de ressources par défaut Java EE en liant le nom JNDI (Java Naming and Directory Interface) pour une ressource par défaut au nom JNDI d'une ressource configurée. Par exemple, vous pouvez lier java:comp/DefaultDataSource à une source de données qui est configurée dans le produit.newfeat
Tableau 1. Ressources par défaut Java EE. Chaque ressource par défaut possède un nom de classe et un nom JNDI. Vous devez lier une ressource au type de ressource WebSphere correspondant.
Classe de ressources Nom JNDI Java EE Type de ressource WebSphere
javax.sql.DataSource java:comp/DefaultDataSource Source de données JDBC
javax.enterprise.concurrent.ContextService java:comp/DefaultContextService Gestionnaire de travaux
javax.enterprise.concurrent.ManagedExecutorService java:comp/DefaultManagedExecutorService Gestionnaire de travaux
javax.enterprise.concurrent.ManagedScheduledExecutorService java:comp/DefaultManagedScheduledExecutorService Gestionnaire de travaux
javax.enterprise.concurrent.ManagedThreadFactory java:comp/DefaultManagedThreadFactory Gestionnaire de travaux
javax.jms.ConnectionFactory java:comp/DefaultJMSConnectionFactory Fabrique de connexions JMS

Procédure

  1. Dans la console d'administration, cliquez sur Ressources > Ressources par défaut Java EE pour accéder à la page Paramètres des ressources par défaut Java EE.
  2. Spécifiez une portée.

    La portée indique l'emplacement du fichier de configuration de ressource. Chaque ressource par défaut Java EE dispose d'une liaison configurable au niveau de chaque portée de type cellule, noeud et serveur. Par défaut, les liaisons sont définies pour chaque ressource par défaut uniquement au niveau de la portée de type cellule. Vous pouvez configurer des liaisons de ressources par défaut pour l'ensemble, certaines ou aucune des portées configurables.

    Si plusieurs ressources existent pour une ressource par défaut, le produit résout les liaisons dans l'ordre de priorité suivant :
    • 1. Portée de type serveur
    • 2. Portée de type noeud
    • 3. Portée de type cellule
    Par exemple, si une source de données par défaut est liée à jdbc/myCellDataSource au niveau de la portée de type cellule et à jdbc/myServerDataSource au niveau de la portée de type serveur pour le serveur server1, toute recherche de java:comp/DefaultDataSource sur server1 est résolue en jdbc/myServerDataSource. Si un autre serveur, server2, existe dans la cellule et qu'il n'existe aucune liaison au niveau de la portée de type noeud ou serveur, toute recherche de java:comp/DefaultDataSource est résolue en jdbc/myCellDataSource.
  3. Liez une ressource par défaut Java EE à une ressource configurée.

    Par exemple, pour lier la source de données par défaut à une source de données JDBC (Java Database Connectivity) configurée, sélectionnez une source de données dans la liste Source de données par défaut. Par défaut, chaque liaison java:comp/Defaultxxx fait référence à une ressource intégrée correspondante fournie par le produit.

    Prenez en compte les informations suivantes lorsque vous configurez le fournisseur de ressources :

    Source de données par défaut
    La source de données par défaut dans la configuration par défaut est une source de données imbriquée Derby, non prise en charge dans un environnement de production.
    Eviter les incidents Eviter les incidents: Pour utiliser une source de données par défaut prise en charge dans un environnement de production, vous devez reconfigurer les liaisons pour la source de données par défaut afin de référencer une source de données prise en charge.gotcha
    Ressources par défaut EE Concurrency
    Contrairement à la source de données par défaut et à la fabrique de connexions JMS par défaut, il n'existe pas de correspondance un à un entre les ressources par défaut EE Concurrency et les types de ressource dans la configuration WebSphere. En revanche, la ressource de gestionnaire de travaux implémente l'ensemble des quatre ressources EE Concurrency. Par défaut, les quatre ressources par défaut EE Concurrency sont toutes liées à une seule ressource de gestionnaire de travaux intégrée via le nom JNDI wm/default. Vous pouvez lier ces ressources par défaut aux différentes ressources de gestionnaire de travaux.
    Ressources par défaut JMS
    La fabrique de connexions JMS par défaut est disponible uniquement au niveau de la portée de type cellule et fait référence au bus d'intégration de services nommé defaultBus. Pour utiliser la fabrique de connexions JMS par défaut, vous pouvez soit créer le bus d'intégration de services nommé defaultBus, soit modifier la propriété Nom du bus de la fabrique de connexions JMS dans la console d'administration de sorte qu'elle fasse référence au bus d'intégration de services de votre choix. Dans les deux cas, vous devez ajouter les membres (serveurs d'applications) au bus et sélectionner le type d'emplacement de stockage des messages (stockage de fichiers ou magasin de données) pour la persistance, afin d'obtenir l'environnement d'exécution du moteur de messagerie.
  4. Cliquez sur OK.

    Une fois ces étapes terminées, les applications peuvent retrouver la ressource par défaut Java EE en effectuant une recherche qui utilise son nom JNDI java:comp/Defaultxxx correspondant. La section Exemple présente un code que votre application peut utiliser pour retrouver une ressource.

Exemple

Les exemples de code suivants montrent de quelle manière une application peut retrouver une ressource par défaut.

  • Recherche qui utilise une injection @Resource
    @Resource(lookup = "java:comp/DefaultDataSource")
    DataSource defaultDatasource;
  • Recherche JNDI
    DataSource defaultDs = (DataSource) new InitialContext().lookup("java:comp/DefaultDataSource");
  • Annotation @Resource sans la recherche, qui prend par défaut le nom JNDI correspondant défini par la spécification Java EE
    @Resource
    DataSource defaultDatasource;

Que faire ensuite

Vous pouvez configurer les propriétés d'une ressource à laquelle est liée une ressource par défaut Java EE. Par exemple, imaginons que la source java:comp/DefaultDataSource soit liée à la source jdbc/myDatasource et que vous souhaitiez affecter la valeur 10 au paramètre de taille de pool maximale pour java:comp/DefaultDataSource. Pour cela, affectez la valeur 10 au paramètre de taille de pool maximale pour jdbc/myDataSource. Pour obtenir des informations relatives à la modification des propriétés des différentes ressources, voir les links connexes.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jeedefaultres
Nom du fichier : tdat_jeedefaultres.html