com.github.jlangch.venice.javainterop

Interface IInterceptor

All Known Implementing Classes:

AcceptAllInterceptor, Interceptor, RejectAllInterceptor, SandboxInterceptor, SandboxRecorder, ValueFilterInterceptor

public interface IInterceptor

Defines a Venice interceptor

Method Summary

Modifier and Type	Method and Description
java.lang.Integer	getMaxExecutionTimeSeconds()
java.lang.Integer	getMaxFutureThreadPoolSize()
java.lang.Object	onGetBeanProperty(IInvoker invoker, java.lang.Object receiver, java.lang.String property) Gets a Java Bean property
java.lang.Object	onGetInstanceField(IInvoker invoker, java.lang.Object receiver, java.lang.String fieldName) Get an instance field's value
java.lang.Object	onGetStaticField(IInvoker invoker, java.lang.Class<?> receiver, java.lang.String fieldName) Get a static field's value
java.lang.Object	onInvokeConstructor(IInvoker invoker, java.lang.Class<?> receiver, java.lang.Object... args) Invokes a constructor
java.lang.Object	onInvokeInstanceMethod(IInvoker invoker, java.lang.Object receiver, java.lang.String method, java.lang.Object... args) Invokes an instance method
java.lang.Object	onInvokeStaticMethod(IInvoker invoker, java.lang.Class<?> receiver, java.lang.String method, java.lang.Object... args) Invokes a static method
byte[]	onLoadClassPathResource(java.lang.String resourceName) Loads a classpath resource
java.lang.String	onReadSystemEnv(java.lang.String name) Reads a Java environment variable
java.lang.String	onReadSystemProperty(java.lang.String propertyName) Reads a Java system property
void	onSetBeanProperty(IInvoker invoker, java.lang.Object receiver, java.lang.String property, java.lang.Object value) Sets a Java Bean property
void	validateLoadModule(java.lang.String moduleName) Validates the load of a module
void	validateVeniceFunction(java.lang.String funcName) Validates the invocation of a Venice function.

Method Detail

onInvokeInstanceMethod

java.lang.Object onInvokeInstanceMethod(IInvoker invoker,
                                        java.lang.Object receiver,
                                        java.lang.String method,
                                        java.lang.Object... args)
                                 throws java.lang.SecurityException

Invokes an instance method

Parameters:

invoker - the invoker

receiver - an object

method - a method

args - a list of arguments

Returns:

the return value

Throws:

java.lang.SecurityException - if the instance method is not whitelisted

onInvokeStaticMethod

java.lang.Object onInvokeStaticMethod(IInvoker invoker,
                                      java.lang.Class<?> receiver,
                                      java.lang.String method,
                                      java.lang.Object... args)
                               throws java.lang.SecurityException

Invokes a static method

Parameters:

invoker - the invoker

receiver - a class

method - a method

args - a list of arguments

Returns:

the return value

Throws:

java.lang.SecurityException - if the static method is not whitelisted

onInvokeConstructor

java.lang.Object onInvokeConstructor(IInvoker invoker,
                                     java.lang.Class<?> receiver,
                                     java.lang.Object... args)
                              throws java.lang.SecurityException

Invokes a constructor

Parameters:

invoker - the invoker

receiver - a class

args - a list of arguments

Returns:

the create object

Throws:

java.lang.SecurityException - if the constructor is not whitelisted

onGetBeanProperty

java.lang.Object onGetBeanProperty(IInvoker invoker,
                                   java.lang.Object receiver,
                                   java.lang.String property)
                            throws java.lang.SecurityException

Gets a Java Bean property

Parameters:

invoker - the invoker

receiver - an object

property - a property name

Returns:

the property's value

Throws:

java.lang.SecurityException - if the bean property (instance method) is not whitelisted

onSetBeanProperty

void onSetBeanProperty(IInvoker invoker,
                       java.lang.Object receiver,
                       java.lang.String property,
                       java.lang.Object value)
                throws java.lang.SecurityException

Sets a Java Bean property

Parameters:

invoker - the invoker

receiver - an object

property - a property name

value - a property value

Throws:

java.lang.SecurityException - if the bean property (instance method) is not whitelisted

onGetStaticField

java.lang.Object onGetStaticField(IInvoker invoker,
                                  java.lang.Class<?> receiver,
                                  java.lang.String fieldName)
                           throws java.lang.SecurityException

Get a static field's value

Parameters:

invoker - the invoker

receiver - a class

fieldName - a field name

Returns:

the field's value

Throws:

java.lang.SecurityException - if the static field is not whitelisted

onGetInstanceField

java.lang.Object onGetInstanceField(IInvoker invoker,
                                    java.lang.Object receiver,
                                    java.lang.String fieldName)
                             throws java.lang.SecurityException

Get an instance field's value

Parameters:

invoker - the invoker

receiver - an object

fieldName - a field name

Returns:

the field's value

Throws:

java.lang.SecurityException - if the instance field is not whitelisted

onLoadClassPathResource

byte[] onLoadClassPathResource(java.lang.String resourceName)
                        throws java.lang.SecurityException

Loads a classpath resource

Parameters:

resourceName - a resource name (e.g.: /foo/org/image.png)

Returns:

the resource data

Throws:

java.lang.SecurityException - if the classpath resource is not whitelisted

onReadSystemProperty

java.lang.String onReadSystemProperty(java.lang.String propertyName)
                               throws java.lang.SecurityException

Reads a Java system property

Parameters:

propertyName - a property name (e.g: user.home)

Returns:

the property's value

Throws:

java.lang.SecurityException - if the property is not whitelisted

onReadSystemEnv

java.lang.String onReadSystemEnv(java.lang.String name)
                          throws java.lang.SecurityException

Reads a Java environment variable

Parameters:

name - a variable name (e.g: USER)

Returns:

the variable value

Throws:

java.lang.SecurityException - if the variable is not whitelisted

validateLoadModule

void validateLoadModule(java.lang.String moduleName)
                 throws java.lang.SecurityException

Validates the load of a module

Parameters:

moduleName - the module name

Throws:

java.lang.SecurityException - if the module is blacklisted

validateVeniceFunction

void validateVeniceFunction(java.lang.String funcName)
                     throws java.lang.SecurityException

Validates the invocation of a Venice function.

Parameters:

funcName - A venice function name

Throws:

java.lang.SecurityException - if the function is blacklisted and not allowed to be invoked.

getMaxExecutionTimeSeconds

java.lang.Integer getMaxExecutionTimeSeconds()

Returns:

the max execution time in seconds a Venice script under this Sandbox is allowed to run.

getMaxFutureThreadPoolSize

java.lang.Integer getMaxFutureThreadPoolSize()

Returns:

the max future thread pool size a Venice script under this Sandbox is allowed to use.