-// ANNA - Anna is Not Nothingness Anymore
-//
-// (c) Copyright 2005-2014 Eduardo Ramos Testillano & Francisco Ruiz Rayo
-//
-// http://redmine.teslayout.com/projects/anna-suite
-//
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions
-// are met:
-//
-// * Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-// * Redistributions in binary form must reproduce the above
-// copyright notice, this list of conditions and the following disclaimer
-// in the documentation and/or other materials provided with the
-// distribution.
-// * Neither the name of the copyright holder nor the names of its
-// contributors may be used to endorse or promote products derived from
-// this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-//
-// Authors: eduardo.ramos.testillano@gmail.com
-// cisco.tierra@gmail.com
+// ANNA - Anna is Not Nothingness Anymore //
+// //
+// (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo //
+// //
+// See project site at http://redmine.teslayout.com/projects/anna-suite //
+// See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE //
#ifndef anna_statistics_Engine_hpp
#include <anna/core/Singleton.hpp>
#include <anna/core/util/Millisecond.hpp>
+#include <anna/core/RuntimeException.hpp>
+#include <anna/core/mt/Mutex.hpp>
// Standard
#include <string>
namespace statistics {
+class Accumulator;
+
+
typedef struct {
std::string SampleFile; // Sample file to optional writtings
typedef std::map <int, _concept_identification_t>::const_iterator _concept_identification_map_iter;
typedef std::map <int, _concept_identification_t>::iterator _concept_identification_map_nc_iter;
+typedef std::map <std::string, Accumulator*> _accumulator_map_t;
+typedef std::map <std::string, Accumulator*>::const_iterator _accumulator_map_it;
+typedef std::map <std::string, Accumulator*>::iterator _accumulator_map_nc_it;
/**
public:
+ /** Destructor */
+ ~Engine();
+
// Sets
/**
/**
* Disable sample log for statistics processings
*
- * @param id Concept identification.
+ * @param id Concept identification. If -1 value is provided, all concepts will be deactivated.
*
* @return @em false if not concept is registered with provided id
+ * @warning Many systems add concepts dynamically. This method only affects to current concepts registered at statistics engine.
*/
- bool disableSampleLog(const int & id) throw();
+ bool disableSampleLog(const int & id = -1) throw();
// Gets
bool enabled(void) const throw() { return (a_enabled); }
+ /**
+ * Creates a statistic accumulator
+ *
+ * @param name Accumulator name
+ *
+ * \return The accumulator created or exception when already exists for the provided name.
+ */
+ Accumulator *createAccumulator(const std::string &name) throw(anna::RuntimeException);
+
+ /**
+ * Returns accumulator instance identified by name.
+ *
+ * \param name Accumulator name
+ *
+ * \return The accumulator instance identified by name provided, NULL if not found
+ */
+ Accumulator* getAccumulator(const std::string &name) throw();
+
+
+
/**
* Class string representation
*
Engine(); // private constructor
_concept_identification_map_t a_concept_identification_map;
+ _accumulator_map_t a_accumulators; // you could create accumulators regardless the engine, but this is easier and asXML will show all the information easily
bool a_enabled;
int a_sequence_concept_id;
+ anna::Mutex a_mutex; // for logSample
bool logSample(const int & conceptId, const anna::Millisecond & unixTimestamp, const double & value) const throw();