public abstract class

DOMService

extends Object
java.lang.Object
   ↳ com.sun.java.browser.dom.DOMService

Summary

Public Constructors
DOMService()
An empty constructor is provided.
Public Methods
static DOMService getService(Object obj)
Returns new instance of a DOMService.
abstract Object invokeAndWait(DOMAction action)
Causes action.run() to be executed synchronously on the DOM action dispatching thread.
abstract void invokeLater(DOMAction action)
Causes action.run() to be executed asynchronously on the DOM action dispatching thread.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public DOMService ()

An empty constructor is provided. Implementations of this abstract class must provide a public no-argument constructor in order for the static getService() method to work correctly. Application programmers should not be able to directly construct implementation subclasses of this abstract subclass.

Public Methods

public static DOMService getService (Object obj)

Returns new instance of a DOMService. The implementation of the DOMService returns depends on the setting of the com.sun.java.browser.dom.DOMServiceProvider property or, if the property is not set, a platform specific default. Throws DOMUnsupportedException if the DOMService is not available to the obj.

Parameters
obj Object to leverage the DOMService

public abstract Object invokeAndWait (DOMAction action)

Causes action.run() to be executed synchronously on the DOM action dispatching thread. This call will block until all pending DOM actions have been processed and (then) action.run() returns. This method should be used when an application thread needs to access the browser's DOM. It should not be called from the DOMActionDispatchThread. Note that if the DOMAction.run() method throws an uncaught exception (on the DOM action dispatching thread), it's caught and re-thrown, as an DOMAccessException, on the caller's thread. If the DOMAction.run() method throws any DOM security related exception (on the DOM action dispatching thread), it's caught and re-thrown, as an DOMSecurityException, on the caller's thread.

Parameters
action DOMAction.

public abstract void invokeLater (DOMAction action)

Causes action.run() to be executed asynchronously on the DOM action dispatching thread. This method should be used when an application thread needs to access the browser's DOM. It should not be called from the DOMActionDispatchThread. Note that if the DOMAction.run() method throws an uncaught exception (on the DOM action dispatching thread), it will not be caught and re-thrown on the caller's thread.

Parameters
action DOMAction.