kernel_object.hpp

FDMP the body of the kernel, the Information-Technology Promotion Agency (IPA) adopted by the unexpl

/*
 *  TOPPERS/FDMP Kernel
 *      Toyohashi Open Platform for Embedded Real-Time Systems/
 *      Function Distributed Multiprocessor Kernel
 *
 *  Copyright (C) 2005 by Takagi Nobuhisa
 * 
 *  忋婰挊嶌尃幰偼丆埲壓偺 (1)乣(4) 偺忦審偐丆Free Software Foundation 
 *  偵傛偭偰岞昞偝傟偰偄傞 GNU General Public License 偺 Version 2 偵婰
 *  弎偝傟偰偄傞忦審傪枮偨偡応崌偵尷傝丆杮僜僼僩僂僃傾乮杮僜僼僩僂僃傾
 *  傪夵曄偟偨傕偺傪娷傓丏埲壓摨偠乯傪巊梡丒暋惢丒夵曄丒嵞攝晍乮埲壓丆
 *  棙梡偲屇傇乯偡傞偙偲傪柍彏偱嫋戻偡傞丏
 *  (1) 杮僜僼僩僂僃傾傪僜乕僗僐乕僪偺宍偱棙梡偡傞応崌偵偼丆忋婰偺挊嶌
 *      尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕偑丆偦偺傑傑偺宍偱僜乕
 *      僗僐乕僪拞偵娷傑傟偰偄傞偙偲丏
 *  (2) 杮僜僼僩僂僃傾傪丆儔僀僽儔儕宍幃側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒傞宍偱嵞攝晍偡傞応崌偵偼丆嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡
 *      幰儅僯儏傾儖側偳乯偵丆忋婰偺挊嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰
 *      偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *  (3) 杮僜僼僩僂僃傾傪丆婡婍偵慻傒崬傓側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒側偄宍偱嵞攝晍偡傞応崌偵偼丆師偺偄偢傟偐偺忦審傪枮偨偡偙
 *      偲丏
 *    (a) 嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡幰儅僯儏傾儖側偳乯偵丆忋婰偺挊
 *        嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *    (b) 嵞攝晍偺宍懺傪丆暿偵掕傔傞曽朄偵傛偭偰丆TOPPERS僾儘僕僃僋僩偵
 *        曬崘偡傞偙偲丏
 *  (4) 杮僜僼僩僂僃傾偺棙梡偵傛傝捈愙揑傑偨偼娫愙揑偵惗偠傞偄偐側傞懝
 *      奞偐傜傕丆忋婰挊嶌尃幰偍傛傃TOPPERS僾儘僕僃僋僩傪柶愑偡傞偙偲丏
 * 
 *  杮僜僼僩僂僃傾偼丆柍曐徹偱採嫙偝傟偰偄傞傕偺偱偁傞丏忋婰挊嶌尃幰偍
 *  傛傃TOPPERS僾儘僕僃僋僩偼丆杮僜僼僩僂僃傾偵娭偟偰丆偦偺揔梡壜擻惈傕
 *  娷傔偰丆偄偐側傞曐徹傕峴傢側偄丏傑偨丆杮僜僼僩僂僃傾偺棙梡偵傛傝捈
 *  愙揑傑偨偼娫愙揑偵惗偠偨偄偐側傞懝奞偵娭偟偰傕丆偦偺愑擟傪晧傢側偄丏
 * 
 */

/*!
 *  \file   toppers/itron/kernel_object.hpp
 *  \brief  僇乕僱儖僆僽僕僃僋僩偵娭偡傞愰尵掕媊
 *
 *  偙偺僼傽僀儖偱掕媊偝傟傞僋儔僗
 *  \code
 *  class kernel_object;
 *  \endcode
 */
#ifndef TOPPERS_KERNEL_OBJECT_HPP_
#define TOPPERS_KERNEL_OBJECT_HPP_

#include "toppers/itron/cfg_kernel_id.hpp"
#include "toppers/itron/cfg_kernel_cfg.hpp"

namespace toppers
{
  namespace itron
  {

    class static_api;

    /*!
     *  \class  kernel_object kernel_object.hpp "toppers/itron/kernel_object.hpp"
     *  \brief  僇乕僱儖僆僽僕僃僋僩娗棟僋儔僗
     */
    class kernel_object
    {
    public:
      typedef boost::shared_ptr<kernel_cfg::initial_block> inib_ptr;
      typedef boost::shared_ptr<kernel_id::id_number> idb_ptr;
      typedef std::map<std::string, std::string> arg_type;
      typedef const boost::shared_ptr<kernel_object> ( *builder_type )( const static_api&, std::vector<boost::shared_ptr<kernel_object> >& );

      /*!
       *  \brief  僨僼僅儖僩僐儞僗僩儔僋僞
       */
      kernel_object() : id_( -1L ) {}
      /*!
       *  \brief  僨僗僩儔僋僞
       */
      virtual ~kernel_object() {}

      /*!
       *  \brief  弶婜壔僽儘僢僋忣曬偺庢摼
       *  \return 弶婜壔僽儘僢僋忣曬傊偺僗儅乕僩億僀儞僞傪曉偡
       */
      const inib_ptr get_inib() const { return do_get_inib(); }
      /*!
       *  \brief  ID斣崋忣曬偺庢摼
       *  \return ID斣崋忣曬傊偺僗儅乕僩億僀儞僞傪曉偡
       */
      const idb_ptr get_idb() const { return do_get_idb(); }
      const char* get_object_type() const { return do_get_object_type(); }
      bool has_id() const { return do_has_id(); }

      /*!
       *  \brief  ID斣崋偺庢摼
       *  \return ID斣崋傪曉偡
       */
      long id() const { return id_; }
      /*!
       *  \brief  僆僽僕僃僋僩柤偺庢摼
       *  \return 僆僽僕僃僋僩柤傪曉偡
       */
      const std::string& name() const { return name_; }
      const std::string& get( const std::string& key ) const;
      void set( const std::string& key, const std::string& value );

      /*!
       *  \brief  惷揑API偺夝愅
       *  \param  api   惷揑API偺僷儔儊乕僞忣曬
       *  \return 夝愅偵惉岟偡傟偽 true 傪曉偡
       */
      bool analyze( const static_api& api ) { return do_analyze( api ); }
      bool analyze_id( const std::string& arg );
      bool analyze_parameters( const static_api& api, const std::string& parameters );

      void swap( kernel_object& other ) throw();

      /*!
       *  \brief  ID斣崋偵帺摦妱晅偗
       *  \param  first   kernel_object 僐儞僥僫偺愭摢埵抲
       *  \param  last    kernel_object 僐儞僥僫偺廔抂埵抲+1
       *  \return ID斣崋偺妱晅偗偵惉岟偡傟偽 true 傪曉偡
       */
      template <class Iterator>
      static bool assign_id( Iterator first, Iterator last )
      {
        typedef std::vector<kernel_object*> vector_t;
        typedef std::map<std::string, vector_t> map_t;
        map_t map;
        for ( Iterator iter( first ); iter != last; ++iter )
        {
          std::string key( ( *iter )->get_object_type() );
          kernel_object* ptr = &**iter;
          map[key].push_back( ptr );
        }
        for ( map_t::const_iterator iter2( map.begin() ), last2( map.end() ); iter2 != last2; ++iter2 )
        {
          if ( !iter2->second.empty() && iter2->second.front()->has_id() )  // ID斣崋妱晅偑昁梫側応崌偵尷傞
          {
            if ( !assign_id_helper( iter2->second.begin(), iter2->second.end() ) )
            {
              return false;
            }
          }
        }
        return true;
      }

    protected:
      virtual bool do_analyze( const static_api& api ) = 0;
      virtual const inib_ptr do_get_inib() const;
      virtual const idb_ptr do_get_idb() const;
      virtual const char* do_get_object_type() const = 0;
      virtual bool do_has_id() const = 0;
      virtual bool do_check_id_range( long id ) const = 0;

      static bool assign_id_helper( std::vector<kernel_object*>::const_iterator first, std::vector<kernel_object*>::const_iterator last );
    private:
      long id_;
      std::string name_;
      arg_type args_;
    };

  }
}

#endif  // ! TOPPERS_KERNEL_OBJECT_HPP_