...
View file | ||||
---|---|---|---|---|
|
Generic Exceptions
For the handling / catching of such exceptions see the section "Examples for specific Exceptions" below.
Exception | HTTP Code | Description / Idea behind |
---|---|---|
Exception | PHP Basic Exception class should never be used directly. Can be thrown by underlying legacy code. | |
Zend_Exception | Zend Basic Exception class should never be used directly. This Exception an subclasses can be thrown by underlying legacy Zend code. | |
ZfExtended_Exception | ZfExtended Basic Exception class should not be used directly anymore. Should be replaced by specific exceptions. | |
ZfExtended_ErrorCodeException | Base class for specific exceptions, should not be thrown directly. | |
Exceptions with Semantic
This exceptions are used to answer errors to the API in REST full way, by transporting semantic as HTTP response code.
This Exceptions are intended not to be caught, since they transport information to the Caller.
But of course they can be caught if needed and handled differently.
Exception | HTTP Code | Description / Idea behind |
---|---|---|
ZfExtended_BadMethodCallException | 405 Method Not Allowed | Means that the used HTTP Method is not allowed / not implemented. So a usage makes only sense on the controller level. |
ZfExtended_NotAuthenticatedException | 401 Unauthorized | Means the the user is not authorized, so in the request there was no information to identify the user. This error should redirect the user in the GUI to the login page. |
ZfExtended_NotFoundException | 404 Not Found | Is used in application routing, is thrown when the whole requested route is not found (invalid URL). |
ZfExtended_Models_Entity_NotFoundException | 404 Not Found | Is used if an entity can not be found (if it is loaded via an id or guid) |
ZfExtended_NoAccessException ZfExtended_Models_Entity_NoAccessException | 403 Forbidden | The user (authenticated or not) is not allowed to see / manipulate the requested resource. TODO: clear the difference between both exceptions. |
TODO new Unprocesseable Entity Exception (or reuse ValidateException?) | 422 Unprocessable Entity | Should be used PUT/POSTed content does prevent normal processing: Wrong parameters, missing parameters. |
ZfExtended_Models_Entity_Conflict | 409 Conflict | Should be used if the status of the entity does prevent normal processing: The entity is locked, the entity is used/referenced in other places. In other words: the entity it self is reasonable that the request can not be processed. |
ZfExtended_VersionConflictException | 409 Conflict | Must only be used if entity can not be saved due a changed entity version. The classical usage of the 409 HTTP error: the entity was changed in the meantime. |
ZfExtended_BadGateway TODO implement 504 Gateway Timeout | 502 Bad Gateway | Should be used if our request calls internally a third party service, and the third party service or the communication with it does not work. |
TODO 422 Unprocessable Entity | 406 Not Acceptable | TODO: 406 Not Acceptable → makes no sense in the currently used application context, only in the REST router if invalid content according to the accept header is given. Should be converted to: 422 Unprocessable Entity |
ZfExtended_ValidateException | 400 Bad Request | TODO Since a Bad Request should only be given if the syntax is invalid (invalid JSON), the ValidateException should remain but should return a 422 instead? |
ZfExtended_FileUploadException | 400 Bad Request | TODO, currently not used. Should be used in the context of errors with uploaded data |
ZfExtended_Models_MaintenanceException | 503 Service Unavailable | Only usable in the context of the maintenance mode |
ZfExtended_Models_Entity_Exceptions_IntegrityDuplicateKey | TODO → specific exception? No direct HTTP code | Is thrown on saving entities and the underlying DB call returns a "integrity constraint violation 1062 Duplicate entry" error: That means an entity with such key does already exist (entities with additional unique keys, customer number or user login). |
ZfExtended_Models_Entity_Exceptions_IntegrityConstraint | TODO → specific exception? No direct HTTP code | Is thrown on saving/deleting entities and the underlying DB call returns one of the following "integrity constraint violation" error:
|
Info |
---|
Abgearbeitete Exceptions für die Doku ZfExtended_BadMethodCallException extends ZfExtended_Exception ZfExtended_NotAuthenticatedException extends ZfExtended_Exception ZfExtended_NoAccessException extends ZfExtended_Exception ZfExtended_Models_Entity_NoAccessException extends ZfExtended_NoAccessException { ZfExtended_BadGateway extends ZfExtended_Exception ZfExtended_NotFoundException extends ZfExtended_Exception ZfExtended_Models_Entity_NotFoundException extends ZfExtended_Exception ZfExtended_Models_Entity_NotAcceptableException extends ZfExtended_NotAcceptableException ZfExtended_NotAcceptableException ZfExtended_Conflict ZfExtended_VersionConflictException extends ZfExtended_Exception ZfExtended_ValidateException extends ZfExtended_Exception ZfExtended_FileUploadException extends ZfExtended_Exception ZfExtended_Models_MaintenanceException extends ZfExtended_Exception ZfExtended_Models_Entity_Exceptions_IntegrityDuplicateKey extends ZfExtended_ErrorCodeException ZfExtended_Models_Entity_Exceptions_IntegrityConstraint extends ZfExtended_ErrorCodeException HERE: Offene Exceptions für die Doku: ZfExtended_ErrorCodeException extends ZfExtended_Exception ZfExtended_Logger_Exception extends ZfExtended_Exception ZfExtended_Plugin_MissingDependencyException extends ZfExtended_Exception ZfExtended_Plugin_ExclusionException extends ZfExtended_Exception AcrossSoapConnectorException extends Exception editor_Plugins_TermTagger_Exception_Open extends editor_Plugins_TermTagger_Exception_Abstract editor_Plugins_TermTagger_Exception_Abstract extends ZfExtended_Exception editor_Plugins_TermTagger_Exception_Request extends editor_Plugins_TermTagger_Exception_Abstract editor_Plugins_TermTagger_Exception_Malfunction extends editor_Plugins_TermTagger_Exception_Abstract editor_Plugins_Okapi_Exception extends ZfExtended_Exception editor_Models_Segment_TermTagTrackChangeStopException extends Exception editor_Models_Import_TaskFoundException extends ZfExtended_Exception editor_Models_Import_FileParser_Sdlxliff_Exception extends editor_Models_Import_FileParser_Exception editor_Models_Import_FileParser_Exception extends ZfExtended_ErrorCodeException |
Examples for specific Exceptions
This exceptions are used in the case of errors in the application.
Handling of such exceptions:
- They are caught and the application deals with the error.
No impact to the API result. - They are caught and the exceptions is translated into an exception with semantic
This happens mostly on the Controller level. The main error message remains untranslated.
In an additional Container multiple errors, with extra data and translated messages can be stored into the semantic exception. - Nothing is done and the exception bubbles to the caller:
In direct API usage this should happen only if we really don't except that such exceptions happens.
In worker context it is Ok to bubble such exceptions, since they are called via REST,
but are then mostly running asynchronous without answering in a RESTfull way to the caller.
This exceptions are transported untranslated into the GUI.
Exception | Description / Idea behind |
---|---|
editor_Models_Import_FileParser_Sdlxliff_Exception | Exception which is thrown on the usage of the SdlXliff fileparser. |
EventCodes
The EventCodes used in exceptions and other logging usages are defined via the ErrorCodes listed and maintained in confluence..
...