CustomRestrictionPolicyContext (Denodo Virtual DataPort 6.0.16 API)

```
public interface CustomRestrictionPolicyContext
```
The CustomRestrictionPolicyContext interface provides access to information about the running query and the corresponding custom policy. The following information is available:
- Running query
- Fields of the view or stored procedure involved in the query
- User who executes the query and his roles
- Database where the query is executed
- User or role who is assigned the custom policy to
- View or stored procedure which is assigned the custom policy to
- Platform properties in the context of the query
- User-defined variables in the context of the query
The CustomRestrictionPolicyContext interface also provides a JMX connection to query VDP Server MBeans and logging capabilities.

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`CustomRestrictionPolicyContext.CredentialsType` Type of the credential which is assigned the custom policy to
`static class`	`CustomRestrictionPolicyContext.ElementType` Type of the element which is assigned the custom policy to
`static class`	`CustomRestrictionPolicyContext.LogLevel` Severity level of the registered events in the log

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CACHE_INVALIDATE_PROPERTY` Platform property which indicates whether the cache is invalidated.
`static String`	`CACHE_PRELOAD_PROPERTY` Platform property which indicates whether the results of this query is used to populate the cache of the executing view.
`static String`	`DELEGATE_UNNAMED_VIEWS_PROPERTY` Platform property which indicates whether unnamed views should be delegated.
`static String`	`I18N_PROPERTY` Platform property which defines the internationalization configuration that will be used for the results of the query.
`static String`	`MEMORY_LIMIT_PROPERTY` Platform property which defines a limit on the memory usage of the query in megabytes.
`static String`	`QUERY_LIMIT_PROPERTY` Platform property which defines a limit on the number of rows obtained from the result set.
`static String`	`QUERY_TIMEOUT_PROPERTY` Platform property which defines the maximum time (in milliseconds) the client is prepared to wait for the statement to complete.
`static String`	`SWAP_PROPERTY` Platform property which indicates whether swapping is enabled for the query.
`static String`	`SWAP_SIZE_PROPERTY` Platform property which defines the maximum size (in megabytes) an intermediate result obtained by running this query can reach without swapping to disk.
`static String`	`USER_NAME_PROPERTY` Platform property which indicates the user name used to query the view instead of the one you have used to connect to the VDP Server.

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`getCurrentDatabaseName()` Returns the name of the database where the query is executed
`String`	`getCurrentUserName()` Returns the name of the user who executes the query
`Set<String>`	`getCurrentUserRoles()` Returns the names of all the roles assigned to the user who executes the query.
`String`	`getElementName()` Returns the name of the element which is assigned the custom policy to
`CustomRestrictionPolicyContext.ElementType`	`getElementType()` Returns the type of the element which is assigned the custom policy to
`Set<String>`	`getFieldsInQuery()` Returns the set of fields in the view or stored procedure involved in the query.
`JmxConnection`	`getJmxConnection()` Returns a JMX connection to query VDP Server MBeans
`String`	`getPolicyCredentialsName()` Returns the name of the credential which is assigned the custom policy to
`CustomRestrictionPolicyContext.CredentialsType`	`getPolicyCredentialsType()` Returns the type of the credential which is assigned the custom policy to
`String`	`getProperty(String name)` Returns a textual representation of the value of a platform property present in the context of the query.
`String`	`getQuery()` Returns the running query
`String`	`getVariable(String name)` Returns a textual representation of the value of a user-defined variable that is present in the context of the query.
`boolean`	`isIncompatibleWithQuery(String condition)` Checks if the given condition is incompatible with the condition specified on a query over the view affected by this policy
`void`	`log(CustomRestrictionPolicyContext.LogLevel level, String logMessage)` Registers an event in the log of the VDP Server with the specified level.
`void`	`setProperty(String name, String value)` Sets the value of a platform property that is used in the context of the query.
`void`	`setVariable(String name, String value)` Sets the value of a user-defined variable in the context of the query.

- Field Detail
  - CACHE_INVALIDATE_PROPERTY
```
static final String CACHE_INVALIDATE_PROPERTY
```
    Platform property which indicates whether the cache is invalidated. This property can take the following values: true, false.
    
    See Also:
    Constant Field Values
  - CACHE_PRELOAD_PROPERTY
```
static final String CACHE_PRELOAD_PROPERTY
```
    Platform property which indicates whether the results of this query is used to populate the cache of the executing view. This property can take the following values: true, false.
    
    See Also:
    Constant Field Values
  - DELEGATE_UNNAMED_VIEWS_PROPERTY
```
static final String DELEGATE_UNNAMED_VIEWS_PROPERTY
```
    Platform property which indicates whether unnamed views should be delegated. By default, unnamed views are delegated if possible unless they have a subview with cache enabled. This property can take the following values: yes, no.
    
    See Also:
    Constant Field Values
  - I18N_PROPERTY
```
static final String I18N_PROPERTY
```
    Platform property which defines the internationalization configuration that will be used for the results of the query. This property takes the name of a valid internationalization configuration as a value (e.g. es_euro ).
    
    See Also:
    Constant Field Values
  - QUERY_LIMIT_PROPERTY
```
static final String QUERY_LIMIT_PROPERTY
```
    Platform property which defines a limit on the number of rows obtained from the result set. This property takes a positive integer as a value.
    
    See Also:
    Constant Field Values
  - QUERY_TIMEOUT_PROPERTY
```
static final String QUERY_TIMEOUT_PROPERTY
```
    Platform property which defines the maximum time (in milliseconds) the client is prepared to wait for the statement to complete. This property takes a positive long integer as a value.
    
    See Also:
    Constant Field Values
  - SWAP_PROPERTY
```
static final String SWAP_PROPERTY
```
    Platform property which indicates whether swapping is enabled for the query. This property can take the following values: on, off.
    
    See Also:
    Constant Field Values
  - SWAP_SIZE_PROPERTY
```
static final String SWAP_SIZE_PROPERTY
```
    Platform property which defines the maximum size (in megabytes) an intermediate result obtained by running this query can reach without swapping to disk. This property takes a positive integer as a value.
    
    See Also:
    Constant Field Values
  - USER_NAME_PROPERTY
```
static final String USER_NAME_PROPERTY
```
    Platform property which indicates the user name used to query the view instead of the one you have used to connect to the VDP Server. This property is only taken into account when the data source has been created with the clause WITH PASS-THROUGH SESSION CREDENTIALS. This property takes a valid user name for the data source as a value.
    
    See Also:
    Constant Field Values
  - MEMORY_LIMIT_PROPERTY
```
static final String MEMORY_LIMIT_PROPERTY
```
    Platform property which defines a limit on the memory usage of the query in megabytes. This property takes a positive integer as a value or zero to set no limit.
    
    See Also:
    Constant Field Values
- Method Detail
  - getCurrentUserName
```
String getCurrentUserName()
```
    Returns the name of the user who executes the query
    
    Returns:
    the name of the user who executes the query
  - getCurrentUserRoles
```
Set<String> getCurrentUserRoles()
```
    Returns the names of all the roles assigned to the user who executes the query. The roles assigned to the roles directly assigned to the user are also included.
    
    Returns:
    the names of all the roles assigned to the user who executes the query
  - getCurrentDatabaseName
```
String getCurrentDatabaseName()
```
    Returns the name of the database where the query is executed
    
    Returns:
    the name of the database where the query is executed
  - getPolicyCredentialsName
```
String getPolicyCredentialsName()
```
    Returns the name of the credential which is assigned the custom policy to
    
    Returns:
    the name of the credential which is assigned the custom policy to
  - getPolicyCredentialsType
```
CustomRestrictionPolicyContext.CredentialsType getPolicyCredentialsType()
```
    Returns the type of the credential which is assigned the custom policy to
    
    Returns:
    the type of the credential which is assigned the custom policy to
  - getElementName
```
String getElementName()
```
    Returns the name of the element which is assigned the custom policy to
    
    Returns:
    the name of the element which is assigned the custom policy to
  - getElementType
```
CustomRestrictionPolicyContext.ElementType getElementType()
```
    Returns the type of the element which is assigned the custom policy to
    
    Returns:
    the type of the element which is assigned the custom policy to
  - getQuery
```
String getQuery()
```
    Returns the running query
    
    Returns:
    the running query
  - getFieldsInQuery
```
Set<String> getFieldsInQuery()
```
    Returns the set of fields in the view or stored procedure involved in the query.
    
    Returns:
    the set of fields in the view or stored procedure involved in the query.
  - getJmxConnection
```
JmxConnection getJmxConnection()
```
    Returns a JMX connection to query VDP Server MBeans
    
    Returns:
    a JMX connection to query VDP Server MBeans
  - getProperty
```
String getProperty(String name)
```
    Returns a textual representation of the value of a platform property present in the context of the query.
    Parameters:
    name - the name of the platform property. The following properties are supported:
    
    CACHE_INVALIDATE_PROPERTY
    
    CACHE_PRELOAD_PROPERTY
    
    DELEGATE_UNNAMED_VIEWS_PROPERTY
    
    I18N_PROPERTY
    
    QUERY_LIMIT_PROPERTY
    
    QUERY_TIMEOUT_PROPERTY
    
    SWAP_PROPERTY
    
    SWAP_SIZE_PROPERTY
    
    USER_NAME_PROPERTY
    Returns:
    a textual representation of the value of a platform property present in the context of the query or null if the property is not present
    
    Throws:
    
    IllegalArgumentException - if name is not a supported property name
  - setProperty
```
void setProperty(String name,
               String value)
```
    Sets the value of a platform property that is used in the context of the query.
    Parameters:
    name - the name of the platform property. The following properties are supported:
    
    CACHE_INVALIDATE_PROPERTY
    
    CACHE_PRELOAD_PROPERTY
    
    DELEGATE_UNNAMED_VIEWS_PROPERTY
    
    I18N_PROPERTY
    
    QUERY_LIMIT_PROPERTY
    
    QUERY_TIMEOUT_PROPERTY
    
    SWAP_PROPERTY
    
    SWAP_SIZE_PROPERTY
    
    USER_NAME_PROPERTY
    value - a textual representation of the value of the platform property
    
    Throws:
    
    IllegalArgumentException - if name is not a supported property name
    
    IllegalArgumentException - if value is not a valid value for the property
  - getVariable
```
String getVariable(String name)
```
    Returns a textual representation of the value of a user-defined variable that is present in the context of the query.
    
    Parameters:
    name - the name of the user-defined variable.
    
    Returns:
    a textual representation of the value of a user-defined variable in the context of the query or null if the variable is not present
  - setVariable
```
void setVariable(String name,
               String value)
```
    Sets the value of a user-defined variable in the context of the query.
    
    Parameters:
    name - the name of the user-defined variable
    value - a textual representation of the value of the user-defined variable
  - isIncompatibleWithQuery
```
boolean isIncompatibleWithQuery(String condition)
                                throws ConditionEvaluationException
```
    Checks if the given condition is incompatible with the condition specified on a query over the view affected by this policy
    
    Parameters:
    condition - condition to check
    
    Returns:
    true if the given condition is incompatible with the condition specified on a query over the view affected by this policy
    false otherwise
    
    Throws:
    
    Exception
    
    ConditionEvaluationException
  - log
```
void log(CustomRestrictionPolicyContext.LogLevel level,
       String logMessage)
```
    Registers an event in the log of the VDP Server with the specified level.
    
    Parameters:
    level - the severity level of the event
    logMessage - the message to be logged

Interface CustomRestrictionPolicyContext

Nested Class Summary

Field Summary

Method Summary

Field Detail

CACHE_INVALIDATE_PROPERTY

CACHE_PRELOAD_PROPERTY

DELEGATE_UNNAMED_VIEWS_PROPERTY

I18N_PROPERTY

QUERY_LIMIT_PROPERTY

QUERY_TIMEOUT_PROPERTY

SWAP_PROPERTY

SWAP_SIZE_PROPERTY

USER_NAME_PROPERTY

MEMORY_LIMIT_PROPERTY

Method Detail

getCurrentUserName

getCurrentUserRoles

getCurrentDatabaseName

getPolicyCredentialsName

getPolicyCredentialsType

getElementName

getElementType

getQuery

getFieldsInQuery

getJmxConnection

getProperty

setProperty

getVariable

setVariable

isIncompatibleWithQuery

log