1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
use std::time::SystemTime;
use rama_core::telemetry::tracing;
use rama_http_types::HeaderValue;
use crate::util::HttpDate;
/// `Expires` header, defined in [RFC7234](https://datatracker.ietf.org/doc/html/rfc7234#section-5.3)
///
/// The `Expires` header field gives the date/time after which the
/// response is considered stale.
///
/// The presence of an Expires field does not imply that the original
/// resource will change or cease to exist at, before, or after that
/// time.
///
/// # ABNF
///
/// ```text
/// Expires = HTTP-date
/// ```
///
/// # Example values
/// * `Thu, 01 Dec 1994 16:00:00 GMT`
///
/// # Example
///
/// ```
/// use rama_http_headers::Expires;
/// use rama_utils::time::now_system_time;
/// use std::time::Duration;
///
/// let time = now_system_time() + Duration::from_hours(24);
/// let expires = Expires::from(time);
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Expires(HttpDate);
impl crate::TypedHeader for Expires {
fn name() -> &'static ::rama_http_types::header::HeaderName {
&::rama_http_types::header::EXPIRES
}
}
impl crate::HeaderDecode for Expires {
fn decode<'i, I>(values: &mut I) -> Result<Self, crate::Error>
where
I: Iterator<Item = &'i ::rama_http_types::header::HeaderValue>,
{
crate::util::TryFromValues::try_from_values(values).map(Expires)
}
}
impl crate::HeaderEncode for Expires {
fn encode<E: Extend<HeaderValue>>(&self, values: &mut E) {
match HeaderValue::try_from(&self.0) {
Ok(value) => values.extend(::std::iter::once(value)),
Err(err) => {
tracing::debug!("failed to encode expires value as header: {err}");
}
}
}
}
impl From<SystemTime> for Expires {
fn from(time: SystemTime) -> Self {
Self(time.into())
}
}
impl From<Expires> for SystemTime {
fn from(date: Expires) -> Self {
date.0.into()
}
}