Struct RequestTarget

Source

pub struct RequestTarget<'a> { /* private fields */ }

Expand description

Validated origin-form HTTP request target.

Implementations§

Source §

impl<'a> RequestTarget<'a>

Source

pub fn new(value: &'a str) -> Result<Self, RequestTargetError>

Validates a /path?query request target.

Examples found in repository ?

examples/provider_neutral.rs (line 7)

6fn main() {
7    let Ok(target) = RequestTarget::new("/resources?page=1") else {
8        return;
9    };
10    let request = TransportRequest::new(Method::Get, target);
11
12    assert_eq!(request.method(), Method::Get);
13    assert_eq!(request.target().as_str(), "/resources?page=1");
14    assert!(request.body().is_empty());
15}

More examples

Hide additional examples

examples/prepared_request.rs (line 41)

31    fn prepare<'storage>(
32        &self,
33        storage: PreparationStorage<'storage>,
34    ) -> Result<PreparedRequest<'storage>, Self::Error> {
35        let (target_storage, _body_storage) = storage.into_parts();
36        let target = target_storage
37            .get_mut(..17)
38            .ok_or(PrepareError::TargetBuffer)?;
39        target.copy_from_slice(b"/resources?page=1");
40        let target = core::str::from_utf8(target).map_err(|_| PrepareError::InvalidTarget)?;
41        let target = RequestTarget::new(target).map_err(|_| PrepareError::InvalidTarget)?;
42        let request = TransportRequest::new(Method::Get, target);
43        let metadata = OperationMetadata::new(
44            OperationImpact::ReadOnly,
45            RequestSemantics::Safe,
46            RetryEligibility::ExplicitPolicy,
47            CostIntent::NoKnownCost,
48        )
49        .map_err(|_| PrepareError::InvalidMetadata)?;
50        let response_policy = ResponsePolicy::new(
51            &OK_STATUS,
52            ContentTypePolicy::Required(&JSON_MEDIA),
53            ResponseBodyPolicy::Required,
54            65_536,
55        )
56        .map_err(|_| PrepareError::InvalidResponsePolicy)?;
57        let endpoint =
58            EndpointIdentity::new(EndpointScheme::Https, "api.example.invalid", 443, "/v1")
59                .map_err(|_| PrepareError::InvalidEndpoint)?;
60        Ok(PreparedRequest::new(
61            request,
62            ProviderService::new(Provider::Hetzner, ApiFamily::Cloud, endpoint),
63            metadata,
64            response_policy,
65        ))
66    }

Source

pub const fn as_str(self) -> &'a str

Returns the validated request target.

Examples found in repository ?

examples/provider_neutral.rs (line 13)

6fn main() {
7    let Ok(target) = RequestTarget::new("/resources?page=1") else {
8        return;
9    };
10    let request = TransportRequest::new(Method::Get, target);
11
12    assert_eq!(request.method(), Method::Get);
13    assert_eq!(request.target().as_str(), "/resources?page=1");
14    assert!(request.body().is_empty());
15}