STK_DataHandlerBase.h

Go to the documentation of this file.

/*--------------------------------------------------------------------*/
/*     Copyright (C) 2004-2016  Serge Iovleff, Université Lille 1, Inria
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as
    published by the Free Software Foundation; either version 2 of the
    License, or (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Lesser General Public License for more details.
 
    You should have received a copy of the GNU Lesser General Public
    License along with this program; if not, write to the
    Free Software Foundation, Inc.,
    59 Temple Place,
    Suite 330,
    Boston, MA 02111-1307
    USA
 
    Contact : S..._Dot_I..._At_stkpp_Dot_org (see copyright for ...)
*/
 
/*
 * Project:  stkpp::DManager
 * created on: 15 nov. 2013
 * Author:   iovleff, S..._Dot_I..._At_stkpp_Dot_org (see copyright for ...)
 **/
 
#ifndef STK_DATAHANDLERBASE_H
#define STK_DATAHANDLERBASE_H
 
#include <map>
#include <Sdk.h>
 
namespace STK
{
namespace hidden
{
template<class DataHandler, typename Type> struct DataHandlerTraits;
 
} // namespace hidden
 
template<class Derived>
class DataHandlerBase: public IRecursiveTemplate<Derived>
{
  protected:
    DataHandlerBase() {}
 
  public:
    typedef std::map<std::string, std::string> InfoMap;
    inline ~DataHandlerBase() {}
    inline InfoMap const& info() const { return info_;}
    bool addInfo(std::string const& idData, std::string const& idModel);
    bool getIdModelName(std::string const& idData, std::string& idModel) const;
    void writeInfo(ostream& os) const;
 
  protected:
    InfoMap info_;
};
 
 
/* @brief Add an info descriptor to the data handler.
 *  An info descriptor is a pair that allow to say that all columns of
 *  the data set(s) handled by the data handler and having the name "idData"
 *  are modeled by the model with model "idModel".
 *  @param idData can be any string given by the user for identifying data.
 *  @param idModel represent the idModel of a given model (can be defined
 *  inside or outside STK++).
 *
 *  @note If the pair (idData, idModel) already exists then addInfo will do nothing.
 *  @return @c false if there exists already an idData matched with an other
 *  idModel, @c true otherwise.
 **/
template<class Derived>
bool DataHandlerBase<Derived>::addInfo(std::string const& idData, std::string const& idModel)
{
  // parse descriptor file
  std::pair<InfoMap::iterator,bool> ret;
  // check if identifer is already present
  ret = info_.insert(std::pair<std::string,std::string>(idData, idModel));
  // if name already exists, check if there is incoherence
  if (ret.second==false)
  {
     if (ret.first->second != idModel)
     {
#ifdef STK_DMANAGER_DEBUG
       stk_cerr << _T("In DataHandlerBase::addInfo, There exists an idData with a different idModel.\n");
#endif
       return false;
     }
  }
  return true;
}
 
/* @brief Giving a the Id of a dataset, find the Id of the model.
 *  @param idData can be any string given by the user.
 *  @param idModel The Id of the model associated with the data
 *  (not modified if idData is not present in the map).
 *  @return @c false if there exists already an idData matched with an other
 *  idModel, @c true otherwise.
 **/
template<class Derived>
bool DataHandlerBase<Derived>::getIdModelName(std::string const& idData, std::string& idModel) const
{
  bool res = false;
  // find idData
  InfoMap::const_iterator it = info_.find(idData);
  if (it != info_.end()) { idModel = it->second; res = true;}
  return res;
}
 
/* write  info on os */
template<class Derived>
void DataHandlerBase<Derived>::writeInfo(ostream& os) const
{
  // show content
  for (InfoMap::const_iterator it=info_.begin(); it!=info_.end(); ++it)
  os << _T("IdData: ") << it->first << _T(", IdModel: ") << it->second << _T('\n');
}
 
 
} // namespace STK
 
#endif /* STK_DATAHANDLERBASE_H */