AAbstractSignal.h

/*
 * AUI Framework - Declarative UI toolkit for modern C++20
 * Copyright (C) 2020-2025 Alex2772 and Contributors
 *
 * SPDX-License-Identifier: MPL-2.0
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
 
#pragma once
 
#include <exception>
 
#include <AUI/Core.h>
#include <AUI/Common/SharedPtrTypes.h>
#include <AUI/Traits/values.h>
 
class AObject;


class API_AUI_CORE AAbstractSignal {
   friend class AObject;
 
public:
   virtual ~AAbstractSignal() = default;

   struct Connection {
       friend class API_AUI_CORE AObjectBase;
       virtual void disconnect() = 0;
 
   private:
       virtual void onBeforeReceiverSideDestroyed() = 0;
   };

   struct AutoDestroyedConnection {
       _<Connection> value = nullptr;
 
       AutoDestroyedConnection() = default;
       AutoDestroyedConnection(_<Connection> connection) noexcept : value(std::move(connection)) {}
       AutoDestroyedConnection(const AutoDestroyedConnection&) = default;
       AutoDestroyedConnection(AutoDestroyedConnection&&) noexcept = default;
 
       AutoDestroyedConnection& operator=(_<Connection> rhs) noexcept {
           if (value == rhs) {
               return *this;
           }
           release();
           value = std::move(rhs);
           return *this;
       }
 
       AutoDestroyedConnection& operator=(const AutoDestroyedConnection& rhs) {
           return operator=(rhs.value);
       }
 
       AutoDestroyedConnection& operator=(AutoDestroyedConnection&& rhs) noexcept {
           return operator=(std::move(rhs.value));
       }
 
       ~AutoDestroyedConnection() {
           release();
       }
 
   private:
       void release() noexcept {
           if (!value) {
               return;
           }
           value->disconnect();
       }
   };

   virtual void clearAllOutgoingConnections() const noexcept = 0;

   virtual void clearAllOutgoingConnectionsWith(aui::no_escape<AObjectBase> receiver) const noexcept = 0;

   virtual bool hasOutgoingConnectionsWith(aui::no_escape<AObjectBase> receiver) const noexcept = 0;

   virtual _<Connection> addGenericObserver(AObjectBase* receiver, std::function<void()> observer) = 0;
 
protected:
   /* some handy functions accessed from public headers */
 
   static _weak<AObject> weakPtrFromObject(AObject* object);

   static void addIngoingConnectionIn(aui::no_escape<AObjectBase> object, _<Connection> connection);

   static void removeIngoingConnectionIn(aui::no_escape<AObjectBase> object, Connection& connection, std::unique_lock<ASpinlockMutex>& lock);
};

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.