SUMO - Simulation of Urban MObility
XMLSubSys.cpp
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.org/sumo
3 // Copyright (C) 2002-2018 German Aerospace Center (DLR) and others.
4 // This program and the accompanying materials
5 // are made available under the terms of the Eclipse Public License v2.0
6 // which accompanies this distribution, and is available at
7 // http://www.eclipse.org/legal/epl-v20.html
8 // SPDX-License-Identifier: EPL-2.0
9 /****************************************************************************/
17 // Utility methods for initialising, closing and using the XML-subsystem
18 /****************************************************************************/
19 
20 
21 // ===========================================================================
22 // included modules
23 // ===========================================================================
24 #include <config.h>
25 
26 #include <cstdint>
27 #include <xercesc/util/PlatformUtils.hpp>
30 #include "SUMOSAXHandler.h"
31 #include "SUMOSAXReader.h"
32 #include "XMLSubSys.h"
33 
34 
35 // ===========================================================================
36 // static member variables
37 // ===========================================================================
38 std::vector<SUMOSAXReader*> XMLSubSys::myReaders;
40 XERCES_CPP_NAMESPACE::SAX2XMLReader::ValSchemes XMLSubSys::myValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Auto;
41 XERCES_CPP_NAMESPACE::SAX2XMLReader::ValSchemes XMLSubSys::myNetValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Auto;
42 
43 
44 // ===========================================================================
45 // method definitions
46 // ===========================================================================
47 void
49  try {
50  XERCES_CPP_NAMESPACE::XMLPlatformUtils::Initialize();
51  myNextFreeReader = 0;
52  } catch (const XERCES_CPP_NAMESPACE::XMLException& e) {
53  throw ProcessError("Error during XML-initialization:\n " + StringUtils::transcode(e.getMessage()));
54  }
55 }
56 
57 
58 void
59 XMLSubSys::setValidation(const std::string& validationScheme, const std::string& netValidationScheme) {
60  if (validationScheme == "never") {
61  myValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Never;
62  } else if (validationScheme == "auto") {
63  myValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Auto;
64  } else if (validationScheme == "always") {
65  myValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Always;
66  } else {
67  throw ProcessError("Unknown xml validation scheme + '" + validationScheme + "'.");
68  }
69  if (netValidationScheme == "never") {
70  myNetValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Never;
71  } else if (netValidationScheme == "auto") {
72  myNetValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Auto;
73  } else if (netValidationScheme == "always") {
74  myNetValidationScheme = XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Always;
75  } else {
76  throw ProcessError("Unknown network validation scheme + '" + netValidationScheme + "'.");
77  }
78 }
79 
80 
81 bool
82 XMLSubSys::isValidating(const bool net) {
83  if (net) {
84  return myNetValidationScheme != XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Never;
85  }
86  return myValidationScheme != XERCES_CPP_NAMESPACE::SAX2XMLReader::Val_Never;
87 }
88 
89 
90 void
92  for (std::vector<SUMOSAXReader*>::iterator i = myReaders.begin(); i != myReaders.end(); ++i) {
93  delete *i;
94  }
95  myReaders.clear();
96  XERCES_CPP_NAMESPACE::XMLPlatformUtils::Terminate();
97 }
98 
99 
102  return new SUMOSAXReader(handler, myValidationScheme);
103 }
104 
105 
106 void
108  myReaders[myNextFreeReader - 1]->setHandler(handler);
109 }
110 
111 
112 bool
114  const std::string& file, const bool isNet) {
115  try {
116  XERCES_CPP_NAMESPACE::SAX2XMLReader::ValSchemes validationScheme = isNet ? myNetValidationScheme : myValidationScheme;
117  if (myNextFreeReader == (int)myReaders.size()) {
118  myReaders.push_back(new SUMOSAXReader(handler, validationScheme));
119  } else {
120  myReaders[myNextFreeReader]->setValidation(validationScheme);
121  myReaders[myNextFreeReader]->setHandler(handler);
122  }
124  std::string prevFile = handler.getFileName();
125  handler.setFileName(file);
126  myReaders[myNextFreeReader - 1]->parse(file);
127  handler.setFileName(prevFile);
129  } catch (ProcessError& e) {
130  WRITE_ERROR(std::string(e.what()) != std::string("") ? std::string(e.what()) : std::string("Process Error"));
131  return false;
132  } catch (const std::runtime_error& re) {
133  WRITE_ERROR("Runtime error: " + std::string(re.what()) + " while parsing '" + file + "'");
134  return false;
135  } catch (const std::exception& ex) {
136  WRITE_ERROR("Error occurred: " + std::string(ex.what()) + " while parsing '" + file + "'");
137  return false;
138  } catch (...) {
139  WRITE_ERROR("Unspecified error occurred wile parsing '" + file + "'");
140  return false;
141  }
143 }
144 
145 
146 /****************************************************************************/
147 
static void init()
Initialises the xml-subsystem.
Definition: XMLSubSys.cpp:48
static MsgHandler * getErrorInstance()
Returns the instance to add errors to.
Definition: MsgHandler.cpp:76
static void close()
Closes the xml-subsystem.
Definition: XMLSubSys.cpp:91
static void setValidation(const std::string &validationScheme, const std::string &netValidationScheme)
Enables or disables validation.
Definition: XMLSubSys.cpp:59
const std::string & getFileName() const
returns the current file name
SAX-reader encapsulation containing binary reader.
Definition: SUMOSAXReader.h:51
static int myNextFreeReader
Information whether the reader is parsing.
Definition: XMLSubSys.h:158
SAX-handler base for SUMO-files.
bool wasInformed() const
Returns the information whether any messages were added.
Definition: MsgHandler.cpp:307
static bool runParser(GenericSAXHandler &handler, const std::string &file, const bool isNet=false)
Runs the given handler on the given file; returns if everything&#39;s ok.
Definition: XMLSubSys.cpp:113
static std::string transcode(const XMLCh *const data)
converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8...
Definition: StringUtils.h:133
A handler which converts occuring elements and attributes into enums.
void setFileName(const std::string &name)
Sets the current file name.
static XERCES_CPP_NAMESPACE::SAX2XMLReader::ValSchemes myValidationScheme
Information whether built reader/parser shall validate XML-documents against schemata.
Definition: XMLSubSys.h:161
static SUMOSAXReader * getSAXReader(SUMOSAXHandler &handler)
Builds a reader and assigns the handler to it.
Definition: XMLSubSys.cpp:101
static void setHandler(GenericSAXHandler &handler)
Sets the given handler for the default reader.
Definition: XMLSubSys.cpp:107
static bool isValidating(const bool net=false)
Returns whether validation is enabled.
Definition: XMLSubSys.cpp:82
#define WRITE_ERROR(msg)
Definition: MsgHandler.h:247
static XERCES_CPP_NAMESPACE::SAX2XMLReader::ValSchemes myNetValidationScheme
Information whether built reader/parser shall validate SUMO networks against schemata.
Definition: XMLSubSys.h:164
static std::vector< SUMOSAXReader * > myReaders
The XML Readers used for repeated parsing.
Definition: XMLSubSys.h:155