22.2. Configuration du sous-système Java Connector Architecture (JCA)

Le sous-système JCA du fichier de configuration de JBoss EAP 6 contrôle les paramètres de configuration généraux du conteneur JCA et déploiements d'adaptateurs de ressources.

Éléments clés du sous-système JCA

Archive validation

Ce paramétrage indique si la validation d'archivage doit avoir lieu sur les unités de déploiement.

Le tableau suivant décrit les attributs que vous pouvez définir pour la validation d'archivage.

Tableau 22.1. Attributs du paramètre de validation d'archivage
Attribut	Valeur par défaut	Description
`enabled`	true	Indique si la validation d'archivage est activée.
`fail-on-error`	true	Indique si un rapport d'erreur de validation d'archivage a fait échouer le développement.
`fail-on-warn`	false	Indique si un rapport d'avertissement de validation d'archivage a fait échouer le développement.

Si une archive n'implémente pas la spécification Java EE Connector Architecture correctement, et que la validation d'archivage est activée, un message d'erreur s'affichera pendant le déploiement pour décrire le problème, comme par exemple :

Severity: ERROR
Section: 19.4.2 
Description: A ResourceAdapter must implement a "public int hashCode()" method. 
Code: com.mycompany.myproject.ResourceAdapterImpl

Severity: ERROR
Section: 19.4.2
Description: A ResourceAdapter must implement a "public boolean equals(Object)" method.
Code: com.mycompany.myproject.ResourceAdapterImpl

Si la validation d'archivage n'est pas spécifiée, on la considérera comme présente et l'attribut enabled aura comme valeur true par défaut.

Bean validation

Ce paramètre indique si la validation de bean (JSR-303) aura lieu sur les unités de déploiement.

Le tableau ci-dessous décrit les attributs que vous pouvez déterminer pour la validation de bean.

Tableau 22.2. Attributs du paramètre de validation de bean
Attribut	Valeur par défaut	Description
`enabled`	true	Indique si la validation de bean est activée.

Si la validation de bean n'est pas spécifiée, on la considérera comme présente et l'attribut enabled aura comme valeur true par défaut.

Work Managers

Il y a deux types de Work Managers :
Work Manager par défaut
Le Work Manager par défaut et ses Thread Pools.
Work Manager personnalisé
Une définition de Work Manager et ses Thread Pools.

Le tableau suivant décrit les attributs que vous pouvez définir pour les Work Managers.

Tableau 22.3. Attributs de Work Managers
Attribut	Description
`name`	Indique le nom du Work Manager. Requis pour les Work Managers personnalisés.
`short-running-threads`	Thread Pool pour les instances Work standards. Chaque Work Manager a un Thread Pool à exécution courte.
`long-running-threads`	Les instances Work de Thread pool de JCA 1.6 qui définissent `LONG_RUNNING`. Chaque Work Manager peut avoir un Thread pool de longue durée en option.

Le tableau ci-dessous décrit les attributs que vous pouvez définir pour les Thread pools de Work Managers.

Tableau 22.4. Attributs de Thread pool
Attribut	Description
`allow-core-timeout`	Paramètre booléen qui détermine quels threads principaux risquent d'expirer. La valeur par défaut est false.
`core-threads`	La taille du pool de threads. Doit être inférieure ou égale à la taille de pool de threads maximum.
`queue-length`	La longueur maximum de la file d'attente.
`max-thread`	Taille de pool de threads maximum.
`keepalive-time`	Indique le durée pendant laquelle les threads de pool doivent être conservés après avoir complété leur tâche.
`thread-factory`	Référence à la fabrique de threads.

Bootstrap Contexts

Utilisé pour définir les contextes de bootstapping (démarrage) personnalisés.

Le tableau suivant décrit les attributs à définir pour les contextes de bootstraping.

Tableau 22.5. Attributs de contexte de bootstrapping
Attribut	Description
`name`	Indique le nom du contexte de bootstrapping
`workmanager`	Indique le nom du Work Manager à utiliser dans ce contexte.

Cached connection manager

Utilisé pour déboguer les connexions et pour supporter l'inscription tardive d'une connexion dans une transaction, pour vérifier leur bonne utilisation et fonctionnement.

Le tableau suivant décrit les attributs que vous pouvez définir pour le manager de connexions mis en cache.

Tableau 22.6. Attributs du paramètre manager de connexion mis en cache
Attribut	Valeur par défaut	Description
`debug`	false	Sorties avertissement en cas d'échec de fermeture explicite des connexions
`error`	false	Envoie une exception en cas d'échec de fermeture explicite des connexions.

Procédure 22.1. Configurer le sous-système JCA par la console de management

Le sous-système JCA de JBoss EAP 6 peut être configuré dans la console de gestion. Les options de configuration de JCA sont situées dans des endroits légèrement différents dans la console de gestion, selon la façon dont le serveur est exécuté.

Cliquer sur l'onglet Configuration en haut de l'écran. Étendre le menu Connector et sélectionner JCA.
Si le serveur exécute en mode de domaine, sélectionner un profil à partir du menu déroulant Profile en haut et à gauche.
Configurer les paramètres du sous-système JCA à l'aide des trois onglets.
1. Config courante
  L'onglet Common Config contient des paramètres pour le gestionnaire de connexions en cache, la validation de l'archive et la validation de bean (JSR-303). Chacun d'entre eux est contenu dans son onglet propre. Ces réglages peuvent être changés en ouvrant l'onglet correspondant, en cliquant sur le bouton Edit, en effectuant les changements nécessaires et puis en cliquant sur le bouton Save de sauvegarde.
  Figure 22.1. Configuration commune JCA
2. Work Managers
  L'onglet Work Manager contient la liste des Work Managers (gestionnaires de travail) configurés. Les nouveaux Work Managers peuvent être ajoutés, supprimés, et leurs pools de threads configurés ici. Chaque Work Manager peut avoir un pool de threads à exécution courte et un pool de threads de longue durée en option.
  Figure 22.2. Work Managers
  Les attributs de thread pool peuvent être configurés en cliquant sur View sur l'adaptateur de ressources sélectionnées.
  Figure 22.3. Work Manager Thread Pools
3. Bootstrap Contexts
  L'onglet Bootstrap Contexts contient la liste des contextes d'amorçage configurés. De nouveaux objets de contexte d'amorçage peuvent être ajoutés, supprimés ou configurés. Un Work Manager doit être assigné à chaque contexte de Bootstrap.
  Figure 22.4. Bootstrap Contexts