172 lines
6.7 KiB
C++
172 lines
6.7 KiB
C++
#pragma once
|
|
|
|
/*
|
|
|
|
ABSTRACT DEVICE COMPONENTS LIBRARY
|
|
|
|
*/
|
|
|
|
#include <concepts>
|
|
|
|
#include "../common/adc_traits.h"
|
|
|
|
/* DEFINITIONS OF NETWORK COMPONENTS INTERFACES */
|
|
|
|
|
|
namespace adc::interfaces
|
|
{
|
|
|
|
|
|
template <traits::adc_time_duration_c... Ts>
|
|
struct adc_duration_common_type;
|
|
|
|
|
|
template <traits::adc_time_duration_c T1, traits::adc_time_duration_c T2>
|
|
struct adc_duration_common_type<T1, T2> : std::common_type<T1, T2> {
|
|
};
|
|
|
|
|
|
template <traits::adc_time_duration_c T1, traits::adc_time_duration_c T2, traits::adc_time_duration_c... Ts>
|
|
struct adc_duration_common_type<T1, T2, Ts...> : adc_duration_common_type<std::common_type_t<T1, T2>, Ts...> {
|
|
};
|
|
|
|
|
|
template <traits::adc_time_duration_c... Ts>
|
|
using adc_duration_common_type_t = typename adc_duration_common_type<Ts...>::type;
|
|
|
|
|
|
/* all STL helper duration types */
|
|
using adc_common_duration_t = adc_duration_common_type_t<std::chrono::nanoseconds,
|
|
std::chrono::microseconds,
|
|
std::chrono::milliseconds,
|
|
std::chrono::seconds,
|
|
std::chrono::minutes,
|
|
std::chrono::hours,
|
|
std::chrono::days,
|
|
std::chrono::weeks,
|
|
std::chrono::months,
|
|
std::chrono::years>;
|
|
|
|
/*
|
|
struct NetService {
|
|
typedef ImplementationDependentT netservice_ident_t;
|
|
typedef ImplementationDependentT async_ctx_t;
|
|
typedef ImplementationDependentT endpoint_t;
|
|
|
|
template<typename Rep, typename Period>
|
|
auto asyncAccept(const endpoint_t&, async_ctx_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period>
|
|
auto asyncConnect(const endpoint_t&, async_ctx_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period, adc::traits::adc_input_char_range R>
|
|
auto asyncSend(const R&, async_ctx_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period>
|
|
auto asyncReceived(async_ctx_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period>
|
|
auto accept(const endpoint_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period>
|
|
auto connect(const endpoint_t&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<typename Rep, typename Period, adc::traits::adc_input_char_range R>
|
|
auto send(const R&, const std::chrono::duration<Rep, Period>&)
|
|
|
|
template<adc::traits::adc_output_char_range R, typename Rep, typename Period>
|
|
R received(const std::chrono::duration<Rep, Period>&)
|
|
|
|
}
|
|
*/
|
|
template <typename SRVT,
|
|
typename SMSGT = std::string_view, // sending message type
|
|
typename RMSGT = std::string, // receiving message type
|
|
typename DURT = adc_common_duration_t // time duration type
|
|
>
|
|
concept adc_netservice_c =
|
|
traits::adc_input_char_range<SMSGT> && traits::adc_output_char_range<RMSGT> && traits::adc_time_duration_c<DURT> &&
|
|
requires(SRVT srv, const SRVT srv_const) {
|
|
typename SRVT::netservice_ident_t;
|
|
|
|
// netservice_ident_t ident() const
|
|
{ srv_const.ident() } -> std::same_as<typename SRVT::netservice_ident_t>;
|
|
|
|
typename SRVT::async_ctx_t;
|
|
typename SRVT::endpoint_t;
|
|
|
|
// asynchronous (non-blocking) operations
|
|
srv.asyncAccept(std::declval<const typename SRVT::endpoint_t&>(), std::declval<typename SRVT::async_ctx_t&>(),
|
|
std::declval<const DURT&>());
|
|
|
|
srv.asyncConnect(std::declval<const typename SRVT::endpoint_t&>(), std::declval<typename SRVT::async_ctx_t&>(),
|
|
std::declval<const DURT&>());
|
|
|
|
srv.asyncSend(std::declval<const SMSGT&>(), std::declval<typename SRVT::async_ctx_t&>(),
|
|
std::declval<const DURT&>());
|
|
|
|
srv.asyncReceive(std::declval<typename SRVT::async_ctx_t&>(), std::declval<const DURT&>());
|
|
|
|
// synchronous (blocking) operations
|
|
srv.accept(std::declval<const typename SRVT::endpoint_t&>(), std::declval<const DURT&>());
|
|
|
|
srv.connect(std::declval<const typename SRVT::endpoint_t&>(), std::declval<const DURT&>());
|
|
|
|
srv.send(std::declval<const SMSGT&>(), std::declval<const DURT&>());
|
|
|
|
{ srv.receive(std::declval<const DURT&>()) } -> std::same_as<RMSGT>;
|
|
|
|
srv.close();
|
|
};
|
|
|
|
|
|
/* NETWORK SESSION */
|
|
|
|
template <typename SESST>
|
|
concept adc_netsession_c =
|
|
std::derived_from<SESST, std::enable_shared_from_this<SESST>> && requires(SESST sess, const SESST sess_const) {
|
|
typename SESST::netsession_ident_t;
|
|
|
|
// netsession_ident_t ident() const
|
|
{ sess_const.ident() } -> std::same_as<typename SESST::netsession_ident_t>;
|
|
|
|
sess.start();
|
|
sess.stop();
|
|
};
|
|
|
|
|
|
|
|
/* NETWORK SESSION-LEVEL PROTOCOL */
|
|
|
|
template <typename SESS_PROTOT, typename BUFFT = std::string_view>
|
|
concept adc_netsession_proto_c =
|
|
traits::adc_input_char_range<BUFFT> && requires(SESS_PROTOT proto, const SESS_PROTOT proto_const) {
|
|
typename SESS_PROTOT::proto_ident_t;
|
|
|
|
// proto_ident_t ident() const (const method)
|
|
{ proto_const.ident() } -> std::same_as<typename SESS_PROTOT::proto_ident_t>;
|
|
|
|
// typename SESS_PROTOT::search_result_t;
|
|
|
|
// search for the first occurence of valid protocol sequence in input user byte sequence
|
|
// the method must return std::tuple<begin, end, flag>:
|
|
// start - input range iterator of the sequence first byte
|
|
// stop - input range iterator of the sequence end ("after-the-last" byte!!!)
|
|
// flag - true if valid sequence was found, false - otherwise
|
|
{
|
|
proto.search(std::declval<const BUFFT&>())
|
|
} -> std::same_as<std::tuple<std::ranges::iterator_t<BUFFT>, std::ranges::iterator_t<BUFFT>, bool>>;
|
|
|
|
|
|
// construct netsession protocol representation of input user byte sequence
|
|
// the method must return a range of char range views or output char range
|
|
{ proto.toProto(std::declval<const BUFFT&>()) } -> traits::adc_range_of_view_or_output_char_range;
|
|
|
|
// return user byte sequence from input netsession protocol representation
|
|
// the method must return a view of char range or output char range
|
|
{ proto.fromProto(std::declval<const BUFFT&>()) } -> traits::adc_view_or_output_char_range;
|
|
};
|
|
|
|
|
|
} // namespace adc::interfaces
|