public interface EventSaveErrorHandler
extends com.google.gwt.event.shared.EventHandler
| Modifier and Type | Method and Description |
|---|---|
void |
onEventSaveError(EventSaveError event)
Notification method fired when an attempt to save
an event
following edits or drag-movements results in an error from the server. |
void onEventSaveError(EventSaveError event)
an event
following edits or drag-movements results in an error from the server. May be overridden to handle specific errors and
provide feedback to the user or push a server-provided record to client caches with a call to updateCaches(), for example. The scenarioCode
parameter may be used to determine how the save was initiated.
Return false from this method to cancel builtin behavior, which is as follows:
If a save happened because
an event-canvas was moved or sized with the mouse, and any kind of error occurs, the event is restored to it's
pre-save position - if this method specifically returns true, the errors are also sent to central error handling, which will show them to the user in a simple error
dialog.
If a save happened because an event was edited in the eventDialog or eventEditor windows and a validation error occurs, the
window is re-opened for editing with the validation errors visible. If any other kind of error occurs, the window will
not be re-opened and, if this method specifically returns true, the error will be sent to central error handling which will show a simple error dialog to the end user.
In all cases, if the server returned an updated record despite the save failing (eg, perhaps the server enforces
optimistic locking and the underlying record has been changed by another user), it is assumed to be a latest-version of
the record and is applied instead of the original record during those builtin UI processes. So, the eventEditor and eventDialog will show any changes from the latest-record.
If the save was caused by dragging an event and the event's start or end dates are different in the latest-record, the
EventCanvas will be positioned using the latest values, instead of returning to it's pre-save position on-screen.
event - the event