org.cytoscape.application.events
Class CyShutdownEvent

java.lang.Object
  org.cytoscape.event.AbstractCyEvent<Object>
      org.cytoscape.application.events.CyShutdownEvent

All Implemented Interfaces:

CyEvent<Object>

public final class CyShutdownEvent
extends AbstractCyEvent<Object>

An event fired immediately before Cytoscape will be shutdown. This event provides methods for listeners processing this event to abort the shutdown. This event should only be fired synchronously to allow all listeners time to clean up.

Cytoscape Backwards Compatibility (Final Class): This class is final and therefore can't be extended by users. This means that we may add methods for minor version updates. Methods will only be removed for major version updates.

Module: application-api

To use this in your app, include the following dependency in your POM:

<dependency>
    <groupId>org.cytoscape</groupId>
    <artifactId>application-api</artifactId>
</dependency>

Constructor Summary

CyShutdownEvent(Object source)
Constructor.

CyShutdownEvent(Object source, boolean force)
Constructor.

Method Summary

void	abortShutdown(String why) A callback to the firing class that allows a listener to abort the shutdown.
String	abortShutdownReason() Returns the reason that the application should not be shut down.
boolean	actuallyShutdown() Returns true if no reason is provided to abort the shutdown and false if anyone processing this event wants to prevent shutdown.
boolean	forceShutdown() Returns true if we want to force the shutdown without any user prompt

Methods inherited from class org.cytoscape.event.AbstractCyEvent

getListenerClass, getSource

Methods inherited from class java.lang.Object

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

Constructor Detail

CyShutdownEvent

public CyShutdownEvent(Object source,
                       boolean force)

Constructor.

Parameters:

source - The object firing this event.

force - If true, force the shutdown (no user prompt)

CyShutdownEvent

public CyShutdownEvent(Object source)

Constructor.

Parameters:

source - The object firing this event.

Method Detail

abortShutdown

public void abortShutdown(String why)

A callback to the firing class that allows a listener to abort the shutdown. This can cause conflicts if abused.

Parameters:

why - A user comprehensible message describing why the shutdown was aborted.

abortShutdownReason

public String abortShutdownReason()

Returns the reason that the application should not be shut down.

Returns:

The reason that the application should not be shut down.

actuallyShutdown

public boolean actuallyShutdown()

Returns true if no reason is provided to abort the shutdown and false if anyone processing this event wants to prevent shutdown.

Returns:

true if no reason is provided to abort the shutdown and false if anyone processing this event wants to prevent shutdown.

forceShutdown

public boolean forceShutdown()

Returns true if we want to force the shutdown without any user prompt