![]() |
Eclipse SUMO - Simulation of Urban MObility
|
#include <MsgHandlerSynchronized.h>
Public Types | |
enum class | MsgType { MT_MESSAGE , MT_WARNING , MT_ERROR , MT_DEBUG , MT_GLDEBUG } |
Public Member Functions | |
void | addRetriever (OutputDevice *retriever) |
Adds a further retriever to the instance responsible for a certain msg type. More... | |
void | beginProcessMsg (std::string msg, bool addType=true) |
Begins a process information. More... | |
void | clear (bool resetInformed=true) |
Clears information whether an error occurred previously. More... | |
void | endProcessMsg (std::string msg) |
Ends a process information. More... | |
void | inform (std::string msg, bool addType=true) |
adds a new error to the list More... | |
template<typename T , typename... Targs> | |
void | informf (const std::string &format, T value, Targs... Fargs) |
adds a new formatted message More... | |
bool | isRetriever (OutputDevice *retriever) const |
Returns whether the given output device retrieves messages from the handler. More... | |
template<class T > | |
MsgHandler & | operator<< (const T &t) |
Generic output operator. More... | |
void | removeRetriever (OutputDevice *retriever) |
Removes the retriever from the handler. More... | |
bool | wasInformed () const |
Returns the information whether any messages were added. More... | |
Static Public Member Functions | |
static void | cleanupOnEnd () |
Removes pending handler. More... | |
static MsgHandler * | create (MsgType type) |
static void | enableDebugGLMessages (bool enable) |
enable/disable gl-debug messages More... | |
static void | enableDebugMessages (bool enable) |
enable/disable debug messages More... | |
static MsgHandler * | getDebugInstance () |
Returns the instance to add debug to. More... | |
static MsgHandler * | getErrorInstance () |
Returns the instance to add errors to. More... | |
static MsgHandler * | getGLDebugInstance () |
Returns the instance to add GLdebug to. More... | |
static MsgHandler * | getMessageInstance () |
Returns the instance to add normal messages to. More... | |
static MsgHandler * | getWarningInstance () |
Returns the instance to add warnings to. More... | |
static void | initOutputOptions () |
init output options More... | |
static void | removeRetrieverFromAllInstances (OutputDevice *out) |
ensure that that given output device is no longer used as retriever by any instance More... | |
static void | setFactory (Factory func) |
Sets the factory function to use for new MsgHandlers. More... | |
static void | setupI18n (const std::string &locale="") |
set up gettext stuff More... | |
static bool | writeDebugGLMessages () |
check whether to enable/disable gl-debug messages More... | |
static bool | writeDebugMessages () |
check whether to enable/disable debug messages More... | |
Protected Member Functions | |
bool | aggregationThresholdReached (const std::string &format) |
std::string | build (const std::string &msg, bool addType) |
Builds the string which includes the mml-message type. More... | |
void | setAggregationThreshold (const int thresh) |
Private Types | |
typedef MsgHandler *(* | Factory) (MsgType) |
Private Member Functions | |
MsgHandlerSynchronized (const MsgHandlerSynchronized &s)=delete | |
invalid copy constructor More... | |
MsgHandlerSynchronized (MsgType type) | |
standard constructor More... | |
MsgHandlerSynchronized & | operator= (const MsgHandlerSynchronized &s)=delete |
invalid assignment operator More... | |
~MsgHandlerSynchronized () | |
destructor More... | |
Private Attributes | |
std::map< const std::string, int > | myAggregationCount |
count for messages of the same type More... | |
int | myAggregationThreshold |
do not output more messages of the same type if the count exceeds this threshold More... | |
std::vector< std::string > | myInitialMessages |
storage for initial messages More... | |
FXMutex | myLock |
The lock for synchronizing all outputs using handlers of this class. More... | |
std::vector< OutputDevice * > | myRetrievers |
The list of retrievers that shall be informed about new messages or errors. More... | |
MsgType | myType |
The type of the instance. More... | |
bool | myWasInformed |
information whether an output occurred at all More... | |
Static Private Attributes | |
static bool | myAmProcessingProcess = false |
Information whether a process information is printed to cout. More... | |
static MsgHandler * | myDebugInstance = nullptr |
The instance to handle debug. More... | |
static MsgHandler * | myErrorInstance = nullptr |
The instance to handle errors. More... | |
static Factory | myFactory = nullptr |
The function to call for new MsgHandlers, nullptr means use default constructor. More... | |
static MsgHandler * | myGLDebugInstance = nullptr |
The instance to handle glDebug. More... | |
static MsgHandler * | myMessageInstance = nullptr |
The instance to handle normal messages. More... | |
static MsgHandler * | myWarningInstance = nullptr |
The instance to handle warnings. More... | |
static bool | myWriteDebugGLMessages |
static bool | myWriteDebugMessages |
Flag to enable or disable debug GL Functions. More... | |
Definition at line 46 of file MsgHandlerSynchronized.h.
|
privateinherited |
Definition at line 61 of file MsgHandler.h.
|
stronginherited |
An enumeration to differ between different types of messages (errors, warning and information)
Definition at line 47 of file MsgHandler.h.
|
inlineprivate |
standard constructor
Definition at line 102 of file MsgHandlerSynchronized.h.
Referenced by create().
|
inlineprivate |
destructor
Definition at line 107 of file MsgHandlerSynchronized.h.
|
privatedelete |
invalid copy constructor
|
inlinevirtual |
Adds a further retriever to the instance responsible for a certain msg type.
Reimplemented from MsgHandler.
Definition at line 83 of file MsgHandlerSynchronized.h.
References MsgHandler::addRetriever(), and myLock.
|
inlineprotectedvirtual |
Reimplemented from MsgHandler.
Definition at line 95 of file MsgHandlerSynchronized.h.
References MsgHandler::aggregationThresholdReached(), and myLock.
|
inlinevirtual |
Begins a process information.
When a longer action is started, this method should be used to inform the user about it. There will be no newline printed, but the message handler will be informed that a process message has been begun. If an error occurs, a newline will be printed. After the action has been performed, use endProcessMsg to inform the user about it.
Reimplemented from MsgHandler.
Definition at line 65 of file MsgHandlerSynchronized.h.
References MsgHandler::beginProcessMsg(), and myLock.
|
inlineprotectedinherited |
Builds the string which includes the mml-message type.
Definition at line 167 of file MsgHandler.h.
References MsgHandler::MT_DEBUG, MsgHandler::MT_ERROR, MsgHandler::MT_GLDEBUG, MsgHandler::MT_MESSAGE, MsgHandler::MT_WARNING, and MsgHandler::myType.
Referenced by MsgHandler::beginProcessMsg(), and MsgHandler::inform().
|
staticinherited |
Removes pending handler.
Definition at line 292 of file MsgHandler.cpp.
References MsgHandler::myDebugInstance, MsgHandler::myErrorInstance, MsgHandler::myGLDebugInstance, MsgHandler::myMessageInstance, and MsgHandler::myWarningInstance.
Referenced by SystemFrame::close(), GUIRunThread::deleteSim(), main(), and MsgHandler::setFactory().
|
inlinevirtual |
Clears information whether an error occurred previously.
Reimplemented from MsgHandler.
Definition at line 77 of file MsgHandlerSynchronized.h.
References MsgHandler::clear(), and myLock.
|
inlinestatic |
Definition at line 48 of file MsgHandlerSynchronized.h.
References MsgHandlerSynchronized().
Referenced by NLBuilder::init(), and main().
|
staticinherited |
enable/disable gl-debug messages
Definition at line 111 of file MsgHandler.cpp.
References MsgHandler::myWriteDebugGLMessages.
Referenced by GUIDialog_Options::InputBool::onCmdSetOption(), and GNELoadThread::run().
|
staticinherited |
enable/disable debug messages
Definition at line 106 of file MsgHandler.cpp.
References MsgHandler::myWriteDebugMessages.
Referenced by GUIDialog_Options::InputBool::onCmdSetOption(), and GNELoadThread::run().
|
inlinevirtual |
Ends a process information.
Reimplemented from MsgHandler.
Definition at line 71 of file MsgHandlerSynchronized.h.
References MsgHandler::endProcessMsg(), and myLock.
|
staticinherited |
Returns the instance to add debug to.
Definition at line 88 of file MsgHandler.cpp.
References MsgHandler::MsgHandler(), MsgHandler::MT_DEBUG, and MsgHandler::myDebugInstance.
Referenced by GUIMessageWindow::registerMsgHandlers(), GNELoadThread::run(), GNELoadThread::submitEndAndCleanup(), and GUIMessageWindow::unregisterMsgHandlers().
|
staticinherited |
Returns the instance to add errors to.
Definition at line 79 of file MsgHandler.cpp.
References MsgHandler::MsgHandler(), MsgHandler::MT_ERROR, and MsgHandler::myErrorInstance.
Referenced by NLHandler::addPhase(), MSRouteHandler::addStop(), NLBuilder::build(), MSSOTLTrafficLightLogic::checkPhases(), OutputDevice::closeAll(), RORouteHandler::closeFlow(), RORouteHandler::closeVehicle(), ROJTRRouter::compute(), GUIRunThread::deleteSim(), GNELoadThread::GNELoadThread(), GUILoadThread::GUILoadThread(), NLBuilder::init(), GUIRunThread::init(), MsgHandler::initOutputOptions(), RORoute::isValid(), NIImporter_OpenStreetMap::load(), PCLoaderOSM::loadIfSet(), loadJTRDefinitions(), NIImporter_ArcView::loadNetwork(), MSNet::loadState(), main(), GUIRunThread::makeStep(), ROLoader::openRoutes(), RORouteDef::preComputeCurrentRoute(), ROLoader::processRoutes(), GUIMessageWindow::registerMsgHandlers(), RORouteDef::repairCurrentRoute(), GUILoadThread::run(), GNELoadThread::run(), XMLSubSys::runParser(), RONet::saveAndRemoveRoutesUntil(), MSSOTLTrafficLightLogic::setToATargetPhase(), GNELoadThread::submitEndAndCleanup(), GUILoadThread::submitEndAndCleanup(), and GUIMessageWindow::unregisterMsgHandlers().
|
staticinherited |
Returns the instance to add GLdebug to.
Definition at line 97 of file MsgHandler.cpp.
References MsgHandler::MsgHandler(), MsgHandler::MT_GLDEBUG, and MsgHandler::myGLDebugInstance.
Referenced by GUIMessageWindow::registerMsgHandlers(), GNELoadThread::run(), GNELoadThread::submitEndAndCleanup(), and GUIMessageWindow::unregisterMsgHandlers().
|
staticinherited |
Returns the instance to add normal messages to.
Definition at line 53 of file MsgHandler.cpp.
References MsgHandler::MsgHandler(), MsgHandler::MT_MESSAGE, MsgHandler::myFactory, and MsgHandler::myMessageInstance.
Referenced by CHBuilder< E, V >::buildContractionHierarchy(), MSDeterministicHiLevelTrafficLightLogic::decideNextPhase(), MSSwarmTrafficLightLogic::decideNextPhase(), GUIRunThread::deleteSim(), MsgHandler::inform(), NLBuilder::init(), GUIRunThread::init(), MsgHandler::initOutputOptions(), NBHeightMapper::loadIfSet(), MSSOTLPhaseTrafficLightLogic::MSSOTLPhaseTrafficLightLogic(), MSSOTLPolicyBasedTrafficLightLogic::MSSOTLPolicyBasedTrafficLightLogic(), MSSOTLWaveTrafficLightLogic::MSSOTLWaveTrafficLightLogic(), GUIMessageWindow::registerMsgHandlers(), GUILoadThread::run(), GNELoadThread::run(), GNELoadThread::submitEndAndCleanup(), GUILoadThread::submitEndAndCleanup(), and GUIMessageWindow::unregisterMsgHandlers().
|
staticinherited |
Returns the instance to add warnings to.
Definition at line 66 of file MsgHandler.cpp.
References MsgHandler::MsgHandler(), MsgHandler::MT_WARNING, MsgHandler::myFactory, and MsgHandler::myWarningInstance.
Referenced by NLHandler::addPhase(), AStarRouter< E, V >::clone(), CHRouter< E, V >::clone(), DijkstraRouter< E, V >::clone(), SystemFrame::close(), ROJTRRouter::compute(), GUIRunThread::deleteSim(), RailwayRouter< E, V >::ensureInternalRouter(), NLBuilder::init(), GUIRunThread::init(), MsgHandler::initOutputOptions(), RORoute::isValid(), PCLoaderOSM::loadIfSet(), main(), NBLoadedTLDef::myCompute(), RORouteDef::preComputeCurrentRoute(), GUIMessageWindow::registerMsgHandlers(), RORouteDef::repairCurrentRoute(), GUILoadThread::run(), GNELoadThread::run(), RONet::saveAndRemoveRoutesUntil(), GNELoadThread::submitEndAndCleanup(), GUILoadThread::submitEndAndCleanup(), TraCIServer::TraCIServer(), and GUIMessageWindow::unregisterMsgHandlers().
|
inlinevirtual |
adds a new error to the list
Reimplemented from MsgHandler.
Definition at line 53 of file MsgHandlerSynchronized.h.
References MsgHandler::inform(), and myLock.
|
inlineinherited |
adds a new formatted message
Definition at line 120 of file MsgHandler.h.
References MsgHandler::aggregationThresholdReached(), StringUtils::format(), and MsgHandler::inform().
Referenced by AStarRouter< E, V >::compute(), CHRouter< E, V >::compute(), DijkstraRouter< E, V >::compute(), SUMOAbstractRouter< E, V >::computeLooped(), RORoute::isValid(), NIXMLConnectionsHandler::myStartElement(), and NIXMLConnectionsHandler::parseLaneBound().
|
staticinherited |
init output options
Definition at line 255 of file MsgHandler.cpp.
References MsgHandler::addRetriever(), OptionsCont::getBool(), OutputDevice::getDevice(), MsgHandler::getErrorInstance(), OptionsCont::getInt(), MsgHandler::getMessageInstance(), OptionsCont::getOptions(), OptionsCont::getString(), MsgHandler::getWarningInstance(), OptionsCont::isSet(), MsgHandler::myInitialMessages, MsgHandler::removeRetriever(), and MsgHandler::setAggregationThreshold().
Referenced by NLBuilder::init(), main(), GUILoadThread::run(), and GNELoadThread::run().
|
inherited |
Returns whether the given output device retrieves messages from the handler.
Definition at line 202 of file MsgHandler.cpp.
References MsgHandler::myRetrievers.
Referenced by MsgHandler::addRetriever().
|
inlineinherited |
Generic output operator.
Definition at line 157 of file MsgHandler.h.
References MsgHandler::myRetrievers.
|
privatedelete |
invalid assignment operator
|
inlinevirtual |
Removes the retriever from the handler.
Reimplemented from MsgHandler.
Definition at line 89 of file MsgHandlerSynchronized.h.
References myLock, and MsgHandler::removeRetriever().
|
staticinherited |
ensure that that given output device is no longer used as retriever by any instance
Definition at line 208 of file MsgHandler.cpp.
References MsgHandler::myDebugInstance, MsgHandler::myErrorInstance, MsgHandler::myGLDebugInstance, MsgHandler::myMessageInstance, MsgHandler::myWarningInstance, and MsgHandler::removeRetriever().
Referenced by OutputDevice::close().
|
inlineprotectedinherited |
Definition at line 195 of file MsgHandler.h.
References MsgHandler::myAggregationThreshold.
Referenced by MsgHandler::initOutputOptions().
|
inlinestaticinherited |
Sets the factory function to use for new MsgHandlers.
Definition at line 65 of file MsgHandler.h.
References MsgHandler::cleanupOnEnd(), and MsgHandler::myFactory.
Referenced by NLBuilder::init(), and main().
|
staticinherited |
set up gettext stuff
Definition at line 228 of file MsgHandler.cpp.
References TL, UNUSED_PARAMETER, and WRITE_WARNING.
Referenced by checkOptions(), and main().
|
inherited |
Returns the information whether any messages were added.
Definition at line 321 of file MsgHandler.cpp.
References MsgHandler::myWasInformed.
Referenced by MsgHandler::clear(), NIImporter_OpenStreetMap::load(), ROLoader::processRoutes(), and XMLSubSys::runParser().
|
inlinestaticinherited |
check whether to enable/disable gl-debug messages
Definition at line 98 of file MsgHandler.h.
References MsgHandler::myWriteDebugGLMessages.
Referenced by SUMORTree::addAdditionalGLObject(), and SUMORTree::removeAdditionalGLObject().
|
inlinestaticinherited |
check whether to enable/disable debug messages
Definition at line 93 of file MsgHandler.h.
References MsgHandler::myWriteDebugMessages.
|
privateinherited |
count for messages of the same type
Definition at line 238 of file MsgHandler.h.
Referenced by MsgHandler::aggregationThresholdReached(), and MsgHandler::clear().
|
privateinherited |
do not output more messages of the same type if the count exceeds this threshold
Definition at line 235 of file MsgHandler.h.
Referenced by MsgHandler::aggregationThresholdReached(), MsgHandler::clear(), and MsgHandler::setAggregationThreshold().
|
staticprivateinherited |
Information whether a process information is printed to cout.
Definition at line 225 of file MsgHandler.h.
Referenced by MsgHandler::beginProcessMsg(), MsgHandler::endProcessMsg(), and MsgHandler::inform().
|
staticprivateinherited |
The instance to handle debug.
Definition at line 210 of file MsgHandler.h.
Referenced by MsgHandler::cleanupOnEnd(), MsgHandler::getDebugInstance(), and MsgHandler::removeRetrieverFromAllInstances().
|
staticprivateinherited |
The instance to handle errors.
Definition at line 216 of file MsgHandler.h.
Referenced by MsgHandler::cleanupOnEnd(), MsgHandler::getErrorInstance(), and MsgHandler::removeRetrieverFromAllInstances().
|
staticprivateinherited |
The function to call for new MsgHandlers, nullptr means use default constructor.
Definition at line 207 of file MsgHandler.h.
Referenced by MsgHandler::getMessageInstance(), MsgHandler::getWarningInstance(), and MsgHandler::setFactory().
|
staticprivateinherited |
The instance to handle glDebug.
Definition at line 213 of file MsgHandler.h.
Referenced by MsgHandler::cleanupOnEnd(), MsgHandler::getGLDebugInstance(), and MsgHandler::removeRetrieverFromAllInstances().
|
privateinherited |
storage for initial messages
Definition at line 244 of file MsgHandler.h.
Referenced by MsgHandler::clear(), MsgHandler::inform(), and MsgHandler::initOutputOptions().
|
private |
The lock for synchronizing all outputs using handlers of this class.
Definition at line 111 of file MsgHandlerSynchronized.h.
Referenced by addRetriever(), aggregationThresholdReached(), beginProcessMsg(), clear(), endProcessMsg(), inform(), and removeRetriever().
|
staticprivateinherited |
The instance to handle normal messages.
Definition at line 222 of file MsgHandler.h.
Referenced by MsgHandler::cleanupOnEnd(), MsgHandler::getMessageInstance(), and MsgHandler::removeRetrieverFromAllInstances().
|
privateinherited |
The list of retrievers that shall be informed about new messages or errors.
Definition at line 241 of file MsgHandler.h.
Referenced by MsgHandler::addRetriever(), MsgHandler::beginProcessMsg(), MsgHandler::endProcessMsg(), MsgHandler::inform(), MsgHandler::isRetriever(), MsgHandler::operator<<(), and MsgHandler::removeRetriever().
|
privateinherited |
The type of the instance.
Definition at line 229 of file MsgHandler.h.
Referenced by MsgHandler::build().
|
staticprivateinherited |
The instance to handle warnings.
Definition at line 219 of file MsgHandler.h.
Referenced by MsgHandler::cleanupOnEnd(), MsgHandler::getWarningInstance(), and MsgHandler::removeRetrieverFromAllInstances().
|
privateinherited |
information whether an output occurred at all
Definition at line 232 of file MsgHandler.h.
Referenced by MsgHandler::beginProcessMsg(), MsgHandler::clear(), MsgHandler::endProcessMsg(), MsgHandler::inform(), and MsgHandler::wasInformed().
|
staticprivateinherited |
Definition at line 258 of file MsgHandler.h.
Referenced by MsgHandler::enableDebugGLMessages(), and MsgHandler::writeDebugGLMessages().
|
staticprivateinherited |
Flag to enable or disable debug GL Functions.
This value is used to show more internal information throught warning messages about certain operations
Definition at line 257 of file MsgHandler.h.
Referenced by MsgHandler::enableDebugMessages(), and MsgHandler::writeDebugMessages().