|
Oracle Data-aware Controls Reference | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Defines the interface for ErrorManager event listeners. Event listeners must implement this interface. A listener that implements this interface provides a mechanism to handle an error event. The error listener is notified by the ErrorManager whenever an error event occurs. The events can be:
When an error is added or removed, the ErrorManager notifies all registered error listeners. When adding or removing an error message the ErrorManager notifies the error listeners by calling addingErrorMessage(ErrorMessage) or removingErrorMessage(ErrorMessage), respectively.
Any listener can veto the addition or removal of the error by calling an ErrorMessageVetoException. If the listener calls the exception and vetos the event, the error will be rolled back, and loggers will not be informed of the event. If the listener does not call the exception, the error will be delivered to the loggers.
ErrorManager
,
ErrorMessage
,
ErrorMessageVetoException
Method Summary | |
void |
addingErrorMessage(ErrorMessage msg)
Called when the ErrorManager has been requested to add an error message. |
java.lang.String |
getName()
Returns the name of the listener. |
void |
removingErrorMessage(ErrorMessage msg)
Called when the ErrorManager has been requested to remove a specific error message. |
void |
rollingBackAddingErrorMessage(ErrorMessage msg)
Called when this error has been added, but another listener vetoes the event. |
void |
rollingBackRemovingErrorMessage(ErrorMessage msg)
Called when this error has been removed, but another Listener vetoes the event. |
Method Detail |
public java.lang.String getName()
public void addingErrorMessage(ErrorMessage msg) throws ErrorMessageVetoException
msg
- the error message being added.ErrorMessageVetoException
- if the listener wishes to
veto the event.public void removingErrorMessage(ErrorMessage msg) throws ErrorMessageVetoException
msg
- the error message being removed.ErrorMessageVetoException
- if the listener wishes to
veto the event.public void rollingBackAddingErrorMessage(ErrorMessage msg)
msg
- the error message being added and vetoed by another listener.public void rollingBackRemovingErrorMessage(ErrorMessage msg)
msg
- the error message being removed and vetoed by another listener.
|
Oracle Data-aware Controls Reference | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |