Utilización de elementos include en los archivos de configuración

Puede tener toda la configuración en un solo archivo server.xml, o puede utilizar elementos de inclusión para consolidar configuraciones de distintos archivos con el fin de crear la estructura que le resulte más útil.

Acerca de esta tarea

Puede resultar más fácil mantener una configuración compleja dividiéndola en un conjunto de archivos. Por ejemplo:
  • Es posible que desee incluir un archivo que contiene las variables que son específicas del host local, de modo que la configuración principal se pueda utilizar en varios hosts.
  • Es posible que desee mantener toda la configuración para una aplicación determinada en un archivo aparte que pueda versionarse con la aplicación misma.

Ejemplo

Esta es la sintaxis para incluir un archivo de configuración. Puede establecer el atributo optional como true si desea omitir el archivo de inclusión cuando no se pueda encontrar:
<include optional="true" location="pathname/filename"/>
o
<include optional="true" location="url"/>
La siguiente lista muestra las posibles ubicaciones; se busca en el orden mostrado.
  1. en una ubicación especificada relativa al archivo padre
  2. en el directorio de configuración del servidor
  3. en una ubicación especificada como una vía de acceso absoluta
  4. en un servidor web
Para asegurarse de que la configuración de inclusión se comporta según lo previsto, debe tener en cuenta las siguientes reglas de proceso para los archivos de configuración de inclusión:
  • Para servicios singleton como el registro cronológico, o la supervisión de aplicación, las entradas se procesan en el orden en que aparecen en el archivo y las entradas posteriores se añaden o alteran temporalmente las entradas anteriores. Esto también es aplicable a las instancias de configuración, por ejemplo una aplicación o un origen de datos, donde las instancias de configuración tienen el mismo ID.
  • Las sentencias include se pueden colocar dentro del elemento <server />.
  • Cada archivo incluido debe contener un elemento <server /> que coincida con uno del archivo de configuración padre.
  • Los archivos de inclusión pueden alojar otros archivos de inclusión anidados.
  • Cada archivo incluido se fusiona lógicamente en la configuración principal en la posición donde se produce la sentencia <include /> en el archivo padre.

En el ejemplo siguiente, el archivo de configuración del servidor primario server.xml incluye el contenido del archivo de configuración blogDS.xml, que se encuentra en el directorio de configuración compartido. El archivo blogDS.xml contiene una definición de origen de datos. Esta definición se ha colocado en un archivo de configuración aparte para que se pueda incluir en varios archivos distintos server.xml y así se pueda utilizar en varias instancias de servidor.

A continuación figura un código de ejemplo del archivo server.xml:
<server>
  <featureManager>
    <feature>servlet-3.0</feature>
    <feature>jdbc-4.0</feature>
  </featureManager>
  <application id="blog" location="blog.war" name="blog" type="war"/>
  <include optional="true" location="${shared.config.dir}/blogDS.xml"/>
</server>
A continuación figura el código de ejemplo del archivo blogDS.xml:
<server>
  <dataSource id="blogDS" jndiName="jdbc/blogDS"
jdbcDriverRef="derbyEmbedded">
    <properties createDatabase="create" databaseName="C:/liberty/basics/derby/data/blogDB" />
  </dataSource>
  <jdbcDriver id="derbyEmbedded"/>
    <library>
      <fileset dir="C:/liberty/basics/derby" includes="derby.jar" />
    </library>
  </jdbcDriver>
</server>

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_setup_includes.html