Struct Body 

pub struct Body { /* private fields */ }

A request body that can be raw bytes or serialized JSON.

Use the From impls to pass raw bytes, or Body::json to serialize a value and automatically set the Content-Type: application/json header.

Examples

use winhttp::Body;

// Raw bytes — no Content-Type is set.
let body: Body = b"hello".as_slice().into();
let body: Body = vec![1, 2, 3].into();
let body: Body = "plain text".into();

use winhttp::Body;

// JSON — Content-Type is set to application/json.
let body = Body::json(&serde_json::json!({"key": "value"}))?;

Implementations

impl Body

pub fn json<T: Serialize>(value: &T) -> Result<Self>

Available on crate feature json only.

Serialize value as JSON and set Content-Type: application/json.

Returns a windows::core::Error if serialization fails.

Requires the json feature.

Example

use winhttp::{Body, Client};
use serde::Serialize;

#[derive(Serialize)]
struct Payload { name: String }

let client = Client::new()?;
let resp = client.post("/users", Body::json(&Payload { name: "Ada".into() })?)?;

pub fn as_bytes(&self) -> &[u8]

Returns the raw bytes of this body.

pub fn content_type(&self) -> Option<&'static str>

Returns the content type that should be set for this body, if any.

Trait Implementations

impl Clone for Body

fn clone(&self) -> Body

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Body

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&[u8]> for Body

fn from(bytes: &[u8]) -> Self

Converts to this type from the input type.

impl<const N: usize> From<&[u8; N]> for Body

fn from(bytes: &[u8; N]) -> Self

Converts to this type from the input type.

impl From<&str> for Body

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for Body

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Body

fn from(bytes: Vec<u8>) -> Self

Converts to this type from the input type.