SandboxRules (venice 0.9.12 API)

java.lang.Object
- com.github.jlangch.venice.javainterop.SandboxRules

```
public class SandboxRules
extends java.lang.Object
```
Defines the Venice's sandbox rules.
The sandbox keeps whitelist rules for the Java Interop and blacklist rules for the Venice functions.

Field Summary

Fields
Modifier and Type Field and Description

static java.util.Set<java.lang.String> DEFAULT_SYSTEM_PROPERTIES

Fields
Modifier and Type	Field and Description
`static java.util.Set<java.lang.String>`	`DEFAULT_SYSTEM_PROPERTIES`

Constructor Summary

Constructors
Constructor and Description

SandboxRules()

Constructors
Constructor and Description
`SandboxRules()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`SandboxRules`	`allowAccessToAllSystemProperties()` Allow access to all Java system properties
`SandboxRules`	`allowAccessToStandardSystemProperties()` Allow access to all standard Java system properties
`static java.util.List<java.lang.String>`	`getDefaultRules()` Returns the default rules used for Venice sandboxes.
`java.util.Set<java.lang.String>`	`getRules()`
`SandboxRules`	`merge(SandboxRules other)` Merges this `SandboxRules` with the passed other `SandboxRules`
`static SandboxRules`	`noDefaults()` Creates new SandboxRules starting without any defaults.
`SandboxRules`	`rejectAllVeniceIoFunctions()` Reject access to all Venice I/O related functions
`java.lang.String`	`toString()`
`SandboxRules`	`withBlacklistedVeniceFn(java.util.Collection<java.lang.String> rules)` Add blacklisted Venice IO function rules to the sandbox.
`SandboxRules`	`withBlacklistedVeniceFn(java.lang.String... rules)` Add blacklisted Venice IO function rules to the sandbox.
`SandboxRules`	`withClasses(java.lang.Class<?>... classes)` Add a rule for classes to the sandbox, whitelisting the class and all its methods and fields
`SandboxRules`	`withClasses(java.util.Collection<java.lang.Class<?>> classes)` Add a rule for classes to the sandbox, whitelisting the class and all its methods and fields
`SandboxRules`	`withClasses(java.util.List<java.lang.String> rules)` Add whitelisted class rules to the sandbox.
`SandboxRules`	`withClasses(java.lang.String... rules)` Add whitelisted class rules to the sandbox.
`SandboxRules`	`withClasspathResources(java.util.Collection<java.lang.String> rules)` Add whitelisted classpath resource rules to the sandbox.
`SandboxRules`	`withClasspathResources(java.lang.String... rules)` Add whitelisted classpath resource rules to the sandbox.
`SandboxRules`	`withDefaultClasses()`
`SandboxRules`	`withSystemProperties(java.util.Collection<java.lang.String> rules)` Add whitelisted system property rules to the sandbox.
`SandboxRules`	`withSystemProperties(java.lang.String... rules)` Add whitelisted system property rules to the sandbox.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - DEFAULT_SYSTEM_PROPERTIES
```
public static final java.util.Set<java.lang.String> DEFAULT_SYSTEM_PROPERTIES
```
- Constructor Detail
  - SandboxRules
```
public SandboxRules()
```
- Method Detail
  - noDefaults
```
public static SandboxRules noDefaults()
```
    Creates new SandboxRules starting without any defaults.
    
    Returns:
    
    SandboxRules
  - withClasses
```
public SandboxRules withClasses(java.lang.String... rules)
```
    Add whitelisted class rules to the sandbox.
    Java whitelist rules for class/instance accessor follow the schema: '{package}.{className}:{methodName | fieldName}'. The asterix may be used as a wildcard
    E.g:
    - java.lang.Boolean (allow calling Java methods with arguments or return values of type Boolean)
    - java.lang.* (allow calling Java methods with arguments or return values of any type in the package 'java.lang')
    - java.lang.Long:new (allow calling Long constructor)
    - java.lang.Math:abs (allow calling Math::abs method)
    - java.lang.Math:* (allow calling all Math constructors/methods/fields)
    - java.lang.*:* (allow calling all constructors/methods/fields for classes in the package 'java.lang')
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withClasses
```
public SandboxRules withClasses(java.util.List<java.lang.String> rules)
```
    Add whitelisted class rules to the sandbox.
    Java whitelist rules for class/instance accessor follow the schema: '{package}.{className}:{methodName | fieldName}'. The asterix may be used as a wildcard
    E.g:
    - java.lang.Boolean (allow calling Java methods with arguments or return values of type Boolean)
    - java.lang.* (allow calling Java methods with arguments or return values of any type in the package 'java.lang')
    - java.lang.Long:new (allow calling Long constructor)
    - java.lang.Math:abs (allow calling Math::abs method)
    - java.lang.Math:* (allow calling all Math constructors/methods/fields)
    - java.lang.*:* (allow calling all constructors/methods/fields for classes in the package 'java.lang')
    - ava.awt.**:* (allow calling all constructors/methods/fields for classes in the package 'java.awt' and all its subpackages)
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withClasses
```
public SandboxRules withClasses(java.lang.Class<?>... classes)
```
    Add a rule for classes to the sandbox, whitelisting the class and all its methods and fields
    Adds a class rule "x.y.classname:*" for each class
    
    Parameters:
    
    classes - classes
    
    Returns:
    
    this SandboxRules
  - withClasses
```
public SandboxRules withClasses(java.util.Collection<java.lang.Class<?>> classes)
```
    Add a rule for classes to the sandbox, whitelisting the class and all its methods and fields
    Adds a class rule "x.y.classname:*" for each class
    
    Parameters:
    
    classes - classes
    
    Returns:
    
    this SandboxRules
  - withDefaultClasses
```
public SandboxRules withDefaultClasses()
```
  - withClasspathResources
```
public SandboxRules withClasspathResources(java.lang.String... rules)
```
    Add whitelisted classpath resource rules to the sandbox. E.g:
    - /foo/org/image.png
    - /foo/org/*.png
    - /foo/org/*.jpg
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withClasspathResources
```
public SandboxRules withClasspathResources(java.util.Collection<java.lang.String> rules)
```
    Add whitelisted classpath resource rules to the sandbox. E.g:
    - /foo/org/image.png
    - /foo/org/*.png
    - /foo/org/*.jpg
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withSystemProperties
```
public SandboxRules withSystemProperties(java.lang.String... rules)
```
    Add whitelisted system property rules to the sandbox.
    E.g: white listing Java system properties
    - file.separator
    - java.home
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withSystemProperties
```
public SandboxRules withSystemProperties(java.util.Collection<java.lang.String> rules)
```
    Add whitelisted system property rules to the sandbox.
    E.g: white listing Java system properties
    - file.separator
    - java.home
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withBlacklistedVeniceFn
```
public SandboxRules withBlacklistedVeniceFn(java.lang.String... rules)
```
    Add blacklisted Venice IO function rules to the sandbox.
    E.g:
    - io/slurp (reject calls to 'io/slurp')
    - *io* (reject all Venice I/O calls like 'io/slurp', 'create-file', ...)
    - . (reject java interop completely)
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - withBlacklistedVeniceFn
```
public SandboxRules withBlacklistedVeniceFn(java.util.Collection<java.lang.String> rules)
```
    Add blacklisted Venice IO function rules to the sandbox.
    E.g:
    - io/slurp (reject calls to 'io/slurp')
    - *io* (reject all Venice I/O calls like 'io/slurp', 'create-file', ...)
    - . (reject java interop completely)
    Parameters:
    
    rules - rules
    
    Returns:
    
    this SandboxRules
  - rejectAllVeniceIoFunctions
```
public SandboxRules rejectAllVeniceIoFunctions()
```
    Reject access to all Venice I/O related functions
    
    Returns:
    
    this SandboxRules
  - allowAccessToStandardSystemProperties
```
public SandboxRules allowAccessToStandardSystemProperties()
```
    Allow access to all standard Java system properties
    Standard system properties:
    - file.separator
    - java.home
    - java.vendor
    - java.vendor.url
    - java.version
    - line.separator
    - os.arch
    - os.name
    - os.version
    - path.separator
    - user.dir
    - user.home
    - user.name
    Returns:
    
    this SandboxRules
  - allowAccessToAllSystemProperties
```
public SandboxRules allowAccessToAllSystemProperties()
```
    Allow access to all Java system properties
    
    Returns:
    
    this SandboxRules
  - merge
```
public SandboxRules merge(SandboxRules other)
```
    Merges this SandboxRules with the passed other SandboxRules
    
    Parameters:
    
    other - the other SandboxRules to merge with
    
    Returns:
    
    the new merged SandboxRules
  - getRules
```
public java.util.Set<java.lang.String> getRules()
```
    Returns:
    
    the rules of this SandboxRules
  - getDefaultRules
```
public static java.util.List<java.lang.String> getDefaultRules()
```
    Returns the default rules used for Venice sandboxes.
    Note: The default rules can be omitted by calling
```
    SandboxRules
        .noDefaults()
        .withClasses(
            "java.lang.Math",
            "java.math.BigDecimal");
 
```
    Returns:
    
    the default rules used for the Sandbox
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class SandboxRules

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_SYSTEM_PROPERTIES

Constructor Detail

SandboxRules

Method Detail

noDefaults

withClasses

withClasses

withClasses

withClasses

withDefaultClasses

withClasspathResources

withClasspathResources

withSystemProperties

withSystemProperties

withBlacklistedVeniceFn

withBlacklistedVeniceFn

rejectAllVeniceIoFunctions

allowAccessToStandardSystemProperties

allowAccessToAllSystemProperties

merge

getRules

getDefaultRules

toString