/******************************************************************************* * Copyright (c) 2000, 2014 IBM Corporation and others. * * This program and the accompanying materials * are made available under the terms of the Eclipse Public License 2.0 * which accompanies this distribution, and is available at * https://www.eclipse.org/legal/epl-2.0/ * * SPDX-License-Identifier: EPL-2.0 * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.swt.widgets; import org.eclipse.swt.*; import org.eclipse.swt.graphics.*; /** * Instances of this class provide synchronization support * for displays. A default instance is created automatically * for each display, and this instance is sufficient for almost * all applications. *

* IMPORTANT: Typical application code never * needs to deal with this class. It is provided only to * allow applications which require non-standard * synchronization behavior to plug in the support they * require. Subclasses which override the methods in * this class must ensure that the superclass methods are * invoked in their implementations *

* * @see Display#setSynchronizer * @see Sample code and further information */ public class Synchronizer { Display display; int messageCount; RunnableLock [] messages; Object messageLock = new Object (); Thread syncThread; static final int GROW_SIZE = 4; static final int MESSAGE_LIMIT = 64; //TEMPORARY CODE static final boolean IS_COCOA = "cocoa".equals (SWT.getPlatform ()); static final boolean IS_GTK = "gtk".equals (SWT.getPlatform ()); /** * Constructs a new instance of this class. * * @param display the display to create the synchronizer on */ public Synchronizer (Display display) { this.display = display; } /** * Removes all pending events from the receiver and inserts them into the beginning of the given * synchronizer's queue * * @param toReceiveTheEvents the synchronizer that will receive the events */ void moveAllEventsTo (Synchronizer toReceiveTheEvents) { RunnableLock[] oldMessages; int oldMessageCount; synchronized (messageLock) { oldMessages = messages; messages = null; oldMessageCount = messageCount; messageCount = 0; } toReceiveTheEvents.addFirst(oldMessages, oldMessageCount); } /** * Adds the given events to the beginning of the message queue, to * be processed in order. * * @param toAdd events to add. Permits null if and only if numToAdd is 0. * @param numToAdd number of events to add from the beginning of the given array. */ void addFirst (RunnableLock[] toAdd, int numToAdd) { if (numToAdd <= 0) { return; } boolean wake = false; synchronized (messageLock) { int nextSize = messageCount + Math.max(numToAdd, GROW_SIZE); if (messages == null) messages = new RunnableLock[nextSize]; if (messages.length < messageCount + numToAdd) { RunnableLock[] newMessages = new RunnableLock[nextSize]; System.arraycopy(messages, 0, newMessages, numToAdd, messageCount); messages = newMessages; } else { System.arraycopy(messages, 0, messages, numToAdd, messageCount); } System.arraycopy(toAdd, 0, messages, 0, numToAdd); wake = (messageCount == 0); messageCount += numToAdd; } if (wake) display.wakeThread(); } void addLast (RunnableLock lock) { boolean wake = false; synchronized (messageLock) { if (messages == null) messages = new RunnableLock [GROW_SIZE]; if (messageCount == messages.length) { RunnableLock[] newMessages = new RunnableLock [messageCount + GROW_SIZE]; System.arraycopy (messages, 0, newMessages, 0, messageCount); messages = newMessages; } messages [messageCount++] = lock; wake = messageCount == 1; } if (wake) display.wakeThread (); } /** * Causes the run() method of the runnable to * be invoked by the user-interface thread at the next * reasonable opportunity. The caller of this method continues * to run in parallel, and is not notified when the * runnable has completed. * * @param runnable code to run on the user-interface thread. * * @see #syncExec */ protected void asyncExec (Runnable runnable) { if (runnable == null) { //TEMPORARY CODE if (!(IS_GTK || IS_COCOA)) { display.wake (); return; } } addLast (new RunnableLock (runnable)); } int getMessageCount () { synchronized (messageLock) { return messageCount; } } void releaseSynchronizer () { display = null; messages = null; messageLock = null; syncThread = null; } RunnableLock removeFirst () { synchronized (messageLock) { if (messageCount == 0) return null; RunnableLock lock = messages [0]; System.arraycopy (messages, 1, messages, 0, --messageCount); messages [messageCount] = null; if (messageCount == 0) { if (messages.length > MESSAGE_LIMIT) messages = null; } return lock; } } boolean runAsyncMessages () { return runAsyncMessages (false); } boolean runAsyncMessages (boolean all) { boolean run = false; do { RunnableLock lock = removeFirst (); if (lock == null) return run; run = true; synchronized (lock) { syncThread = lock.thread; display.sendPreEvent(SWT.None); try { lock.run (display); } catch (Throwable t) { lock.throwable = t; SWT.error (SWT.ERROR_FAILED_EXEC, t); } finally { if (display != null && !display.isDisposed()) { display.sendPostEvent(SWT.None); } syncThread = null; lock.notifyAll (); } } } while (all); return run; } /** * Causes the run() method of the runnable to * be invoked by the user-interface thread at the next * reasonable opportunity. The thread which calls this method * is suspended until the runnable completes. * * @param runnable code to run on the user-interface thread. * * @exception SWTException * * @see #asyncExec */ protected void syncExec (Runnable runnable) { RunnableLock lock = null; synchronized (Device.class) { if (display == null || display.isDisposed ()) SWT.error (SWT.ERROR_DEVICE_DISPOSED); if (!display.isValidThread ()) { if (runnable == null) { display.wake (); return; } lock = new RunnableLock (runnable); /* * Only remember the syncThread for syncExec. */ lock.thread = Thread.currentThread(); addLast (lock); } } if (lock == null) { if (runnable != null) { display.sendPreEvent(SWT.None); try { runnable.run(); } catch (RuntimeException exception) { display.getRuntimeExceptionHandler ().accept (exception); } catch (Error error) { display.getErrorHandler ().accept (error); } finally { if (display != null && !display.isDisposed()) { display.sendPostEvent(SWT.None); } } } return; } synchronized (lock) { boolean interrupted = false; while (!lock.done ()) { try { lock.wait (); } catch (InterruptedException e) { interrupted = true; } } if (interrupted) { Thread.currentThread().interrupt(); } if (lock.throwable != null) { SWT.error (SWT.ERROR_FAILED_EXEC, lock.throwable); } } } }