org.mozilla.javascript
Class WrapFactory

java.lang.Object
  |
  +--org.mozilla.javascript.WrapFactory

public class WrapFactory

extends java.lang.Object

Embeddings that wish to provide their own custom wrappings for Java objects may extend this class and call Context.setWrapFactory(WrapFactory) Once an instance of this class or an extension of this class is enabled for a given context (by calling setWrapFactory on that context), Rhino will call the methods of this class whenever it needs to wrap a value resulting from a call to a Java method or an access to a Java field.

Since:

1.5 Release 4

See Also:

Context.setWrapFactory(WrapFactory)

Constructor Summary

WrapFactory()

Method Summary

boolean	isJavaPrimitiveWrap() Return false if result of Java method, which is instance of String, Number, Boolean and Character, should be used directly as JavaScript primitive type.
void	setJavaPrimitiveWrap(boolean value)
java.lang.Object	wrap(Context cx, Scriptable scope, java.lang.Object obj, java.lang.Class staticType) Wrap the object.
Scriptable	wrapNewObject(Context cx, Scriptable scope, java.lang.Object obj) Wrap an object newly created by a constructor call.

Methods inherited from class java.lang.Object

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

Constructor Detail

WrapFactory

public WrapFactory()

Method Detail

wrap

public java.lang.Object wrap(Context cx,
                             Scriptable scope,
                             java.lang.Object obj,
                             java.lang.Class staticType)

Wrap the object.

The value returned must be one of

• java.lang.Boolean
• java.lang.String
• java.lang.Number
• org.mozilla.javascript.Scriptable objects
• The value returned by Context.getUndefinedValue()
• null

Parameters:

cx - the current Context for this thread

scope - the scope of the executing script

obj - the object to be wrapped. Note it can be null.

Returns:

the wrapped value.

wrapNewObject

public Scriptable wrapNewObject(Context cx,
                                Scriptable scope,
                                java.lang.Object obj)

Wrap an object newly created by a constructor call.

Parameters:

cx - the current Context for this thread

scope - the scope of the executing script

obj - the object to be wrapped

Returns:

the wrapped value.

isJavaPrimitiveWrap

public final boolean isJavaPrimitiveWrap()

Return false if result of Java method, which is instance of String, Number, Boolean and Character, should be used directly as JavaScript primitive type. By default the method returns true to indicate that instances of String, Number, Boolean and Character should be wrapped as any other Java object and scripts can access any Java method available in these objects. Use setJavaPrimitiveWrap(boolean) to change this.

setJavaPrimitiveWrap

public final void setJavaPrimitiveWrap(boolean value)

See Also:

isJavaPrimitiveWrap()