org.glassfish.hk2.api

Interface ErrorService

All Known Implementing Classes:

ImmediateHelper, RethrowErrorService

@Contract
public interface ErrorService

This interface should be implemented by those who wish to be notified of error conditions that occur within HK2. These errors are those that might happen during normal processing of HK2 requests but which are not otherwise reported up the calling stack frame.

An implementation of ErrorService must be in the Singleton scope

Author:

jwells

Method Summary

Methods

Modifier and Type	Method and Description
void	onFailure(ErrorInformation errorInformation) This method is called when a failure occurs in the system.

Method Detail

onFailure

void onFailure(ErrorInformation errorInformation)
               throws MultiException

This method is called when a failure occurs in the system. This method may use any ServiceLocator api. For example, an implementation of this method might want to remove a descriptor from the registry if the error can be determined to be a permanent failure.

Parameters:

errorInformation - Information about the error that occurred

Throws:

MultiException - if this method throws an exception that exception will be thrown back to the caller wrapped in another MultiException if the error is of type ErrorType.FAILURE_TO_REIFY. If the error is of type ErrorType.DYNAMIC_CONFIGURATION_FAILURE then any exception thrown from this method is ignored and the original exception is thrown back to the DynamicConfiguration.commit() method