Package org.glassfish.hk2.api
Interface ErrorService
-
- All Known Implementing Classes:
ErrorServiceImpl
,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 requestsAn implementation of ErrorService must be in the Singleton scope. Implementations of ErrorService will be instantiated as soon as they are added to HK2 in order to avoid deadlocks and circular references. Therefore it is recommended that implementations of ErrorService make liberal use of
Provider
orIterableProvider
when injecting dependent services so that these services are not instantiated when the ErrorService is created- Author:
- jwells
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method 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 anyServiceLocator
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 typeErrorType.FAILURE_TO_REIFY
. If the error is of typeErrorType.DYNAMIC_CONFIGURATION_FAILURE
orErrorType.SERVICE_CREATION_FAILURE
orErrorType.SERVICE_DESTRUCTION_FAILURE
then any exception thrown from this method is ignored and the original exception is thrown back to the caller
-
-