24.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

Validation d'archive
  • 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 24.1. Attributs 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.
Validation de bean
  • 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 24.2. Attributs 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 24.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 24.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 à 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 24.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.
Gestionnaire de connexion mis en cache
  • 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 24.6. Attributs de 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 24.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é.
  1. Cliquer sur l'onglet Configuration en haut de l'écran. Étendre le menu Connector et sélectionner JCA.
  2. Si le serveur exécute en mode de domaine, sélectionner un profil à partir du menu déroulant Profile en haut et à gauche.
  3. 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.
      Configuration commune JCA

      Figure 24.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.
      Work Managers

      Figure 24.2. Work Managers

      Les attributs de thread pool peuvent être configurés en cliquant sur View sur l'adaptateur de ressources sélectionnées.
      Work Manager Thread Pools

      Figure 24.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.
      Bootstrap Contexts

      Figure 24.4. Bootstrap Contexts