Índice |
|
wrapper.java.additional.<n> |
||||||||||||||
Parámetros adicionales de Java para pasar a Java cuando se inicia. Estos no son parámetros para su aplicación, sino parámetros para la JVM. Si desea cambiar dinámicamente la lista de parámetros adicionales de Java, existen varias maneras de hacerlo. La primera es usar archivos de inclusión en cascada para añadir un archivo de configuración generado que incluya las propiedades wrapper.java.additional.<n> junto con las opciones de la JVM. Como alternativa, puede usar la propiedad XDF para referenciar un archivo de parámetros donde simplemente se enumerarán las opciones de la JVM sin propiedades. Finalmente, puede pasar wrapper.java.additional.<n> como propiedades de línea de comandos al iniciar el Wrapper. NOTA
Para propiedades específicas de la aplicación, especialmente aquellas con valores que contienen datos
confidenciales, considere usar las propiedades wrapper. Componente <n>:
Cada elemento tiene un nombre de propiedad que empieza con "wrapper. Entrada de parámetros individuales: Es importante que cada propiedad solamente defina un único parámetro.
NOTAA partir de la versión 3.6.0, las siguientes opciones se pueden separar de sus argumentos por un espacio.
Comillas: Versión 3.6.0 y superiores A partir de la versión 3.6.0, el manejo de caracteres especiales ha cambiado para garantizar la coherencia en todas las plataformas. En la mayoría de los casos, puede escribir el valor de parámetro exactamente como desee que se reciba por la JVM. Una excepción a esto son los espacios iniciales o finales, que normalmente se eliminan de los valores de las propiedades. Para conservar estos espacios, es necesario encapsular el valor entre comillas. Estas comillas se eliminarán si la propiedad "quotable" correspondiente se establece en TRUE. Para conservar las comillas en el valor, escápelas con el carácter '\'. Las barras invertidas también deben duplicarse ('\\'). No se permite escapar ningún otro carácter. When stripping quotes, only the the following changes will apply:
Versiones anteriores a 3.6.0 En versiones anteriores del Wrapper, la forma como se administran las comillas varia de acuerdo con la plataforma. En Windows, el proceso Java se crea mediante una línea de comandos donde los argumentos que contienen espacios deben ir entre comillas. Las comillas se eliminan automáticamente de la línea de comandos al iniciar el proceso. En Linux, sin embargo, se utiliza una matriz y los argumentos se pasan directamente. Para simular el comportamiento de Windows y utilizar la misma configuración en todas las plataformas, es posible marcar ciertos parámetros con un indicador de eliminación de comillas (propiedad stripquotes = TRUE). Este indicador solo se utiliza en Unix, y especifica que las comillas de deben eliminar antes de pasar el (los) parámetro(s) a la JVM. Al eliminar las comillas, todos los demás caracteres, excepto los siguientes, permanecerán sin cambios.
|
wrapper.java.additional.<n>.stripquotes |
||||||||||
ADVERTENCIAA partir de la versión 3.6.0, esta propiedad ya no es necesaria y, por lo tanto, deja de ser válida. Cualquier valor marcado con "stripquotes" debe revisarse para no escapar más las barras invertidas ('\') y las comillas ('"').
Si un valor de wrapper.
La propiedad wrapper.
El valor predeterminado es el valor de la propiedad wrapper. Componente <n>:
Cada elemento tiene un nombre de propiedad que comienza con "wrapper.
Al eliminar las comillas, se realizarán los siguientes reemplazos. Todos los demás caracteres permanecerán inalterados.
|
wrapper.java.additional.default.stripquotes |
||||||||
ADVERTENCIAA partir de la versión 3.6.0, esta propiedad ya no es necesaria y, por lo tanto, deja de ser válida. Cualquier valor marcado con "stripquotes" debe revisarse para no escapar más las barras invertidas ('\') y las comillas ('"').
Permite cambiar el comportamiento predeterminado de las comillas en UNIX cuando desee tener el mismo comportamiento para los valores de todas las propiedades wrapper.
|
wrapper.java.additional.<n>.java_version.min |
||||||||||
Esta propiedad se puede utilizar para agregar la opción con el índice 'n' solo si la versión de Java es mayor o igual al valor especificado. El valor predeterminado es '1.4', que es el la versión más antigua compatible con el Wrapper. Cualquier valor inferior no es válido y hará que el Wrapper se detenga. El valor puede ser en los formatos '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 utilizaba el primer formato, mientras que Java 9 y versiones posteriores utilizan el segundo formato. Los corchetes indican que los componentes de versión menor y de revisión son opcionales. Si se deja uno o ambos sin especificar, significa que estos marcadores de posición aceptarán cualquier número.
ADVERTENCIA
|
wrapper.java.additional.<n>.java_version.max |
||||||||||
Esta propiedad se utiliza para agregar la opción 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 ser en los formatos '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 utilizaba el primer formato, mientras que Java 9 y versiones posteriores utilizan el segundo formato. Los corchetes indican que los componentes de versión menor y de revisión son opcionales. Si se deja uno o ambos sin especificar, significa que estos marcadores de posición aceptarán cualquier número.
ADVERTENCIA
|
wrapper.java.additional.<n>.app_only |
|||||||||
ADVERTENCIA
El uso de esta propiedad ha quedado obsoleto a partir de la versión 3.5.60 del Wrapper en favor de la propiedad
wrapper. Antes de iniciar una JVM para ejecutar la aplicación Java, el Wrapper ejecutará la línea de comando Java con una opción --dry-run para verificar que la línea de comando sea válida.
La propiedad wrapper. Esta propiedad no tiene efecto cuando se utilizan versiones de Java que no admiten la opción --dry-run (anteriores a Java 9). El valor predeterminado es FALSE", lo que significa que la opción especificada estará presente tanto en la línea de comandos de Java real como en la línea de comandos "--dry-run". En la gran mayoría de los casos, se prefiere FALSE para que se verifiquen todas las opciones de JVM. NOTASi se establece esta propiedad a TRUE, se omitirá la comprobación de validez de la opción especificada.
Sin embargo, hay algunos casos en los que establecer wrapper.
La mayoría de las veces, esta advertencia no será visible porque la salida se registrará en el nivel especificado con la propiedad wrapper.java.query.loglevel, que es DEBUG de forma predeterminada. Sin embargo, no es posible rastrear el uso de la memoria nativa de una JVM "--dry-run" porque no ejecutará el código nativo del usuario. Por lo tanto, es mejor no incluir esta opción en la línea de comandos "--dry-run".
|
wrapper.java.additional.<n>.scope |
|||||||||
ADVERTENCIANO modifique ninguno de estos parámetros a menos que haya leído la descripción de esta propiedad. Una configuración incorrecta puede hacer que el Wrapper no funcione como esperado. Antes de iniciar la aplicación Java, el Wrapper ejecutará el comando java varias veces para determinar las características de la instalación actual de Java y las configuraciones adecuadas para la aplicación. En la mayoría de los casos, las líneas de comandos para estas invocaciones de Java son construidas por el Wrapper sin que el usuario tenga que preocuparse por ello. Sin embargo, en algunos casos excepcionales, puede ser necesario agregar o quitar ciertas opciones a estas líneas de comandos. Primero, elaboremos la lista de estas invocaciones de Java y sus funciones:
La propiedad wrapper. Los valores posibles son:
El valor predeterminado es DRYRUN_APP.
|
wrapper.java.additional_file |
||||||||||
Esta propiedad proporciona una forma de especificar un archivo que puede contener uno o más parámetros que se pasarán tal cual a la JVM cuando se inicie. Esto puede ser muy útil cuando la lista de parámetros necesita generarse dinámicamente o mediante un instalador. Cualquier parámetro definido en este archivo aparecerá después de aquellos definidos mediante las propiedades wrapper.java.additional.<n> estándar. A partir de la versión 3.5.23 del Wrapper, se ampliarán todas las referencias a variables de entorno en el archivo. NOTAPuede utilizar diferentes versiones de Java incluyendo la variable de entorno WRAPPER_JAVA_VERSION en el nombre del archivo. Formato del Archivo de Parámetros: El formato del archivo es simple.
NOTALas versiones anteriores a 3.6.0 no tienen el modo "quotable" (encomillable), y siempre se permiten múltiples parámetros por línea. Si uno de los valores necesita incluir un espacio, es necesario agregar comillas siguiendo las reglas que se describen a continuación para asegurarse de que el archivo funcione de manera consistente entre todas las plataformas. |
wrapper.java.additional_file.required |
||||||||
Especifica si el archivo adicional Java es obligatorio o no. Si es obligatorio y no se encuentra, el Wrapper se detendrá sin iniciar la máquina JVM. Si no es obligatorio, el archivo se ignorará cuando no se encuentre. El valor predeterminado es TRUE.
|
wrapper.java.additional_file.quotable |
|||||||||||
Cuando se configura en TRUE, se eliminarán las comillas del "archivo de adicional". Esto permite usar comillas como delimitadores de valores y, por lo tanto, enumerar varios argumentos en una sola línea. Además, las comillas se pueden utilizar como delimitadores para conservar espacios iniciales o finales en los argumentos. El valor predeterminado de esta propiedad es "FALSE" ADVERTENCIALas versiones anteriores a 3.6.0 no tienen el modo "quotable" (encomillable), y siempre se permiten múltiples parámetros por línea. Si uno de los valores necesita incluir un espacio, es necesario agregar comillas siguiendo las reglas que se describen a continuación para asegurarse de que el archivo funcione de manera consistente entre todas las plataformas. En el ejemplo a seguir, la línea interpretada como tres parámetros distintos antes de la versión 3.6.0. A partir de la versión 3.6.0, se interpretan como un único parámetro que contiene comillas, a menos que la propiedad wrapper.java.additional_file.quotable se establezca en TRUE.
Cuando una propiedad "quotable" se establece en TRUE, las comillas reales que se conservarán en el valor correspondiente deben entonces escaparse con un carácter '\', y las barras invertidas deben duplicarse ('\\'). No se permite escapar ningún otro carácter. Los siguientes reemplazos se realizarán al eliminar las comillas.
|
wrapper.java.additional_file.stripquotes |
||||||||||
ADVERTENCIAA partir de la versión 3.6.0, esta propiedad ya no es necesaria y, por lo tanto, deja de ser válida. Cualquier valor marcado con "stripquotes" debe revisarse para no escapar más las barras invertidas ('\') y las comillas ('"'). Cada plataforma maneja los parámetros con espacios de forma distinta. Para que una configuración funcione correctamente, siempre debe entrecomillar esos valores. En Windows, se usarán tal cual. Sin embargo, en plataformas UNIX, las comillas se eliminarán al dividir la línea de comandos en una lista de parámetros. En casi todos los casos, deseará eliminar estas comillas. El valor predeterminado es "FALSE".
|
Ejemplos de Uso |
||||||
|
Referencia: Parámetros |
|