Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

7.4. Créer un module personnalisé

La procédure suivante décrit comment créer un module personnalisé pour rendre les fichiers de propriétés et les autres ressources disponibles à toutes les applications qui exécutent sur le serveur JBoss EAP.

Procédure 7.2. Créer un module personnalisé

  1. Créer et compléter la structure de répertoire module/.
    1. Créer une structure de répertoire sous le répertoire EAP_HOME/module qui contienne les fichiers et les JAR.
      $ cd EAP_HOME/modules/ 
      $ mkdir -p myorg-conf/main/properties
    2. Déplacer les fichiers de propriétés dans le répertoire EAP_HOME/modules/myorg-conf/main/properties/ que vous avez créé à l'étape précédente.
    3. Créer un fichier module.xml dans le répertoire EAP_HOME/modules/myorg-conf/main/ qui contienne l'XML suivant :
      <module xmlns="urn:jboss:module:1.1" name="myorg-conf">
          <resources>
              <resource-root path="properties"/>
          </resources>
      </module>
  2. Modifier le sous-système ee du fichier de configuration du serveur. Vous pouvez utiliser l'interface en ligne de commande JBoss CLI, ou bien, vous pouvez éditer le fichier manuellement.
    • Suivez ces étapes pour modifier le fichier de configuration du serveur par l'interface en ligne de commande JBoss CLI.
      1. Démarrez le serveur et connectez-vous à l'interface en ligne de commande.
        • Dans Linux, saisir ce qui suit au niveau de la ligne de commande :
           EAP_HOME/bin/jboss-cli.sh --connect
        • Dans Windows, saisir ce qui suit au niveau de la ligne de commande :
          C:\>EAP_HOME\bin\jboss-cli.bat --connect
        Vous devriez voir apparaître le résultat suivant :
        Connected to standalone controller at localhost:9999
      2. Pour créer l'élément <global-modules> myorg-conf dans le sous-système ee, saisir ce qui suit dans la ligne de commande :
        /subsystem=ee:write-attribute(name=global-modules, value=[{"name"=>"myorg-conf","slot"=>"main"}])
        Vous devriez voir apparaître le résultat suivant :
        {"outcome" => "success"}
    • Suivre ces étapes si vous préférez éditer manuellement le fichier de configuration du serveur.
      1. Arrêter le serveur et ouvrir le fichier de configuration du serveur dans un éditeur de texte. Si vous exécutez sur un serveur autonome, il s'agira du fichier EAP_HOME/standalone/configuration/standalone.xml ou du fichier EAP_HOME/domain/configuration/domain.xml si vous exécutez sur un domaine géré.
      2. Chercher le sous-système ee et ajouter le module global de myorg-conf. Ce qui suit est un exemple d'élément du sous-système ee modifié pour inclure l'élément myorg-conf :

        Exemple 7.3. élément myorg-conf

        <subsystem xmlns="urn:jboss:domain:ee:1.0" >            
            <global-modules>
                <module name="myorg-conf" slot="main" />            
            </global-modules>
        </subsystem>
  3. Si vous copiez un fichier nommé my.properties dans l'emplacement de module qui convient, vous pourrez alors charger les fichiers de propriétés en utilisant un code qui ressemble à ceci :

    Exemple 7.4. Télécharger le fichier de propriétés

    Thread.currentThread().getContextClassLoader().getResource("my.properties");