org.glassfish.hk2.extras.operation

Interface OperationManager

All Known Implementing Classes:

OperationManagerImpl

@Contract
public interface OperationManager

Author:

jwells

Method Summary

Methods

Modifier and Type	Method and Description
OperationHandle	createAndStartOperation(Annotation scope) Creates an OperationHandle that will be associated with the thread calling this method.
OperationHandle	createOperation(Annotation scope) Creates an OperationHandle.
List<OperationHandle>	getCurrentOperations(Annotation scope) Gets the list of all Operations that are in state OperationState.ACTIVE or OperationState.SUSPENDED.
void	shutdownAllOperations(Annotation scope) This method will suspend all currently open operations on all threads and then close them.

Method Detail

createOperation

OperationHandle createOperation(Annotation scope)

Creates an OperationHandle. The returned handle will not be associated with any threads. The scope parameter is normally created with AnnotationLiteral

Parameters:

scope - The scope annotation for this operation type

Returns:

A non-null OperationHandle that can be used to associate threads with the Operation

createAndStartOperation

OperationHandle createAndStartOperation(Annotation scope)

Creates an OperationHandle that will be associated with the thread calling this method. The scope parameter is normally created with AnnotationLiteral

Parameters:

scope - The scope annotation for this operation type

Returns:

A non-null OperationHandle that can be used to associate threads with the Operation

Throws:

IllegalStateException - if the current thread is associated with a different Operation of the same type

getCurrentOperations

List<OperationHandle> getCurrentOperations(Annotation scope)

Gets the list of all Operations that are in state OperationState.ACTIVE or OperationState.SUSPENDED. Operations that are in the OperationState.CLOSED state are no longer tracked by the Manager. The scope parameter is normally created with AnnotationLiteral

Parameters:

scope - The scope annotation for this operation type

Returns:

A non-null but possibly empty list of OperationHandles that have not been closed

shutdownAllOperations

void shutdownAllOperations(Annotation scope)

This method will suspend all currently open operations on all threads and then close them. The scope parameter is normally created with AnnotationLiteral

Parameters:

scope - The scope annotation for this operation type