Utilisation de balises Ref dans les fichiers de configuration
Vous pouvez définir un élément de configuration commun, puis réutiliser cette définition en la référençant (à l'aide d'une balise Ref) depuis un autre endroit dans la configuration. Les balises Ref sont utilisables aussi bien dans le même fichier de configuration (celui qui contient la définition de l'élément) que dans un fichier de configuration inclus.
Pourquoi et quand exécuter cette tâche
Différentes approches sont utilisées pour spécifier les relations entre les éléments de configuration requis. Par exemple, les définitions de source de données suivantes sont toutes valides. La première utilise un procédé de définition directe (sans balise Ref), la seconde une combinaison de définition directe et de balises Ref et la troisième, des balises Ref uniquement.
Exemple
Exemple 1 : Pas d'utilisation de balises Ref.
<dataSource id="blogDS" jndiName="jdbc/blogDS">
<properties createDatabase="create" databaseName="C:/liberty/basics/derby/data/blogDB"/>
<jdbcDriver>
<library>
<fileset dir="C:/liberty/basics/derby" includes="derby.jar"/>
</library>
</jdbcDriver>
<connectionManager maxPoolSize="10"/>
</dataSource>
Exemple 2 : Combinaison d'une définition d'élément directe et de balises Ref.
<dataSource id="blogDS" jndiName="jdbc/blogDS" connectionManagerRef="derbyPool">
<properties createDatabase="create" databaseName="C:/liberty/basics/derby/data/blogDB"/>
<jdbcDriver libraryRef="derbyLib"/>
</dataSource>
<connectionManager id="derbyPool" maxPoolSize="10"/>
<library id="derbyLib"/>
<fileset dir="C:/liberty/basics/derby" includes="derby.jar"/>
</library>
Exemple 3 : Utilisation de balises Ref uniquement (sauf pour l'élément properties, qui ne peut être qu'imbriqué).
<dataSource id="blogDS" jndiName="jdbc/blogDS"
connectionManagerRef="derbyPool" jdbcDriverRef="derbyEmbedded">
<properties createDatabase="create" databaseName="C:/liberty/basics/derby/data/blogDB"/>
</dataSource>
<connectionManager id="derbyPool" maxPoolSize="10"/>
<jdbcDriver id="derbyEmbedded" libraryRef="derbyLib"/>
<library id="derbyLib" filesetRef="derbyFileset"/>
<fileset id="derbyFileset" dir="C:/liberty/basics/derby" includes="derby.jar"/>