Compatibilité :	3.5.28
Éditions :
Plateformes :

Lorsque cette propriété est définie sur TRUE, elle indique que le Wrapper qui surveille l'application en cours d'exécution sera notifié de toute tentative de lancement d'une autre instance. Par défaut, cela donnera le focus à la première fenêtre visible (dans l'ordre z) de l'application Java. Toutefois, cette fonctionnalité peut être désactivée à l'aide de wrapper.single_invocation.notify.focus_window.

Le Wrapper enverra également une notification à la JVM, qui déclenchera à son tour un événement nommé « WrapperSecondInvocationEvent ». Cet événement peut être traité par votre application Java afin d'exécuter des tâches personnalisées. La valeur par défaut de cette propriété est FALSE, ce qui signifie qu'aucune notification ne sera envoyée et qu'un simple message d'erreur s'affichera si une instance est déjà en cours d'exécution.

Pour gérer l'événement, quelques modifications seront nécessaires dans votre application :

• Tout d'abord, ajoutez une dépendance à wrapper.jar.
• Ensuite, implémentez l'interface org.tanukisoftware.wrapper.event.WrapperEventListener dans l'une de vos classes. Cela ne nécessite que l'ajout d'une seule méthode dans votre classe. Il s'agit de la méthode qui sera appelée lorsque l'événement est déclenché.
• Enfin, ajoutez la classe en tant qu'écouteur de l'événement.

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
            ...
        }
    }
}

Toute action personnalisée peut être codée dans la méthode fired(). Une pratique courante consiste à ramener une fenêtre spécifique de l'application en cours d'exécution au premier plan lorsque l'utilisateur tente de la lancer une seconde fois. L'exemple suivant utilise setAlwaysOnTop(true) pour amener une fenêtre au premier plan. Cela aura toutefois pour effet de rendre la fenêtre « topmost », ce qui signifie qu'elle se superposera à toutes les autres fenêtres du bureau même si l'utilisateur clique sur l'arrière-plan. Ce comportement peut être annulé en appelant setAlwaysOnTop(false).

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
    }
}

Compatibilité :	3.5.28
Éditions :
Plateformes :

Cette propriété est définie sur TRUE par défaut et donnera le focus à la première fenêtre visible (dans l'ordre z) de l'application Java lorsque l'utilisateur tente de la lancer une seconde fois. S'il n'existe pas de telle fenêtre, une tentative sera faite pour donner le focus à une fenêtre du Wrapper qui surveille l'application en cours d'exécution. Cette fonctionnalité n'est disponible que si wrapper.single_invocation.notify est défini sur TRUE.

Techniquement, l'application Java ne peut pas activer ses propres fenêtres, car elle n'est pas l'application active au moment où l'utilisateur tente de lancer une seconde instance. Lorsque le Wrapper qui surveille l'application Java reçoit une notification d'une autre instance, il communiquera en retour les informations nécessaires afin que l'instance lancée par l'utilisateur puisse activer la fenêtre appropriée. Dans tous les cas, cela sera effectué après le déclenchement de l'événement, donnant ainsi à l'application Java la possibilité de placer sa fenêtre préférée en tête de l'ordre z.

Sauf si vous souhaitez exécuter des actions personnalisées n'impliquant aucune fenêtre, vous devriez toujours laisser cette propriété définie sur TRUE, car il peut être déroutant d'amener une fenêtre au premier plan alors que le focus reste défini sur une fenêtre en arrière-plan.

Compatibilité :	3.5.28
Éditions :
Plateformes :

Cette propriété spécifie le délai maximal (en secondes) pendant lequel le Wrapper attendra une réponse de l'instance en cours d'exécution. À défaut, il affichera un message d'erreur et s'arrêtera. La valeur par défaut est de 15 secondes. Sauf si les actions déclenchées par l'événement mettent trop de temps à s'exécuter, la réponse devrait arriver sans latence.

Compatibilité :	3.5.28
Éditions :
Plateformes :

En mode d'invocation unique, le comportement par défaut consiste à ne pas afficher l'écran de démarrage lorsque le Wrapper est lancé une seconde fois. Si les actions déclenchées par l'événement mettent trop de temps à s'exécuter, il peut être utile d'afficher l'écran de démarrage. Cela peut se faire en définissant cette propriété sur TRUE.