Package com.orchestranetworks.schema.trigger

Interface BeforeModifyOccurrenceContext

All Superinterfaces:
TableTriggerExecutionContext, TriggerExecutionContext
public interface BeforeModifyOccurrenceContext extends TableTriggerExecutionContext
Provides a context for executing pre-record modification operations.
See Also:

  • Method Details

    • getChanges

      ValueChanges getChanges()
      Returns the changes that will modify the current record.

      More precisely, the returned changes are those that are known just before entering the trigger method handleBeforeModify. If, during the execution of this method, a ValueContextForUpdate.setValue... is invoked, it is not taken into account by the returned object. Such additional modifications are taken into account after handleBeforeModify, and the trigger can access them (all changes) in handleAfterModify.

      Since:
      5.2.5
      See Also:

    • getAdaptationOccurrence

      Adaptation getAdaptationOccurrence()
      Returns the record to be modified.

    • getOccurrenceContextForUpdate

      ValueContextForUpdate getOccurrenceContextForUpdate()
      Returns the record context for performing the update. This has the same content as the read context, but allows setting additional data in the context.

      When a record is copied as-is from one table to another (see ProcedureContext.getContext(AdaptationName)), the default context is a read context. In this case, this method transforms it from a read context to an update context.

      See Also:

    • getDefinitionMode

      DefinitionMode getDefinitionMode()
      Returns the definition mode of the record to be modified.

    • isAllPrivileges

      boolean isAllPrivileges()
      See Also:

    • setAllPrivileges

      void setAllPrivileges()
      Disables all permission checks for all nodes during the current operation.

      Using this method is not recommended, because the scope of the granted privileges is very wide. It is instead recommended to use ValueContextForUpdate.setPrivilegeForNode(com.orchestranetworks.schema.Path), which allows to grant privilege to required nodes only.

      Privilege scope

      As soon as these privileges are granted by this method, permission check for the specified node will be skipped during the whole operation.

      For instance, given a user with read-only permission on the some updated nodes:

      • an import user service launched by this user could still set a value for these nodes.
      • a Procedure executed with this user session and with setAllPrivileges(false) could still set a value for these nodes.
      • a SOAP data service call with this user session could still set a value for these nodes.
      • any trigger with no privilege granted could still set a value for these nodes when multiple triggers are specified by the data model. Indeed, all triggers implied in the operation are affected by the privilege.

      The granted privilege will return to its previous state just after the update operation and before the invocation of after modify triggers.

      See Also: