wrapper.jvm.encoding

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

Esta propiedad se utiliza para establecer la codificación predeterminada de la JVM cuando debe diferir de la codificación utilizada por el Wrapper, o para especificar una codificación distinta de UTF-8 al usar Java 18 y versiones posteriores. El valor especificado con wrapper.jvm.encoding se proporciona a la JVM mediante la propiedad del sistema file.encoding en la línea de comandos.

Los valores válidos incluyen:

  • UTF-8: Este es el valor recomendado al usar Java 18 y versiones posteriores. También funciona con JVM anteriores.

  • COMPAT (Desde ver. 3.7.0): Este token se resuelve de la siguiente manera:
    - En Java 18 y posteriores, COMPAT se pasa tal cual a la JVM, lo que hace que Java determine la codificación predeterminada en modo de compatibilidad, como lo hacía en Java 17.
    - En Java 17 y anteriores, COMPAT es interpretado por el propio Wrapper y se traduce a la página de códigos ANSI en Windows, o a la codificación basada en la configuración regional en el momento en que el Wrapper se inicia en Unix.

  • WRAPPER * (Desde ver. 3.7.0): Este token se utiliza para especificar la misma codificación que el proceso Wrapper (es decir, el valor de wrapper.lang.<platform>.encoding convertido automáticamente a la notación Java correspondiente).
    Tenga en cuenta que este ha sido el comportamiento predeterminado para las versiones del Wrapper anteriores a 3.7.0 independientemente de la versión de Java, y sigue siendo el predeterminado para Java 17 y versiones anteriores.

  • <canonical_name> *: Un valor válido de file.encoding admitido por la JVM actual (p. ej., ISO-8859-1, windows-1252, etc.). Por ejemplo, Oracle Java 17 admite las siguientes codificaciones.
    Tenga en cuenta que en Java 18 y posteriores, los únicos valores admitidos oficialmente para file.encoding son 'UTF-8' y 'COMPAT'.

  • DEFAULT: Este es el valor predeterminado.
    - En Java 18 y posteriores, el comportamiento predeterminado es no pasar la codificación a la JVM (es decir, dejar que use UTF-8).
    - En Java 17 y anteriores, el comportamiento predeterminado es resolver la codificación de la JVM como se describe para el valor WRAPPER.

* Si la codificación especificada (o la codificación resuelta al usar WRAPPER) no es admitida por la JVM actual, el Wrapper registrará un mensaje de error y se detendrá. Sin embargo, esta restricción se puede anular estableciendo wrapper.jvm.encoding.allow_unsupported en TRUE.

Ejemplo: (establecer la codificación predeterminada de la JVM en modo 'COMPAT')
wrapper.jvm.encoding=COMPAT

NOTA

Establecer wrapper.jvm.encoding solo se admite cuando la JVM permite especificar una codificación independiente para la salida estándar. Esto requiere soporte para las propiedades del sistema stdout.encoding y stderr.encoding (disponibles en Java 18 y posteriores), o las propiedades sun.stdout.encoding y sun.stderr.encoding (disponibles en las implementaciones de Oracle y OpenJDK a partir de Java 8). El Wrapper siempre comprueba este soporte, pero si wrapper.jvm.encoding se establece en un valor distinto de DEFAULT, solo iniciará la aplicación si se cumplen las condiciones necesarias.

ADVERTENCIA

El uso de esta propiedad (cualquier valor distinto de 'DEFAULT') requiere que no haya ninguna referencia a 'file.encoding', 'stdout.encoding', 'stderr.encoding', 'sun.stdout.encoding' o 'sun.stderr.encoding' en los argumentos pasados a la JVM; de lo contrario, el Wrapper se detendrá.

Esta propiedad no se recarga cuando la JVM se reinicia y wrapper.restart.reload_configuration está establecido en TRUE. Sin embargo, si alguna de las propiedades del sistema anteriores se agregó en los argumentos de la JVM mientras esta propiedad está establecida, el Wrapper se detendrá.

wrapper.jvm.encoding.allow_unsupported

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

Esta propiedad permite que el Wrapper omita la validación del valor de wrapper.jvm.encoding frente a las codificaciones admitidas por la versión actual de Java. Esto puede ser útil, especialmente al usar Java 18 o posterior, donde solo 'UTF-8' y 'COMPAT' son admitidos oficialmente por la JVM, pero muchas otras codificaciones, aunque ya no estén garantizadas, siguen documentadas como "likely to continue to work".

El valor predeterminado es FALSE.

Ejemplo: (permitir que se pase 'EUC-JP' a la JVM aunque no sea admitido oficialmente por Java 18+)
wrapper.lang=en_US
wrapper.lang.unix.encoding=UTF-8

# This will add -Dfile.encoding=EUC-JP to the command line, which is not officially supported by Java 18+.
wrapper.jvm.encoding=EUC-JP

# Without this property, the Wrapper would stop.
wrapper.jvm.encoding.allow_unsupported=TRUE