Archivos de Configuración en Cascada

A partir de Wrapper versión 3.0.0, es posible especificar "archivos de inclusión dentro de un archivo de configuración como estilo en cascada. Esto es útil cuando es necesario anular los valores predeterminados sin modificar el archivo de configuración predeterminado principal "wrapper.conf".

Sintaxis:

Los archivos de inclusión se especifican colocando una línea en el archivo de configuración con la siguiente sintaxis:

#include ../conf/wrapper2.conf

Profundidad de Niveles

El anidamiento de archivos de inclusión puede continuar hasta 10 niveles con el estilo de cascada.

Prioridad de Propiedad:

El orden en el que se debe colocar la definición del archivo de inclusión dentro de un archivo es importante. Si el mismo nombre de propiedades existe en los archivos de configuración, es necesario prestar atención al orden.

La definición de la línea "#include" debe colocarse en la parte inferior del archivo de configuración. Por ejemplo, el archivo "wrapper.conf" incluye "File2.conf" y el archivo "File2.conf" incluye "File3.conf". Además, la propiedad "PropertyX=valueX" se define en CADA UNO de los tres archivos. En este caso, el valor de propiedad "PropertyX=value3" de "File3.conf" se establecerá después de procesar todos los archivos.

En el otro ejemplo, las propiedades establecidas después del archivo incluido anularán la configuración de propiedades dentro de los archivos incluidos.

Esta regla también se aplica a todo el contenido de los archivos de inclusión.

Ruta:

Si se especifican rutas relativas a los archivos de inclusión, tenga en cuenta que todas las rutas deben ser relativas a la ubicación del directorio de trabajo del Wrapper. De forma predeterminada, el directorio de trabajo es la ubicación del archivo wrapper.exe en Windows o del script utilizado para iniciar el Wrapper en UNIX. El directorio de trabajo se puede cambiar usando la propiedad wrapper.working.dir, pero esto no surte efecto hasta que se haya cargado el archivo de configuración completo. Esto significa que las referencias de archivos de inclusión relativas siempre serán relativas al directorio de trabajo original del Wrapper.


Usar Variables de Entorno:

Cuando se utilizan archivos de inclusión, también es posible hacer referencia a variables de entorno. Puede hacer referencia a las variables de entorno que ya están definidas por el Wrapper o establecer sus propias variables de entorno en el archivo de configuración según sea necesario.

Las variables de entorno predefinidas se pueden encontrar en la página Variables de entorno page.

Cuando la ruta al archivo de inclusión que contiene la variable coincide con un archivo existente en su máquina, esto le permitirá especificar en ese archivo un conjunto de propiedades de configuración que solo desee aplicar para un entorno específico.

Por ejemplo, si desea incluir configuraciones específicas de la plataforma, puede hacer referencia a la siguiente directiva #include en su archivo de configuración principal:

wrapper.conf
#include ../conf/wrapper-%WRAPPER_OS%.conf

Y luego crear un archivo para cada plataforma que necesite una configuración específica.

wrapper-windows.conf
wrapper.java.command=
wrapper.registry.java_home=HKEY_LOCAL_MACHINE\SOFTWARE\MyCompany\MyApplication\JavaHome
wrapper-linux.conf
wrapper.java.command=%JAVA_HOME%/bin/java

Requerir un archivo de inclusión:

Si el archivo especificado no se puede encontrar por algún motivo, simplemente se ignorará. Esto facilita la especificación de una serie de archivos de configuración en cascada opcionales que los usuarios pueden crear o no todavía.

En algunos casos, se requiere un archivo de inclusión para el correcto funcionamiento de una aplicación. A partir de Wrapper versión 3.5.5, es posible especificar una inclusión requerida, lo que provocará un error y evitará que el Wrapper se inicie si está faltando.

Ejemplo:
#include.required ../conf/wrapper-settings.conf

Depuración

Habilitar Mensajes de Depuración:

De forma predeterminada, los archivos de inclusión están diseñados para ser opcionales, por lo que el Wrapper omitirá silenciosamente el archivo de inclusión si no se puede encontrar. Esto puede hacer que los problemas de depuración que implican incluir archivos sean frustrantes. Para ayudar con esto, es posible habilitar mensajes de depuración sobre archivos de inclusión usando la siguiente declaración "#include.debug" antes de cualquier referencia de archivos #include. Tenga en cuenta que esta declaración de depuración deberá realizarse antes de que las propiedades de registro configuradas se hayan procesado en el archivo de configuración "wrapper.conf".

#include.debug

Salida de Registro:

La salida se mostrará en la consola, así como en el archivo wrapper.log predeterminado, que se ubicará en el mismo directorio que el binario del Wrapper. Si el Wrapper se ejecuta como un servicio de Windows, el wrapper.log predeterminado aparecerá en el directorio System32 de Windows.

Archivo de Licencia en Cascada:

Un archivo de licencia recién creado que incluye las propiedades de la clave de licencia se puede colocar en el mismo directorio del archivo de configuración "wrapper.conf". Visite la página Archivo de Licencia en el Archivo de Configuraciones en Cascada para más detalles.