Descripción general: propiedades wrapper.single_invocation.notify

Cuando se habilita la invocación única, el Wrapper comprobará que no hay otra instancia en ejecución con el mismo valor de la propiedad wrapper.ntservice.name. Si existe otra instancia, mostrará un mensaje de error de forma predeterminada.

A partir de la versión 3.5.28, es posible dar el foco a una ventana de la aplicación en ejecución en lugar de mostrar el mensaje de error. Esto funcionará de inmediato sin necesidad de código adicional.

Otra solución ofrece más flexibilidad al permitirle ejecutar acciones personalizadas en respuesta a la segunda invocación. Si su aplicación tiene varias ventanas, podrá seleccionar exactamente cuál mostrar. También puede querer desencadenar acciones completamente diferentes, como mostrar un mensaje personalizado o enviar una notificación por correo electrónico. Esta solución se basa en el manejo de eventos y requiere algo de código.

NOTA

Estas nuevas funciones requieren que la segunda instancia del Wrapper se inicie desde el mismo usuario que (o un usuario con privilegios superiores a) la primera instancia.

Si la primera instancia se está ejecutando como servicio, a menos que sea interactivo, no podrá mostrar una GUI. Por lo tanto, no es posible dar el foco a ninguna ventana, pero una segunda instancia con privilegios suficientes seguirá pudiendo desencadenar acciones diferentes siempre que no impliquen la GUI.

A partir de Windows Vista y Server 2008, un servicio no tiene permitido interactuar con el escritorio del usuario. En este caso, el servicio no podrá dar el foco a una aplicación de escritorio.

wrapper.single_invocation.notify

Compatibilidad :3.5.28
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Cuando se establece en TRUE, esta propiedad especifica que el Wrapper que supervisa la aplicación en ejecución recibirá una notificación de cualquier intento de iniciar otra instancia. De forma predeterminada, esto dará el foco a la primera ventana visible (en el orden z) de la aplicación Java. Sin embargo, esta función se puede desactivar mediante wrapper.single_invocation.notify.focus_window.

El Wrapper también enviará una notificación a la JVM, que a su vez desencadenará un evento llamado 'WrapperSecondInvocationEvent'. Este evento puede ser consumido por su aplicación Java para ejecutar tareas personalizadas. El valor predeterminado de esta propiedad es FALSE, lo que significa que no se enviará ninguna notificación y se mostrará un mensaje de error simple si ya hay una instancia en ejecución.

Para manejar el evento, se necesitarán algunos cambios en su aplicación:

  • En primer lugar, añada una dependencia a wrapper.jar.
  • A continuación, implemente la interfaz org.tanukisoftware.wrapper.event.WrapperEventListener en una de sus clases. Esto requiere añadir solo un método en su clase. Es el método que se llamará cuando se desencadene el evento.
  • Por último, añada la clase como oyente del evento.
Ejemplo: Cómo implementar WrapperEventListener y escuchar WrapperSecondInvocationEvent
import org.tanukisoftware.wrapper.WrapperManager;
import org.tanukisoftware.wrapper.event.WrapperEvent;
import org.tanukisoftware.wrapper.event.WrapperSecondInvocationEvent;
import org.tanukisoftware.wrapper.event.WrapperEventListener;

// Implement WrapperEventListener
public class Main implements WrapperEventListener {
    
    /**
    * Create the application.
    */
    public Main() {
        ...
        // Adds itself as a listener for WrapperSecondInvocationEvent
        WrapperManager.addWrapperEventListener( this, 
            WrapperEventListener.EVENT_FLAG_REMOTE_CONTROL );
    }
        
    public void fired( WrapperEvent event ) {
        if (event instanceof WrapperSecondInvocationEvent ) {
            // Write here the code to be executed 
            // in response to WrapperSecondInvocationEvent
            ...
        }
    }
}

Cualquier acción personalizada se puede codificar dentro del método fired(). Una práctica común es traer al frente una ventana específica de la aplicación en ejecución cada vez que el usuario intenta iniciarla por segunda vez. El siguiente ejemplo usa setAlwaysOnTop(true) para traer una ventana al frente. Sin embargo, esto hará que la ventana sea 'topmost', lo que significa que se superpondrá a todas las demás ventanas del escritorio incluso si el usuario hace clic en el fondo. Este comportamiento se puede cancelar llamando a setAlwaysOnTop(false).

Ejemplo:
public void fired( WrapperEvent event )
{
    if (event instanceof WrapperSecondInvocationEvent )
    {
        // requires java 1.5 or later
        frame.setAlwaysOnTop(true); // bring the window to the top
        frame.setAlwaysOnTop(false);  // remove the topmost feature
    }
}

ADVERTENCIA

Al habilitar esta propiedad, se abrirá una canalización con nombre para permitir la comunicación entre las dos instancias del Wrapper. Tenga en cuenta que cualquier aplicación que se ejecute con el mismo usuario o un usuario con privilegios superiores podría comunicarse a través de la canalización y, por lo tanto, desencadenar el evento. Esto puede causar un problema de seguridad y es responsabilidad de la aplicación Java ejecutar código que sea seguro en este aspecto.

wrapper.single_invocation.notify.focus_window

Compatibilidad :3.5.28
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad está establecida en TRUE de forma predeterminada y dará el foco a la primera ventana visible (en el orden z) de la aplicación Java cada vez que el usuario intente iniciarla por segunda vez. Si no existe tal ventana, se intentará dar el foco a una ventana del Wrapper que supervisa la aplicación en ejecución. Esta función solo está disponible si wrapper.single_invocation.notify está establecido en TRUE.

Técnicamente, la aplicación Java no puede activar sus propias ventanas porque no es la aplicación activa en el momento en que el usuario intenta iniciar una segunda instancia. Cuando el Wrapper que supervisa la aplicación Java recibe una notificación de otra instancia, devolverá la información necesaria para que la instancia iniciada por el usuario pueda activar la ventana adecuada. En cualquier caso, esto se hará después de desencadenar el evento, dando a la aplicación Java la oportunidad de colocar su ventana preferida en la parte superior de la posición del orden z.

A menos que desee ejecutar algunas acciones personalizadas que no impliquen ninguna ventana, siempre debe mantener esta propiedad establecida en TRUE, porque puede resultar confuso traer una ventana al primer plano mientras el foco sigue establecido en una ventana de fondo.

wrapper.single_invocation.notify.timeout

Compatibilidad :3.5.28
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad especifica la cantidad máxima de tiempo (en segundos) que el Wrapper esperará hasta obtener una respuesta de la instancia en ejecución. De lo contrario, mostrará un mensaje de error y se detendrá. El valor predeterminado está establecido en 15 segundos. A menos que las acciones desencadenadas por el evento tarden demasiado en ejecutarse, la respuesta debería llegar sin latencia.

wrapper.single_invocation.notify.show_splashscreen

Compatibilidad :3.5.28
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Con el modo de invocación única, el comportamiento predeterminado es no mostrar la pantalla de inicio cuando el Wrapper se inicia por segunda vez. Si las acciones desencadenadas por el evento tardan demasiado en ejecutarse, puede ser útil mostrar la pantalla de inicio. Esto se puede hacer estableciendo esta propiedad en TRUE.

Referencia: Invocación Única