AbstractNode.h

/**********************************************************************
 *
 * GEOS - Geometry Engine Open Source
 * http://geos.osgeo.org
 *
 * Copyright (C) 2006 Refractions Research Inc.
 *
 * This is free software; you can redistribute and/or modify it under
 * the terms of the GNU Lesser General Public Licence as published
 * by the Free Software Foundation.
 * See the COPYING file for more information.
 *
 **********************************************************************/

#ifndef GEOS_INDEX_STRTREE_ABSTRACTNODE_H
#define GEOS_INDEX_STRTREE_ABSTRACTNODE_H

#include <cassert>
#include <cstddef>
#include <geos/export.h>
#include <geos/index/strtree/Boundable.h> // for inheritance

#include <vector>

#ifdef _MSC_VER
#pragma warning(push)
#pragma warning(disable: 4251) // warning C4251: needs to have dll-interface to be used by clients of class
#endif

namespace geos {
namespace index { // geos::index
namespace strtree { // geos::index::strtree

class GEOS_DLL AbstractNode: public Boundable {
private:
    std::vector<Boundable*> childBoundables;
    int level;
public:

    /*
     * Constructs an AbstractNode at the given level in the tree
     * @param level 0 if this node is a leaf, 1 if a parent of a leaf, and so on;
     * the root node will have the highest level
     */
    AbstractNode(int newLevel, size_t capacity = 10) : level(newLevel), bounds(nullptr) {
        childBoundables.reserve(capacity);
    }

    ~AbstractNode() override = default;

    // TODO: change signature to return by ref,
    // document ownership of the return
    inline std::vector<Boundable*>*
    getChildBoundables()
    {
        return &childBoundables;
    }

    // TODO: change signature to return by ref,
    // document ownership of the return
    inline const std::vector<Boundable*>*
    getChildBoundables() const
    {
        return &childBoundables;
    }

    const void* getBounds() const override {
        if(bounds == nullptr) {
            bounds = computeBounds();
        }
        return bounds;
    }

    int getLevel() {
        return level;
    }

    void addChildBoundable(Boundable* childBoundable) {
        assert(bounds == nullptr);
        childBoundables.push_back(childBoundable);
    }

    bool isLeaf() const override {
        return false;
    }

protected:

    virtual void* computeBounds() const = 0;

    mutable void* bounds;
};


} // namespace geos::index::strtree
} // namespace geos::index
} // namespace geos

#ifdef _MSC_VER
#pragma warning(pop)
#endif

#endif // GEOS_INDEX_STRTREE_ABSTRACTNODE_H