com.sibvisions.rad.ui.swing.impl
Class JSBridge

java.lang.Object
  com.sibvisions.rad.ui.swing.impl.JSBridge

public class JSBridge
extends java.lang.Object

The JSBridge encapsulates the access to javascript functions. It's only possible to access javascript in a web browser. The constructor will throw an exception if it's not possible to access the javascript engine.

Constructor Summary

JSBridge(java.applet.Applet pApplet)
Creates a new instance of JSBridge for an applet.

Method Summary

java.lang.Object	call(java.lang.String pMethod, java.lang.Object... pParams) Calls a javascript method.
void	close() Closes the window.
java.lang.Object	get(java.lang.String pMember) Retrieves a named member of a JavaScript object.
java.lang.String	getCookie(java.lang.String pName) Gets the value of a cookie.
java.lang.Object	getIntern(java.lang.Object pObject, java.lang.String pMember) Retrieves a named member of a JavaScript object.
java.lang.String	getLocation() Gets the current location.
java.lang.String	getTitle() Gets the current window title.
void	openWindow(java.lang.String pURL, java.lang.String pTarget, int iX, int iY, int iWidth, int iHeight, boolean pCenter) Opens a new browser window.
void	requestFocus() Requests the focus.
void	set(java.lang.String pMember, java.lang.Object pValue) Sets a named member of a JavaScript object.
void	setCookie(java.lang.String pName, java.lang.String pValue, long pSecondsValid) Sets the value for a cookie.
void	setLocation(java.lang.String pLocation) Sets the location.
void	setTitle(java.lang.String pTitle) Sets the window title.

Methods inherited from class java.lang.Object

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

Constructor Detail

JSBridge

public JSBridge(java.applet.Applet pApplet)
         throws java.lang.Throwable

Creates a new instance of JSBridge for an applet.

Parameters:

pApplet - the applet

Throws:

java.lang.Throwable - if it's not possible to detect the window object of the applet

Method Detail

setTitle

public void setTitle(java.lang.String pTitle)
              throws java.lang.Throwable

Sets the window title.

Parameters:

pTitle - the title

Throws:

java.lang.Throwable - if the access to the document object fails

getTitle

public java.lang.String getTitle()
                          throws java.lang.Throwable

Gets the current window title.

Returns:

the title

Throws:

java.lang.Throwable - if the access to the document object fails

setLocation

public void setLocation(java.lang.String pLocation)
                 throws java.lang.Throwable

Sets the location.

Parameters:

pLocation - the location

Throws:

java.lang.Throwable - if the access to the location object fails

getLocation

public java.lang.String getLocation()
                             throws java.lang.Throwable

Gets the current location.

Returns:

the location

Throws:

java.lang.Throwable - if the access to the location object fails

close

public void close()
           throws java.lang.Throwable

Closes the window. This operation doesn't work with firefox if the window was not opened through a script.

Throws:

java.lang.Throwable - if the close operation fails

requestFocus

public void requestFocus()
                  throws java.lang.Throwable

Requests the focus.

Throws:

java.lang.Throwable - if the focus can't be set

openWindow

public void openWindow(java.lang.String pURL,
                       java.lang.String pTarget,
                       int iX,
                       int iY,
                       int iWidth,
                       int iHeight,
                       boolean pCenter)
                throws java.lang.Throwable

Opens a new browser window.

Parameters:

pURL - the url for the window

pTarget - the target name

iX - the x location on screen

iY - the y location on screen

iWidth - the window width

iHeight - the window height

pCenter - true to center the window (only used if height or width are defined)

Throws:

java.lang.Throwable - if it's not possible to open the window

call

public java.lang.Object call(java.lang.String pMethod,
                             java.lang.Object... pParams)
                      throws java.lang.Throwable

Calls a javascript method.

Parameters:

pMethod - the method name

pParams - the parameters

Returns:

the result of the method call or null if the method doesn't return a value

Throws:

java.lang.Throwable - if the method is not available or the call failed

set

public void set(java.lang.String pMember,
                java.lang.Object pValue)
         throws java.lang.Throwable

Sets a named member of a JavaScript object. Equivalent to "this.name = value" in JavaScript.

Parameters:

pMember - the member name

pValue - the value for the member

Throws:

java.lang.Throwable - if the member or the parent object is not available

get

public java.lang.Object get(java.lang.String pMember)
                     throws java.lang.Throwable

Retrieves a named member of a JavaScript object. Equivalent to "this.name" in JavaScript.

Parameters:

pMember - the member name

Returns:

the value

Throws:

java.lang.Throwable - if the member is or the parent object is not available

getIntern

public java.lang.Object getIntern(java.lang.Object pObject,
                                  java.lang.String pMember)
                           throws java.lang.Throwable

Retrieves a named member of a JavaScript object. Equivalent to "this.name" in JavaScript.

Parameters:

pObject - the object from which the method should be called

pMember - the member name

Returns:

the value

Throws:

java.lang.Throwable - if the member is or the parent object is not available

setCookie

public void setCookie(java.lang.String pName,
                      java.lang.String pValue,
                      long pSecondsValid)
               throws java.lang.Throwable

Sets the value for a cookie.

Parameters:

pName - the cookie name

pValue - the value to set

pSecondsValid - sets the maximum age of the cookie in seconds

Throws:

java.lang.Throwable - if the cookie can not be set

getCookie

public java.lang.String getCookie(java.lang.String pName)
                           throws java.lang.Throwable

Gets the value of a cookie.

Parameters:

pName - the cookie name

Returns:

the value or null if the cookie is not available

Throws:

java.lang.Throwable - if it's not possible to access the cookie list