|
|
| version 1.21, 2001/11/15 18:21:31 | version 1.76, 2026/04/25 13:38:46 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @file |
| Parser: exception decls. | Parser: exception decls. |
| Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) | Copyright (c) 2001-2026 Art. Lebedev Studio (https://www.artlebedev.com) |
| Author: Alexander Petrosyan <paf@design.ru> (http://paf.design.ru) | Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru> |
| $Id$ | |
| */ | */ |
| #ifndef PA_EXCEPTION_H | #ifndef PA_EXCEPTION_H |
| #define PA_EXCEPTION_H | #define PA_EXCEPTION_H |
| #include "pa_config_includes.h" | #define IDENT_PA_EXCEPTION_H "$Id$" |
| #include "pa_types.h" | |
| #include "pa_string.h" | const char* const PARSER_RUNTIME = "parser.runtime"; |
| const char* const IMAGE_FORMAT = "image.format"; | |
| #ifdef XML | const char* const PCRE_EXCEPTION_TYPE = "pcre.execute"; |
| #include <PlatformSupport/XSLException.hpp> | const char* const DATE_RANGE_EXCEPTION_TYPE = "date.range"; |
| #include <sax/SAXException.hpp> | const char* const BASE64_FORMAT = "base64.format"; |
| #include <sax/SAXParseException.hpp> | |
| #include <util/XMLException.hpp> | const char* const NAME_MUST_BE_STRING = "name must be string"; |
| #endif | const char* const FILE_NAME_MUST_BE_STRING = "file name must be string"; |
| const char* const FILE_NAME_MUST_BE_STRING_OR_FILE = "file name must be string or file"; | |
| const char* const FILE_NAME_MUST_BE_NE_STRING = "file name must be not empty string"; | |
| const char* const VALUE_MUST_BE_STRING = "value must be string"; | |
| const char* const PARAMETER_MUST_BE_STRING = "parameter must be string"; | |
| const char* const COLUMN_NAME_MUST_BE_STRING = "column name must be string"; | |
| const char* const FILE_NAME_MUST_BE_SPECIFIED = "file name must be specified"; | |
| const char* const PARAM_MUST_NOT_BE_CODE = "param must not be code"; | |
| const char* const PARAM_MUST_BE_HASH = "param must be hash"; | |
| const char* const MODE_MUST_BE_STRING = "mode must be string"; | |
| const char* const OPTIONS_MUST_NOT_BE_CODE = "options must not be code"; | |
| const char* const CALLED_WITH_INVALID_OPTION = "called with invalid option"; | |
| // includes | |
| #include "pa_memory.h" | |
| class Pool; | // forwards |
| class String; | |
| // defines | |
| /// Just simple longjump mechanizm dressed in class clothes. use Temp_exception | |
| class Exception { | class Exception { |
| public: | public: |
| Exception(); | Exception(); |
| Exception( | Exception(const char* atype, const String* aproblem_source, const char* comment_fmt, ...); |
| const String *atype, const String *acode, | Exception(const Exception& src); |
| const String *aproblem_source, | |
| const char *comment_fmt, ...); | operator bool() { return ftype || fproblem_source || fcomment; } |
| Exception& operator =(const Exception& src); | |
| #ifdef XML | |
| /// converts XSL exception to parser exception | |
| static void provide_source(Pool& pool, const String *source, const XSLException& e); | |
| /// converts SAX exception to parser exception | |
| static void provide_source(Pool& pool, const String *source, const SAXException& e); | |
| /// converts SAX parse exception to parser exception | |
| static void provide_source(Pool& pool, const String *source, const SAXParseException& e); | |
| /// converts XML exception to parser exception | |
| static void provide_source(Pool& pool, const String *source, const XMLException& e); | |
| /// converts Xalan DOM exception to parser exception | |
| static void provide_source(Pool& pool, const String *source, const XalanDOMException& e); | |
| #endif | |
| /// extracts exception type | /// extracts exception type |
| const String *type() const { return ftype; } | const char* type(bool can_be_empty=false) const { |
| /// extracts exception code | return can_be_empty || ftype ? ftype : "<no type>"; |
| const String *code() const { return fcode; } | } |
| /// extracts exception problem_source | |
| const String *problem_source() const { return fproblem_source; } | |
| /// extracts exception comment | |
| const char *comment() const { return *fcomment?fcomment:0; } | |
| private: | /// extracts exception problem_source |
| const String* problem_source() const; | |
| const String *ftype, *fcode, *fproblem_source; | /// extracts exception comment |
| char fcomment[MAX_STRING]; | const char* comment(bool can_be_empty=false) const { |
| const char* result=fcomment && *fcomment ? fcomment : 0; | |
| return can_be_empty || result ? result : "<no comment>"; | |
| } | |
| // modifies exception to fine-tune error reporting | |
| void set_source(const String* aproblem_source) { | |
| if(!problem_source()) | |
| fproblem_source=aproblem_source; | |
| } | |
| void add_comment(const char* acomment); | |
| #define ALTER_EXCEPTION_SOURCE(code, source) \ | |
| try { \ | |
| code; \ | |
| } catch (Exception& e) { \ | |
| e.set_source(source); \ | |
| rethrow; \ | |
| } | |
| #define ALTER_EXCEPTION_COMMENT(code, comment) \ | |
| try { \ | |
| code; \ | |
| } catch (Exception& e) { \ | |
| e.add_comment(comment); \ | |
| rethrow; \ | |
| } | |
| protected: | |
| const char* ftype; | |
| const String* fproblem_source; | |
| const char* fcomment; | |
| }; | }; |