wrapper.event.<event_name>.command.argv.<n>
Compatibilidad :3.3.0
Ediciones :Edición ProfesionaEdición Estándar (No Compatible)Edición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Esta propiedade se usa para especificar los argumentos de un comando ejecutado en respuesta a un evento específico.

Como varias de las propiedades de comandos de eventos, se puede definir:

  • Globalmente para todos los eventos: propiedad wrapper.event.default.command.argv.<n>, o
  • Para un evento específico: propiedad wrapper.event.<event_name>.command.argv.<n>.

El componente "<event_name>" del nombre de la propiedad puede ser la palabra clave "default", o uno de los Tipos de Eventos. El componente "<n>" del nombre de la propiedad es un número entero a partir de "1". La propiedad wrapper.ignore_sequence_gaps se puede configurar opcionalmente para permitir espacios en la secuencia.

NOTA

El uso de la palabra clave "default" se agregó en la versión 3.5.5 del Wrapper.


event.default.command:

No es posible especificar valores "default" para elementos individuales de un comando. El Wrapper primero buscará un wrapper.event.<event_name>.command.argv.1. Si encuentra, solo buscará los elementos de comando que contienen <event_name>. Si no encuentra, entonces el Wrapper buscará la propiedad wrapper.event.default.command.argv.1. Al encontrarlo, buscará el resto del comando utilizando las propiedades predeterminadas (default) de los eventos.

Tenga en cuenta que definir un "comando de eventos default" hará que el comando se ejecute en todos los eventos del Wrapper, incluidos los eventos definidos por el usuario.

Ejemplo: 
wrapper.event.jvm_prelaunch.command.argv.1=/usr/bin/mycleanup
wrapper.event.jvm_prelaunch.command.argv.2=/tmp/myapp-tmp

Consulte la documentación para Comandos de Eventos para más ejemplos y una explicación de cómo se pueden usar juntas las diversas propiedades de eventos.


Variables del Controlador de Eventos:

Cuando el Wrapper genera la línea de comandos para ejecutar un proceso hijo, las Variables del Controlador de Eventos se reemplazarán en el valor.

Ejemplo: 
wrapper.event.jvm_prelaunch.command.argv.1=/usr/bin/mycleanup
wrapper.event.jvm_prelaunch.command.argv.2=/tmp/myapp-tmp-%WRAPPER_EVENT_JVM_PID%

Problemas?

Siempre que se encuentren problemas al intentar configurar un comando de eventos, puede ser muy útil habilitar la depuración para ayudar a descubrir exactamente qué está sucediendo.

Ejemplo: 
wrapper.event.default.command.loglevel=INFO

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 del parámetro exactamente como desee que se reciba por la aplicación Java.

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.

Al eliminar comillas, solo se aplicarán los siguientes cambios:

  • '\\' se convertirá en '\',
  • '\"' se convertirá en '"'
  • '"' se convertirá ene ''
Ejemplo: 
wrapper.event.jvm_prelaunch.command.argv.1=/usr/bin/mycleanup
wrapper.event.jvm_prelaunch.command.argv.2="Argument with trailing spaces  "
wrapper.event.jvm_prelaunch.command.argv.2.quotable=TRUE

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.

  • '\\' se convertirá en '\',
  • '\"' se convertirá en '"'
  • '"' se convertirá en ''

Referencia: Comando de Eventos

El Java Service Wrapper proporciona un conjunto completo de propiedades de configuración que le permiten adaptarlo a sus necesidades específicas. Por favor, lea la documentación de las propiedades individuales para ver todas las posibilidades, además de los ejemplos mostrados anteriormente.