Índice |
|
Expansión de Variables de Entorno |
||||||
El Wrapper permite la expansión de variables de entorno en tiempo de ejecución dentro de los valores de cualquier propiedad.
Para mantener la naturaleza independiente de plataforma en el archivo de configuración
"wrapper. Cuando el Wrapper se ejecuta como un servicio, las variables de entorno se cargarán desde el registro del sistema, en lugar de desde el entorno. Esto es necesario porque Windows carga las variables de entorno que están disponibles a los servicios cuando la máquina se inicia. Cualquier cambio en las variables de entorno del sistema en el registro (establecidas directamente ó desde el panel de control del sistema) no se hacen disponible a los servicios hasta que la máquina se reinicie nuevamente. Al cargar las variables de entorno desde el registro, se puede evitar el reinicio mientras se proporciona la misma funcionalidad.
Esto se expandirá en tiempo de ejecución a una ruta completamente calificada en cualquier sistema que defina la variable de entorno JAVA_HOME .
NOTASi una variable de entorno a la que se hace referencia no está definida, se registrará una advertencia y se dejará sin cambios en el valor de la propiedad. A partir de la versión 3.5.55, es posible deshabilitar la expansión de variables en secciones del archivo de configuración (y evitar mensajes de advertencia) usando la directiva #variables.expand. |
Definición de Variables de Entorno |
|||||||||
El Wrapper admite la capacidad de definir variables de entorno desde el archivo de configuración
"wrapper. Nombre Especial de Propiedad Empezando con "set." y "set.default." :
Las variables de entorno se definen al usar nombres especiales de propiedad que empiezan con
"set.
se usa el nombre de propiedad "set.
Ejemplo: La capacidad de definir variables de entorno permite modificar fácilmente los valores que se pueden utilizar en un archivo de configuración. El ejemplo a seguir muestra como una variable de entorno puede ser usada para especificar la ubicación de una aplicación externa.
El uso de las definiciones de las variables de entorno puede ser muy potente si entiende como y cuando sus valores se definen. El uso de definiciones de variables de entorno puede ser muy potente si comprende cómo y cuándo se establecen sus valores. Las variables de entorno que se establecieron antes de que se lanzara el Wrapper, por supuesto, pueden usarse como de costumbre. Si se especifica el mismo nombre de variable en el archivo de configuración, el valor en el archivo de configuración anulará el valor existente. Desde la Línea de Comandos:
Las variables de entorno definidas desde la línea de comandos funcionan de manera un poco diferente.
Estos valores desde la línea de comandos anularán cualquieres valores desde el sistema o las establecidas en el archivo de configuración.
Estos valores de la línea de comando anularán cualquier valor del sistema o de los establecidos en el archivo de configuración.
Esto hace posible definir variables de entorno predeterminadas dentro del archivo de configuración
"wrapper.
NOTANote que, como todas las propiedades establecidas desde la línea de comandos, las propiedades que incluyen espacios se pueden definir incluyendo el conjunto completo de "nombre y valor de propiedad" entre comillas. NOTAExiste un problema conocido en el que las variables configuradas con referencias circulares crecerían cada vez que se recarga la configuración (que se requiere al menos una vez al iniciar y opionalmente al reiniciar la JVM). Un ejemplo típico es cuando se agrega una ruta a la variable de entorno PATH:
Actualmente estamos trabajando en una solución para solucionar este problema, pero mientras tanto, una solución alternativa es hacer uso de una variable temporal que solo se establece una vez:
|
Definiciones por Defecto de Variables de Entorno |
||||||||||||||||||||||||
Al iniciarse, el Wrapper establece las siguientes variables de entorno en su propio entorno.
Estas variables se pueden utilizar dentro del archivo de configuración
"wrapper.
|
Pseudo-environment Variable Definitions |
||||||||||||
Además de las variables de entorno anteriores, el Wrapper genera las siguientes variables sin que realmente se almacenen en el entorno. Las variables WRAPPER_RAND_NNNNNN y WRAPPER_TIME_YYYYMMDDHHIISS pueden ser referenciadas varias veces en el archivo de configuración y pueden generar valores diferentes para cada referencia. Por esta razón, no se almacenan en el entorno. Sin embargo, se puede almacenar el valor generado para una referencia única en su propia variable de entorno usando la sintaxis "set.<X>", pero tenga en cuenta que cada vez que se cambia el valor de una variable de entorno, la llamada a la función del sistema subyacente dará como resultado una pequeña pérdida de memoria. Esto debe tenerse en cuenta si el archivo de configuración se puede volver a cargar varias veces, ya que el valor de estas variables se regenerará y cambiará cada vez.
|
Definiciones de Variables de Controlador de Eventos |
||||
Se puede hacer referencia a las siguientes variables en las propiedades de eventos y usarlas cuando se disparan esos eventos. Estas variables también son pseudo-variables de entorno, lo que significa que no se almacenan en el entorno.
|
Enmascaramiento de datos confidenciales |
||||||||||
La sintaxis %. Esta notación no debe confundirse con una definición de variable. Simplemente utiliza los mismos delimitadores '%' que para las variables para indicar que se expandirá al procesar el archivo de configuración. El texto o los datos confidenciales que se enmascararán en la salida del registro se deben escribir entre el delimitador de apertura '%' y el carácter '|'. Para uso interno del Wrapper o de la aplicación Java, esta notación se expandirá a solamente los datos confidenciales, removiendo los delimitadores Para uso interno del Wrapper o de la aplicación Java, esta notación se ampliará solo a los datos confidenciales, eliminando los delimitadores '%' y la parte '|mask. Para la salida del registro, los datos confidenciales se reemplazarán por caracteres '*'. Esta notación es especialmente útil para enmascarar contraseñas, por ejemplo en el valor de una propiedad wrapper.app.property.<n>.
La configuración anterior generará la siguiente salida de registro si establece la propiedad wrapper.properties.dump.loglevel en INFO.
|