com.github.jlangch.venice.javainterop

Class Interceptor

java.lang.Object

com.github.jlangch.venice.javainterop.Interceptor

All Implemented Interfaces:

IInterceptor

Direct Known Subclasses:

AcceptAllInterceptor, RejectAllInterceptor, SandboxRecorder, ValueFilterInterceptor

public abstract class Interceptor
extends java.lang.Object
implements IInterceptor

Constructor Summary

Constructors

Constructor and Description
Interceptor()

Method Summary

Modifier and Type	Method and Description
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	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	validateBlackListedVeniceFunction(java.lang.String funcName) Validates the invocation of a Venice function with args.

Methods inherited from class java.lang.Object

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

Constructor Detail

Interceptor

public Interceptor()

Method Detail

onInvokeInstanceMethod

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

Description copied from interface: IInterceptor

Invokes an instance method

Specified by:

onInvokeInstanceMethod in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Invokes a static method

Specified by:

onInvokeStaticMethod in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Invokes a constructor

Specified by:

onInvokeConstructor in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Gets a Java Bean property

Specified by:

onGetBeanProperty in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Sets a Java Bean property

Specified by:

onSetBeanProperty in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Get a static field's value

Specified by:

onGetStaticField in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Get an instance field's value

Specified by:

onGetInstanceField in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Loads a classpath resource

Specified by:

onLoadClassPathResource in interface IInterceptor

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

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

Description copied from interface: IInterceptor

Reads a Java system property

Specified by:

onReadSystemProperty in interface IInterceptor

Parameters:

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

Returns:

the property's value

Throws:

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

validateBlackListedVeniceFunction

public void validateBlackListedVeniceFunction(java.lang.String funcName)
                                       throws java.lang.SecurityException

Description copied from interface: IInterceptor

Validates the invocation of a Venice function with args.

Specified by:

validateBlackListedVeniceFunction in interface IInterceptor

Parameters:

funcName - A venice function name

Throws:

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