ServiceManager.h

/*
 * MIT License
 *
 * Copyright (c) 2026 Adriano dos Santos Fernandes
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
 
#ifndef FBCPP_SERVICE_MANAGER_H
#define FBCPP_SERVICE_MANAGER_H
 
#include "Exception.h"
#include "fb-cpp-export.h"
#include "fb-api.h"
#include "SmartPtrs.h"
#include <cstdint>
#include <functional>
#include <limits>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
 
namespace fbcpp
{
    enum class ReplicaMode
    {
        NONE,
 
        READ_ONLY,
 
        READ_WRITE
    };
 
    class Client;
 
    class ServiceManagerOptions final
    {
    public:
        const std::optional<std::string>& getServer() const
        {
            return server;
        }
 
        ServiceManagerOptions& setServer(const std::string& value)
        {
            server = value;
            return *this;
        }
 
        const std::string& getServiceManagerName() const
        {
            return serviceManagerName;
        }
 
        ServiceManagerOptions& setServiceManagerName(const std::string& value)
        {
            serviceManagerName = value;
            return *this;
        }
 
        const std::optional<std::string>& getUserName() const
        {
            return userName;
        }
 
        ServiceManagerOptions& setUserName(const std::string& value)
        {
            userName = value;
            return *this;
        }
 
        const std::optional<std::string>& getPassword() const
        {
            return password;
        }
 
        ServiceManagerOptions& setPassword(const std::string& value)
        {
            password = value;
            return *this;
        }
 
        const std::optional<std::string>& getRole() const
        {
            return role;
        }
 
        ServiceManagerOptions& setRole(const std::string& value)
        {
            role = value;
            return *this;
        }
 
        const std::vector<std::uint8_t>& getSpb() const
        {
            return spb;
        }
 
        ServiceManagerOptions& setSpb(const std::vector<std::uint8_t>& value)
        {
            spb = value;
            return *this;
        }
 
        ServiceManagerOptions& setSpb(std::vector<std::uint8_t>&& value)
        {
            spb = std::move(value);
            return *this;
        }
 
    private:
        std::optional<std::string> server;
        std::string serviceManagerName = "service_mgr";
        std::optional<std::string> userName;
        std::optional<std::string> password;
        std::optional<std::string> role;
        std::vector<std::uint8_t> spb;
    };
 
    class FB_CPP_EXPORT ServiceManager
    {
    public:
        using VerboseOutput = std::function<void(std::string_view line)>;
 
        explicit ServiceManager(Client& client, const ServiceManagerOptions& options = {});
 
        ServiceManager(ServiceManager&& o) noexcept
            : client{o.client},
              handle{std::move(o.handle)}
        {
        }
 
        ServiceManager& operator=(ServiceManager&& o) noexcept
        {
            if (this != &o)
            {
                if (isValid())
                {
                    try
                    {
                        detachHandle();
                    }
                    catch (...)
                    {
                        // swallow
                    }
                }
 
                client = o.client;
                handle = std::move(o.handle);
            }
 
            return *this;
        }
 
        ServiceManager(const ServiceManager&) = delete;
        ServiceManager& operator=(const ServiceManager&) = delete;
 
        ~ServiceManager() noexcept
        {
            if (isValid())
            {
                try
                {
                    detachHandle();
                }
                catch (...)
                {
                    // swallow
                }
            }
        }
 
    public:
        bool isValid() noexcept
        {
            return handle != nullptr;
        }
 
        Client& getClient() noexcept
        {
            return *client;
        }
 
        FbRef<fb::IService> getHandle() noexcept
        {
            return handle;
        }
 
        void disconnect();
 
    protected:
        static void addSpbInt(fb::IXpbBuilder* builder, impl::StatusWrapper* status, unsigned char tag,
            std::uint64_t value, const char* what)
        {
            if (value > static_cast<std::uint64_t>(std::numeric_limits<std::int64_t>::max()))
                throw FbCppException(std::string(what) + " is too large");
 
            if (value > static_cast<std::uint64_t>(std::numeric_limits<int>::max()))
                builder->insertBigInt(status, tag, static_cast<std::int64_t>(value));
            else
                builder->insertInt(status, tag, static_cast<int>(value));
        }
 
        void startAction(const std::vector<std::uint8_t>& spb);
        void waitForCompletion(const VerboseOutput& verboseOutput = {}, bool requestStdin = false);
 
    private:
        void detachHandle();
 
    private:
        Client* client;
        FbRef<fb::IService> handle;
    };
}  // namespace fbcpp
 
 
#endif  // FBCPP_SERVICE_MANAGER_H