org.apache.pivot.wtk
Class ApplicationContext

java.lang.Object
  extended by org.apache.pivot.wtk.ApplicationContext
Direct Known Subclasses:
BrowserApplicationContext, DesktopApplicationContext

public abstract class ApplicationContext
extends Object

Base class for application contexts.


Nested Class Summary
static class ApplicationContext.DisplayHost
          Native display host.
static class ApplicationContext.QueuedCallback
          Class representing a queued callback.
static class ApplicationContext.ResourceCacheDictionary
          Resource cache dictionary implementation.
static class ApplicationContext.ScheduledCallback
          Class representing a scheduled callback.
 
Field Summary
protected static ArrayList<Application> applications
           
protected static ArrayList<Display> displays
           
protected static URL origin
           
 
Constructor Summary
ApplicationContext()
           
 
Method Summary
static void applyStylesheet(String resourceName)
          Adds the styles from a named stylesheet to the named or typed style collections.
protected static void createTimer()
           
static void defaultUncaughtExceptionHandler(Exception exception)
           
protected static void destroyTimer()
           
static List<Display> getDisplays()
           
static Version getJavaVersion()
          Returns the current Java Runtime version, parsed from the "java.runtime.version" system property.
static Version getJVMVersion()
          Returns the current JVM version, parsed from the "java.vm.version" system property.
static URL getOrigin()
          Returns this application's origin (the URL of it's originating server).
static Version getPivotVersion()
          Returns the current Pivot version.
static ApplicationContext.ResourceCacheDictionary getResourceCache()
          Resource properties accessor.
static void handleUncaughtException(Exception exception)
           
protected static void invalidateDisplays()
           
static ApplicationContext.QueuedCallback queueCallback(Runnable callback)
          Queues a task to execute after all pending events have been processed and returns without waiting for the task to complete.
static ApplicationContext.QueuedCallback queueCallback(Runnable callback, boolean wait)
          Queues a task to execute after all pending events have been processed and optionally waits for the task to complete.
static ApplicationContext.ScheduledCallback scheduleCallback(Runnable callback, long delay)
          Schedules a task for one-time execution.
static ApplicationContext.ScheduledCallback scheduleRecurringCallback(Runnable callback, long period)
          Schedules a task for repeated execution.
static ApplicationContext.ScheduledCallback scheduleRecurringCallback(Runnable callback, long delay, long period)
          Schedules a task for repeated execution.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

origin

protected static URL origin

displays

protected static ArrayList<Display> displays

applications

protected static ArrayList<Application> applications
Constructor Detail

ApplicationContext

public ApplicationContext()
Method Detail

getOrigin

public static URL getOrigin()
Returns this application's origin (the URL of it's originating server).

Returns:
The application's origin, or null if the origin cannot be determined.

getResourceCache

public static ApplicationContext.ResourceCacheDictionary getResourceCache()
Resource properties accessor.


applyStylesheet

public static void applyStylesheet(String resourceName)
Adds the styles from a named stylesheet to the named or typed style collections.

Parameters:
resourceName -

getJVMVersion

public static Version getJVMVersion()
Returns the current JVM version, parsed from the "java.vm.version" system property.

Returns:
The current JVM version, or an "empty" version if it can't be determined (that is, "0.0.0_00").

getJavaVersion

public static Version getJavaVersion()
Returns the current Java Runtime version, parsed from the "java.runtime.version" system property.

Returns:
The current Java version, or an "empty" version if it can't be determined (that is, "0.0.0_00").

getPivotVersion

public static Version getPivotVersion()
Returns the current Pivot version.

Returns:
The current Pivot version (determined at build time), or an "empty" version if it can't be determined (that is, "0.0.0_00").

scheduleCallback

public static ApplicationContext.ScheduledCallback scheduleCallback(Runnable callback,
                                                                    long delay)
Schedules a task for one-time execution. The task will be executed on the UI thread.

Parameters:
callback - The task to execute.
delay - The length of time to wait before executing the task (in milliseconds).

scheduleRecurringCallback

public static ApplicationContext.ScheduledCallback scheduleRecurringCallback(Runnable callback,
                                                                             long period)
Schedules a task for repeated execution. The task will be executed on the UI thread and will begin executing immediately.

Parameters:
callback - The task to execute.
period - The interval at which the task will be repeated (in milliseconds).

scheduleRecurringCallback

public static ApplicationContext.ScheduledCallback scheduleRecurringCallback(Runnable callback,
                                                                             long delay,
                                                                             long period)
Schedules a task for repeated execution. The task will be executed on the UI thread.

Parameters:
callback - The task to execute.
delay - The length of time to wait before the first execution of the task (milliseconds).
period - The interval at which the task will be repeated (also in milliseconds).

queueCallback

public static ApplicationContext.QueuedCallback queueCallback(Runnable callback)
Queues a task to execute after all pending events have been processed and returns without waiting for the task to complete.

Parameters:
callback - The task to execute.

queueCallback

public static ApplicationContext.QueuedCallback queueCallback(Runnable callback,
                                                              boolean wait)
Queues a task to execute after all pending events have been processed and optionally waits for the task to complete.

Parameters:
callback - The task to execute.
wait - If true, does not return until the task has executed. Otherwise, returns immediately.

createTimer

protected static void createTimer()

destroyTimer

protected static void destroyTimer()

getDisplays

public static List<Display> getDisplays()

invalidateDisplays

protected static void invalidateDisplays()

defaultUncaughtExceptionHandler

public static void defaultUncaughtExceptionHandler(Exception exception)

handleUncaughtException

public static void handleUncaughtException(Exception exception)