Package org.kohsuke.groovy.sandbox.impl

Class Checker

java.lang.Object

org.kohsuke.groovy.sandbox.impl.Checker

public class Checker
extends Object

Intercepted Groovy script calls into this class.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Checker.SuperConstructorWrapper
static class	Checker.ThisConstructorWrapper
static interface	Checker.Thunk	Same as Callable but can throw Throwable.

Constructor Summary

Constructors

Constructor	Description
Checker()

Method Summary

Modifier and Type	Method	Description
static Object	checkedBinaryOp(Object lhs, int op, Object rhs)	Intercepts the binary expression of the form lhs op rhs like lhs+rhs, lhs>>rhs, etc.
static Object	checkedCall(Object _receiver, boolean safe, boolean spread, String _method, Object[] _args)
static Object	checkedCast(Class<?> clazz, Object exp, boolean ignoreAutoboxing, boolean coerce, boolean strict)	Runs ScriptBytecodeAdapter.asType(java.lang.Object, java.lang.Class) but only after giving interceptors the chance to reject any possible interface methods as applied to the receiver.
static Object	checkedComparison(Object lhs, int op, Object rhs)	A compare method that invokes a.equals(b) or a.compareTo(b)==0
static Object	checkedConstructor(Class _type, Object[] _args)
static Object	checkedGetArray(Object _receiver, Object _index)
static Object	checkedGetAttribute(Object _receiver, boolean safe, boolean spread, Object _property)
static Object	checkedGetProperty(Object _receiver, boolean safe, boolean spread, Object _property)
static Object	checkedPostfixArray(Object r, Object i, String op)	a[i]++ / a[i]--
static Object	checkedPostfixProperty(Object receiver, Object property, boolean safe, boolean spread, String op)	a.x++ / a.x--
static Object	checkedPrefixArray(Object r, Object i, String op)	++a[i] / --a[i]
static Object	checkedPrefixProperty(Object receiver, Object property, boolean safe, boolean spread, String op)	++a.x / --a.x
static Object	checkedSetArray(Object _receiver, Object _index, int op, Object _value)	Intercepts the array assignment of the form "receiver[index] = value"
static Object	checkedSetAttribute(Object _receiver, Object _property, boolean safe, boolean spread, int op, Object _value)	Intercepts the attribute assignment of the form "receiver.@property = value"
static Object	checkedSetProperty(Object _receiver, Object _property, boolean safe, boolean spread, int op, Object _value)
static Object	checkedStaticCall(Class _receiver, String _method, Object[] _args)
static Object	checkedSuperCall(Class _senderType, Object _receiver, String _method, Object[] _args)
static Checker.SuperConstructorWrapper	checkedSuperConstructor(Class<?> thisClass, Class<?> superClass, Object[] superCallArgs, Object[] constructorArgs, Class<?>[] constructorParamTypes)
static Checker.ThisConstructorWrapper	checkedThisConstructor(Class<?> clazz, Object[] thisCallArgs, Object[] constructorArgs, Class<?>[] constructorParamTypes)
static Checker.Thunk	preCheckedCast(Class<?> clazz, Object exp, boolean ignoreAutoboxing, boolean coerce, boolean strict)

Methods inherited from class java.lang.Object

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

Constructor Details

Checker

public Checker()

Method Details

checkedCall

public static Object checkedCall(Object _receiver,
 boolean safe,
 boolean spread,
 String _method,
 Object[] _args)
                          throws Throwable

Throws:

Throwable

checkedStaticCall

public static Object checkedStaticCall(Class _receiver,
 String _method,
 Object[] _args)
                                throws Throwable

Throws:

Throwable

checkedConstructor

public static Object checkedConstructor(Class _type,
 Object[] _args)
                                 throws Throwable

Throws:

Throwable

checkedSuperCall

public static Object checkedSuperCall(Class _senderType,
 Object _receiver,
 String _method,
 Object[] _args)
                               throws Throwable

Throws:

Throwable

checkedSuperConstructor

public static Checker.SuperConstructorWrapper checkedSuperConstructor(Class<?> thisClass,
 Class<?> superClass,
 Object[] superCallArgs,
 Object[] constructorArgs,
 Class<?>[] constructorParamTypes)
                                                               throws Throwable

Throws:

Throwable

checkedThisConstructor

public static Checker.ThisConstructorWrapper checkedThisConstructor(Class<?> clazz,
 Object[] thisCallArgs,
 Object[] constructorArgs,
 Class<?>[] constructorParamTypes)
                                                             throws Throwable

Throws:

Throwable

checkedGetProperty

public static Object checkedGetProperty(Object _receiver,
 boolean safe,
 boolean spread,
 Object _property)
                                 throws Throwable

Throws:

Throwable

checkedSetProperty

public static Object checkedSetProperty(Object _receiver,
 Object _property,
 boolean safe,
 boolean spread,
 int op,
 Object _value)
                                 throws Throwable

Throws:

Throwable

checkedGetAttribute

public static Object checkedGetAttribute(Object _receiver,
 boolean safe,
 boolean spread,
 Object _property)
                                  throws Throwable

Throws:

Throwable

checkedSetAttribute

public static Object checkedSetAttribute(Object _receiver,
 Object _property,
 boolean safe,
 boolean spread,
 int op,
 Object _value)
                                  throws Throwable

Intercepts the attribute assignment of the form "receiver.@property = value"

Parameters:

op - One of the assignment operators of Types

Throws:

Throwable

checkedGetArray

public static Object checkedGetArray(Object _receiver,
 Object _index)
                              throws Throwable

Throws:

Throwable

checkedSetArray

public static Object checkedSetArray(Object _receiver,
 Object _index,
 int op,
 Object _value)
                              throws Throwable

Intercepts the array assignment of the form "receiver[index] = value"

Parameters:

op - One of the assignment operators of Types

Throws:

Throwable

checkedPostfixArray

public static Object checkedPostfixArray(Object r,
 Object i,
 String op)
                                  throws Throwable

a[i]++ / a[i]--

Parameters:

op - "next" for ++, "previous" for --. These names are defined by Groovy.

Throws:

Throwable

checkedPrefixArray

public static Object checkedPrefixArray(Object r,
 Object i,
 String op)
                                 throws Throwable

++a[i] / --a[i]

Throws:

Throwable

checkedPostfixProperty

public static Object checkedPostfixProperty(Object receiver,
 Object property,
 boolean safe,
 boolean spread,
 String op)
                                     throws Throwable

a.x++ / a.x--

Throws:

Throwable

checkedPrefixProperty

public static Object checkedPrefixProperty(Object receiver,
 Object property,
 boolean safe,
 boolean spread,
 String op)
                                    throws Throwable

++a.x / --a.x

Throws:

Throwable

checkedBinaryOp

public static Object checkedBinaryOp(Object lhs,
 int op,
 Object rhs)
                              throws Throwable

Intercepts the binary expression of the form lhs op rhs like lhs+rhs, lhs>>rhs, etc. In Groovy, binary operators are method calls.

Parameters:

op - One of the binary operators of Types

Throws:

Throwable

See Also:

• BinaryExpressionHelper.evaluateBinaryExpressionWithAssignment(java.lang.String, org.codehaus.groovy.ast.expr.BinaryExpression)

checkedComparison

public static Object checkedComparison(Object lhs,
 int op,
 Object rhs)
                                throws Throwable

A compare method that invokes a.equals(b) or a.compareTo(b)==0

Throws:

Throwable

checkedCast

public static Object checkedCast(Class<?> clazz,
 Object exp,
 boolean ignoreAutoboxing,
 boolean coerce,
 boolean strict)
                          throws Throwable

Runs ScriptBytecodeAdapter.asType(java.lang.Object, java.lang.Class) but only after giving interceptors the chance to reject any possible interface methods as applied to the receiver. For example, might run receiver.method1(null, false) and receiver.method2(0, null) if methods with matching signatures were defined in the interfaces.

Throws:

Throwable

See Also:

• SandboxTransformer.mightBePositionalArgumentConstructor(org.codehaus.groovy.ast.expr.VariableExpression)

preCheckedCast

public static Checker.Thunk preCheckedCast(Class<?> clazz,
 Object exp,
 boolean ignoreAutoboxing,
 boolean coerce,
 boolean strict)
                                    throws Throwable

Throws:

Throwable