# Package javax.resource.spi.work

This package contains APIs for the Work Management, Generic and Security Work Context contracts.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  DistributableWork | This models a `Work` instance that would be distributed by a `DistributableWorkManager` for execution in a remote `DistributableWorkManager`
  DistributableWorkManager | This interface models a `WorkManager` that supports distributed execution of Work instances.
  Work | This models a `Work` instance that would be executed by a `WorkManager` upon submission.
  WorkContext | This class serves as a standard mechanism for a resource adapter to propagate an imported context from an enterprise information system to an application server.
  WorkContextLifecycleListener | This class models the various events that occur during the processing of the `WorkContext`s associated with a `Work` instance.
  WorkContextProvider | This interface specifies the methods a `Work` instance uses to associate a `List` of `WorkContext` instances to be set when the `Work` instance gets executed by a `WorkManager`.
  WorkListener | This models a `WorkListener` instance which would be notified by the `WorkManager` when the various `Work` processing events (work accepted, work rejected, work started, work completed) occur.
  WorkManager | This interface models a `WorkManager` which provides a facility to submit `Work` instances for execution.

- Class Summary
  Class | Description
  --- | ---
  ExecutionContext | This class models an execution context (transaction, security, etc) with which the `Work` instance must be executed.
  HintsContext | A standard `WorkContext` that allows a `Work` instance to propagate quality-of-service (QoS) hints about the `Work` to the `WorkManager`.
  SecurityContext | A standard `WorkContext` that allows a `Work` instance to propagate security related context information from an EIS to an application server.
  TransactionContext | A standard `WorkContext` that allows a `Work` instance to propagate transaction related context information from an EIS to an application server.
  WorkAdapter | This class is provided as a convenience for easily creating `WorkListener` instances by extending this class and overriding only those methods of interest.
  WorkContextErrorCodes | This class models the possible error conditions that might occur during associating an `WorkContext` with a `Work` instance.
  WorkEvent | This class models the various events that occur during the processing of a `Work` instance.

- Exception Summary
  Exception | Description
  --- | ---
  RetryableWorkRejectedException | A subclass of the `WorkRejectedException` that indicates that the the service unavailability is transient.
  WorkCompletedException | This exception is thrown by a `WorkManager` to indicate that a submitted `Work` instance has completed with an exception.
  WorkException | A common base class for all `Work` processing related exceptions.
  WorkRejectedException | This exception is thrown by a `WorkManager` to indicate that a submitted `Work` instance has been rejected.

## Package javax.resource.spi.work Description

This package contains APIs for the Work Management, Generic and Security Work Context contracts.

Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.