i_udp_client.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2024, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include "kcenon/network/interfaces/i_network_component.h"
 
#include <cstdint>
#include <functional>
#include <string_view>
#include <system_error>
#include <vector>
 
#include "kcenon/network/detail/utils/result_types.h"
 
namespace kcenon::network::interfaces
{
 
    class i_udp_client : public i_network_component
    {
    public:
        struct endpoint_info
        {
            std::string address;  
            uint16_t port;        
        };
 
        using receive_callback_t = std::function<void(
            const std::vector<uint8_t>&,
            const endpoint_info&)>;
 
        using error_callback_t = std::function<void(std::error_code)>;
 
        using send_callback_t = std::function<void(std::error_code, std::size_t)>;
 
        [[nodiscard]] virtual auto start(std::string_view host, uint16_t port) -> VoidResult = 0;
 
        [[nodiscard]] virtual auto stop() -> VoidResult = 0;
 
        [[nodiscard]] virtual auto send(
            std::vector<uint8_t>&& data,
            send_callback_t handler = nullptr) -> VoidResult = 0;
 
        [[nodiscard]] virtual auto set_target(std::string_view host, uint16_t port) -> VoidResult = 0;
 
        virtual auto set_receive_callback(receive_callback_t callback) -> void = 0;
 
        virtual auto set_error_callback(error_callback_t callback) -> void = 0;
    };
 
} // namespace kcenon::network::interfaces