Índice

wrapper.app.property.<n>

Compatibilidad :3.5.57
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Lista de propiedades específicas de la aplicación que el Wrapper envía a la JVM a través de backend pipe o socket una vez que se establece la conexión.

La aplicación del usuario se iniciará después de que todas las propiedades hayan sido recibidas y configuradas en el lado de Java. Esto garantiza que todas las propiedades estarán disponibles cuando la aplicación se inicie.

El uso de las propiedades wrapper.app.property.<n> es más seguro que configurar wrapper.java.additional.<n>, lo cual las expone en texto sin formato a las herramientas de lista de procesos. Por esta razón, se le recomienda encarecidamente que utilice las propiedades de la aplicación para las contraseñas o cualquier dato confidencial que su aplicación pueda utilizar.

Para proteger los datos almacenados en su archivo de configuración, una buena práctica es aislar las propiedades wrapper.app.property.<n> que contienen valores confidenciales en un "archivo de inclusión" separado y asignarle permisos de lectura restrictivos (por ejemplo, solo para el administrador o el propietario).

Además, para evitar que las contraseñas o datos confidenciales se impriman en texto sin formato en la salida del registro del Wrapper, utilice la sintaxis %...|mask%.

Componente <n>:

Cada elemento tiene un nombre de propiedad que comienza con "wrapper.app.property." y el componente "<n>" del nombre de la propiedad es un número entero que cuenta a partir de "1". De manera predeterminada, la numeración debe ser secuencial, sin intervalos. Opcionalmente, puede configurar la propiedad wrapper.ignore_sequence_gaps para permitir intervalos en la secuencia.

Ejemplo:
wrapper.app.property.1=mypassword=%secret|mask%

ADVERTENCIA

A diferencia de las propiedades configuradas a través de la línea de comandos de Java, que están disponibles tan pronto como se inicia la JVM, estas propiedades solo se configuran después de recibirse a través del canal de backend creado por el Wrapper. Por lo tanto, las propiedades a las que se hace referencia con wrapper.app.property.<n> están destinadas a que usted las use solo dentro del contexto de su aplicación Java.

Varias clases del sistema se cargan antes de que se cree el canal de backend. Si una de estas clases va a utilizar una propiedad del sistema, se debe hacer referencia a ella en wrapper.java.additional.<n> para que se pase como argumentos de la línea de comandos.

wrapper.app.property.<n>.quotable

Compatibilidad :3.6.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Si el valor de una propiedad debe incluir espacios finales, puede conservarlos encerrando el valor entre comillas. Estas comillas se eliminarán si usted configura la propiedad wrapper.app.property.<n>.quotable correspondiente en TRUE.

El valor predeterminado para esta propiedad es "FALSE".

Cuando una propiedad "quotable" se configura en TRUE, las comillas reales que se conservarán en el valor correspondiente deben escaparse con un carácter "\", y las barras invertidas deben duplicarse ("\\"). No se le permite escapar ningún otro carácter.

Se realizarán los siguientes reemplazos al eliminar las comillas.

  • "\\" se convertirá en "\",
  • "\"" se convertirá en """
  • """ se convertirá en ""
Ejemplo:
wrapper.app.property.1=prop1="value with trailing spaces   "
wrapper.app.property.1.quotable=TRUE

wrapper.app.property.<n>.java_version.min

Compatibilidad :3.5.57
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Esta propiedad se puede utilizar para agregar la propiedad con el índice "n" solo si la versión de Java es mayor o igual que el valor especificado.

El valor predeterminado es "1.4", que es la versión de JVM más antigua compatible con el Wrapper. Cualquier valor menor es inválido y hará que el Wrapper se detenga.

El valor puede tener el formato "1.major[.minor[_revision]]" o "major[.minor[.revision]]", independientemente de la versión de Java. Esto se hace para admitir ambos esquemas de numeración devueltos por "java -version": antes de Java 9 se usaba el primer formato, mientras que Java 9 y superior usan el segundo formato.

Los corchetes indican que los componentes menores y de revisión son opcionales. Dejar uno o ambos sin especificar significa que estos marcadores de posición aceptarán cualquier número.

La opción con el índice "n" se ignora para cualquier versión de Java inferior a 1.7:
wrapper.app.property.<n>.java_version.min=1.7
La opción con el índice "n" se ignora para cualquier versión de Java inferior a 8.0.40:
wrapper.app.property.<n>.java_version.min=8.0.40

ADVERTENCIA

wrapper.app.property.<n>.java_version.max

Compatibilidad :3.5.57
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Esta propiedad se puede utilizar para agregar la propiedad con el índice "n" solo si la versión de Java es menor o igual al valor especificado.

El valor predeterminado es "UNLIMITED".

El valor puede tener el formato "1.major[.minor[_revision]]" o "major[.minor[.revision]]", independientemente de la versión de Java. Esto se hace para admitir ambos esquemas de numeración devueltos por "java -version": antes de Java 9 se usaba el primer formato, mientras que Java 9 y superior usan el segundo formato.

Los corchetes indican que los componentes menores y de revisión son opcionales. Dejar uno o ambos sin especificar significa que estos marcadores de posición aceptarán cualquier número.

La opción con el índice "n" se ignora para cualquier versión de Java superior a 9.0.1:
wrapper.app.property.<n>.java_version.max=9.0.1
La opción con el índice "n" se ignora para cualquier versión de Java superior a 9:
wrapper.app.property.<n>.java_version.max=9

ADVERTENCIA

wrapper.app.property_file

Compatibilidad :3.5.57
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Esta propiedad le proporciona una forma de especificar un archivo que puede contener una o más propiedades para pasar a la aplicación Java. Esto puede ser muy útil cuando usted necesite que la lista de propiedades se genere dinámicamente o mediante un instalador.

Cualquier propiedad definida en este archivo aparecerá después de las definidas utilizando las propiedades estándar wrapper.app.property.<n>.

A partir de la versión 3.5.23 de Wrapper, se expandirá cualquier referencia a variables de entorno en el archivo.


Formato del archivo:

El formato del archivo es simple.

  • Debe comenzar con una línea de directiva de codificación al igual que el archivo de configuración del Wrapper. Esto es necesario para indicarle al Wrapper qué codificación utilizar al leer el archivo. Si falta esta línea, el Wrapper intentará continuar después de registrar una advertencia. La codificación utilizada en el archivo puede ser diferente de la codificación utilizada en otros archivos de configuración.
  • El carácter "#" se interpreta como un carácter de comentario. Para incluir un carácter "#" en un valor de propiedad, el valor debe estar entre comillas ("#") o escaparse con un segundo carácter "#".
  • Por defecto, solo se puede escribir una propiedad por línea. Este comportamiento se puede cambiar si usted configura la propiedad wrapper.app.property_file.quotable en TRUE. En este modo, los argumentos están delimitados por espacios sin comillas. Esto permite que se enumeren varios parámetros en la misma línea. Los valores que contienen espacios deben estar entre comillas; estas comillas se eliminarán durante el análisis del archivo.

Ejemplo de archivo de propiedades (con .quotable=FALSE):
@encoding=UTF-8
# Propiedades de ejemplo: Una propiedad por línea
prop1=Valor1
prop2=Valor2 con espacio
prop3=Valor3 con espacio
prop4=Valor4

Ejemplo de archivo de propiedades (con .quotable=TRUE):
@encoding=UTF-8
# Propiedades de ejemplo: Varias propiedades en una línea
prop1=Valor1 prop2="Valor2 con espacio" "prop3=Valor3 con espacio"

# Más argumentos
prop4=Valor4

NOTA

Las versiones 3.5.57 a 3.5.60 no tienen el modo "quotable". El archivo solo puede contener una propiedad por línea y las comillas no se eliminan.

wrapper.app.property_file.required

Compatibilidad :3.5.57
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Especifica si el archivo de propiedades es obligatorio o no. Si es obligatorio y no se encuentra, el Wrapper se detendrá sin iniciar la JVM. Si no es obligatorio, el archivo se ignorará cuando no se encuentre.

El valor predeterminado es TRUE.

Ejemplo:
wrapper.app.property_file.required=FALSE

wrapper.app.property_file.quotable

Compatibilidad :3.6.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cuando se configura en TRUE, se eliminarán las comillas contenidas en el archivo de propiedades. Esto le permite a usted utilizar las comillas como delimitadores para los valores y así enumerar múltiples parámetros en una sola línea.

Además, las comillas se pueden usar como delimitadores para conservar los espacios iniciales o finales en los valores de las propiedades.

El valor predeterminado para esta propiedad es "FALSE".

NOTA

Las versiones 3.5.57 a 3.5.60 no tienen el modo "quotable". El archivo solo puede contener una propiedad por línea y las comillas no se eliminan.

Cuando una propiedad "quotable" se configura en TRUE, las comillas reales que se conservarán en el valor correspondiente deben escaparse con un carácter "\", y las barras invertidas deben duplicarse ("\\"). No se le permite escapar ningún otro carácter.

Se realizarán los siguientes reemplazos al eliminar las comillas.

  • "\\" se convertirá en "\",
  • "\"" se convertirá en """
  • """ se convertirá en ""
Ejemplo:
wrapper.app.property_file.quotable=TRUE
Ejemplo de archivo de parámetros UTF-8:
@encoding=UTF-8
prop1=Valor1 prop2="Valor de prueba con espacios."

Referencia: Parámetros