/*
* InspIRCd -- Internet Relay Chat Daemon
*
* Copyright (C) 2019-2023, 2026 Sadie Powell <sadie@witchery.services>
* Copyright (C) 2013, 2015 Attila Molnar <attilamolnar@hush.com>
*
* This file is part of InspIRCd. InspIRCd 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, version 2.
*
* 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 General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include "service.h"
class CoreExport dynamic_reference_base
: public insp::intrusive_list_node<dynamic_reference_base>
{
public:
class CaptureHook
{
public:
/** Called when the target of the dynamic_reference has been acquired
*/
virtual void OnCapture() = 0;
};
private:
std::string service_name;
std::string service_type;
bool strict_ref;
CaptureHook* hook = nullptr;
void resolve();
static void* operator new(std::size_t) = delete;
static void* operator new[](std::size_t) = delete;
protected:
Service::Provider* value = nullptr;
public:
const WeakModulePtr creator;
dynamic_reference_base(const WeakModulePtr& mod, const std::string& stype, const std::string& sname, bool strict);
dynamic_reference_base(const dynamic_reference_base& other);
~dynamic_reference_base();
inline const auto& GetProviderName() const { return this->service_name; }
inline const auto& GetProviderType() const { return this->service_type; }
void ClearProviderName();
void SetProvider(const std::string& stype, const std::string& sname);
void SetProviderName(const std::string& sname);
dynamic_reference_base& operator=(const dynamic_reference_base& rhs)
{
SetProvider(rhs.GetProviderType(), rhs.GetProviderName());
return *this;
}
/** Set handler to call when the target object becomes available
* @param h Handler to call
*/
void SetCaptureHook(CaptureHook* h) { hook = h; }
void check();
operator bool() const { return (value != nullptr); }
static void reset_all(const std::string& stype = "");
};
inline void dynamic_reference_base::check()
{
if (!value)
{
throw ModuleException(creator, "Dynamic reference to {} {} failed to resolve. Are you missing a module?",
GetProviderType(), GetProviderName());
}
}
template<typename T>
class dynamic_reference
: public dynamic_reference_base
{
public:
dynamic_reference(const WeakModulePtr& mod, const std::string& stype, const std::string& sname = "", bool strict = false)
: dynamic_reference_base(mod, stype, sname, strict)
{
}
inline T* operator->()
{
check();
return static_cast<T*>(value);
}
T* operator*()
{
return operator->();
}
const T* operator->() const
{
return static_cast<T*>(value);
}
const T* operator*() const
{
return operator->();
}
};
template<typename T>
class dynamic_reference_nocheck
: public dynamic_reference_base
{
public:
dynamic_reference_nocheck(const WeakModulePtr& mod, const std::string& stype, const std::string& sname = "", bool strict = false)
: dynamic_reference_base(mod, stype, sname, strict)
{
}
T* operator->()
{
return static_cast<T*>(value);
}
T* operator*()
{
return operator->();
}
const T* operator->() const
{
return static_cast<T*>(value);
}
const T* operator*() const
{
return operator->();
}
};
class ModeHandler;
class ChanModeReference final
: public dynamic_reference_nocheck<ModeHandler>
{
public:
ChanModeReference(const WeakModulePtr& mod, const std::string& modename)
: dynamic_reference_nocheck<ModeHandler>(mod, "ModeHandler/C", modename, true)
{
}
};
class UserModeReference final
: public dynamic_reference_nocheck<ModeHandler>
{
public:
UserModeReference(const WeakModulePtr& mod, const std::string& modename)
: dynamic_reference_nocheck<ModeHandler>(mod, "ModeHandler/U", modename, true)
{
}
};