Package org.glassfish.hk2.api
Interface ErrorService
- All Known Implementing Classes:
ErrorServiceImpl
,ImmediateHelper
,RethrowErrorService
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
An 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
or IterableProvider
when injecting dependent services so that these services are not instantiated
when the ErrorService is created
-
Method Summary
Modifier and TypeMethodDescriptionvoid
onFailure
(ErrorInformation errorInformation) This method is called when a failure occurs in the system.
-
Method Details
-
onFailure
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
-