Initial import

src/libs/aggregation/aggregate.h

@@ -0,0 +1,134 @@
+/***************************************************************************
+**
+** This file is part of Qt Creator
+**
+** Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
+**
+** Contact:  Qt Software Information (qt-info@nokia.com)
+**
+** 
+** Non-Open Source Usage  
+** 
+** Licensees may use this file in accordance with the Qt Beta Version
+** License Agreement, Agreement version 2.2 provided with the Software or,
+** alternatively, in accordance with the terms contained in a written
+** agreement between you and Nokia.  
+** 
+** GNU General Public License Usage 
+** 
+** Alternatively, this file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the packaging
+** of this file.  Please review the following information to ensure GNU
+** General Public Licensing requirements will be met:
+**
+** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
+** http://www.gnu.org/copyleft/gpl.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt GPL Exception version
+** 1.2, included in the file GPL_EXCEPTION.txt in this package.  
+** 
+***************************************************************************/
+#ifndef QAGGREGATION_H
+#define QAGGREGATION_H
+
+#include "aggregation_global.h"
+
+#include <QtCore/QObject>
+#include <QtCore/QList>
+#include <QtCore/QHash>
+#include <QtCore/QReadWriteLock>
+#include <QtCore/QReadLocker>
+
+namespace Aggregation {
+
+class AGGREGATION_EXPORT Aggregate : public QObject
+{
+    Q_OBJECT
+
+public:
+    Aggregate(QObject *parent = 0);
+    virtual ~Aggregate();
+
+    void add(QObject *component);
+    void remove(QObject *component);
+
+    template <typename T> T *component() {
+        QReadLocker(&lock());
+        foreach (QObject *component, m_components) {
+            if (T *result = qobject_cast<T *>(component))
+                return result;
+        }
+        return (T *)0;
+    }
+
+    template <typename T> QList<T *> components() {
+        QReadLocker(&lock());
+        QList<T *> results;
+        foreach (QObject *component, m_components) {
+            if (T *result = qobject_cast<T *>(component)) {
+                results << result;
+            }
+        }
+        return results;
+    }
+
+    static Aggregate *parentAggregate(QObject *obj);
+    static QReadWriteLock &lock();
+
+private slots:
+    void deleteSelf(QObject *obj);
+
+private:
+    static QHash<QObject *, Aggregate *> &aggregateMap();
+
+    QList<QObject *> m_components;
+};
+
+// get a component via global template function
+template <typename T> T *query(Aggregate *obj)
+{
+    if (!obj)
+        return (T *)0;
+    return obj->template component<T>();
+}
+
+template <typename T> T *query(QObject *obj)
+{
+    if (!obj)
+        return (T *)0;
+    T *result = qobject_cast<T *>(obj);
+    if (!result) {
+        QReadLocker(&lock());
+        Aggregate *parentAggregation = Aggregate::parentAggregate(obj);
+        result = (parentAggregation ? query<T>(parentAggregation) : 0);
+    }
+    return result;
+}
+
+// get all components of a specific type via template function
+template <typename T> QList<T *> query_all(Aggregate *obj)
+{
+    if (!obj)
+        return QList<T *>();
+    return obj->template components<T>();
+}
+
+template <typename T> QList<T *> query_all(QObject *obj)
+{
+    if (!obj)
+        return QList<T *>();
+    QReadLocker(&lock());
+    Aggregate *parentAggregation = Aggregate::parentAggregate(obj);
+    QList<T *> results;
+    if (parentAggregation)
+        results = query_all<T>(parentAggregation);
+    else if (T *result = qobject_cast<T *>(obj))
+        results.append(result);
+    return results;
+}
+
+} // namespace Aggregation
+
+#endif // header guard