kcenon::network::facade::http_facade Class Reference

Simplified facade for creating HTTP clients and servers. More...

#include <http_facade.h>

Collaboration diagram for kcenon::network::facade::http_facade:

Classes
struct	client_config
	Configuration for creating an HTTP client. More...
struct	server_config
	Configuration for creating an HTTP server. More...

Public Member Functions
auto	create_client (const client_config &config) const -> Result< std::shared_ptr< interfaces::i_protocol_client > >
	Creates an HTTP client with the specified configuration.
auto	create_server (const server_config &config) const -> Result< std::shared_ptr< interfaces::i_protocol_server > >
	Creates an HTTP server with the specified configuration.

Static Private Member Functions
static auto	generate_client_id () -> std::string
	Generates a unique client ID.
static auto	generate_server_id () -> std::string
	Generates a unique server ID.
static auto	validate_client_config (const client_config &config) -> VoidResult
	Validates client configuration.
static auto	validate_server_config (const server_config &config) -> VoidResult
	Validates server configuration.

Detailed Description

Simplified facade for creating HTTP clients and servers.

This facade provides a simple, unified API for creating HTTP/1.1 protocol clients and servers, hiding the complexity of underlying implementation from the user.

Design Goals

• Simplicity: No template parameters or protocol tags
• Consistency: Same API pattern across all protocol facades
• Type Safety: Returns unified protocol interfaces (i_protocol_client/i_protocol_server)
• Zero Cost: No performance overhead compared to direct instantiation

Thread Safety

All methods are thread-safe and can be called concurrently.

Usage Example

using namespace kcenon::network::facade;
 
// Create HTTP client
http_facade facade;
auto client = facade.create_client({
    .client_id = "my-http-client",
    .timeout = std::chrono::seconds(10)
});
 
// Create HTTP server
auto server = facade.create_server({
    .port = 8080,
    .server_id = "my-http-server"
});

See also

interfaces::i_protocol_client

interfaces::i_protocol_server

Definition at line 76 of file http_facade.h.

Member Function Documentation

create_client()

auto kcenon::network::facade::http_facade::create_client ( const client_config & config ) const -> Result<std::shared_ptr<interfaces::i_protocol_client>>

nodiscard

Creates an HTTP client with the specified configuration.

Parameters

config

Client configuration.

Returns

Result containing shared pointer to i_protocol_client, or error.

Behavior

• Creates an HTTP client adapter wrapping http_client
• Client ID is auto-generated if not provided
• Default timeout is 30 seconds if not specified
• Returns unified i_protocol_client interface for protocol-agnostic usage

Protocol-Specific Notes

• start() sets the base URL (host:port) for subsequent requests
• send() performs an HTTP POST request with binary data
• Received response body is delivered via receive callback

Error Conditions

• Returns error if timeout is zero or negative

Definition at line 63 of file http_facade.cpp.

{
    auto validation = validate_client_config(config);
    if (validation.is_err())
    {
        return error<std::shared_ptr<interfaces::i_protocol_client>>(
            validation.error().code, validation.error().message, "http_facade");
    }
 
    const auto client_id = config.client_id.empty() ? generate_client_id() : config.client_id;
 
    // Create adapter with timeout from config
    auto adapter = std::make_shared<internal::adapters::http_client_adapter>(
        client_id, config.timeout);
 
    // Configure path and SSL
    adapter->set_path(config.path);
    adapter->set_use_ssl(config.use_ssl);
 
    return ok(std::shared_ptr<interfaces::i_protocol_client>(adapter));
}

References config, kcenon::network::error, and kcenon::network::ok().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

create_server()

auto kcenon::network::facade::http_facade::create_server ( const server_config & config ) const -> Result<std::shared_ptr<interfaces::i_protocol_server>>

nodiscard

Creates an HTTP server with the specified configuration.

Parameters

config

Server configuration.

Returns

Result containing shared pointer to i_protocol_server, or error.

Behavior

• Creates an HTTP server adapter wrapping http_server
• Server ID is auto-generated if not provided
• Server must be started manually using start() method
• Returns unified i_protocol_server interface for protocol-agnostic usage

Protocol-Specific Notes

• Receive callback delivers HTTP request body as binary data
• Session send() queues response data for the current request

Error Conditions

• Returns error if port is 0 or > 65535

Definition at line 86 of file http_facade.cpp.

{
    auto validation = validate_server_config(config);
    if (validation.is_err())
    {
        return error<std::shared_ptr<interfaces::i_protocol_server>>(
            validation.error().code, validation.error().message, "http_facade");
    }
 
    const auto server_id = config.server_id.empty() ? generate_server_id() : config.server_id;
 
    // Create adapter
    return ok(std::shared_ptr<interfaces::i_protocol_server>(
        std::make_shared<internal::adapters::http_server_adapter>(server_id)));
}

References config, kcenon::network::error, and kcenon::network::ok().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

generate_client_id()

auto kcenon::network::facade::http_facade::generate_client_id ( ) -> std::string

staticnodiscardprivate

Generates a unique client ID.

Definition at line 27 of file http_facade.cpp.

{
    const auto id = g_client_id_counter.fetch_add(1, std::memory_order_relaxed);
    std::ostringstream oss;
    oss << "http_client_" << std::setfill('0') << std::setw(8) << id;
    return oss.str();
}

generate_server_id()

auto kcenon::network::facade::http_facade::generate_server_id ( ) -> std::string

staticnodiscardprivate

Generates a unique server ID.

Definition at line 35 of file http_facade.cpp.

{
    const auto id = g_server_id_counter.fetch_add(1, std::memory_order_relaxed);
    std::ostringstream oss;
    oss << "http_server_" << std::setfill('0') << std::setw(8) << id;
    return oss.str();
}

validate_client_config()

auto kcenon::network::facade::http_facade::validate_client_config ( const client_config & config ) -> VoidResult

staticprivate

Validates client configuration.

Definition at line 43 of file http_facade.cpp.

{
    if (config.timeout.count() <= 0)
    {
        return error_void(-1, "http_facade: timeout must be positive", "http_facade");
    }
 
    return ok();
}

References config, kcenon::network::error_void(), and kcenon::network::ok().

Here is the call graph for this function:

validate_server_config()

auto kcenon::network::facade::http_facade::validate_server_config ( const server_config & config ) -> VoidResult

staticprivate

Validates server configuration.

Definition at line 53 of file http_facade.cpp.

{
    if (config.port == 0 || config.port > 65535)
    {
        return error_void(-1, "http_facade: port must be between 1 and 65535", "http_facade");
    }
 
    return ok();
}

References config, kcenon::network::error_void(), and kcenon::network::ok().

Here is the call graph for this function:

---

The documentation for this class was generated from the following files:

• include/kcenon/network/facade/http_facade.h
• src/facade/http_facade.cpp