ServiceRegistrationBuilder.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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 <string>
#include <vector>
#include <memory>
 
#include "celix/Utils.h"
#include "celix/ServiceRegistration.h"
 
namespace celix {
    template<typename I>
    class ServiceRegistrationBuilder {
    private:
        friend class BundleContext;
 
        //NOTE private to prevent move so that a build() call cannot be forgotten
        ServiceRegistrationBuilder(ServiceRegistrationBuilder&&) noexcept = default;
    public:
        ServiceRegistrationBuilder(
                std::shared_ptr<celix_bundle_context_t> _cCtx,
                std::shared_ptr<I> _svc,
                std::string _name,
                bool _registerAsync = true,
                bool _unregisterAsync = true) :
                cCtx{std::move(_cCtx)},
                svc{std::move(_svc)},
                name{std::move(_name)},
                version{celix::typeVersion<I>()},
                registerAsync{_registerAsync},
                unregisterAsync{_unregisterAsync} {}
 
        ServiceRegistrationBuilder& operator=(ServiceRegistrationBuilder&&) = delete;
        ServiceRegistrationBuilder(const ServiceRegistrationBuilder&) = delete;
        ServiceRegistrationBuilder operator=(const ServiceRegistrationBuilder&) = delete;
 
#if __cplusplus >= 201703L //C++17 or higher
        ServiceRegistrationBuilder& setVersion(std::string_view v) { version = v; return *this; }
#else
        ServiceRegistrationBuilder& setVersion(std::string v) { version = std::move(v); return *this; }
#endif
 
#if __cplusplus >= 201703L //C++17 or higher
        template<typename T>
        ServiceRegistrationBuilder& addProperty(std::string_view key, T&& value) { properties.template set(key, std::forward<T>(value)); return *this; }
#else
        template<typename T>
        ServiceRegistrationBuilder& addProperty(const std::string& key, T&& value) { properties.set(key, std::forward<T>(value)); return *this; }
#endif
 
        ServiceRegistrationBuilder& setProperties(celix::Properties p) { properties = std::move(p); return *this; }
 
        ServiceRegistrationBuilder& addProperties(const celix::Properties& props) {
            for (const auto& pair : props) {
                properties.set(pair.first, pair.second);
            }
            return *this;
        }
 
        ServiceRegistrationBuilder& addOnRegistered(std::function<void(ServiceRegistration&)> callback) {
            onRegisteredCallbacks.emplace_back(std::move(callback));
            return *this;
        }
 
        ServiceRegistrationBuilder& addOnUnregistered(std::function<void(ServiceRegistration&)> callback) {
            onUnregisteredCallbacks.emplace_back(std::move(callback));
            return *this;
        }
 
        ServiceRegistrationBuilder& setRegisterAsync(bool async) {
            registerAsync = async;
            return *this;
        }
 
        ServiceRegistrationBuilder& setUnregisterAsync(bool async) {
            unregisterAsync = async;
            return *this;
        }
 
        std::shared_ptr<ServiceRegistration> build() {
            return ServiceRegistration::create(
                    cCtx,
                    std::move(svc),
                    std::move(name),
                    std::move(version),
                    std::move(properties),
                    registerAsync,
                    unregisterAsync,
                    std::move(onRegisteredCallbacks),
                    std::move(onUnregisteredCallbacks));
        }
    private:
        const std::shared_ptr<celix_bundle_context_t> cCtx;
        std::shared_ptr<I> svc;
        std::string name;
        std::string version;
        bool registerAsync;
        bool unregisterAsync;
        celix::Properties properties{};
        std::vector<std::function<void(ServiceRegistration&)>> onRegisteredCallbacks{};
        std::vector<std::function<void(ServiceRegistration&)>> onUnregisteredCallbacks{};
    };
}