element_view.h

Go to the documentation of this file.

/**
 * @file src/common/model/element_view.h
 *
 * Copyright (c) 2021-2024 Bartek Kryza <bkryza@gmail.com>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#pragma once
 
#include "common/types.h"
 
namespace clanguml::common::model {
 
using clanguml::common::eid_t;
 
/**
 * Provides type based views over elements in a diagram.
 *
 * @tparam T Type of diagram element
 */
template <typename T> class element_view {
public:
    /**
     * @brief Add reference to diagram element
     *
     * @param element Reference to diagram element of specific type
     */
    void add(std::reference_wrapper<T> element)
    {
        elements_.emplace_back(std::move(element));
    }
 
    /**
     * @brief Get collection of reference to diagram elements
     *
     * @return
     */
    const reference_vector<T> &view() const { return elements_; }
 
    /**
     * @brief Get collection of reference to diagram elements
     *
     * @return
     */
    reference_vector<T> &view() { return elements_; }
 
    /**
     * @brief Get typed diagram element by id
     * @param id Global id of a diagram element
     *
     * @return
     */
    common::optional_ref<T> get(eid_t id) const
    {
        for (const auto &e : elements_) {
            if (e.get().id() == id) {
                return {e};
            }
        }
 
        return {};
    }
 
    /**
     * @brief Check whether the element view is empty
     *
     * @return True, if the view does not contain any elements
     */
    bool is_empty() const { return elements_.empty(); }
 
    void remove(const std::set<eid_t> &element_ids)
    {
        elements_.erase(std::remove_if(elements_.begin(), elements_.end(),
                            [&element_ids](auto &&e) {
                                return element_ids.count(e.get().id()) > 0;
                            }),
            elements_.end());
    }
 
private:
    reference_vector<T> elements_;
};
 
} // namespace clanguml::common::model