Rust

Send a Staged Multipart REST Request

Demonstrates Rest.SendReqMultipart, which sends a multipart request using the parts configured on the object, then reads the response in separate steps.

Background. The staged request model separates sending from reading: a SendReq method transmits the request, ReadResponseHeader reads the status line and headers, and a ReadResp method reads the body. This gives fine control over large or streamed messages compared with the single-call full-request methods.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


let rest = chilkat::Rest::new();
let b_tls = true;
let b_auto_reconnect = true;
if rest.connect("example.com", 443, b_tls, b_auto_reconnect).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// Configure one multipart part before sending.
rest.set_part_selector("1");
let _ = rest.add_header("Content-Type", "text/plain");
let _ = rest.add_header("Content-Disposition", "form-data; name=\"field1\"");
if rest.set_multipart_body_string("value1").is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// Send the multipart request using the configured parts.
if rest.send_req_multipart("POST", "/api/upload").is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// After sending, read the response status line and header fields.  The return value is the HTTP
// status code, or -1 if no response was received.
let status_code = rest.read_response_header();
if status_code < 0 {
    println!("{}", rest.last_error_text());
    return;
}

println!("Response status code: {}", status_code);

// Read the response body as text.
let Ok(response_body) = rest.read_resp_body_string() else {
    println!("{}", rest.last_error_text());
    return;
};

println!("{}", response_body);