Index

wrapper.app.parameter.<n>

Compatibilidad :1.0.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Estas propiedades se usan para especificar parámetros que serán pasados al método principal de su aplicación.

Cuando el valor de la propiedad wrapper.java.mainclass es org.tanukisoftware.wrapper.WrapperSimpleApp, el primer parámetro para la aplicación debe ser el nombre de la clase que contiene su método principal. Todos os otrs parámetros son entonces pasados al método principal de su aplicación en orden. Por favor, lea la sección Integración para más detalles.

Componente <n>:

Cada elemento tiene un nombre de propiedad que empieza con wrapper.app.parameter. y el componente "<n>" del nombre de la propiedad es un número entero contando a partir de "1". Por defecto, no puede faltar números. La propiedad wrapper.ignore_sequence_gaps se puede configurar opcionalmente para permitir vacíos en la secuencia.

Comillas:

Para cada entrada, también puede tener un indicador correspondiente de comillas (stripquotes property = TRUE), que eliminará las comillas sin escape del elemento cuando se ejecuta en máquinas Linux /UNIX. Esto es necesario para permitir referencias de archivos que contienen espacios. Para parámetros como los siguientes, de lo contrario, no sería posible decidir cuándo eliminar las comillas y quando dejarlas como están. Todos los demás caracteres, excepto los siguientes, permanecerán sin cambios.

  • '\\' se convertirá en '\',
  • '\"' se convertirá en '"'
  • '"' se convertirá en ''
Ejemplo:
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=com.widgetsrus.MyAppMain
wrapper.app.parameter.2=-d
wrapper.app.parameter.3=-c"../conf/myapp.conf"
wrapper.app.parameter.3.stripquotes=TRUE
wrapper.app.parameter.4=-p4

NOTA

Entrada de parámetro individual:

Los parámetros de la aplicación son diseñados para ser entradas de parámetros individuales. Si especifica un parámetro como '-c conf/myconffile.conf', éste funcionará correctamente en Windows porque los parámetros '-c' y 'conf/myconffile.conf' se analizarán correctamente cuando se inicie Java. Pero en sistemas UNIX, los parámetros será interpretados incorrectamente como un parámetro único '-c conf/myconffile.conf'.

Incorrecto:
wrapper.app.parameter.1=-c conf/myconffile.conf
Correcto:
wrapper.app.parameter.1=-c
wrapper.app.parameter.2=conf/myconffile.conf

wrapper.app.parameter.<n>.stripquotes

Compatibilidad :3.5.17
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Si un valor de wrapper.app.parameter.<n> contiene comillas, el contenido de las comillas será pasado a la aplicación Java como un argumento único en Windows. Sin embargo, en UNIX las comillas también se incluirán como parte del valor del argumento. En la mayoría de los casos, este no es el comportamiento correcto en UNIX, pero es así para mantener la compatibilidad con versiones anteriores.

La propiedad wrapper.app.parameter.<n>.stripquotes hace posible indicarle al Wrapper que elimine automáticamente las comillas adicionales en UNIX. Esta propiedad es ignorada en Windows.

Se define automáticamente con la propiedad wrapper.app.parameter.default.stripquotes, que se revierte automáticamente a "FALSE".

Los siguientes reemplazos se realizarán al eliminar las comillas. Todos los demás caracteres permanecerán sin cambios.

  • '\\' se convertirá en '\',
  • '\"' se convertirá en '"'
  • '"' se convertirá en ''
Ejemplo:
wrapper.app.parameter.1="parm1"
wrapper.app.parameter.1.stripquotes=TRUE
wrapper.app.parameter.2=parm=\"value\"
wrapper.app.parameter.2.stripquotes=TRUE

wrapper.app.parameter.default.stripquotes

Compatibilidad :3.5.17
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Permite cambiar el comportamiento predeterminado de las comillas en UNIX cuando desee tener el mismo comportamiento para todos los valores de las propiedades wrapper.app.parameter.<n>. El valor predeterminado es "FALSE". La propiedad es ignorada en Windows.

Ejemplo:
wrapper.app.parameter.default.stripquotes=FALSE

wrapper.app.parameter_file

Compatibilidad :3.5.17
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

En ciertos casos, puede ser inconveniente enumerar los parámetros de su aplicación en el archivo de configuración del Wrapper. Esta propiedad proviene una forma de especificar un archivo que contiene uno o más parámetros que se pasarán tal cual a la JVM cuando se lance. Esto puede ser muy útil cuando la lista de parámetros debe generarse dinámicamente o por un instalador.

Cualquier parámetro definido en este archivo aparecerá después los definidos usando las propiedades estándar wrapper.app.parameter.<n>.

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

Formato de Archivo de Parámetros:

El formato del archivo es simple.

  • Debe empezar con una línea directiva de codificación como en el archivo de configuración del Wrapper. Esto es necesario para indicar al Wrapper cual codificación usar para leer el archivo. Si falta esta línea, el Wrapper intentará continuar después de registrar una advertencia. La codificación usada en el archivo puede ser diferente de la codificación usada en otros archivos de configuración.
  • Se pueden escribir múltiples parámetros en una línea separando cada parámetro con uno o más espacios.
  • También es posible dividir los parámetros en varias líneas.
  • El carácter '#' se interpreta como un carácter de comentário. Para incluir un carácter '#' en el valor de una propiedad, el valor debe estar entre comillas ("#") o "escapado" por un segundo carácter '#'.
  • Si uno de los valores necesita incluir un espacio, entonces es necesario siguiendo las reglas que se describen a continuación para asegurarse de que el archivo funciona de manera consistente entre todas las plataformas.
Ejemplo de Archivo de Parámetros UTF-8:
#encoding=UTF-8
# Example parameters: Multiple parameters in one line
-DTEST1=Value1 -DTEST2=Value2

# More parameters
-DTEST3=Value3

wrapper.app.parameter_file.required

Compatibilidad :3.5.36
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Especifica si el archivo de parámetros es obligatorio o no. Si es obligatorio y no se encuentra, el Wrapper parará sin iniciar la máquina JVM. Si no es obligatorio, el archivo se ignorará cuando no se encuentre.

El valor predeterminado es TRUE.

Ejemplo:
wrapper.app.parameter_file.required=FALSE

wrapper.app.parameter_file.stripquotes

Compatibilidad :3.5.17
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Las diferentes plataformas manejan los parámetros con espacios de manera diferente. Para hacer que una configuración dada funcione de manera consistente, debe poner estos valores entre comillas. Los valores se usarán tal cual en Windows. Sin embargo, en plataformas UNIX, las comillas se eliminarán a medida que la línea de comando se divida en una lista de parámetros.

En case todos los casos, se sugere eliminar estas comillas. Por defecto, esta propiedad está configurada en FALSE.

Ejemplo:
wrapper.app.parameter_file.stripquotes=FALSE
Ejemplo de Archivo de Parámetros UTF-8:
#encoding=UTF-8
-DTEST1=Value1 -DTEST2="Test Value with spaces."

Referencia: Parámetros