Utilización de los códigos Ref en los archivos de configuración
Puede definir un elemento de configuración común y, a continuación, volver a utilizar dicha definición haciendo referencia a él (utilizando un código Ref) desde cualquier lugar de la configuración. Los códigos Ref se pueden utilizar en el mismo archivo de configuración que contiene la definición del elemento o en un archivo de configuración incluido.
Acerca de esta tarea
Se utilizan distintos enfoques para especificar las relaciones entre los elementos de configuración necesarios. Por ejemplo, son válidas todas las definiciones de origen de datos siguientes. El primero no utiliza ningún código Ref, el segundo utiliza una combinación de la definición de elemento directo y los códigos Ref y el tercero utiliza solo códigos Ref.
Ejemplo
Ejemplo 1: utilización de ningún código 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>
Ejemplo 2: combinación de la definición de elemento directo y códigos Ref.
<dataSource id="blogDS" jndiName="jdbc/blogDS" connectionManagerRef="derbyPool">
<properties createDatabase="create" databaseName="C:/liberty/basics/derby/data/blogDB"/>
<jdbcDriver libaryRef="derbyLib"/>
</dataSource>
<connectionManager id="derbyPool" maxPoolSize="10"/>
<library id="derbyLib"/>
<fileset dir="C:/liberty/basics/derby" includes="derby.jar"/>
</library>
Ejemplo 3: sólo códigos Reff (excepto para el elemento properties que solo se permite como anidado).
<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"/>