PersistentAspect ( @enterprise 10.0 API)

java.lang.Object
- java.lang.Enum<PersistentAspect>
- - com.groiss.store.PersistentAspect

All Implemented Interfaces:

Serializable, Comparable<PersistentAspect>
```
public enum PersistentAspect
extends Enum<PersistentAspect>
```
Allows to change certain aspects of the behavior of the Store and OrgData operations on Persistent objects.
Can be set on a thread/transaction level or on individual object level.
Deviations from standard behavior are reset at the end of the transaction.

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ALL_PERMISSIONS` Automatically grant all permissions on all objects.
`NO_CHANGE_SYSTEMFIELDS` Don't change standard fields (createdBy, changedBy, createdAt, changedAt) when a DMSObject is inserted or updated.
`NO_DEFERREDCHECK` Avoid checking of deferred updates during update and delete.
`NO_LOG` Avoid writing of Log Information insert and update and delete via OrgData.
`NO_OBJECTEXTENSIONCLEANUP` Avoid deleting of attached object extensions when their referencing persistent is deleted.
`NO_OPTLOCKING` Avoid checking of transaction id in update.
`NO_PERMISSIONCHECK` Avoid checking of permissions during insert, update and delete via OrgData.
`NO_VALIDATION` Avoid checking of validation constraints during insert and update.

Field Summary

Fields
Modifier and Type Field and Description

static org.slf4j.Logger logger

Fields
Modifier and Type	Field and Description
`static org.slf4j.Logger`	`logger`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static AutoCloseablePersistentAspect`	`add(PersistentAspect... aspects)` Add the PersistentAspects at thread level.
`static AutoCloseablePersistentAspect`	`add(Persistent p, PersistentAspect... aspects)` Add the PersistentAspects for an object.
`static void`	`clear()` Clears all PersistentAspects.
`static void`	`clear(Persistent p)` Clears all PersistentAspects of an object.
`static EnumSet<PersistentAspect>`	`get()` Get the set of currently set PersistentAspects at the thread level.
`static EnumSet<PersistentAspect>`	`get(Persistent p)` Get the set of currently set PersistentAspects for an object.
`static EnumSet<PersistentAspect>`	`getForObject(Persistent p)` Get the set of currently set PersistentAspects for an object.
`static boolean`	`isSet(PersistentAspect aspect)` Checks if a PersistentAspect is active at the thread level.
`static boolean`	`isSet(Persistent p, PersistentAspect aspect)` Checks if a PersistentAspect is active for an object.
`static boolean`	`isSetForObject(Persistent p, PersistentAspect aspect)` Checks if a PersistentAspect is active for an object.
`static AutoCloseablePersistentAspect`	`remove(PersistentAspect... aspects)` Remove the PersistentAspects at thread level.
`static AutoCloseablePersistentAspect`	`remove(Persistent p, PersistentAspect... aspects)` Remove the PersistentAspects from an object.
`static void`	`set(EnumSet<PersistentAspect> aspects)` Set the PersistentAspects at the thread level.
`static void`	`set(Persistent p, EnumSet<PersistentAspect> aspects)` Set the PersistentAspects for an object.
`static PersistentAspect`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static PersistentAspect[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - NO_OPTLOCKING
```
public static final PersistentAspect NO_OPTLOCKING
```
    Avoid checking of transaction id in update. Via Store for OptimisticLocking.
    In former times used on Thread Level;
    - on: ThreadContext.setAttribute(StoreEJB.IGNORE_TRANSACTION_ID,true);
    - off: ThreadContext.removeAttribute(StoreEJB.IGNORE_TRANSACTION_ID);
  - NO_DEFERREDCHECK
```
public static final PersistentAspect NO_DEFERREDCHECK
```
    Avoid checking of deferred updates during update and delete. Done via Store for HasDeferredChange.
    In former times used on Thread Level:
    - on: ThreadContext.setAttribute(LoggedObject.NO_CHECK_DEFERRED, Boolean.TRUE);
    - off: ThreadContext.removeAttribute(LoggedObject.NO_CHECK_DEFERRED);
  - NO_VALIDATION
```
public static final PersistentAspect NO_VALIDATION
```
    Avoid checking of validation constraints during insert and update. PersistentObject.beforeInsert and beforeUpdate methods check this to avoid calling of PersistentObject.isValid(). Other Persistent classes (which do not extend PersistentObject) have to implement a corresponding behavior themselves.
    In former times used on Thread Level:
    - on: ThreadContext.setAttribute(SQLObject.DO_BLIND, Boolean.TRUE);
    - off: ThreadContext.removeAttribute(SQLObject.DO_BLIND);
  - NO_PERMISSIONCHECK
```
public static final PersistentAspect NO_PERMISSIONCHECK
```
    Avoid checking of permissions during insert, update and delete via OrgData. OrgData.insert/update/delete methods check this to avoid calling of OrgData.mayXXX(). Contrast with ALL_PERMISSIONS.
    In former times used on object level:
    - LoggedObject.insert/update/deleteNocheck(p);
  - NO_LOG
```
public static final PersistentAspect NO_LOG
```
    Avoid writing of Log Information insert and update and delete via OrgData. OrgData.insert/update/delete methods check this to avoid calling of OrgData.makeLog()
    In former times used on object level:
    - LoggedObject.insert/update/deleteNocheck(p);
  - NO_OBJECTEXTENSIONCLEANUP
```
public static final PersistentAspect NO_OBJECTEXTENSIONCLEANUP
```
    Avoid deleting of attached object extensions when their referencing persistent is deleted.
  - ALL_PERMISSIONS
```
public static final PersistentAspect ALL_PERMISSIONS
```
    Automatically grant all permissions on all objects. Be sure to use this feature responsibly and as sparingly as possible. Contrast with NO_PERMISSIONCHECK.
    Is honored solely at thread level. Setting this on individual objects has no effect whatsoever.
  - NO_CHANGE_SYSTEMFIELDS
```
public static final PersistentAspect NO_CHANGE_SYSTEMFIELDS
```
    Don't change standard fields (createdBy, changedBy, createdAt, changedAt) when a DMSObject is inserted or updated.
    In former times used on object level:
    - com.dec.avw.core.Form.disableAutoUpdate() to set and
    - com.dec.avw.core.Form.enableAutoUpdate() to remove the aspect
- Field Detail
  - logger
```
public static final org.slf4j.Logger logger
```
- Method Detail
  - values
```
public static PersistentAspect[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (PersistentAspect c : PersistentAspect.values())
    System.out.println(c);
```
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static PersistentAspect valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - get
```
public static EnumSet<PersistentAspect> get()
```
    Get the set of currently set PersistentAspects at the thread level.
    
    Returns:
    
    an EnumSet of currently active PersistentAspects
  - set
```
public static void set(EnumSet<PersistentAspect> aspects)
```
    Set the PersistentAspects at the thread level. Currently set object aspect are NOT changed.
    
    Parameters:
    
    aspects - the EnumSet of PersistentAspects to activate
  - isSet
```
public static boolean isSet(PersistentAspect aspect)
```
    Checks if a PersistentAspect is active at the thread level.
    
    Parameters:
    
    aspect - the PersistentAspect to check
    
    Returns:
    
    true, if the PersistentAspect is set
  - add
```
public static AutoCloseablePersistentAspect add(PersistentAspect... aspects)
```
    Add the PersistentAspects at thread level. Currently set object aspect are NOT changed.
    
    Parameters:
    
    aspects - the PersistentAspects to add
    
    Returns:
    
    an AutoCloseablePersistentAspect to use in a try(with resource) block
  - remove
```
public static AutoCloseablePersistentAspect remove(PersistentAspect... aspects)
```
    Remove the PersistentAspects at thread level. Currently set object aspect are NOT changed.
    
    Parameters:
    
    aspects - the PersistentAspects to remove
    
    Returns:
    
    an AutoCloseablePersistentAspect to use in a try(with resource) block
  - clear
```
public static void clear()
```
    Clears all PersistentAspects. Automatically called at end of transaction.
  - get
```
public static EnumSet<PersistentAspect> get(Persistent p)
```
    Get the set of currently set PersistentAspects for an object. Thread level PersistentAspects are accounted for.
    
    Parameters:
    
    p - the Persistent for which to get the PersistentAspects
    
    Returns:
    
    an EnumSet of currently active PersistentAspects for this Persistent
  - getForObject
```
public static EnumSet<PersistentAspect> getForObject(Persistent p)
```
    Get the set of currently set PersistentAspects for an object. Thread level PersistentAspects are NOT accounted for.
    
    Parameters:
    
    p - the Persistent for which to get the PersistentAspects
    
    Returns:
    
    an EnumSet of currently active PersistentAspects for this Persistent
  - set
```
public static void set(Persistent p,
                       EnumSet<PersistentAspect> aspects)
```
    Set the PersistentAspects for an object.
    The oid of the object must have been set before.
    
    Parameters:
    
    p - the Persistent for which to set the PersistentAspects
    
    aspects - the EnumSet of PersistentAspects to activate
  - isSet
```
public static boolean isSet(Persistent p,
                            PersistentAspect aspect)
```
    Checks if a PersistentAspect is active for an object. Thread level PersistentAspects are accounted for.
    
    Parameters:
    
    aspect - the PersistentAspect to check
    
    p - the Persistent to check for
    
    Returns:
    
    true, if the PersistentAspect is set for the object
  - isSetForObject
```
public static boolean isSetForObject(Persistent p,
                                     PersistentAspect aspect)
```
    Checks if a PersistentAspect is active for an object. Thread level PersistentAspects are NOT accounted for.
    
    Parameters:
    
    aspect - the PersistentAspect to check
    
    p - the Persistent to check for
    
    Returns:
    
    true, if the PersistentAspect is set for the object
  - add
```
public static AutoCloseablePersistentAspect add(Persistent p,
                                                PersistentAspect... aspects)
```
    Add the PersistentAspects for an object.
    The oid of the object must have been set before.
    
    Parameters:
    
    p - the Persistent for which to add the PersistentAspects
    
    aspects - the PersistentAspects to add
    
    Returns:
    
    an AutoCloseablePersistentAspect to use in a try(with resource) block
  - remove
```
public static AutoCloseablePersistentAspect remove(Persistent p,
                                                   PersistentAspect... aspects)
```
    Remove the PersistentAspects from an object.
    
    Parameters:
    
    p - the Persistent from which to remove the PersistentAspects
    
    aspects - the PersistentAspects to remove
    
    Returns:
    
    an AutoCloseablePersistentAspect to use in a try(with resource) block
  - clear
```
public static void clear(Persistent p)
```
    Clears all PersistentAspects of an object.
    
    Parameters:
    
    p - the object to clear all persistent aspects for

Enum PersistentAspect

Enum Constant Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

NO_OPTLOCKING

NO_DEFERREDCHECK

NO_VALIDATION

NO_PERMISSIONCHECK

NO_LOG

NO_OBJECTEXTENSIONCLEANUP

ALL_PERMISSIONS

NO_CHANGE_SYSTEMFIELDS

Field Detail

logger

Method Detail

values

valueOf

get

set

isSet

add

remove

clear

get

getForObject

set

isSet

isSetForObject

add

remove

clear