Class XSingleInstanceService

java.lang.Object

net.sourceforge.jnlp.services.XSingleInstanceService

All Implemented Interfaces:

SingleInstanceService, ExtendedSingleInstanceService

public class XSingleInstanceService
extends Object
implements ExtendedSingleInstanceService

This class implements SingleInstanceService

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	XSingleInstanceService.SingleInstanceServer	Implements a server that listens for arguments from new instances of this application

Field Summary

Fields

Modifier and Type	Field	Description
(package private) boolean	initialized
private final List<SingleInstanceListener>	listeners
private static final Logger	LOG

Constructor Summary

Constructors

Constructor	Description
XSingleInstanceService()	Create a new XSingleInstanceService

Method Summary

Modifier and Type	Method	Description
void	addSingleInstanceListener(SingleInstanceListener sil)	Add the specified SingleInstanceListener
void	checkSingleInstanceRunning(JNLPFile jnlpFile)	Check if another instance of this application is already running
void	initializeSingleInstance()	Initialize the new SingleInstanceService
private void	notifySingleInstanceListeners(String[] arguments)	Notify any SingleInstanceListener with new arguments
void	removeSingleInstanceListener(SingleInstanceListener sil)	Remove the specified SingleInstanceListener
private void	sendProgramArgumentsToExistingApplication(int port, String[] arguments)	Send the arguments for this application to the main instance
private void	startListeningServer(SingleInstanceLock lockFile)	Start the listening server to accept arguments from new instances of applications

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOG

private static final Logger LOG

listeners

private final List<SingleInstanceListener> listeners

initialized

boolean initialized

Constructor Details

XSingleInstanceService

XSingleInstanceService()

Create a new XSingleInstanceService

Method Details

initializeSingleInstance

public void initializeSingleInstance()

Initialize the new SingleInstanceService

Specified by:

initializeSingleInstance in interface ExtendedSingleInstanceService

Throws:

InstanceExistsException - if the instance already exists

checkSingleInstanceRunning

public void checkSingleInstanceRunning(JNLPFile jnlpFile)

Check if another instance of this application is already running

Specified by:

checkSingleInstanceRunning in interface ExtendedSingleInstanceService

Parameters:

jnlpFile - The JNLPFile that specifies the application

Throws:

InstanceExistsException - if an instance of this application already exists

startListeningServer

private void startListeningServer(SingleInstanceLock lockFile)

Start the listening server to accept arguments from new instances of applications

Parameters:

lockFile - the SingleInstanceLock that the server should use

sendProgramArgumentsToExistingApplication

private void sendProgramArgumentsToExistingApplication(int port,
 String[] arguments)
                                                throws IOException

Send the arguments for this application to the main instance

Parameters:

port - the port at which the SingleInstanceServer is listening at

arguments - the new arguments

Throws:

IOException - on any io exception

notifySingleInstanceListeners

private void notifySingleInstanceListeners(String[] arguments)

Notify any SingleInstanceListener with new arguments

Parameters:

arguments - the new arguments to the application

addSingleInstanceListener

public void addSingleInstanceListener(SingleInstanceListener sil)

Add the specified SingleInstanceListener

Specified by:

addSingleInstanceListener in interface SingleInstanceService

Parameters:

sil - the single instance listener to be added. No action is performed if it is null.

Throws:

InstanceExistsException - which is likely to terminate the application but not guaranteed to

removeSingleInstanceListener

public void removeSingleInstanceListener(SingleInstanceListener sil)

Remove the specified SingleInstanceListener

Specified by:

removeSingleInstanceListener in interface SingleInstanceService

Parameters:

sil - the single instance listener to be removed. No action is performed if it is null or not in the notification list.

Throws:

InstanceExistsException - if an instance of this single instance application already exists