use std::collections::HashMap;
use std::fmt::Debug;
use std::fmt::Formatter;
use http::header;
use http::header::IF_MATCH;
use http::header::IF_NONE_MATCH;
use http::Request;
use http::Response;
use http::StatusCode;
use log::debug;
use serde::Deserialize;
use super::error::parse_error;
use crate::raw::*;
use crate::services::http::reader::HttpReader;
use crate::*;
#[derive(Default, Deserialize)]
#[serde(default)]
#[non_exhaustive]
pub struct HttpConfig {
pub endpoint: Option<String>,
pub username: Option<String>,
pub password: Option<String>,
pub token: Option<String>,
pub root: Option<String>,
}
impl Debug for HttpConfig {
fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
let mut de = f.debug_struct("HttpConfig");
de.field("endpoint", &self.endpoint);
de.field("root", &self.root);
de.finish_non_exhaustive()
}
}
#[doc = include_str!("docs.md")]
#[derive(Default)]
pub struct HttpBuilder {
config: HttpConfig,
http_client: Option<HttpClient>,
}
impl Debug for HttpBuilder {
fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
let mut de = f.debug_struct("HttpBuilder");
de.field("config", &self.config).finish()
}
}
impl HttpBuilder {
pub fn endpoint(&mut self, endpoint: &str) -> &mut Self {
self.config.endpoint = if endpoint.is_empty() {
None
} else {
Some(endpoint.to_string())
};
self
}
pub fn username(&mut self, username: &str) -> &mut Self {
if !username.is_empty() {
self.config.username = Some(username.to_owned());
}
self
}
pub fn password(&mut self, password: &str) -> &mut Self {
if !password.is_empty() {
self.config.password = Some(password.to_owned());
}
self
}
pub fn token(&mut self, token: &str) -> &mut Self {
if !token.is_empty() {
self.config.token = Some(token.to_owned());
}
self
}
pub fn root(&mut self, root: &str) -> &mut Self {
self.config.root = if root.is_empty() {
None
} else {
Some(root.to_string())
};
self
}
pub fn http_client(&mut self, client: HttpClient) -> &mut Self {
self.http_client = Some(client);
self
}
}
impl Builder for HttpBuilder {
const SCHEME: Scheme = Scheme::Http;
type Accessor = HttpBackend;
fn from_map(map: HashMap<String, String>) -> Self {
let config = HttpConfig::deserialize(ConfigDeserializer::new(map))
.expect("config deserialize must succeed");
HttpBuilder {
config,
http_client: None,
}
}
fn build(&mut self) -> Result<Self::Accessor> {
debug!("backend build started: {:?}", &self);
let endpoint = match &self.config.endpoint {
Some(v) => v,
None => {
return Err(Error::new(ErrorKind::ConfigInvalid, "endpoint is empty")
.with_context("service", Scheme::Http))
}
};
let root = normalize_root(&self.config.root.take().unwrap_or_default());
debug!("backend use root {}", root);
let client = if let Some(client) = self.http_client.take() {
client
} else {
HttpClient::new().map_err(|err| {
err.with_operation("Builder::build")
.with_context("service", Scheme::Http)
})?
};
let mut auth = None;
if let Some(username) = &self.config.username {
auth = Some(format_authorization_by_basic(
username,
self.config.password.as_deref().unwrap_or_default(),
)?);
}
if let Some(token) = &self.config.token {
auth = Some(format_authorization_by_bearer(token)?)
}
debug!("backend build finished: {:?}", &self);
Ok(HttpBackend {
endpoint: endpoint.to_string(),
authorization: auth,
root,
client,
})
}
}
#[derive(Clone)]
pub struct HttpBackend {
endpoint: String,
root: String,
client: HttpClient,
authorization: Option<String>,
}
impl Debug for HttpBackend {
fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
f.debug_struct("Backend")
.field("endpoint", &self.endpoint)
.field("root", &self.root)
.field("client", &self.client)
.finish()
}
}
impl Access for HttpBackend {
type Reader = HttpReader;
type Writer = ();
type Lister = ();
type BlockingReader = ();
type BlockingWriter = ();
type BlockingLister = ();
fn info(&self) -> AccessorInfo {
let mut ma = AccessorInfo::default();
ma.set_scheme(Scheme::Http)
.set_root(&self.root)
.set_native_capability(Capability {
stat: true,
stat_with_if_match: true,
stat_with_if_none_match: true,
read: true,
read_with_if_match: true,
read_with_if_none_match: true,
..Default::default()
});
ma
}
async fn stat(&self, path: &str, args: OpStat) -> Result<RpStat> {
if path == "/" {
return Ok(RpStat::new(Metadata::new(EntryMode::DIR)));
}
let resp = self.http_head(path, &args).await?;
let status = resp.status();
match status {
StatusCode::OK => parse_into_metadata(path, resp.headers()).map(RpStat::new),
StatusCode::NOT_FOUND | StatusCode::FORBIDDEN if path.ends_with('/') => {
Ok(RpStat::new(Metadata::new(EntryMode::DIR)))
}
_ => Err(parse_error(resp).await?),
}
}
async fn read(&self, path: &str, args: OpRead) -> Result<(RpRead, Self::Reader)> {
Ok((RpRead::default(), HttpReader::new(self.clone(), path, args)))
}
}
impl HttpBackend {
pub async fn http_get(
&self,
path: &str,
range: BytesRange,
args: &OpRead,
) -> Result<Response<Buffer>> {
let p = build_rooted_abs_path(&self.root, path);
let url = format!("{}{}", self.endpoint, percent_encode_path(&p));
let mut req = Request::get(&url);
if let Some(if_match) = args.if_match() {
req = req.header(IF_MATCH, if_match);
}
if let Some(if_none_match) = args.if_none_match() {
req = req.header(IF_NONE_MATCH, if_none_match);
}
if let Some(auth) = &self.authorization {
req = req.header(header::AUTHORIZATION, auth.clone())
}
if !range.is_full() {
req = req.header(header::RANGE, range.to_header());
}
let req = req.body(Buffer::new()).map_err(new_request_build_error)?;
self.client.send(req).await
}
async fn http_head(&self, path: &str, args: &OpStat) -> Result<Response<Buffer>> {
let p = build_rooted_abs_path(&self.root, path);
let url = format!("{}{}", self.endpoint, percent_encode_path(&p));
let mut req = Request::head(&url);
if let Some(if_match) = args.if_match() {
req = req.header(IF_MATCH, if_match);
}
if let Some(if_none_match) = args.if_none_match() {
req = req.header(IF_NONE_MATCH, if_none_match);
}
if let Some(auth) = &self.authorization {
req = req.header(header::AUTHORIZATION, auth.clone())
}
let req = req.body(Buffer::new()).map_err(new_request_build_error)?;
self.client.send(req).await
}
}