fix(lib): Support large body uploads with repeated read callbacks

When uploading larger amounts of data, cURL will call the read
callback incrementally multiple times to receive all the expected
data.

Previously if the size of the data to upload exceeded the size of the
initial buffer provided by cURL, the write (and thus the request)
would fail.

This changes the logic to write the data in chunks of a size that are
acceptable to cURL.
This commit is contained in:
Vincent Ambo 2019-02-27 14:02:49 +01:00 committed by Vincent Ambo
parent a18dfc5a5e
commit 67bfba446d
2 changed files with 42 additions and 12 deletions

View file

@ -77,7 +77,7 @@ extern crate curl;
pub use curl::init; pub use curl::init;
use curl::easy::{Auth, Easy, Form, List, ReadError}; use curl::easy::{Auth, Easy, Form, List, Transfer, ReadError, WriteError};
use std::collections::HashMap; use std::collections::HashMap;
use std::io::Write; use std::io::Write;
use std::path::Path; use std::path::Path;
@ -379,18 +379,10 @@ impl <'a> Request<'a> {
// Write the payload if it exists: // Write the payload if it exists:
match self.body { match self.body {
Body::Bytes { data, .. } => transfer.read_function(move |mut into| { Body::Bytes { data, .. } => chunked_read_function(&mut transfer, data)?,
into.write_all(data)
.map(|_| data.len())
.map_err(|_| ReadError::Abort)
})?,
#[cfg(feature = "json")] #[cfg(feature = "json")]
Body::Json(json) => transfer.read_function(move |mut into| { Body::Json(ref json) => chunked_read_function(&mut transfer, json)?,
into.write_all(&json)
.map(|_| json.len())
.map_err(|_| ReadError::Abort)
})?,
// Do nothing if there is no body or if the body is a // Do nothing if there is no body or if the body is a
// form. // form.
@ -426,7 +418,7 @@ impl <'a> Request<'a> {
let len = data.len(); let len = data.len();
body.write_all(data) body.write_all(data)
.map(|_| len) .map(|_| len)
.map_err(|err| panic!("{:?}", err)) .map_err(|_| WriteError::Pause)
})?; })?;
transfer.perform()?; transfer.perform()?;
@ -440,6 +432,26 @@ impl <'a> Request<'a> {
} }
} }
/// Provide a data chunk potentially larger than cURL's initial write
/// buffer to the data reading callback by tracking the offset off
/// already written data.
///
/// As we manually set the expected upload size, cURL will call the
/// read callback repeatedly until it has all the data it needs.
fn chunked_read_function<'easy, 'data>(transfer: &mut Transfer<'easy, 'data>,
data: &'data [u8]) -> Result<(), curl::Error> {
let mut data = data;
transfer.read_function(move |mut into| {
let written = into.write(data)
.map_err(|_| ReadError::Abort)?;
data = &data[written..];
Ok(written)
})
}
impl <T> Response<T> { impl <T> Response<T> {
/// Check whether the status code of this HTTP response is a /// Check whether the status code of this HTTP response is a
/// success (i.e. in the 200-299 range). /// success (i.e. in the 200-299 range).

View file

@ -114,6 +114,24 @@ fn test_basic_auth() {
assert!(response.is_success(), "authorized request should succeed"); assert!(response.is_success(), "authorized request should succeed");
} }
#[test]
fn test_large_body() {
// By default cURL buffers seem to be 2^16 bytes in size. The test
// size is therefore 2^16+1.
const BODY_SIZE: usize = 65537;
let resp = Request::post("http://127.0.0.1:4662/post")
.body("application/octet-stream", &[0; BODY_SIZE])
.send().expect("sending request")
.as_json::<Value>().expect("JSON deserialisation");
// httpbin returns the uploaded data as a string in the `data`
// field.
let data = resp.body.get("data").unwrap().as_str().unwrap();
assert_eq!(BODY_SIZE, data.len(), "uploaded data length should be correct");
}
// Tests for various other features. // Tests for various other features.
#[test] #[test]