playn.core

Class Exec

java.lang.Object

playn.core.Exec

Direct Known Subclasses:

Exec.Default

public abstract class Exec
extends java.lang.Object

Handles execution of units of code, both on background threads (invokeAsync(java.lang.Runnable)) and on the main PlayN game thread (invokeLater(java.lang.Runnable)).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Exec.Default A default exec implementation which processes Exec.Default.invokeLater(java.lang.Runnable) via the frame tick.

Constructor Summary

Constructors

Constructor and Description
Exec()

Method Summary

Modifier and Type	Method and Description
<T> RPromise<T>	deferredPromise() Creates a promise which defers notification of success or failure to the game thread, regardless of what thread on which it is completed.
void	invokeAsync(java.lang.Runnable action) Invokes the supplied action on a separate thread.
abstract void	invokeLater(java.lang.Runnable action) Invokes action on the next Platform.frame signal.
boolean	isAsyncSupported() Returns whether this platform supports async (background) operations.
abstract boolean	isMainThread() Returns true if the caller is running on the 'main' game thread, false otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

Exec

public Exec()

Method Detail

isMainThread

public abstract boolean isMainThread()

Returns true if the caller is running on the 'main' game thread, false otherwise.

invokeLater

public abstract void invokeLater(java.lang.Runnable action)

Invokes action on the next Platform.frame signal. The default implementation listens to the frame signal at a very high priority so that invoke later actions will run before the game's normal callbacks.

deferredPromise

public <T> RPromise<T> deferredPromise()

Creates a promise which defers notification of success or failure to the game thread, regardless of what thread on which it is completed. Note that even if it is completed on the game thread, it will still defer completion until the next frame.

isAsyncSupported

public boolean isAsyncSupported()

Returns whether this platform supports async (background) operations. HTML doesn't, most other platforms do.

invokeAsync

public void invokeAsync(java.lang.Runnable action)

Invokes the supplied action on a separate thread.

Throws:

java.lang.UnsupportedOperationException - if the platform does not support async operations.