Lorsque vous créez une fabrique de connexions JMS, GlassFish Server crée un pool de connexions de connecteur et une ressource de connecteur pour la fabrique de connexions. Vous pouvez visualiser ces objets sous le noeud Connecteurs.
Dans l'arborescence de navigation, développez le noeud Ressources.
Sous le noeud Ressources, développez le noeud Ressources JMS.
Sous le noeud Ressources JMS, sélectionnez le noeud Fabriques de connexions JMS.
La page Fabriques de connexions JMS apparaît.
Sur la page Fabriques de connexions JMS, cliquez sur Nouveau.
La page Nouvelle fabrique de connexions JMS apparaît.
Dans le champ Nom du pool, saisissez le nom unique de la fabrique de connexions.
GlassFish Server définit le nom JNDI de la fabrique de connexions sur cette valeur.
Dans la liste déroulante Type de ressource, sélectionnez javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory ou javax.jms.TopicConnectionFactory.
Dans le champ Description, saisissez la description de la fabrique de connexions.
Sélectionnez la case Activé du champ Statut pour activer la ressource lors de l'exécution.
Cette option est activée par défaut.
Dans le champ Taille initiale et minimale du pool, spécifiez le nombre minimal de connexions dans le pool.
La valeur par défaut est 8.
Dans le champ Taille maximale du pool, spécifiez le nombre maximal de connexions dans le pool.
La valeur par défaut est 32.
Dans le champ Valeur de redimensionnement du pool, spécifiez le nombre de connexions à enlever lorsque le délai d'inactivité du pool est dépassé.
La valeur par défaut est 2.
Dans le champ Délai d'inactivité, spécifiez la durée maximale, en secondes, pendant laquelle une connexion peut rester inactive dans le pool.
La valeur par défaut est 300.
Dans le champ Attente max., spécifiez le délai d'attente au-delà duquel la connexion est temporisée pour l'application demandant une connexion.
La valeur par défaut est 60 000.
Si la case Fermer toutes les connexions du champ Echec sur tout est cochée, GlassFish Server ferme toutes les connexions du pool et les rétablit en cas d'échec de l'une d'entre elles.
Si vous ne sélectionnez pas cette case, les connexions individuelles ne seront rétablies que lorsqu'elles seront utilisées. Cette option est désactivée par défaut.
Pour une ressource de fabrique de connexions JMS, sélectionnez le niveau de prise en charge des transactions.
La valeur sélectionnée remplace l'attribut de prise en charge des transactions dans l'adaptateur de ressources de façon à garantir la compatibilité descendante.
Sélectionnez XATransaction (valeur par défaut pour l'adaptateur de ressources JMS) pour une ressource pouvant être utilisée pour les transactions qui impliquent l'utilisation de plusieurs ressources dans la portée d'une transaction.
Par exemple, les transactions peuvent impliquer cette ressource ainsi qu'une ressource JDBC, une ressource de connecteur ou une autre ressource de fabrique de connexions JMS. Cette valeur offre un maximum de flexibilité. Une ressource qui est configurée comme XATransaction participera aux opérations de validation (commit) en deux phases.
Sélectionnez LocalTransaction pour une ressource pouvant être utilisée soit pour les transactions qui impliquent uniquement une ressource dans la portée de la transaction, soit en tant que dernier agent dans une transaction distribuée qui implique plusieurs ressources XA.
Cette valeur offre de meilleures performances. Une ressource qui est configurée comme LocalTransaction ne sera pas utilisée dans les opérations de validation (commit) en deux phases.
Sélectionnez NoTransaction pour une ressource qui ne peut participer à aucune transaction.
Dans les applications JMS, l'utilisation de cette configuration est limitée.
Cochez la case Obligatoire du champ Validation de la connexion pour activer la validation des connexions.
Si cette option est sélectionnée, les connexions sont validées avant d'être affectées à l'application. Si la validation d'une ressource échoue, elle est détruite et une autre ressource est créée puis renvoyée. Cette option est désactivée par défaut.
Dans la section Autres propriétés, spécifiez les propriétés supplémentaires de la fabrique de connexions.
Pour plus d'informations sur les propriétés disponibles, reportez-vous à Propriétés propres aux fabriques de connexions JMS.
Pour ajouter une propriété, cliquez sur le bouton Ajouter une propriété. Sur la ligne vide qui apparaît, saisissez le nom de la propriété dans le champ Nom et la valeur de la propriété dans le champ Valeur.
Dans la zone Cibles, procédez comme suit :
Dans la colonne Disponible, sélectionnez les cibles sur lesquelles les applications qui utilisent la ressource seront déployées.
Les cibles disponibles comprennent les instances de serveur et les clusters disponibles, ainsi que l'instance de serveur par défaut server.
Cliquez sur Ajouter pour déplacer la cible vers la colonne Sélectionné.
Cliquez sur OK.