javax.resource.spi.work

## Interface WorkListener

- All Superinterfaces:
    EventListener
  All Known Implementing Classes:
    WorkAdapter

      public interface WorkListener
      extends EventListener

  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. The `WorkListener` instance must not make any thread assumptions and must be thread-safe ie., a notification could occur from any arbitrary thread. Further, it must not make any assumptions on the ordering of notifications.
  Version:
    1.0
  Author:
    Ram Jeyaraman

- - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `workAccepted(WorkEvent e)` Invoked when a `Work` instance has been accepted.
    `void` | `workCompleted(WorkEvent e)` Invoked when a `Work` instance has completed execution.
    `void` | `workRejected(WorkEvent e)` Invoked when a `Work` instance has been rejected.
    `void` | `workStarted(WorkEvent e)` Invoked when a `Work` instance has started execution.

- - ### Method Detail

    - #### workAccepted

          void workAccepted(WorkEvent e)

      Invoked when a `Work` instance has been accepted.
      Parameters:
        `e` - A `WorkEvent` object that provides more information about the accepted Work.

    - #### workRejected

          void workRejected(WorkEvent e)

      Invoked when a `Work` instance has been rejected.
      Parameters:
        `e` - A `WorkEvent` object that provides more information about the rejected Work.

    - #### workStarted

          void workStarted(WorkEvent e)

      Invoked when a `Work` instance has started execution. This only means that a thread has been allocated.
      Parameters:
        `e` - A `WorkEvent` object that provides more information about the rejected Work.

    - #### workCompleted

          void workCompleted(WorkEvent e)

      Invoked when a `Work` instance has completed execution.
      Parameters:
        `e` - A `WorkEvent` object that provides more information about the completed Work.

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