Skip to main content

HttpClient

rustial_engine::io

Trait HttpClient 

Source 
pub trait HttpClient: Send + Sync {
    // Required methods
    fn send(&self, request: HttpRequest);
    fn poll(&self) -> Vec<(String, Result<HttpResponse, String>)>;
}
Expand description

Abstract HTTP client.

The engine calls send to initiate a request and poll each frame to collect completed responses. Implementations must not block in either method.

§Object safety

The trait is object-safe so it can be stored as Box<dyn HttpClient>.

§Thread safety

Required to be Send + Sync because the engine state may be shared across threads (e.g. between a main thread and a render thread).

Required Methods§

Source

fn send(&self, request: HttpRequest)

Initiate an HTTP request. Must return immediately.

The implementation should enqueue the request for background execution and make the result available via poll.

Source

fn poll(&self) -> Vec<(String, Result<HttpResponse, String>)>

Collect completed HTTP responses.

Returns (original_url, Result<HttpResponse, error_message>) for every request that has finished since the last call.

Returns an empty Vec when no requests have completed.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§