Java: How could I "intercept" Ctrl+C in a CLI application?

Question

Hello!

How could I "intercept" Ctrl+C (which normally would kill the process) in a CLI (command line interface) Java application?

Does a multi-platform solution exist (Linux, Solaris, Windows)?

I'm using Console's readLine(), but if necessary, I could use some other method to read characters from standard input.

Answer 1

I am assuming you want to shutdown gracefully, and not do short circuit the shutdown process. If my assumption is correct, then you should look at Shutdown Hooks.

Answer 2

In order to be able to handle Ctrl+C without shutting down for some reason, you'll need to use some form of signal handling (since the Ctrl+C input isn't actually passed directly to your application, but instead is handled by the OS which generates a SIGINT that is then passed to Java.

See http://java.sun.com/javase/6/webnotes/trouble/TSG-VM/html/signals.html for details on signal handling.

(If you're just wanting to gracefully shutdown, akf's answer will suffice.)

Answer 3

Runtime.getRuntime().addShutdownHook(new Thread() {
    public void run() { /*
       my shutdown code here
    */ }
 });

should be able to intercept the signal, but only as an intermediate step before the JVM completely shutdowns itself, so it may not be what you are looking after.

You need to use a SignalHandler (sun.misc.SignalHandler) to intercept the SIGINT signal triggered by a CTRL-C (on Unix as well inseras on Windows).
See this article.

Answer 4

Some links about how to handle SIGTERM - that is the signal the program is getting on the OS side:

http://blog.webinf.info/2008/08/intercepting-sigterm.html

http://java.sun.com/javase/6/webnotes/trouble/TSG-VM/html/signals.html

http://www.ibm.com/developerworks/java/library/i-signalhandling/

That should work on POSIX operating systems - that is, Mac and Unix should work, on windows I'm not sure, I remember hearing it is also POSIX compatible to some extent, but might varty a lot with different versions.