Package org.jenkinsci.plugins.scriptsecurity.sandbox.whitelists

Class EnumeratingWhitelist

java.lang.Object

org.jenkinsci.plugins.scriptsecurity.sandbox.Whitelist

org.jenkinsci.plugins.scriptsecurity.sandbox.whitelists.EnumeratingWhitelist

Direct Known Subclasses:

StaticWhitelist

public abstract class EnumeratingWhitelist
extends Whitelist

A whitelist based on listing signatures and searching them. Lists of signatures should not change from invocation to invocation.

If that's a need it is better to directly extend Whitelist and roll a custom implementation OR extend ProxyWhitelist and add some custom delegates.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EnumeratingWhitelist.FieldSignature
static class	EnumeratingWhitelist.MethodSignature
static final class	EnumeratingWhitelist.NewSignature
static class	EnumeratingWhitelist.Signature

Constructor Summary

Constructors

Constructor	Description
EnumeratingWhitelist()

Method Summary

Modifier and Type	Method	Description
protected abstract List<EnumeratingWhitelist.FieldSignature>	fieldSignatures()
static @NotNull String	getName(@NotNull Class<?> c)
static @NotNull String	getName(@Nullable Object o)
protected abstract List<EnumeratingWhitelist.MethodSignature>	methodSignatures()
protected abstract List<EnumeratingWhitelist.NewSignature>	newSignatures()
final boolean	permitsConstructor(Constructor<?> constructor, Object[] args)
final boolean	permitsFieldGet(Field field, Object receiver)
final boolean	permitsFieldSet(Field field, Object receiver, Object value)
final boolean	permitsMethod(Method method, Object receiver, Object[] args)	Checks whether a given virtual method may be invoked.
final boolean	permitsStaticFieldGet(Field field)
final boolean	permitsStaticFieldSet(Field field, Object value)
final boolean	permitsStaticMethod(Method method, Object[] args)
protected abstract List<EnumeratingWhitelist.FieldSignature>	staticFieldSignatures()
protected abstract List<EnumeratingWhitelist.MethodSignature>	staticMethodSignatures()

Methods inherited from class org.jenkinsci.plugins.scriptsecurity.sandbox.Whitelist

all

Methods inherited from class java.lang.Object

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

Constructor Details

EnumeratingWhitelist

public EnumeratingWhitelist()

Method Details

methodSignatures

protected abstract List<EnumeratingWhitelist.MethodSignature> methodSignatures()

newSignatures

protected abstract List<EnumeratingWhitelist.NewSignature> newSignatures()

staticMethodSignatures

protected abstract List<EnumeratingWhitelist.MethodSignature> staticMethodSignatures()

fieldSignatures

protected abstract List<EnumeratingWhitelist.FieldSignature> fieldSignatures()

staticFieldSignatures

protected abstract List<EnumeratingWhitelist.FieldSignature> staticFieldSignatures()

permitsMethod

public final boolean permitsMethod(Method method,
 Object receiver,
 Object[] args)

Description copied from class: Whitelist

Checks whether a given virtual method may be invoked.

Note that method should not be implementing or overriding a method in a supertype; in such a case the caller must pass that supertype method instead. In other words, call site selection is the responsibility of the caller (such as StandardGroovySandbox), not the whitelist.

Specified by:

permitsMethod in class Whitelist

Parameters:

method - a method defined in the JVM

receiver - this, the receiver of the method call

args - zero or more arguments

Returns:

true to allow the method to be called, false to reject it

permitsConstructor

public final boolean permitsConstructor(Constructor<?> constructor,
 Object[] args)

Specified by:

permitsConstructor in class Whitelist

permitsStaticMethod

public final boolean permitsStaticMethod(Method method,
 Object[] args)

Specified by:

permitsStaticMethod in class Whitelist

permitsFieldGet

public final boolean permitsFieldGet(Field field,
 Object receiver)

Specified by:

permitsFieldGet in class Whitelist

permitsFieldSet

public final boolean permitsFieldSet(Field field,
 Object receiver,
 Object value)

Specified by:

permitsFieldSet in class Whitelist

permitsStaticFieldGet

public final boolean permitsStaticFieldGet(Field field)

Specified by:

permitsStaticFieldGet in class Whitelist

permitsStaticFieldSet

public final boolean permitsStaticFieldSet(Field field,
 Object value)

Specified by:

permitsStaticFieldSet in class Whitelist

getName

@NotNull
public static @NotNull String getName(@NotNull
 @NotNull Class<?> c)

getName

@NotNull
public static @NotNull String getName(@Nullable
 @Nullable Object o)