Package com.orchestranetworks.rest.util

# Interface ProcedureUtility

public interface ProcedureUtility
This class eases `Procedure` execution through automatic pre-configuration.

The provided `Procedure`s will run against a `ProcedureContext` fed with settings coming from the REST Toolkit JAX-RS components. Those pre-configurations are settled before executing the incoming `Procedure`, allowing their override.

Since:
  6.0.0
See Also:
  - `SessionContext.getProcedureUtility()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `ProcedureResult`
  `execute(Procedure aProcedure, AdaptationHome aDataspace)`
  Executes the given `Procedure` against the provided dataspace.

- ## Method Details

  - ### execute

    ProcedureResult execute(Procedure aProcedure, AdaptationHome aDataspace) throws IllegalArgumentException
    Executes the given `Procedure` against the provided dataspace.

    The `ProcedureContext` supplied to the `Procedure` will be pre-configured according to the REST Toolkit JAX-RS components (i.e. `SessionContext`).

    Parameters:
      `aProcedure` - the procedure to execute
      `aDataspace` - the dataspace against which the procedure should be run
    Returns:
      the result of the execution (whether it has thrown an exception, except for the underlying cases).
    Throws:
      `IllegalArgumentException` - if the provided `Procedure` is `null`, if the provided dataspace is `null`