X-Git-Url: http://git.nikiroo.be/?p=jvcard.git;a=blobdiff_plain;f=src%2Fcom%2Fgooglecode%2Flanterna%2Fgui2%2FTextGUIThread.java;fp=src%2Fcom%2Fgooglecode%2Flanterna%2Fgui2%2FTextGUIThread.java;h=0000000000000000000000000000000000000000;hp=f76fccde01e9a6940fb9d47aabc89b048951533f;hb=f06c81000632cfb5f525ca458f719338f55f9f66;hpb=a73a906356c971b080c36368e71a15d87e8b8d31 diff --git a/src/com/googlecode/lanterna/gui2/TextGUIThread.java b/src/com/googlecode/lanterna/gui2/TextGUIThread.java deleted file mode 100644 index f76fccd..0000000 --- a/src/com/googlecode/lanterna/gui2/TextGUIThread.java +++ /dev/null @@ -1,98 +0,0 @@ -/* - * This file is part of lanterna (http://code.google.com/p/lanterna/). - * - * lanterna is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this program. If not, see . - * - * Copyright (C) 2010-2015 Martin - */ -package com.googlecode.lanterna.gui2; - -import java.io.IOException; - -/** - * Class that represents the thread this is expected to run the event/input/update loop for the {@code TextGUI}. There - * are mainly two implementations of this interface, one for having lanterna automatically spawn a new thread for doing - * all the processing and leaving the creator thread free to do other things, and one that assumes the creator thread - * will hand over control to lanterna for as long as the GUI is running. - * @see SameTextGUIThread - * @see SeparateTextGUIThread - * @author Martin - */ -public interface TextGUIThread { - /** - * Invokes custom code on the GUI thread. Even if the current thread is the GUI thread, the code will be - * executed at a later time when the event processing is done. - * - * @param runnable Code to run asynchronously - * @throws java.lang.IllegalStateException If the GUI thread is not running - */ - void invokeLater(Runnable runnable) throws IllegalStateException; - - /** - * Main method to call when you are managing the event/input/update loop yourself. This method will run one round - * through the GUI's event/input queue and update the visuals if required. If the operation did nothing (returning - * {@code false}) you could sleep for a millisecond and then try again. If you use {@code SameTextGUIThread} you - * must either call this method directly to make the GUI update or use one of the methods on - * {@code WindowBasedTextGUI} that blocks until a particular window has closed. - * @return {@code true} if there was anything to process or the GUI was updated, otherwise {@code false} - * @throws IOException - */ - @SuppressWarnings("BooleanMethodIsAlwaysInverted") - boolean processEventsAndUpdate() throws IOException; - - /** - * Schedules custom code to be executed on the GUI thread and waits until the code has been executed before - * returning. If this is run on the GUI thread, it will immediately run the {@code Runnable} and then return. - * - * @param runnable Code to be run and waited for completion before this method returns - * @throws IllegalStateException If the GUI thread is not running - * @throws InterruptedException If the caller thread was interrupted while waiting for the task to be executed - */ - void invokeAndWait(Runnable runnable) throws IllegalStateException, InterruptedException; - - /** - * Updates the exception handler used by this TextGUIThread. The exception handler will be invoked when an exception - * occurs in the main event loop. You can then decide how to log this exception and if you want to terminate the - * thread or not. - * @param exceptionHandler Handler to inspect exceptions - */ - void setExceptionHandler(ExceptionHandler exceptionHandler); - - /** - * Returns the Java thread which is processing GUI events and updating the screen - * @return Thread which is processing events and updating the screen - */ - Thread getThread(); - - /** - * This interface defines an exception handler, that is used for looking at exceptions that occurs during the main - * event loop of the TextGUIThread. You can for example use this for logging, but also decide if you want the - * exception to kill the thread. - */ - interface ExceptionHandler { - /** - * Will be called when an IOException has occurred in the main event thread - * @param e IOException that occurred - * @return If you return {@code true}, the event thread will be terminated - */ - boolean onIOException(IOException e); - - /** - * Will be called when a RuntimeException has occurred in the main event thread - * @param e RuntimeException that occurred - * @return If you return {@code true}, the event thread will be terminated - */ - boolean onRuntimeException(RuntimeException e); - } -}