urho3d/Engine/Core/Object.cpp

//
// Urho3D Engine
// Copyright (c) 2008-2012 Lasse Öörni
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
//

#include "Precompiled.h"
#include "Context.h"
#include "HashSet.h"

#include "DebugNew.h"

Object::Object(Context* context) :
    context_(context)
{
    assert(context_);
}

Object::~Object()
{
    UnsubscribeFromAllEvents();
    context_->RemoveEventSender(this);
}

void Object::OnEvent(Object* sender, bool broadcast, StringHash eventType, VariantMap& eventData)
{
    // Make a copy of the context pointer in case the object is destroyed during event handler invocation
    Context* context = context_;
    
    // Check first the specific event handlers, which have priority
    Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::ConstIterator i = eventHandlers_.Find(
        MakePair(sender, eventType));
    if (i != eventHandlers_.End())
    {
        context->SetEventHandler(i->second_);
        i->second_->Invoke(eventType, eventData);
        context->SetEventHandler(0);
        return;
    }
    
    // Then check non-specific (null sender pointer)
    i = eventHandlers_.Find(MakePair((Object*)0, eventType));
    if (i != eventHandlers_.End())
    {
        context->SetEventHandler(i->second_);
        i->second_->Invoke(eventType, eventData);
        context->SetEventHandler(0);
    }
}

void Object::SubscribeToEvent(StringHash eventType, EventHandler* handler)
{
    if (!handler)
        return;
    
    Pair<Object*, StringHash> combination((Object*)0, eventType);
    
    eventHandlers_[combination] = handler;
    context_->AddEventReceiver(this, eventType);
}

void Object::SubscribeToEvent(Object* sender, StringHash eventType, EventHandler* handler)
{
    if (!sender || !handler)
        return;
    
    Pair<Object*, StringHash> combination(sender, eventType);
    
    eventHandlers_[combination] = handler;
    context_->AddEventReceiver(this, sender, eventType);
}

void Object::UnsubscribeFromEvent(StringHash eventType)
{
    for (Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Begin();
        i != eventHandlers_.End();)
    {
        Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator current = i++;
        if (current->first_.second_ == eventType)
        {
            if (current->first_.first_)
                context_->RemoveEventReceiver(this, current->first_.first_, current->first_.second_);
            else
                context_->RemoveEventReceiver(this, current->first_.second_);
            eventHandlers_.Erase(current);
        }
    }
}

void Object::UnsubscribeFromEvent(Object* sender, StringHash eventType)
{
    Pair<Object*, StringHash> combination(sender, eventType);
    
    Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Find(combination);
    if (i != eventHandlers_.End())
    {
        context_->RemoveEventReceiver(this, i->first_.first_, i->first_.second_);
        eventHandlers_.Erase(i);
    }
}

void Object::UnsubscribeFromEvents(Object* sender)
{
    if (!sender)
        return;
    
    for (Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Begin();
        i != eventHandlers_.End();)
    {
        Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator current = i++;
        if (current->first_.first_ == sender)
        {
            context_->RemoveEventReceiver(this, current->first_.first_, current->first_.second_);
            eventHandlers_.Erase(current);
        }
    }
}

void Object::UnsubscribeFromAllEvents()
{
    for (Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Begin();
        i != eventHandlers_.End(); ++i)
    {
        if (i->first_.first_)
            context_->RemoveEventReceiver(this, i->first_.first_, i->first_.second_);
        else
            context_->RemoveEventReceiver(this, i->first_.second_);
    }
    
    eventHandlers_.Clear();
}

void Object::UnsubscribeFromAllEventsWithUserData()
{
    for (Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Begin();
        i != eventHandlers_.End(); )
    {
        if (i->second_->GetUserData())
        {
            Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator current = i++;
            if (current->first_.first_)
                context_->RemoveEventReceiver(this, current->first_.first_, current->first_.second_);
            else
                context_->RemoveEventReceiver(this, current->first_.second_);
            eventHandlers_.Erase(current);
        }
        else
            ++i;
    }
}

void Object::SendEvent(StringHash eventType)
{
    VariantMap noEventData;
    
    SendEvent(eventType, noEventData);
}

void Object::SendEvent(StringHash eventType, VariantMap& eventData)
{
    // Make a weak pointer to self to check for destruction during event handling
    WeakPtr<Object> self(this);
    Context* context = context_;
    HashSet<Object*> processed;
    
    context->BeginSendEvent(this);
    
    // Check first the specific event receivers
    const Set<Object*>* group = context->GetEventReceivers(this, eventType);
    if (group)
    {
        for (Set<Object*>::ConstIterator i = group->Begin(); i != group->End();)
        {
            Set<Object*>::ConstIterator current = i++;
            Object* receiver = *current;
            Object* next = 0;
            if (i != group->End())
                next = *i;
            
            unsigned oldSize = group->Size();
            receiver->OnEvent(this, true, eventType, eventData);
            
            // If self has been destroyed as a result of event handling, exit
            if (self.Expired())
            {
                context->EndSendEvent();
                return;
            }
            
            // If group has changed size during iteration (removed/added subscribers) try to recover
            /// \todo This is not entirely foolproof, as a subscriber could have been added to make up for the removed one
            if (group->Size() != oldSize)
                i = group->Find(next);
            
            processed.Insert(receiver);
        }
    }
    
    // Then the non-specific receivers
    group = context->GetEventReceivers(eventType);
    if (group)
    {
        if (processed.Empty())
        {
            for (Set<Object*>::ConstIterator i = group->Begin(); i != group->End();)
            {
                Set<Object*>::ConstIterator current = i++;
                Object* receiver = *current;
                Object* next = 0;
                if (i != group->End())
                    next = *i;
                
                unsigned oldSize = group->Size();
                receiver->OnEvent(this, true, eventType, eventData);
                
                if (self.Expired())
                {
                    context->EndSendEvent();
                    return;
                }
                
                if (group->Size() != oldSize)
                    i = group->Find(next);
            }
        }
        else
        {
            // If there were specific receivers, check that the event is not sent doubly to them
            for (Set<Object*>::ConstIterator i = group->Begin(); i != group->End();)
            {
                Set<Object*>::ConstIterator current = i++;
                Object* receiver = *current;
                Object* next = 0;
                if (i != group->End())
                    next = *i;
                
                if (!processed.Contains(receiver))
                {
                    unsigned oldSize = group->Size();
                    receiver->OnEvent(this, true, eventType, eventData);
                    
                    if (self.Expired())
                    {
                        context->EndSendEvent();
                        return;
                    }
                    
                    if (group->Size() != oldSize)
                        i = group->Find(next);
                }
            }
        }
    }
    
    context->EndSendEvent();
}

void Object::SendEvent(Object* receiver, StringHash eventType)
{
    if (receiver)
    {
        VariantMap noEventData;
        Context* context = context_;
        
        context->BeginSendEvent(this);
        receiver->OnEvent(this, false, eventType, noEventData);
        context->EndSendEvent();
    }
}

void Object::SendEvent(Object* receiver, StringHash eventType, VariantMap& eventData)
{
    if (receiver)
    {
        Context* context = context_;
        
        context->BeginSendEvent(this);
        receiver->OnEvent(this, false, eventType, eventData);
        context->EndSendEvent();
    }
}

Object* Object::GetSubsystem(ShortStringHash type) const
{
    return context_->GetSubsystem(type);
}

Object* Object::GetEventSender() const
{
    return context_->GetEventSender();
}

EventHandler* Object::GetEventHandler() const
{
    return context_->GetEventHandler();
}

bool Object::HasSubscribedToEvent(StringHash eventType) const
{
    return eventHandlers_.Find(MakePair((Object*)0, eventType)) != eventHandlers_.End();
}

bool Object::HasSubscribedToEvent(Object* sender, StringHash eventType) const
{
    return eventHandlers_.Find(MakePair(sender, eventType)) != eventHandlers_.End();
}

void Object::RemoveEventSender(Object* sender)
{
    for (Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator i = eventHandlers_.Begin();
        i != eventHandlers_.End();)
    {
        Map<Pair<Object*, StringHash>, SharedPtr<EventHandler> >::Iterator current = i++;
        if (current->first_.first_ == sender)
            eventHandlers_.Erase(current);
    }
}