ai/composite/aspect.hpp

Go to the documentation of this file.

/* $Id: aspect.hpp 52533 2012-01-07 02:35:17Z shadowmaster $ */
/*
   Copyright (C) 2009 - 2012 by Yurii Chernyi <terraninfo@terraninfo.net>
   Part of the Battle for Wesnoth Project http://www.wesnoth.org/

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU 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.

   See the COPYING file for more details.
*/

/**
 * @file
 */

#ifndef AI_COMPOSITE_ASPECT_HPP_INCLUDED
#define AI_COMPOSITE_ASPECT_HPP_INCLUDED

#include "property_handler.hpp"
#include "value_translator.hpp"
#include "../lua/lua_object.hpp"
#include "../lua/core.hpp"
#include "../../scripting/lua.hpp"

#include "../../log.hpp"

#include <boost/bind.hpp>
#include <boost/lexical_cast.hpp>
#include <boost/pointer_cast.hpp>

#ifdef _MSC_VER
#pragma warning(push)
//silence "inherits via dominance" warnings
#pragma warning(disable:4250)
#endif

namespace ai {

class aspect : public readonly_context_proxy, public events::observer, public component {
public:
    aspect(readonly_context &context, const config &cfg, const std::string &id);

    virtual ~aspect();

    void invalidate() const
    {
        valid_ = false;
        valid_variant_ = false;
        valid_lua_ = false;
    }


    virtual const variant& get_variant() const = 0;


    virtual boost::shared_ptr<variant> get_variant_ptr() const = 0;


    virtual void recalculate() const = 0;


    virtual void on_create();


    virtual bool redeploy(const config &cfg, const std::string & id);


    virtual config to_config() const;


    virtual bool delete_all_facets();


    void handle_generic_event(const std::string &/*event_name*/)
    {
        invalidate();
    }


    virtual bool active() const
    {
        return true;
    }

    virtual std::string get_name() const
    { return name_; }

    virtual std::string get_id() const
    { return id_; }

    virtual std::string get_engine() const
    { return engine_; }

    static lg::log_domain& log();

protected:
    mutable bool valid_;
    mutable bool valid_variant_;
    mutable bool valid_lua_;

    config cfg_;
    bool invalidate_on_turn_start_;
    bool invalidate_on_tod_change_;
    bool invalidate_on_gamestate_change_;
    bool invalidate_on_minor_gamestate_change_;
    std::string engine_;
    std::string name_;
    std::string id_;

};

template<typename T>
class typesafe_aspect : public aspect {
public:
    typesafe_aspect(readonly_context &context, const config &cfg, const std::string &id)
        : aspect(context,cfg,id)
        , value_()
        , value_variant_()
        , value_lua_()
    {
    }

    virtual ~typesafe_aspect()
    {
    }


    virtual const T& get() const
    {
        return *get_ptr();
    }


    virtual const variant& get_variant() const
    {
        return *get_variant_ptr();
    }

    virtual boost::shared_ptr<variant> get_variant_ptr() const
    {
        if (!valid_variant_) {
            if (!valid_) {
                recalculate();
            }

            if (!valid_variant_ && valid_ ) {
                value_variant_ = boost::shared_ptr<variant>(new variant(variant_value_translator<T>::value_to_variant(this->get())));
                valid_variant_ = true;
            } else if (!valid_variant_ && valid_lua_) {
                value_ = value_lua_->get();
                value_variant_ = boost::shared_ptr<variant>(new variant(variant_value_translator<T>::value_to_variant(this->get())));
                valid_variant_ = true; // @note: temporary workaround
            } else {
                assert(valid_variant_);
            }
        }
        return value_variant_;
    }

    virtual void recalculate() const = 0;


    virtual boost::shared_ptr<T> get_ptr() const
    {
        if (!valid_) {
            if (!(valid_variant_ || valid_lua_)) {
                recalculate();
            }

            if (!valid_ ) {
                if (valid_variant_) {
                    value_ = boost::shared_ptr<T>(new T(variant_value_translator<T>::variant_to_value(get_variant())));
                    valid_ = true;
                } else if (valid_lua_){
                    value_ = value_lua_->get();
                    valid_ = true;
                } else {
                    assert(valid_);
                }
            }
        }
        return value_;
    }

protected:
    mutable boost::shared_ptr<T> value_;
    mutable boost::shared_ptr<variant> value_variant_;
    mutable boost::shared_ptr< lua_object<T> > value_lua_;
};


class known_aspect {
public:
    known_aspect(const std::string &name);


    virtual ~known_aspect();


    virtual void set(aspect_ptr a) = 0;


    virtual void add_facet(const config &cfg) = 0;


    const std::string& get_name() const;

protected:
    const std::string name_;
};


template<class T>
class composite_aspect;

template<typename T>
class typesafe_known_aspect : public known_aspect {
public:
    typesafe_known_aspect(const std::string &name, boost::shared_ptr< typesafe_aspect<T> > &where, aspect_map &aspects)
    : known_aspect(name), where_(where), aspects_(aspects)
    {
    }

    void set(aspect_ptr a)
    {
        boost::shared_ptr< typesafe_aspect <T> > c = boost::dynamic_pointer_cast< typesafe_aspect<T> >(a);
        if (c) {
            assert (c->get_id()== this->get_name());
            where_ = c;
            aspects_.insert(make_pair(this->get_name(),c));
        } else {
            LOG_STREAM(debug, aspect::log()) << "typesafe_known_aspect [" << this->get_name() << "] : while setting aspect, got null. this might be caused by invalid [aspect] WML" << std::endl;
        }
    }

    virtual void add_facet(const config &cfg)
    {
        boost::shared_ptr< composite_aspect <T> > c = boost::dynamic_pointer_cast< composite_aspect<T> >(where_);
        if (c) {
            assert (c->get_id()==this->get_name());
            c->add_facet(-1, cfg);
            c->invalidate();
        } else {
            LOG_STREAM(debug, aspect::log()) << "typesafe_known_aspect [" << this->get_name() << "] : while adding facet to aspect, got null. this might be caused by target [aspect] being not composite" << std::endl;
        }
    }

protected:
    boost::shared_ptr<typesafe_aspect <T> > &where_;
    aspect_map &aspects_;

};


template<typename T>
class composite_aspect : public typesafe_aspect<T> {
public:

    composite_aspect(readonly_context &context, const config &cfg, const std::string &id)
        : typesafe_aspect<T>(context, cfg, id)
        , facets_()
        , default_()
    {
        foreach (const config &cfg_element, this->cfg_.child_range("facet") ){
            add_facet(-1,cfg_element);
        }

        const config &_default = this->cfg_.child("default");
        if (_default) {
            std::vector< aspect_ptr > default_aspects;
            engine::parse_aspect_from_config(*this,_default,this->get_id(),std::back_inserter(default_aspects));
            if (!default_aspects.empty()) {
                typename aspect_type<T>::typesafe_ptr b = boost::dynamic_pointer_cast< typesafe_aspect<T> >(default_aspects.front());
                default_ = b;
            }
        }

        boost::function2<void, typename aspect_type<T>::typesafe_ptr_vector&, const config&> factory_facets =
                        boost::bind(&ai::composite_aspect<T>::create_facet,*this,_1,_2);

                register_vector_property(this->property_handlers(),"facet",facets_, factory_facets);

    }


    void create_facet(  typename aspect_type<T>::typesafe_ptr_vector &facets, const config &cfg)
        {
        std::vector<aspect_ptr> facets_base;
        engine::parse_aspect_from_config(*this,cfg,this->get_id(),std::back_inserter(facets_base));
        foreach (aspect_ptr a, facets_base ){
            typename aspect_type<T>::typesafe_ptr b = boost::dynamic_pointer_cast< typesafe_aspect<T> > (a);
            facets.push_back(b);
        }
        }


    virtual void recalculate() const
    {
        ///@todo 1.9 optimize in case of an aspect which returns variant
        foreach (const typename aspect_type<T>::typesafe_ptr &f, make_pair(facets_.rbegin(),facets_.rend())) {
            if (f->active()) {
                this->value_ = boost::shared_ptr<T>(f->get_ptr());
                this->valid_ = true;
                return;
            }
        }
        this->value_ = boost::shared_ptr<T>(default_->get_ptr());
        this->valid_ = true;
    }


    virtual config to_config() const
    {
        config cfg = aspect::to_config();
        foreach (const typename aspect_type<T>::typesafe_ptr f, facets_) {
            cfg.add_child("facet",f->to_config());
        }
        if (default_) {
            cfg.add_child("default",default_->to_config());
        }
        return cfg;
    }


    virtual bool add_facet(int pos, const config &cfg)
    {
        if (pos<0) {
            pos = facets_.size();
        }
        std::vector< aspect_ptr > facets;
        engine::parse_aspect_from_config(*this,cfg,this->get_id(),std::back_inserter(facets));
        int j=0;
        foreach (aspect_ptr a, facets ){
            typename aspect_type<T>::typesafe_ptr b = boost::dynamic_pointer_cast< typesafe_aspect<T> > (a);
            facets_.insert(facets_.begin()+pos+j,b);
            j++;
        }
        return (j>0);
    }


    virtual bool delete_all_facets()
    {
        bool b = !facets_.empty();
        facets_.clear();
        return b;
    }

protected:
    typename aspect_type<T>::typesafe_ptr_vector facets_;
    typename aspect_type<T>::typesafe_ptr default_;

};

template<typename T>
class standard_aspect : public typesafe_aspect<T> {
public:
    standard_aspect(readonly_context &context, const config &cfg, const std::string &id)
        : typesafe_aspect<T>(context, cfg, id), time_of_day_(cfg["time_of_day"]),turns_(cfg["turns"])
    {
        boost::shared_ptr<T> value(new T(config_value_translator<T>::cfg_to_value(this->cfg_)));
        this->value_= value;
        LOG_STREAM(debug, aspect::log()) << "standard aspect has time_of_day=["<<time_of_day_<<"], turns=["<<turns_<<"], and value: "<< std::endl << config_value_translator<T>::value_to_cfg(this->get()) << std::endl;
    }


    virtual bool active() const
    {
        return this->is_active(time_of_day_,turns_);
    }


    void recalculate() const
    {
        //nothing to recalculate
        this->valid_ = true;
    }


    config to_config() const
    {
        config cfg = aspect::to_config();
        config_value_translator<T>::value_to_cfg(this->get(),cfg);
        cfg["time_of_day"] = time_of_day_;
        cfg["turns"] = turns_;
        return cfg;
    }

protected:
    std::string time_of_day_;
    std::string turns_;

};

template<typename T>
class lua_aspect : public typesafe_aspect<T>
{
public:
    lua_aspect(readonly_context &context, const config &cfg, const std::string &id, boost::shared_ptr<lua_ai_context>& l_ctx)
        : typesafe_aspect<T>(context, cfg, id)
        , handler_(), code_()
    {
        std::string value;
        if (cfg.has_attribute("value"))
        {
            value = cfg["value"].str();
            if (value == "yes") /** @todo for Nephro or Crab: get rid of this workaround */
            {
                value = "true";
            }
            value = "return " + value;
        }
        else if (cfg.has_attribute("code"))
        {
            value = cfg["code"].str();
        }
        else
        {
            // error
            return;
        }
        code_ = value;
        handler_ = boost::shared_ptr<lua_ai_action_handler>(resources::lua_kernel->create_lua_ai_action_handler(value.c_str(), *l_ctx));
    }

    void recalculate() const
    {
        this->valid_lua_ = true;
        boost::shared_ptr< lua_object<T> > l_obj = boost::shared_ptr< lua_object<T> >(new lua_object<T>());
        config c = config();
        handler_->handle(c, true, l_obj);
        this->value_lua_ = l_obj;
    }

    config to_config() const
    {
        config cfg = aspect::to_config();
        cfg["code"] = code_;
        return cfg;
    }

private:
    boost::shared_ptr<lua_ai_action_handler> handler_;
    std::string code_;
};


class aspect_factory{
public:
    typedef boost::shared_ptr< aspect_factory > factory_ptr;
    typedef std::map<std::string, factory_ptr> factory_map;
    typedef std::pair<const std::string, factory_ptr> factory_map_pair;

    static factory_map& get_list() {
        static factory_map *aspect_factories;
        if (aspect_factories==NULL) {
            aspect_factories = new factory_map;
        }
        return *aspect_factories;
    }

    virtual aspect_ptr get_new_instance( readonly_context &context, const config &cfg, const std::string &id) = 0;

    aspect_factory( const std::string &name )
    {
        factory_ptr ptr_to_this(this);
        get_list().insert(make_pair(name,ptr_to_this));
    }

    virtual ~aspect_factory() {}
};


template<class ASPECT>
class register_aspect_factory : public aspect_factory {
public:
    register_aspect_factory( const std::string &name )
        : aspect_factory( name )
    {
    }

    aspect_ptr get_new_instance( readonly_context &context, const config &cfg, const std::string &id)
    {
        boost::shared_ptr<ASPECT> _a(new ASPECT(context,cfg,id));
        aspect_ptr a = _a;
        a->on_create();
        return a;
    }
};

class lua_aspect_factory{
public:
    typedef boost::shared_ptr< lua_aspect_factory > factory_ptr;
    typedef std::map<std::string, factory_ptr> factory_map;
    typedef std::pair<const std::string, factory_ptr> factory_map_pair;

    static factory_map& get_list() {
        static factory_map *aspect_factories;
        if (aspect_factories==NULL) {
            aspect_factories = new factory_map;
        }
        return *aspect_factories;
    }

    virtual aspect_ptr get_new_instance( readonly_context &context, const config &cfg, const std::string &id, boost::shared_ptr<lua_ai_context>& l_ctx) = 0;

    lua_aspect_factory( const std::string &name )
    {
        factory_ptr ptr_to_this(this);
        get_list().insert(make_pair(name,ptr_to_this));
    }

    virtual ~lua_aspect_factory() {}
};

template<class ASPECT>
class register_lua_aspect_factory : public lua_aspect_factory {
public:
    register_lua_aspect_factory( const std::string &name )
        : lua_aspect_factory( name )
    {
    }

    aspect_ptr get_new_instance( readonly_context &context, const config &cfg, const std::string &id, boost::shared_ptr<lua_ai_context>& l_ctx)
    {
        boost::shared_ptr<ASPECT> _a(new ASPECT(context,cfg,id,l_ctx));
        aspect_ptr a = _a;
        a->on_create();
        return a;
    }
};


} //end of namespace ai

#ifdef _MSC_VER
#pragma warning(pop)
#endif

#endif