1 + | /*
|
2 + | * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
3 + | * SPDX-License-Identifier: Apache-2.0
|
4 + | */
|
5 + |
|
6 + | //! HTTP binding protocol for REST-style APIs.
|
7 + |
|
8 + | use crate::codec::{Codec, FinishSerializer};
|
9 + | use crate::protocol::ClientProtocol;
|
10 + | use crate::serde::{SerdeError, SerializableStruct, ShapeDeserializer, ShapeSerializer};
|
11 + | use crate::{Schema, ShapeId};
|
12 + | use aws_smithy_runtime_api::http::{Request, Response};
|
13 + | use aws_smithy_types::body::SdkBody;
|
14 + | use aws_smithy_types::config_bag::ConfigBag;
|
15 + |
|
16 + | /// An HTTP protocol for REST-style APIs that use HTTP bindings.
|
17 + | ///
|
18 + | /// This protocol splits input members between HTTP locations (headers, query
|
19 + | /// strings, URI labels) and the payload based on HTTP binding traits
|
20 + | /// (`@httpHeader`, `@httpQuery`, `@httpLabel`, `@httpPayload`, etc.).
|
21 + | /// Non-bound members are serialized into the body using the provided codec.
|
22 + | ///
|
23 + | /// # Type parameters
|
24 + | ///
|
25 + | /// * `C` — the payload codec (e.g., `JsonCodec`, `XmlCodec`)
|
26 + | #[derive(Debug)]
|
27 + | pub struct HttpBindingProtocol<C> {
|
28 + | protocol_id: ShapeId,
|
29 + | codec: C,
|
30 + | content_type: &'static str,
|
31 + | }
|
32 + |
|
33 + | impl<C: Codec> HttpBindingProtocol<C> {
|
34 + | /// Creates a new HTTP binding protocol.
|
35 + | pub fn new(protocol_id: ShapeId, codec: C, content_type: &'static str) -> Self {
|
36 + | Self {
|
37 + | protocol_id,
|
38 + | codec,
|
39 + | content_type,
|
40 + | }
|
41 + | }
|
42 + | }
|
43 + |
|
44 + | // Note: there is a percent_encoding crate we use some other places for this, but I'm trying to keep
|
45 + | // the dependencies to a minimum.
|
46 + | /// Percent-encode a string per RFC 3986 section 2.3 (unreserved characters only).
|
47 + | pub fn percent_encode(input: &str) -> String {
|
48 + | let mut out = String::with_capacity(input.len());
|
49 + | for byte in input.bytes() {
|
50 + | match byte {
|
51 + | b'A'..=b'Z' | b'a'..=b'z' | b'0'..=b'9' | b'-' | b'.' | b'_' | b'~' => {
|
52 + | out.push(byte as char);
|
53 + | }
|
54 + | _ => {
|
55 + | out.push('%');
|
56 + | out.push(char::from(HEX[(byte >> 4) as usize]));
|
57 + | out.push(char::from(HEX[(byte & 0x0f) as usize]));
|
58 + | }
|
59 + | }
|
60 + | }
|
61 + | out
|
62 + | }
|
63 + |
|
64 + | pub(crate) const HEX: &[u8; 16] = b"0123456789ABCDEF";
|
65 + |
|
66 + | /// A ShapeSerializer that intercepts member writes and routes HTTP-bound
|
67 + | /// members to headers, query params, or URI labels instead of the body.
|
68 + | ///
|
69 + | /// Members without HTTP binding traits are forwarded to the inner body
|
70 + | /// serializer unchanged.
|
71 + | struct HttpBindingSerializer<'a, S> {
|
72 + | body: S,
|
73 + | headers: Vec<(String, String)>,
|
74 + | query_params: Vec<(String, String)>,
|
75 + | labels: Vec<(String, String)>,
|
76 + | /// When set, member schemas are resolved from this schema by name to find
|
77 + | /// HTTP binding traits. This allows the protocol to override bindings
|
78 + | /// (e.g., for presigning where body members become query params).
|
79 + | input_schema: Option<&'a Schema>,
|
80 + | /// True for the top-level input struct in serialize_request.
|
81 + | /// Cleared after the first write_struct so nested structs delegate directly.
|
82 + | is_top_level: bool,
|
83 + | /// Tracks whether any member was written to the body serializer (i.e., a member
|
84 + | /// without an HTTP binding trait). Used by `HttpBindingProtocol` to determine
|
85 + | /// whether to wrap the body in `{}` and set `Content-Type: application/json`.
|
86 + | /// Per the REST-JSON spec, operations with no body members must send an empty
|
87 + | /// body with no Content-Type header.
|
88 + | has_body_content: bool,
|
89 + | /// Raw payload bytes for `@httpPayload` blob/string members. When a member
|
90 + | /// has `@httpPayload` and targets a blob or string, the raw bytes bypass
|
91 + | /// the codec serializer entirely and are used as the HTTP body directly.
|
92 + | /// Safety: the referenced bytes are borrowed from the input struct passed to
|
93 + | /// `serialize_request`, which outlives this serializer.
|
94 + | raw_payload: Option<&'a [u8]>,
|
95 + | }
|
96 + |
|
97 + | impl<'a, S> HttpBindingSerializer<'a, S> {
|
98 + | fn new(body: S, input_schema: Option<&'a Schema>) -> Self {
|
99 + | Self {
|
100 + | body,
|
101 + | headers: Vec::new(),
|
102 + | query_params: Vec::new(),
|
103 + | labels: Vec::new(),
|
104 + | input_schema,
|
105 + | is_top_level: true,
|
106 + | has_body_content: false,
|
107 + | raw_payload: None,
|
108 + | }
|
109 + | }
|
110 + |
|
111 + | /// Finish serialization and return only the body bytes, discarding
|
112 + | /// any collected headers/query/labels.
|
113 + | fn finish_body(self) -> Vec<u8>
|
114 + | where
|
115 + | S: FinishSerializer,
|
116 + | {
|
117 + | if let Some(payload) = self.raw_payload {
|
118 + | payload.to_vec()
|
119 + | } else {
|
120 + | self.body.finish()
|
121 + | }
|
122 + | }
|
123 + |
|
124 + | /// Resolve the effective member schema: if an input_schema override is set,
|
125 + | /// look up the member by name there (to get the correct HTTP bindings).
|
126 + | /// Otherwise use the schema as-is.
|
127 + | fn resolve_member<'s>(&self, schema: &'s Schema) -> &'s Schema
|
128 + | where
|
129 + | 'a: 's,
|
130 + | {
|
131 + | if let (Some(input_schema), Some(name)) = (self.input_schema, schema.member_name()) {
|
132 + | input_schema.member_schema(name).unwrap_or(schema)
|
133 + | } else {
|
134 + | schema
|
135 + | }
|
136 + | }
|
137 + | }
|
138 + |
|
139 + | /// Helper: format a value as a string for HTTP binding serialization.
|
140 + | fn value_to_string<T: std::fmt::Display>(value: T) -> String {
|
141 + | value.to_string()
|
142 + | }
|
143 + |
|
144 + | impl<'a, S: ShapeSerializer> ShapeSerializer for HttpBindingSerializer<'a, S> {
|
145 + | fn write_struct(
|
146 + | &mut self,
|
147 + | schema: &Schema,
|
148 + | value: &dyn SerializableStruct,
|
149 + | ) -> Result<(), SerdeError> {
|
150 + | if self.is_top_level {
|
151 + | // Top-level input struct: route serialize_members through the binder
|
152 + | // so HTTP-bound members are intercepted. The body serializer's
|
153 + | // write_struct is used for framing (e.g., { } for JSON), with a
|
154 + | // proxy whose serialize_members delegates back to the binder.
|
155 + | struct Proxy<'a, 'b, S> {
|
156 + | binder: &'a mut HttpBindingSerializer<'b, S>,
|
157 + | value: &'a dyn SerializableStruct,
|
158 + | }
|
159 + | impl<S: ShapeSerializer> SerializableStruct for Proxy<'_, '_, S> {
|
160 + | fn serialize_members(
|
161 + | &self,
|
162 + | _serializer: &mut dyn ShapeSerializer,
|
163 + | ) -> Result<(), SerdeError> {
|
164 + | let binder = self.binder as *const HttpBindingSerializer<'_, S>
|
165 + | as *mut HttpBindingSerializer<'_, S>;
|
166 + | // SAFETY: The body serializer called serialize_members on
|
167 + | // this proxy, passing &mut self (body). The binder wraps
|
168 + | // that same body serializer. We need mutable access to the
|
169 + | // binder to route writes. This is safe because:
|
170 + | // 1. The body serializer's write_struct only calls
|
171 + | // serialize_members once, synchronously.
|
172 + | // 2. Body member writes from the binder go back to the
|
173 + | // body serializer, which is in a valid state (between
|
174 + | // the { and } it emitted).
|
175 + | self.value.serialize_members(unsafe { &mut *binder })
|
176 + | }
|
177 + | }
|
178 + | // Clear is_top_level so nested write_struct calls (from body members)
|
179 + | // take the else branch and delegate directly to the body serializer.
|
180 + | // input_schema is preserved so resolve_member continues to work.
|
181 + | self.is_top_level = false;
|
182 + | let proxy = Proxy {
|
183 + | binder: self,
|
184 + | value,
|
185 + | };
|
186 + | let binder_ptr = &mut *proxy.binder as *mut HttpBindingSerializer<'_, S>;
|
187 + | // SAFETY: `proxy` holds a shared reference to `binder` (via &mut that
|
188 + | // we reborrow). We need to call `binder.body.write_struct(schema, &proxy)`
|
189 + | // but can't do so through normal references because `proxy` borrows `binder`.
|
190 + | // The raw pointer dereference is safe because:
|
191 + | // 1. `binder_ptr` points to a valid, live `HttpBindingSerializer` (it was
|
192 + | // just derived from `proxy.binder`).
|
193 + | // 2. `body.write_struct` is called synchronously and returns before `proxy`
|
194 + | // is dropped, so the binder is not moved or deallocated.
|
195 + | // 3. The only re-entrant access is through `proxy.serialize_members`, which
|
196 + | // uses the same raw-pointer pattern with its own safety justification above.
|
197 + | unsafe { (*binder_ptr).body.write_struct(schema, &proxy) }
|
198 + | } else {
|
199 + | // Nested struct (a body member targeting a structure): delegate
|
200 + | // entirely to the body serializer.
|
201 + | let schema = self.resolve_member(schema);
|
202 + | if schema.http_payload().is_some() {
|
203 + | // @httpPayload struct/union: write as the body's top-level object
|
204 + | // without a member name prefix. Use a non-member schema for the
|
205 + | // write_struct call so prefix() doesn't emit a field name.
|
206 + | self.has_body_content = true;
|
207 + | self.body.write_struct(&crate::prelude::DOCUMENT, value)?;
|
208 + | return Ok(());
|
209 + | }
|
210 + | self.has_body_content = true;
|
211 + | self.body.write_struct(schema, value)
|
212 + | }
|
213 + | }
|
214 + |
|
215 + | fn write_list(
|
216 + | &mut self,
|
217 + | schema: &Schema,
|
218 + | write_elements: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
219 + | ) -> Result<(), SerdeError> {
|
220 + | self.has_body_content = true;
|
221 + | self.body.write_list(schema, write_elements)
|
222 + | }
|
223 + |
|
224 + | fn write_map(
|
225 + | &mut self,
|
226 + | schema: &Schema,
|
227 + | write_entries: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
228 + | ) -> Result<(), SerdeError> {
|
229 + | let schema = self.resolve_member(schema);
|
230 + | // @httpPrefixHeaders: serialize map entries as prefixed headers
|
231 + | if let Some(prefix) = schema.http_prefix_headers() {
|
232 + | // Collect entries via a temporary serializer
|
233 + | let mut collector = MapEntryCollector::new(prefix.value().to_string());
|
234 + | write_entries(&mut collector)?;
|
235 + | self.headers.extend(collector.entries);
|
236 + | return Ok(());
|
237 + | }
|
238 + | // @httpQueryParams: serialize map entries as query params
|
239 + | if schema.http_query_params().is_some() {
|
240 + | let mut collector = MapEntryCollector::new(String::new());
|
241 + | write_entries(&mut collector)?;
|
242 + | for (k, v) in collector.entries {
|
243 + | self.query_params.push((k, v));
|
244 + | }
|
245 + | return Ok(());
|
246 + | }
|
247 + | self.has_body_content = true;
|
248 + | self.body.write_map(schema, write_entries)
|
249 + | }
|
250 + |
|
251 + | fn write_boolean(&mut self, schema: &Schema, value: bool) -> Result<(), SerdeError> {
|
252 + | let schema = self.resolve_member(schema);
|
253 + | if let Some(binding) = http_string_binding(schema) {
|
254 + | return self.add_binding(binding, schema, &value_to_string(value));
|
255 + | }
|
256 + | self.has_body_content = true;
|
257 + | self.body.write_boolean(schema, value)
|
258 + | }
|
259 + |
|
260 + | fn write_byte(&mut self, schema: &Schema, value: i8) -> Result<(), SerdeError> {
|
261 + | let schema = self.resolve_member(schema);
|
262 + | if let Some(binding) = http_string_binding(schema) {
|
263 + | return self.add_binding(binding, schema, &value_to_string(value));
|
264 + | }
|
265 + | self.has_body_content = true;
|
266 + | self.body.write_byte(schema, value)
|
267 + | }
|
268 + |
|
269 + | fn write_short(&mut self, schema: &Schema, value: i16) -> Result<(), SerdeError> {
|
270 + | let schema = self.resolve_member(schema);
|
271 + | if let Some(binding) = http_string_binding(schema) {
|
272 + | return self.add_binding(binding, schema, &value_to_string(value));
|
273 + | }
|
274 + | self.has_body_content = true;
|
275 + | self.body.write_short(schema, value)
|
276 + | }
|
277 + |
|
278 + | fn write_integer(&mut self, schema: &Schema, value: i32) -> Result<(), SerdeError> {
|
279 + | let schema = self.resolve_member(schema);
|
280 + | if let Some(binding) = http_string_binding(schema) {
|
281 + | return self.add_binding(binding, schema, &value_to_string(value));
|
282 + | }
|
283 + | self.has_body_content = true;
|
284 + | self.body.write_integer(schema, value)
|
285 + | }
|
286 + |
|
287 + | fn write_long(&mut self, schema: &Schema, value: i64) -> Result<(), SerdeError> {
|
288 + | let schema = self.resolve_member(schema);
|
289 + | if let Some(binding) = http_string_binding(schema) {
|
290 + | return self.add_binding(binding, schema, &value_to_string(value));
|
291 + | }
|
292 + | self.has_body_content = true;
|
293 + | self.body.write_long(schema, value)
|
294 + | }
|
295 + |
|
296 + | fn write_float(&mut self, schema: &Schema, value: f32) -> Result<(), SerdeError> {
|
297 + | let schema = self.resolve_member(schema);
|
298 + | if let Some(binding) = http_string_binding(schema) {
|
299 + | return self.add_binding(binding, schema, &value_to_string(value));
|
300 + | }
|
301 + | self.has_body_content = true;
|
302 + | self.body.write_float(schema, value)
|
303 + | }
|
304 + |
|
305 + | fn write_double(&mut self, schema: &Schema, value: f64) -> Result<(), SerdeError> {
|
306 + | let schema = self.resolve_member(schema);
|
307 + | if let Some(binding) = http_string_binding(schema) {
|
308 + | return self.add_binding(binding, schema, &value_to_string(value));
|
309 + | }
|
310 + | self.has_body_content = true;
|
311 + | self.body.write_double(schema, value)
|
312 + | }
|
313 + |
|
314 + | fn write_big_integer(
|
315 + | &mut self,
|
316 + | schema: &Schema,
|
317 + | value: &aws_smithy_types::BigInteger,
|
318 + | ) -> Result<(), SerdeError> {
|
319 + | let schema = self.resolve_member(schema);
|
320 + | if let Some(binding) = http_string_binding(schema) {
|
321 + | return self.add_binding(binding, schema, value.as_ref());
|
322 + | }
|
323 + | self.has_body_content = true;
|
324 + | self.body.write_big_integer(schema, value)
|
325 + | }
|
326 + |
|
327 + | fn write_big_decimal(
|
328 + | &mut self,
|
329 + | schema: &Schema,
|
330 + | value: &aws_smithy_types::BigDecimal,
|
331 + | ) -> Result<(), SerdeError> {
|
332 + | let schema = self.resolve_member(schema);
|
333 + | if let Some(binding) = http_string_binding(schema) {
|
334 + | return self.add_binding(binding, schema, value.as_ref());
|
335 + | }
|
336 + | self.has_body_content = true;
|
337 + | self.body.write_big_decimal(schema, value)
|
338 + | }
|
339 + |
|
340 + | fn write_string(&mut self, schema: &Schema, value: &str) -> Result<(), SerdeError> {
|
341 + | let schema = self.resolve_member(schema);
|
342 + | if let Some(binding) = http_string_binding(schema) {
|
343 + | return self.add_binding(binding, schema, value);
|
344 + | }
|
345 + | if schema.http_payload().is_some() {
|
346 + | // SAFETY: We extend the lifetime of `value.as_bytes()` from its anonymous
|
347 + | // lifetime to `'a`. This is sound because:
|
348 + | // 1. `value` is borrowed from the input struct passed to `serialize_request`.
|
349 + | // 2. `HttpBindingSerializer` is a local variable within `serialize_request`
|
350 + | // and is dropped before `serialize_request` returns.
|
351 + | // 3. The input struct (and thus `value`) outlives the serializer.
|
352 + | // 4. `raw_payload` is read in `serialize_request` immediately after
|
353 + | // `serialize_members` returns, before the input is dropped.
|
354 + | // We use transmute rather than copying to avoid allocating for potentially
|
355 + | // multi-GB string payloads.
|
356 + | self.raw_payload =
|
357 + | Some(unsafe { std::mem::transmute::<&[u8], &'a [u8]>(value.as_bytes()) });
|
358 + | return Ok(());
|
359 + | }
|
360 + | self.has_body_content = true;
|
361 + | self.body.write_string(schema, value)
|
362 + | }
|
363 + |
|
364 + | fn write_blob(
|
365 + | &mut self,
|
366 + | schema: &Schema,
|
367 + | value: &aws_smithy_types::Blob,
|
368 + | ) -> Result<(), SerdeError> {
|
369 + | let schema = self.resolve_member(schema);
|
370 + | if schema.http_header().is_some() {
|
371 + | let encoded = aws_smithy_types::base64::encode(value.as_ref());
|
372 + | self.headers
|
373 + | .push((schema.http_header().unwrap().value().to_string(), encoded));
|
374 + | return Ok(());
|
375 + | }
|
376 + | if schema.http_payload().is_some() {
|
377 + | // SAFETY: We extend the lifetime of `value.as_ref()` (a `&[u8]`) from its
|
378 + | // anonymous lifetime to `'a`. This is sound because:
|
379 + | // 1. `value` is borrowed from the input struct passed to `serialize_request`.
|
380 + | // 2. `HttpBindingSerializer` is a local variable within `serialize_request`
|
381 + | // and is dropped before `serialize_request` returns.
|
382 + | // 3. The input struct (and thus `value`) outlives the serializer.
|
383 + | // 4. `raw_payload` is read in `serialize_request` immediately after
|
384 + | // `serialize_members` returns, before the input is dropped.
|
385 + | // We use transmute rather than copying to avoid allocating for potentially
|
386 + | // multi-GB blob payloads.
|
387 + | self.raw_payload =
|
388 + | Some(unsafe { std::mem::transmute::<&[u8], &'a [u8]>(value.as_ref()) });
|
389 + | return Ok(());
|
390 + | }
|
391 + | self.has_body_content = true;
|
392 + | self.body.write_blob(schema, value)
|
393 + | }
|
394 + |
|
395 + | fn write_timestamp(
|
396 + | &mut self,
|
397 + | schema: &Schema,
|
398 + | value: &aws_smithy_types::DateTime,
|
399 + | ) -> Result<(), SerdeError> {
|
400 + | let schema = self.resolve_member(schema);
|
401 + | if let Some(binding) = http_string_binding(schema) {
|
402 + | // Headers default to http-date, query/label default to date-time
|
403 + | let format = if schema.timestamp_format().is_some() {
|
404 + | match schema.timestamp_format().unwrap().format() {
|
405 + | crate::traits::TimestampFormat::EpochSeconds => {
|
406 + | aws_smithy_types::date_time::Format::EpochSeconds
|
407 + | }
|
408 + | crate::traits::TimestampFormat::HttpDate => {
|
409 + | aws_smithy_types::date_time::Format::HttpDate
|
410 + | }
|
411 + | crate::traits::TimestampFormat::DateTime => {
|
412 + | aws_smithy_types::date_time::Format::DateTime
|
413 + | }
|
414 + | }
|
415 + | } else {
|
416 + | match binding {
|
417 + | HttpBinding::Header(_) => aws_smithy_types::date_time::Format::HttpDate,
|
418 + | _ => aws_smithy_types::date_time::Format::DateTime,
|
419 + | }
|
420 + | };
|
421 + | let formatted = value
|
422 + | .fmt(format)
|
423 + | .map_err(|e| SerdeError::custom(format!("failed to format timestamp: {e}")))?;
|
424 + | return self.add_binding(binding, schema, &formatted);
|
425 + | }
|
426 + | self.has_body_content = true;
|
427 + | self.body.write_timestamp(schema, value)
|
428 + | }
|
429 + |
|
430 + | fn write_document(
|
431 + | &mut self,
|
432 + | schema: &Schema,
|
433 + | value: &aws_smithy_types::Document,
|
434 + | ) -> Result<(), SerdeError> {
|
435 + | self.has_body_content = true;
|
436 + | self.body.write_document(schema, value)
|
437 + | }
|
438 + |
|
439 + | fn write_null(&mut self, schema: &Schema) -> Result<(), SerdeError> {
|
440 + | self.has_body_content = true;
|
441 + | self.body.write_null(schema)
|
442 + | }
|
443 + | }
|
444 + |
|
445 + | /// Which HTTP location a member is bound to.
|
446 + | enum HttpBinding<'a> {
|
447 + | Header(&'a str),
|
448 + | Query(&'a str),
|
449 + | Label,
|
450 + | }
|
451 + |
|
452 + | /// Determine the HTTP binding for a member schema, if any.
|
453 + | fn http_string_binding(schema: &Schema) -> Option<HttpBinding<'_>> {
|
454 + | if let Some(h) = schema.http_header() {
|
455 + | return Some(HttpBinding::Header(h.value()));
|
456 + | }
|
457 + | if let Some(q) = schema.http_query() {
|
458 + | return Some(HttpBinding::Query(q.value()));
|
459 + | }
|
460 + | if schema.http_label().is_some() {
|
461 + | return Some(HttpBinding::Label);
|
462 + | }
|
463 + | None
|
464 + | }
|
465 + |
|
466 + | impl<'a, S> HttpBindingSerializer<'a, S> {
|
467 + | fn add_binding(
|
468 + | &mut self,
|
469 + | binding: HttpBinding<'_>,
|
470 + | schema: &Schema,
|
471 + | value: &str,
|
472 + | ) -> Result<(), SerdeError> {
|
473 + | match binding {
|
474 + | HttpBinding::Header(name) => {
|
475 + | self.headers.push((name.to_string(), value.to_string()));
|
476 + | }
|
477 + | HttpBinding::Query(name) => {
|
478 + | self.query_params
|
479 + | .push((name.to_string(), value.to_string()));
|
480 + | }
|
481 + | HttpBinding::Label => {
|
482 + | let name = schema
|
483 + | .member_name()
|
484 + | .ok_or_else(|| SerdeError::custom("httpLabel on non-member schema"))?;
|
485 + | self.labels.push((name.to_string(), value.to_string()));
|
486 + | }
|
487 + | }
|
488 + | Ok(())
|
489 + | }
|
490 + | }
|
491 + |
|
492 + | /// Collects map key-value pairs written via ShapeSerializer for
|
493 + | /// @httpPrefixHeaders and @httpQueryParams.
|
494 + | struct MapEntryCollector {
|
495 + | prefix: String,
|
496 + | entries: Vec<(String, String)>,
|
497 + | pending_key: Option<String>,
|
498 + | }
|
499 + |
|
500 + | impl MapEntryCollector {
|
501 + | fn new(prefix: String) -> Self {
|
502 + | Self {
|
503 + | prefix,
|
504 + | entries: Vec::new(),
|
505 + | pending_key: None,
|
506 + | }
|
507 + | }
|
508 + | }
|
509 + |
|
510 + | impl ShapeSerializer for MapEntryCollector {
|
511 + | fn write_string(&mut self, _schema: &Schema, value: &str) -> Result<(), SerdeError> {
|
512 + | if let Some(key) = self.pending_key.take() {
|
513 + | self.entries
|
514 + | .push((format!("{}{}", self.prefix, key), value.to_string()));
|
515 + | } else {
|
516 + | self.pending_key = Some(value.to_string());
|
517 + | }
|
518 + | Ok(())
|
519 + | }
|
520 + |
|
521 + | // All other methods are no-ops — maps in HTTP bindings only have string keys/values.
|
522 + | fn write_struct(&mut self, _: &Schema, _: &dyn SerializableStruct) -> Result<(), SerdeError> {
|
523 + | Ok(())
|
524 + | }
|
525 + | fn write_list(
|
526 + | &mut self,
|
527 + | _: &Schema,
|
528 + | _: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
529 + | ) -> Result<(), SerdeError> {
|
530 + | Ok(())
|
531 + | }
|
532 + | fn write_map(
|
533 + | &mut self,
|
534 + | _: &Schema,
|
535 + | _: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
536 + | ) -> Result<(), SerdeError> {
|
537 + | Ok(())
|
538 + | }
|
539 + | fn write_boolean(&mut self, _: &Schema, _: bool) -> Result<(), SerdeError> {
|
540 + | Ok(())
|
541 + | }
|
542 + | fn write_byte(&mut self, _: &Schema, _: i8) -> Result<(), SerdeError> {
|
543 + | Ok(())
|
544 + | }
|
545 + | fn write_short(&mut self, _: &Schema, _: i16) -> Result<(), SerdeError> {
|
546 + | Ok(())
|
547 + | }
|
548 + | fn write_integer(&mut self, _: &Schema, _: i32) -> Result<(), SerdeError> {
|
549 + | Ok(())
|
550 + | }
|
551 + | fn write_long(&mut self, _: &Schema, _: i64) -> Result<(), SerdeError> {
|
552 + | Ok(())
|
553 + | }
|
554 + | fn write_float(&mut self, _: &Schema, _: f32) -> Result<(), SerdeError> {
|
555 + | Ok(())
|
556 + | }
|
557 + | fn write_double(&mut self, _: &Schema, _: f64) -> Result<(), SerdeError> {
|
558 + | Ok(())
|
559 + | }
|
560 + | fn write_big_integer(
|
561 + | &mut self,
|
562 + | _: &Schema,
|
563 + | _: &aws_smithy_types::BigInteger,
|
564 + | ) -> Result<(), SerdeError> {
|
565 + | Ok(())
|
566 + | }
|
567 + | fn write_big_decimal(
|
568 + | &mut self,
|
569 + | _: &Schema,
|
570 + | _: &aws_smithy_types::BigDecimal,
|
571 + | ) -> Result<(), SerdeError> {
|
572 + | Ok(())
|
573 + | }
|
574 + | fn write_blob(&mut self, _: &Schema, _: &aws_smithy_types::Blob) -> Result<(), SerdeError> {
|
575 + | Ok(())
|
576 + | }
|
577 + | fn write_timestamp(
|
578 + | &mut self,
|
579 + | _: &Schema,
|
580 + | _: &aws_smithy_types::DateTime,
|
581 + | ) -> Result<(), SerdeError> {
|
582 + | Ok(())
|
583 + | }
|
584 + | fn write_document(
|
585 + | &mut self,
|
586 + | _: &Schema,
|
587 + | _: &aws_smithy_types::Document,
|
588 + | ) -> Result<(), SerdeError> {
|
589 + | Ok(())
|
590 + | }
|
591 + | fn write_null(&mut self, _: &Schema) -> Result<(), SerdeError> {
|
592 + | Ok(())
|
593 + | }
|
594 + | }
|
595 + |
|
596 + | impl<C> ClientProtocol for HttpBindingProtocol<C>
|
597 + | where
|
598 + | C: Codec + Send + Sync + std::fmt::Debug + 'static,
|
599 + | for<'a> C::Deserializer<'a>: ShapeDeserializer,
|
600 + | {
|
601 + | fn protocol_id(&self) -> &ShapeId {
|
602 + | &self.protocol_id
|
603 + | }
|
604 + |
|
605 + | fn supports_http_bindings(&self) -> bool {
|
606 + | true
|
607 + | }
|
608 + |
|
609 + | fn serialize_request(
|
610 + | &self,
|
611 + | input: &dyn SerializableStruct,
|
612 + | input_schema: &Schema,
|
613 + | endpoint: &str,
|
614 + | _cfg: &ConfigBag,
|
615 + | ) -> Result<Request, SerdeError> {
|
616 + | let mut binder =
|
617 + | HttpBindingSerializer::new(self.codec.create_serializer(), Some(input_schema));
|
618 + |
|
619 + | // Check if there's an @httpPayload member targeting a structure/union.
|
620 + | // In that case, the payload member's own write_struct provides the body
|
621 + | // framing, so we must not add top-level struct framing.
|
622 + | let has_struct_payload = input_schema.members().iter().any(|m| {
|
623 + | m.http_payload().is_some()
|
624 + | && matches!(
|
625 + | m.shape_type(),
|
626 + | crate::ShapeType::Structure | crate::ShapeType::Union
|
627 + | )
|
628 + | });
|
629 + | if has_struct_payload {
|
630 + | binder.is_top_level = false;
|
631 + | input.serialize_members(&mut binder)?;
|
632 + | } else {
|
633 + | binder.write_struct(input_schema, input)?;
|
634 + | }
|
635 + | let raw_payload = binder.raw_payload;
|
636 + | let mut body = if raw_payload.is_some() {
|
637 + | // @httpPayload blob/string — don't use the codec output
|
638 + | Vec::new()
|
639 + | } else {
|
640 + | binder.body.finish()
|
641 + | };
|
642 + |
|
643 + | // Per the REST-JSON content-type handling spec:
|
644 + | // - If @httpPayload targets a blob/string: send raw bytes, no Content-Type when empty
|
645 + | // - If body members exist (even if all optional and unset): send `{}` with Content-Type
|
646 + | // - If no body members at all (everything is in headers/query/labels): empty body, no Content-Type
|
647 + | let has_blob_or_string_payload = raw_payload.is_some();
|
648 + | let has_body_members = input_schema.members().iter().any(|m| {
|
649 + | m.http_header().is_none()
|
650 + | && m.http_query().is_none()
|
651 + | && m.http_label().is_none()
|
652 + | && m.http_prefix_headers().is_none()
|
653 + | && m.http_query_params().is_none()
|
654 + | });
|
655 + |
|
656 + | let set_content_type = if has_blob_or_string_payload {
|
657 + | // Blob/string payload: only set Content-Type if there's actual content
|
658 + | raw_payload.is_some_and(|p| !p.is_empty())
|
659 + | } else if has_body_members {
|
660 + | // Operation has body members — body includes framing (e.g., `{}`).
|
661 + | // Per the REST-JSON spec, even if all members are optional and unset, send `{}`.
|
662 + | true
|
663 + | } else {
|
664 + | // No body members at all — empty body, no Content-Type.
|
665 + | body = Vec::new();
|
666 + | false
|
667 + | };
|
668 + |
|
669 + | // Build URI: use @http trait if available (with label substitution from binder),
|
670 + | // otherwise fall back to endpoint with manual label substitution.
|
671 + | let mut uri = match input_schema.http() {
|
672 + | Some(h) => {
|
673 + | let mut path = h.uri().to_string();
|
674 + | for (name, value) in &binder.labels {
|
675 + | let placeholder = format!("{{{name}}}");
|
676 + | path = path.replace(&placeholder, &percent_encode(value));
|
677 + | }
|
678 + | if endpoint.is_empty() {
|
679 + | path
|
680 + | } else {
|
681 + | format!("{}{}", endpoint, path)
|
682 + | }
|
683 + | }
|
684 + | None => {
|
685 + | let mut u = if endpoint.is_empty() {
|
686 + | "/".to_string()
|
687 + | } else {
|
688 + | endpoint.to_string()
|
689 + | };
|
690 + | for (name, value) in &binder.labels {
|
691 + | let placeholder = format!("{{{name}}}");
|
692 + | u = u.replace(&placeholder, &percent_encode(value));
|
693 + | }
|
694 + | u
|
695 + | }
|
696 + | };
|
697 + | if !binder.query_params.is_empty() {
|
698 + | uri.push(if uri.contains('?') { '&' } else { '?' });
|
699 + | let pairs: Vec<String> = binder
|
700 + | .query_params
|
701 + | .iter()
|
702 + | .map(|(k, v)| format!("{}={}", percent_encode(k), percent_encode(v)))
|
703 + | .collect();
|
704 + | uri.push_str(&pairs.join("&"));
|
705 + | }
|
706 + |
|
707 + | let mut request = if let Some(payload) = raw_payload {
|
708 + | Request::new(SdkBody::from(payload))
|
709 + | } else {
|
710 + | Request::new(SdkBody::from(body))
|
711 + | };
|
712 + | // Set HTTP method from @http trait
|
713 + | if let Some(http) = input_schema.http() {
|
714 + | request
|
715 + | .set_method(http.method())
|
716 + | .map_err(|e| SerdeError::custom(format!("invalid HTTP method: {e}")))?;
|
717 + | }
|
718 + | request
|
719 + | .set_uri(uri.as_str())
|
720 + | .map_err(|e| SerdeError::custom(format!("invalid endpoint URI: {e}")))?;
|
721 + | if set_content_type {
|
722 + | request
|
723 + | .headers_mut()
|
724 + | .insert("Content-Type", self.content_type);
|
725 + | }
|
726 + | if let Some(len) = request.body().content_length() {
|
727 + | if len > 0 || set_content_type {
|
728 + | request
|
729 + | .headers_mut()
|
730 + | .insert("Content-Length", len.to_string());
|
731 + | }
|
732 + | }
|
733 + | for (name, value) in &binder.headers {
|
734 + | request.headers_mut().insert(name.clone(), value.clone());
|
735 + | }
|
736 + | Ok(request)
|
737 + | }
|
738 + |
|
739 + | fn deserialize_response<'a>(
|
740 + | &self,
|
741 + | response: &'a Response,
|
742 + | _output_schema: &Schema,
|
743 + | _cfg: &ConfigBag,
|
744 + | ) -> Result<Box<dyn ShapeDeserializer + 'a>, SerdeError> {
|
745 + | let body = response
|
746 + | .body()
|
747 + | .bytes()
|
748 + | .ok_or_else(|| SerdeError::custom("response body is not available as bytes"))?;
|
749 + | Ok(Box::new(self.codec.create_deserializer(body)))
|
750 + | }
|
751 + |
|
752 + | fn serialize_body(
|
753 + | &self,
|
754 + | input: &dyn SerializableStruct,
|
755 + | input_schema: &Schema,
|
756 + | _endpoint: &str,
|
757 + | _cfg: &ConfigBag,
|
758 + | ) -> Result<Request, SerdeError> {
|
759 + | // Check if there are body members (non-HTTP-bound) to determine Content-Type and body behavior.
|
760 + | let has_body_members = input_schema.members().iter().any(|m| {
|
761 + | m.http_header().is_none()
|
762 + | && m.http_query().is_none()
|
763 + | && m.http_label().is_none()
|
764 + | && m.http_prefix_headers().is_none()
|
765 + | && m.http_query_params().is_none()
|
766 + | && m.http_payload().is_none()
|
767 + | });
|
768 + |
|
769 + | // Use HttpBindingSerializer to filter out HTTP-bound members, keeping only body members.
|
770 + | // The collected headers/query/labels are discarded — the caller writes those directly.
|
771 + | let mut request = if has_body_members {
|
772 + | let serializer = self.codec.create_serializer();
|
773 + | let mut binding_ser = HttpBindingSerializer::new(serializer, None);
|
774 + | binding_ser.write_struct(input_schema, input)?;
|
775 + | let body = binding_ser.finish_body();
|
776 + | let mut r = Request::new(SdkBody::from(body));
|
777 + | r.headers_mut().insert("Content-Type", self.content_type);
|
778 + | if let Some(len) = r.body().content_length() {
|
779 + | r.headers_mut().insert("Content-Length", len.to_string());
|
780 + | }
|
781 + | r
|
782 + | } else {
|
783 + | Request::new(SdkBody::empty())
|
784 + | };
|
785 + |
|
786 + | // Set HTTP method from @http trait.
|
787 + | if let Some(http) = input_schema.http() {
|
788 + | request
|
789 + | .set_method(http.method())
|
790 + | .map_err(|e| SerdeError::custom(format!("invalid HTTP method: {e}")))?;
|
791 + | }
|
792 + | Ok(request)
|
793 + | }
|
794 + | }
|
795 + |
|
796 + | #[cfg(test)]
|
797 + | mod tests {
|
798 + | use super::*;
|
799 + | use crate::serde::SerializableStruct;
|
800 + | use crate::{prelude::*, ShapeType};
|
801 + |
|
802 + | struct TestSerializer {
|
803 + | output: Vec<u8>,
|
804 + | }
|
805 + |
|
806 + | impl FinishSerializer for TestSerializer {
|
807 + | fn finish(self) -> Vec<u8> {
|
808 + | self.output
|
809 + | }
|
810 + | }
|
811 + |
|
812 + | impl ShapeSerializer for TestSerializer {
|
813 + | fn write_struct(
|
814 + | &mut self,
|
815 + | _: &Schema,
|
816 + | value: &dyn SerializableStruct,
|
817 + | ) -> Result<(), SerdeError> {
|
818 + | self.output.push(b'{');
|
819 + | value.serialize_members(self)?;
|
820 + | self.output.push(b'}');
|
821 + | Ok(())
|
822 + | }
|
823 + | fn write_list(
|
824 + | &mut self,
|
825 + | _: &Schema,
|
826 + | _: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
827 + | ) -> Result<(), SerdeError> {
|
828 + | Ok(())
|
829 + | }
|
830 + | fn write_map(
|
831 + | &mut self,
|
832 + | _: &Schema,
|
833 + | _: &dyn Fn(&mut dyn ShapeSerializer) -> Result<(), SerdeError>,
|
834 + | ) -> Result<(), SerdeError> {
|
835 + | Ok(())
|
836 + | }
|
837 + | fn write_boolean(&mut self, _: &Schema, _: bool) -> Result<(), SerdeError> {
|
838 + | Ok(())
|
839 + | }
|
840 + | fn write_byte(&mut self, _: &Schema, _: i8) -> Result<(), SerdeError> {
|
841 + | Ok(())
|
842 + | }
|
843 + | fn write_short(&mut self, _: &Schema, _: i16) -> Result<(), SerdeError> {
|
844 + | Ok(())
|
845 + | }
|
846 + | fn write_integer(&mut self, _: &Schema, _: i32) -> Result<(), SerdeError> {
|
847 + | Ok(())
|
848 + | }
|
849 + | fn write_long(&mut self, _: &Schema, _: i64) -> Result<(), SerdeError> {
|
850 + | Ok(())
|
851 + | }
|
852 + | fn write_float(&mut self, _: &Schema, _: f32) -> Result<(), SerdeError> {
|
853 + | Ok(())
|
854 + | }
|
855 + | fn write_double(&mut self, _: &Schema, _: f64) -> Result<(), SerdeError> {
|
856 + | Ok(())
|
857 + | }
|
858 + | fn write_big_integer(
|
859 + | &mut self,
|
860 + | _: &Schema,
|
861 + | _: &aws_smithy_types::BigInteger,
|
862 + | ) -> Result<(), SerdeError> {
|
863 + | Ok(())
|
864 + | }
|
865 + | fn write_big_decimal(
|
866 + | &mut self,
|
867 + | _: &Schema,
|
868 + | _: &aws_smithy_types::BigDecimal,
|
869 + | ) -> Result<(), SerdeError> {
|
870 + | Ok(())
|
871 + | }
|
872 + | fn write_string(&mut self, _: &Schema, v: &str) -> Result<(), SerdeError> {
|
873 + | self.output.extend_from_slice(v.as_bytes());
|
874 + | Ok(())
|
875 + | }
|
876 + | fn write_blob(&mut self, _: &Schema, _: &aws_smithy_types::Blob) -> Result<(), SerdeError> {
|
877 + | Ok(())
|
878 + | }
|
879 + | fn write_timestamp(
|
880 + | &mut self,
|
881 + | _: &Schema,
|
882 + | _: &aws_smithy_types::DateTime,
|
883 + | ) -> Result<(), SerdeError> {
|
884 + | Ok(())
|
885 + | }
|
886 + | fn write_document(
|
887 + | &mut self,
|
888 + | _: &Schema,
|
889 + | _: &aws_smithy_types::Document,
|
890 + | ) -> Result<(), SerdeError> {
|
891 + | Ok(())
|
892 + | }
|
893 + | fn write_null(&mut self, _: &Schema) -> Result<(), SerdeError> {
|
894 + | Ok(())
|
895 + | }
|
896 + | }
|
897 + |
|
898 + | struct TestDeserializer<'a> {
|
899 + | input: &'a [u8],
|
900 + | }
|
901 + |
|
902 + | impl ShapeDeserializer for TestDeserializer<'_> {
|
903 + | fn read_struct(
|
904 + | &mut self,
|
905 + | _: &Schema,
|
906 + | _: &mut dyn FnMut(&Schema, &mut dyn ShapeDeserializer) -> Result<(), SerdeError>,
|
907 + | ) -> Result<(), SerdeError> {
|
908 + | Ok(())
|
909 + | }
|
910 + | fn read_list(
|
911 + | &mut self,
|
912 + | _: &Schema,
|
913 + | _: &mut dyn FnMut(&mut dyn ShapeDeserializer) -> Result<(), SerdeError>,
|
914 + | ) -> Result<(), SerdeError> {
|
915 + | Ok(())
|
916 + | }
|
917 + | fn read_map(
|
918 + | &mut self,
|
919 + | _: &Schema,
|
920 + | _: &mut dyn FnMut(String, &mut dyn ShapeDeserializer) -> Result<(), SerdeError>,
|
921 + | ) -> Result<(), SerdeError> {
|
922 + | Ok(())
|
923 + | }
|
924 + | fn read_boolean(&mut self, _: &Schema) -> Result<bool, SerdeError> {
|
925 + | Ok(false)
|
926 + | }
|
927 + | fn read_byte(&mut self, _: &Schema) -> Result<i8, SerdeError> {
|
928 + | Ok(0)
|
929 + | }
|
930 + | fn read_short(&mut self, _: &Schema) -> Result<i16, SerdeError> {
|
931 + | Ok(0)
|
932 + | }
|
933 + | fn read_integer(&mut self, _: &Schema) -> Result<i32, SerdeError> {
|
934 + | Ok(0)
|
935 + | }
|
936 + | fn read_long(&mut self, _: &Schema) -> Result<i64, SerdeError> {
|
937 + | Ok(0)
|
938 + | }
|
939 + | fn read_float(&mut self, _: &Schema) -> Result<f32, SerdeError> {
|
940 + | Ok(0.0)
|
941 + | }
|
942 + | fn read_double(&mut self, _: &Schema) -> Result<f64, SerdeError> {
|
943 + | Ok(0.0)
|
944 + | }
|
945 + | fn read_big_integer(
|
946 + | &mut self,
|
947 + | _: &Schema,
|
948 + | ) -> Result<aws_smithy_types::BigInteger, SerdeError> {
|
949 + | use std::str::FromStr;
|
950 + | Ok(aws_smithy_types::BigInteger::from_str("0").unwrap())
|
951 + | }
|
952 + | fn read_big_decimal(
|
953 + | &mut self,
|
954 + | _: &Schema,
|
955 + | ) -> Result<aws_smithy_types::BigDecimal, SerdeError> {
|
956 + | use std::str::FromStr;
|
957 + | Ok(aws_smithy_types::BigDecimal::from_str("0").unwrap())
|
958 + | }
|
959 + | fn read_string(&mut self, _: &Schema) -> Result<String, SerdeError> {
|
960 + | Ok(String::from_utf8_lossy(self.input).into_owned())
|
961 + | }
|
962 + | fn read_blob(&mut self, _: &Schema) -> Result<aws_smithy_types::Blob, SerdeError> {
|
963 + | Ok(aws_smithy_types::Blob::new(vec![]))
|
964 + | }
|
965 + | fn read_timestamp(&mut self, _: &Schema) -> Result<aws_smithy_types::DateTime, SerdeError> {
|
966 + | Ok(aws_smithy_types::DateTime::from_secs(0))
|
967 + | }
|
968 + | fn read_document(&mut self, _: &Schema) -> Result<aws_smithy_types::Document, SerdeError> {
|
969 + | Ok(aws_smithy_types::Document::Null)
|
970 + | }
|
971 + | fn is_null(&self) -> bool {
|
972 + | false
|
973 + | }
|
974 + | fn container_size(&self) -> Option<usize> {
|
975 + | None
|
976 + | }
|
977 + | }
|
978 + |
|
979 + | #[derive(Debug)]
|
980 + | struct TestCodec;
|
981 + |
|
982 + | impl Codec for TestCodec {
|
983 + | type Serializer = TestSerializer;
|
984 + | type Deserializer<'a> = TestDeserializer<'a>;
|
985 + | fn create_serializer(&self) -> Self::Serializer {
|
986 + | TestSerializer { output: Vec::new() }
|
987 + | }
|
988 + | fn create_deserializer<'a>(&self, input: &'a [u8]) -> Self::Deserializer<'a> {
|
989 + | TestDeserializer { input }
|
990 + | }
|
991 + | }
|
992 + |
|
993 + | static TEST_SCHEMA: Schema =
|
994 + | Schema::new(crate::shape_id!("test", "TestStruct"), ShapeType::Structure);
|
995 + |
|
996 + | struct EmptyStruct;
|
997 + | impl SerializableStruct for EmptyStruct {
|
998 + | fn serialize_members(&self, _: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
999 + | Ok(())
|
1000 + | }
|
1001 + | }
|
1002 + |
|
1003 + | static NAME_MEMBER: Schema = Schema::new_member(
|
1004 + | crate::shape_id!("test", "TestStruct"),
|
1005 + | ShapeType::String,
|
1006 + | "name",
|
1007 + | 0,
|
1008 + | );
|
1009 + | static MEMBERS: &[&Schema] = &[&NAME_MEMBER];
|
1010 + | static STRUCT_WITH_MEMBER: Schema = Schema::new_struct(
|
1011 + | crate::shape_id!("test", "TestStruct"),
|
1012 + | ShapeType::Structure,
|
1013 + | MEMBERS,
|
1014 + | );
|
1015 + |
|
1016 + | struct NameStruct;
|
1017 + | impl SerializableStruct for NameStruct {
|
1018 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1019 + | s.write_string(&NAME_MEMBER, "Alice")
|
1020 + | }
|
1021 + | }
|
1022 + |
|
1023 + | fn make_protocol() -> HttpBindingProtocol<TestCodec> {
|
1024 + | HttpBindingProtocol::new(
|
1025 + | crate::shape_id!("test", "proto"),
|
1026 + | TestCodec,
|
1027 + | "application/test",
|
1028 + | )
|
1029 + | }
|
1030 + |
|
1031 + | #[test]
|
1032 + | fn serialize_sets_content_type() {
|
1033 + | // A struct with body members gets Content-Type
|
1034 + | let request = make_protocol()
|
1035 + | .serialize_request(
|
1036 + | &EmptyStruct,
|
1037 + | &STRUCT_WITH_MEMBER,
|
1038 + | "https://example.com",
|
1039 + | &ConfigBag::base(),
|
1040 + | )
|
1041 + | .unwrap();
|
1042 + | assert_eq!(
|
1043 + | request.headers().get("Content-Type").unwrap(),
|
1044 + | "application/test"
|
1045 + | );
|
1046 + | }
|
1047 + |
|
1048 + | #[test]
|
1049 + | fn serialize_no_body_members_omits_content_type() {
|
1050 + | // A struct with no members gets no Content-Type per REST-JSON spec
|
1051 + | let request = make_protocol()
|
1052 + | .serialize_request(
|
1053 + | &EmptyStruct,
|
1054 + | &TEST_SCHEMA,
|
1055 + | "https://example.com",
|
1056 + | &ConfigBag::base(),
|
1057 + | )
|
1058 + | .unwrap();
|
1059 + | assert!(request.headers().get("Content-Type").is_none());
|
1060 + | }
|
1061 + |
|
1062 + | #[test]
|
1063 + | fn serialize_sets_uri() {
|
1064 + | let request = make_protocol()
|
1065 + | .serialize_request(
|
1066 + | &EmptyStruct,
|
1067 + | &TEST_SCHEMA,
|
1068 + | "https://example.com/path",
|
1069 + | &ConfigBag::base(),
|
1070 + | )
|
1071 + | .unwrap();
|
1072 + | assert_eq!(request.uri(), "https://example.com/path");
|
1073 + | }
|
1074 + |
|
1075 + | #[test]
|
1076 + | fn serialize_body() {
|
1077 + | let request = make_protocol()
|
1078 + | .serialize_request(
|
1079 + | &NameStruct,
|
1080 + | &STRUCT_WITH_MEMBER,
|
1081 + | "https://example.com",
|
1082 + | &ConfigBag::base(),
|
1083 + | )
|
1084 + | .unwrap();
|
1085 + | assert_eq!(request.body().bytes().unwrap(), b"{Alice}");
|
1086 + | }
|
1087 + |
|
1088 + | #[test]
|
1089 + | fn deserialize_response() {
|
1090 + | let response = Response::new(
|
1091 + | 200u16.try_into().unwrap(),
|
1092 + | SdkBody::from(r#"{"name":"Bob"}"#),
|
1093 + | );
|
1094 + | let mut deser = make_protocol()
|
1095 + | .deserialize_response(&response, &TEST_SCHEMA, &ConfigBag::base())
|
1096 + | .unwrap();
|
1097 + | assert_eq!(deser.read_string(&STRING).unwrap(), r#"{"name":"Bob"}"#);
|
1098 + | }
|
1099 + |
|
1100 + | #[test]
|
1101 + | fn update_endpoint() {
|
1102 + | let mut request = make_protocol()
|
1103 + | .serialize_request(
|
1104 + | &EmptyStruct,
|
1105 + | &TEST_SCHEMA,
|
1106 + | "https://old.example.com",
|
1107 + | &ConfigBag::base(),
|
1108 + | )
|
1109 + | .unwrap();
|
1110 + | let endpoint = aws_smithy_types::endpoint::Endpoint::builder()
|
1111 + | .url("https://new.example.com")
|
1112 + | .build();
|
1113 + | make_protocol()
|
1114 + | .update_endpoint(&mut request, &endpoint, &ConfigBag::base())
|
1115 + | .unwrap();
|
1116 + | assert_eq!(request.uri(), "https://new.example.com/");
|
1117 + | }
|
1118 + |
|
1119 + | #[test]
|
1120 + | fn protocol_id() {
|
1121 + | let protocol = HttpBindingProtocol::new(
|
1122 + | crate::shape_id!("aws.protocols", "restJson1"),
|
1123 + | TestCodec,
|
1124 + | "application/json",
|
1125 + | );
|
1126 + | assert_eq!(protocol.protocol_id().as_str(), "aws.protocols#restJson1");
|
1127 + | }
|
1128 + |
|
1129 + | #[test]
|
1130 + | fn invalid_uri_returns_error() {
|
1131 + | assert!(make_protocol()
|
1132 + | .serialize_request(
|
1133 + | &EmptyStruct,
|
1134 + | &TEST_SCHEMA,
|
1135 + | "not a valid uri\n\n",
|
1136 + | &ConfigBag::base()
|
1137 + | )
|
1138 + | .is_err());
|
1139 + | }
|
1140 + |
|
1141 + | // -- @httpHeader tests --
|
1142 + |
|
1143 + | static HEADER_MEMBER: Schema = Schema::new_member(
|
1144 + | crate::shape_id!("test", "S"),
|
1145 + | ShapeType::String,
|
1146 + | "xToken",
|
1147 + | 0,
|
1148 + | )
|
1149 + | .with_http_header("X-Token");
|
1150 + |
|
1151 + | static HEADER_SCHEMA: Schema = Schema::new_struct(
|
1152 + | crate::shape_id!("test", "S"),
|
1153 + | ShapeType::Structure,
|
1154 + | &[&HEADER_MEMBER],
|
1155 + | );
|
1156 + |
|
1157 + | struct HeaderStruct;
|
1158 + | impl SerializableStruct for HeaderStruct {
|
1159 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1160 + | s.write_string(&HEADER_MEMBER, "my-token-value")
|
1161 + | }
|
1162 + | }
|
1163 + |
|
1164 + | #[test]
|
1165 + | fn http_header_string() {
|
1166 + | let request = make_protocol()
|
1167 + | .serialize_request(
|
1168 + | &HeaderStruct,
|
1169 + | &HEADER_SCHEMA,
|
1170 + | "https://example.com",
|
1171 + | &ConfigBag::base(),
|
1172 + | )
|
1173 + | .unwrap();
|
1174 + | assert_eq!(request.headers().get("X-Token").unwrap(), "my-token-value");
|
1175 + | }
|
1176 + |
|
1177 + | static INT_HEADER_MEMBER: Schema = Schema::new_member(
|
1178 + | crate::shape_id!("test", "S"),
|
1179 + | ShapeType::Integer,
|
1180 + | "retryCount",
|
1181 + | 0,
|
1182 + | )
|
1183 + | .with_http_header("X-Retry-Count");
|
1184 + |
|
1185 + | static INT_HEADER_SCHEMA: Schema = Schema::new_struct(
|
1186 + | crate::shape_id!("test", "S"),
|
1187 + | ShapeType::Structure,
|
1188 + | &[&INT_HEADER_MEMBER],
|
1189 + | );
|
1190 + |
|
1191 + | struct IntHeaderStruct;
|
1192 + | impl SerializableStruct for IntHeaderStruct {
|
1193 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1194 + | s.write_integer(&INT_HEADER_MEMBER, 3)
|
1195 + | }
|
1196 + | }
|
1197 + |
|
1198 + | #[test]
|
1199 + | fn http_header_integer() {
|
1200 + | let request = make_protocol()
|
1201 + | .serialize_request(
|
1202 + | &IntHeaderStruct,
|
1203 + | &INT_HEADER_SCHEMA,
|
1204 + | "https://example.com",
|
1205 + | &ConfigBag::base(),
|
1206 + | )
|
1207 + | .unwrap();
|
1208 + | assert_eq!(request.headers().get("X-Retry-Count").unwrap(), "3");
|
1209 + | }
|
1210 + |
|
1211 + | static BOOL_HEADER_MEMBER: Schema = Schema::new_member(
|
1212 + | crate::shape_id!("test", "S"),
|
1213 + | ShapeType::Boolean,
|
1214 + | "verbose",
|
1215 + | 0,
|
1216 + | )
|
1217 + | .with_http_header("X-Verbose");
|
1218 + |
|
1219 + | static BOOL_HEADER_SCHEMA: Schema = Schema::new_struct(
|
1220 + | crate::shape_id!("test", "S"),
|
1221 + | ShapeType::Structure,
|
1222 + | &[&BOOL_HEADER_MEMBER],
|
1223 + | );
|
1224 + |
|
1225 + | struct BoolHeaderStruct;
|
1226 + | impl SerializableStruct for BoolHeaderStruct {
|
1227 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1228 + | s.write_boolean(&BOOL_HEADER_MEMBER, true)
|
1229 + | }
|
1230 + | }
|
1231 + |
|
1232 + | #[test]
|
1233 + | fn http_header_boolean() {
|
1234 + | let request = make_protocol()
|
1235 + | .serialize_request(
|
1236 + | &BoolHeaderStruct,
|
1237 + | &BOOL_HEADER_SCHEMA,
|
1238 + | "https://example.com",
|
1239 + | &ConfigBag::base(),
|
1240 + | )
|
1241 + | .unwrap();
|
1242 + | assert_eq!(request.headers().get("X-Verbose").unwrap(), "true");
|
1243 + | }
|
1244 + |
|
1245 + | // -- @httpQuery tests --
|
1246 + |
|
1247 + | static QUERY_MEMBER: Schema =
|
1248 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "color", 0)
|
1249 + | .with_http_query("color");
|
1250 + |
|
1251 + | static QUERY_SCHEMA: Schema = Schema::new_struct(
|
1252 + | crate::shape_id!("test", "S"),
|
1253 + | ShapeType::Structure,
|
1254 + | &[&QUERY_MEMBER],
|
1255 + | );
|
1256 + |
|
1257 + | struct QueryStruct;
|
1258 + | impl SerializableStruct for QueryStruct {
|
1259 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1260 + | s.write_string(&QUERY_MEMBER, "blue")
|
1261 + | }
|
1262 + | }
|
1263 + |
|
1264 + | #[test]
|
1265 + | fn http_query_string() {
|
1266 + | let request = make_protocol()
|
1267 + | .serialize_request(
|
1268 + | &QueryStruct,
|
1269 + | &QUERY_SCHEMA,
|
1270 + | "https://example.com/things",
|
1271 + | &ConfigBag::base(),
|
1272 + | )
|
1273 + | .unwrap();
|
1274 + | assert_eq!(request.uri(), "https://example.com/things?color=blue");
|
1275 + | }
|
1276 + |
|
1277 + | static INT_QUERY_MEMBER: Schema =
|
1278 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::Integer, "size", 0)
|
1279 + | .with_http_query("size");
|
1280 + |
|
1281 + | static INT_QUERY_SCHEMA: Schema = Schema::new_struct(
|
1282 + | crate::shape_id!("test", "S"),
|
1283 + | ShapeType::Structure,
|
1284 + | &[&INT_QUERY_MEMBER],
|
1285 + | );
|
1286 + |
|
1287 + | struct IntQueryStruct;
|
1288 + | impl SerializableStruct for IntQueryStruct {
|
1289 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1290 + | s.write_integer(&INT_QUERY_MEMBER, 42)
|
1291 + | }
|
1292 + | }
|
1293 + |
|
1294 + | #[test]
|
1295 + | fn http_query_integer() {
|
1296 + | let request = make_protocol()
|
1297 + | .serialize_request(
|
1298 + | &IntQueryStruct,
|
1299 + | &INT_QUERY_SCHEMA,
|
1300 + | "https://example.com/things",
|
1301 + | &ConfigBag::base(),
|
1302 + | )
|
1303 + | .unwrap();
|
1304 + | assert_eq!(request.uri(), "https://example.com/things?size=42");
|
1305 + | }
|
1306 + |
|
1307 + | // -- Multiple @httpQuery params --
|
1308 + |
|
1309 + | static Q1: Schema =
|
1310 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "a", 0)
|
1311 + | .with_http_query("a");
|
1312 + | static Q2: Schema =
|
1313 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "b", 1)
|
1314 + | .with_http_query("b");
|
1315 + | static MULTI_QUERY_SCHEMA: Schema = Schema::new_struct(
|
1316 + | crate::shape_id!("test", "S"),
|
1317 + | ShapeType::Structure,
|
1318 + | &[&Q1, &Q2],
|
1319 + | );
|
1320 + |
|
1321 + | struct MultiQueryStruct;
|
1322 + | impl SerializableStruct for MultiQueryStruct {
|
1323 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1324 + | s.write_string(&Q1, "x")?;
|
1325 + | s.write_string(&Q2, "y")
|
1326 + | }
|
1327 + | }
|
1328 + |
|
1329 + | #[test]
|
1330 + | fn http_query_multiple_params() {
|
1331 + | let request = make_protocol()
|
1332 + | .serialize_request(
|
1333 + | &MultiQueryStruct,
|
1334 + | &MULTI_QUERY_SCHEMA,
|
1335 + | "https://example.com",
|
1336 + | &ConfigBag::base(),
|
1337 + | )
|
1338 + | .unwrap();
|
1339 + | assert_eq!(request.uri(), "https://example.com?a=x&b=y");
|
1340 + | }
|
1341 + |
|
1342 + | // -- @httpQuery with percent-encoding --
|
1343 + |
|
1344 + | #[test]
|
1345 + | fn http_query_percent_encodes_values() {
|
1346 + | struct SpaceQueryStruct;
|
1347 + | impl SerializableStruct for SpaceQueryStruct {
|
1348 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1349 + | s.write_string(&QUERY_MEMBER, "hello world")
|
1350 + | }
|
1351 + | }
|
1352 + | let request = make_protocol()
|
1353 + | .serialize_request(
|
1354 + | &SpaceQueryStruct,
|
1355 + | &QUERY_SCHEMA,
|
1356 + | "https://example.com",
|
1357 + | &ConfigBag::base(),
|
1358 + | )
|
1359 + | .unwrap();
|
1360 + | assert_eq!(request.uri(), "https://example.com?color=hello%20world");
|
1361 + | }
|
1362 + |
|
1363 + | // -- @httpLabel tests --
|
1364 + |
|
1365 + | static LABEL_MEMBER: Schema = Schema::new_member(
|
1366 + | crate::shape_id!("test", "S"),
|
1367 + | ShapeType::String,
|
1368 + | "bucketName",
|
1369 + | 0,
|
1370 + | )
|
1371 + | .with_http_label();
|
1372 + |
|
1373 + | static LABEL_SCHEMA: Schema = Schema::new_struct(
|
1374 + | crate::shape_id!("test", "S"),
|
1375 + | ShapeType::Structure,
|
1376 + | &[&LABEL_MEMBER],
|
1377 + | );
|
1378 + |
|
1379 + | struct LabelStruct;
|
1380 + | impl SerializableStruct for LabelStruct {
|
1381 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1382 + | s.write_string(&LABEL_MEMBER, "my-bucket")
|
1383 + | }
|
1384 + | }
|
1385 + |
|
1386 + | #[test]
|
1387 + | fn http_label_substitution() {
|
1388 + | let request = make_protocol()
|
1389 + | .serialize_request(
|
1390 + | &LabelStruct,
|
1391 + | &LABEL_SCHEMA,
|
1392 + | "https://example.com/{bucketName}/objects",
|
1393 + | &ConfigBag::base(),
|
1394 + | )
|
1395 + | .unwrap();
|
1396 + | assert_eq!(request.uri(), "https://example.com/my-bucket/objects");
|
1397 + | }
|
1398 + |
|
1399 + | #[test]
|
1400 + | fn http_label_percent_encodes() {
|
1401 + | struct SpecialLabelStruct;
|
1402 + | impl SerializableStruct for SpecialLabelStruct {
|
1403 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1404 + | s.write_string(&LABEL_MEMBER, "my bucket/name")
|
1405 + | }
|
1406 + | }
|
1407 + | let request = make_protocol()
|
1408 + | .serialize_request(
|
1409 + | &SpecialLabelStruct,
|
1410 + | &LABEL_SCHEMA,
|
1411 + | "https://example.com/{bucketName}",
|
1412 + | &ConfigBag::base(),
|
1413 + | )
|
1414 + | .unwrap();
|
1415 + | assert!(request.uri().contains("my%20bucket%2Fname"));
|
1416 + | }
|
1417 + |
|
1418 + | static INT_LABEL_MEMBER: Schema = Schema::new_member(
|
1419 + | crate::shape_id!("test", "S"),
|
1420 + | ShapeType::Integer,
|
1421 + | "itemId",
|
1422 + | 0,
|
1423 + | )
|
1424 + | .with_http_label();
|
1425 + |
|
1426 + | static INT_LABEL_SCHEMA: Schema = Schema::new_struct(
|
1427 + | crate::shape_id!("test", "S"),
|
1428 + | ShapeType::Structure,
|
1429 + | &[&INT_LABEL_MEMBER],
|
1430 + | );
|
1431 + |
|
1432 + | struct IntLabelStruct;
|
1433 + | impl SerializableStruct for IntLabelStruct {
|
1434 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1435 + | s.write_integer(&INT_LABEL_MEMBER, 123)
|
1436 + | }
|
1437 + | }
|
1438 + |
|
1439 + | #[test]
|
1440 + | fn http_label_integer() {
|
1441 + | let request = make_protocol()
|
1442 + | .serialize_request(
|
1443 + | &IntLabelStruct,
|
1444 + | &INT_LABEL_SCHEMA,
|
1445 + | "https://example.com/items/{itemId}",
|
1446 + | &ConfigBag::base(),
|
1447 + | )
|
1448 + | .unwrap();
|
1449 + | assert_eq!(request.uri(), "https://example.com/items/123");
|
1450 + | }
|
1451 + |
|
1452 + | // -- Combined: @httpHeader + @httpQuery + @httpLabel + body --
|
1453 + |
|
1454 + | static COMBINED_LABEL: Schema =
|
1455 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "id", 0)
|
1456 + | .with_http_label();
|
1457 + | static COMBINED_HEADER: Schema =
|
1458 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "token", 1)
|
1459 + | .with_http_header("X-Token");
|
1460 + | static COMBINED_QUERY: Schema = Schema::new_member(
|
1461 + | crate::shape_id!("test", "S"),
|
1462 + | ShapeType::String,
|
1463 + | "filter",
|
1464 + | 2,
|
1465 + | )
|
1466 + | .with_http_query("filter");
|
1467 + | static COMBINED_BODY: Schema =
|
1468 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::String, "data", 3);
|
1469 + | static COMBINED_SCHEMA: Schema = Schema::new_struct(
|
1470 + | crate::shape_id!("test", "S"),
|
1471 + | ShapeType::Structure,
|
1472 + | &[
|
1473 + | &COMBINED_LABEL,
|
1474 + | &COMBINED_HEADER,
|
1475 + | &COMBINED_QUERY,
|
1476 + | &COMBINED_BODY,
|
1477 + | ],
|
1478 + | );
|
1479 + |
|
1480 + | struct CombinedStruct;
|
1481 + | impl SerializableStruct for CombinedStruct {
|
1482 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1483 + | s.write_string(&COMBINED_LABEL, "item-42")?;
|
1484 + | s.write_string(&COMBINED_HEADER, "secret")?;
|
1485 + | s.write_string(&COMBINED_QUERY, "active")?;
|
1486 + | s.write_string(&COMBINED_BODY, "payload-data")
|
1487 + | }
|
1488 + | }
|
1489 + |
|
1490 + | #[test]
|
1491 + | fn combined_bindings() {
|
1492 + | let request = make_protocol()
|
1493 + | .serialize_request(
|
1494 + | &CombinedStruct,
|
1495 + | &COMBINED_SCHEMA,
|
1496 + | "https://example.com/{id}/details",
|
1497 + | &ConfigBag::base(),
|
1498 + | )
|
1499 + | .unwrap();
|
1500 + | assert_eq!(
|
1501 + | request.uri(),
|
1502 + | "https://example.com/item-42/details?filter=active"
|
1503 + | );
|
1504 + | // Header
|
1505 + | assert_eq!(request.headers().get("X-Token").unwrap(), "secret");
|
1506 + | // Body contains only the unbound member
|
1507 + | let body = request.body().bytes().unwrap();
|
1508 + | assert!(body
|
1509 + | .windows(b"payload-data".len())
|
1510 + | .any(|w| w == b"payload-data"));
|
1511 + | }
|
1512 + |
|
1513 + | // -- @httpPrefixHeaders tests --
|
1514 + |
|
1515 + | static PREFIX_MEMBER: Schema =
|
1516 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::Map, "metadata", 0)
|
1517 + | .with_http_prefix_headers("X-Meta-");
|
1518 + |
|
1519 + | static PREFIX_SCHEMA: Schema = Schema::new_struct(
|
1520 + | crate::shape_id!("test", "S"),
|
1521 + | ShapeType::Structure,
|
1522 + | &[&PREFIX_MEMBER],
|
1523 + | );
|
1524 + |
|
1525 + | struct PrefixHeaderStruct;
|
1526 + | impl SerializableStruct for PrefixHeaderStruct {
|
1527 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1528 + | s.write_map(&PREFIX_MEMBER, &|s| {
|
1529 + | s.write_string(&STRING, "Color")?;
|
1530 + | s.write_string(&STRING, "red")?;
|
1531 + | s.write_string(&STRING, "Size")?;
|
1532 + | s.write_string(&STRING, "large")?;
|
1533 + | Ok(())
|
1534 + | })
|
1535 + | }
|
1536 + | }
|
1537 + |
|
1538 + | #[test]
|
1539 + | fn http_prefix_headers() {
|
1540 + | let request = make_protocol()
|
1541 + | .serialize_request(
|
1542 + | &PrefixHeaderStruct,
|
1543 + | &PREFIX_SCHEMA,
|
1544 + | "https://example.com",
|
1545 + | &ConfigBag::base(),
|
1546 + | )
|
1547 + | .unwrap();
|
1548 + | assert_eq!(request.headers().get("X-Meta-Color").unwrap(), "red");
|
1549 + | assert_eq!(request.headers().get("X-Meta-Size").unwrap(), "large");
|
1550 + | }
|
1551 + |
|
1552 + | // -- @httpQueryParams tests --
|
1553 + |
|
1554 + | static QUERY_PARAMS_MEMBER: Schema =
|
1555 + | Schema::new_member(crate::shape_id!("test", "S"), ShapeType::Map, "params", 0)
|
1556 + | .with_http_query_params();
|
1557 + |
|
1558 + | static QUERY_PARAMS_SCHEMA: Schema = Schema::new_struct(
|
1559 + | crate::shape_id!("test", "S"),
|
1560 + | ShapeType::Structure,
|
1561 + | &[&QUERY_PARAMS_MEMBER],
|
1562 + | );
|
1563 + |
|
1564 + | struct QueryParamsStruct;
|
1565 + | impl SerializableStruct for QueryParamsStruct {
|
1566 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1567 + | s.write_map(&QUERY_PARAMS_MEMBER, &|s| {
|
1568 + | s.write_string(&STRING, "page")?;
|
1569 + | s.write_string(&STRING, "2")?;
|
1570 + | s.write_string(&STRING, "limit")?;
|
1571 + | s.write_string(&STRING, "50")?;
|
1572 + | Ok(())
|
1573 + | })
|
1574 + | }
|
1575 + | }
|
1576 + |
|
1577 + | #[test]
|
1578 + | fn http_query_params() {
|
1579 + | let request = make_protocol()
|
1580 + | .serialize_request(
|
1581 + | &QueryParamsStruct,
|
1582 + | &QUERY_PARAMS_SCHEMA,
|
1583 + | "https://example.com",
|
1584 + | &ConfigBag::base(),
|
1585 + | )
|
1586 + | .unwrap();
|
1587 + | assert_eq!(request.uri(), "https://example.com?page=2&limit=50");
|
1588 + | }
|
1589 + |
|
1590 + | // -- Timestamp in header defaults to http-date --
|
1591 + |
|
1592 + | static TS_HEADER_MEMBER: Schema = Schema::new_member(
|
1593 + | crate::shape_id!("test", "S"),
|
1594 + | ShapeType::Timestamp,
|
1595 + | "ifModified",
|
1596 + | 0,
|
1597 + | )
|
1598 + | .with_http_header("If-Modified-Since");
|
1599 + |
|
1600 + | static TS_HEADER_SCHEMA: Schema = Schema::new_struct(
|
1601 + | crate::shape_id!("test", "S"),
|
1602 + | ShapeType::Structure,
|
1603 + | &[&TS_HEADER_MEMBER],
|
1604 + | );
|
1605 + |
|
1606 + | struct TimestampHeaderStruct;
|
1607 + | impl SerializableStruct for TimestampHeaderStruct {
|
1608 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1609 + | s.write_timestamp(&TS_HEADER_MEMBER, &aws_smithy_types::DateTime::from_secs(0))
|
1610 + | }
|
1611 + | }
|
1612 + |
|
1613 + | #[test]
|
1614 + | fn timestamp_header_uses_http_date() {
|
1615 + | let request = make_protocol()
|
1616 + | .serialize_request(
|
1617 + | &TimestampHeaderStruct,
|
1618 + | &TS_HEADER_SCHEMA,
|
1619 + | "https://example.com",
|
1620 + | &ConfigBag::base(),
|
1621 + | )
|
1622 + | .unwrap();
|
1623 + | let value = request.headers().get("If-Modified-Since").unwrap();
|
1624 + | // http-date format: "Thu, 01 Jan 1970 00:00:00 GMT"
|
1625 + | assert!(value.contains("1970"), "expected http-date, got: {value}");
|
1626 + | }
|
1627 + |
|
1628 + | // -- Timestamp in query defaults to date-time --
|
1629 + |
|
1630 + | static TS_QUERY_MEMBER: Schema = Schema::new_member(
|
1631 + | crate::shape_id!("test", "S"),
|
1632 + | ShapeType::Timestamp,
|
1633 + | "since",
|
1634 + | 0,
|
1635 + | )
|
1636 + | .with_http_query("since");
|
1637 + |
|
1638 + | static TS_QUERY_SCHEMA: Schema = Schema::new_struct(
|
1639 + | crate::shape_id!("test", "S"),
|
1640 + | ShapeType::Structure,
|
1641 + | &[&TS_QUERY_MEMBER],
|
1642 + | );
|
1643 + |
|
1644 + | struct TimestampQueryStruct;
|
1645 + | impl SerializableStruct for TimestampQueryStruct {
|
1646 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1647 + | s.write_timestamp(&TS_QUERY_MEMBER, &aws_smithy_types::DateTime::from_secs(0))
|
1648 + | }
|
1649 + | }
|
1650 + |
|
1651 + | #[test]
|
1652 + | fn timestamp_query_uses_date_time() {
|
1653 + | let request = make_protocol()
|
1654 + | .serialize_request(
|
1655 + | &TimestampQueryStruct,
|
1656 + | &TS_QUERY_SCHEMA,
|
1657 + | "https://example.com",
|
1658 + | &ConfigBag::base(),
|
1659 + | )
|
1660 + | .unwrap();
|
1661 + | assert_eq!(
|
1662 + | request.uri(),
|
1663 + | "https://example.com?since=1970-01-01T00%3A00%3A00Z"
|
1664 + | );
|
1665 + | }
|
1666 + |
|
1667 + | // -- Unbound members go to body, bound members do not --
|
1668 + |
|
1669 + | static BOUND_MEMBER: Schema = Schema::new_member(
|
1670 + | crate::shape_id!("test", "S"),
|
1671 + | ShapeType::String,
|
1672 + | "headerVal",
|
1673 + | 0,
|
1674 + | )
|
1675 + | .with_http_header("X-Val");
|
1676 + | static UNBOUND_MEMBER: Schema = Schema::new_member(
|
1677 + | crate::shape_id!("test", "S"),
|
1678 + | ShapeType::String,
|
1679 + | "bodyVal",
|
1680 + | 1,
|
1681 + | );
|
1682 + | static MIXED_SCHEMA: Schema = Schema::new_struct(
|
1683 + | crate::shape_id!("test", "S"),
|
1684 + | ShapeType::Structure,
|
1685 + | &[&BOUND_MEMBER, &UNBOUND_MEMBER],
|
1686 + | );
|
1687 + |
|
1688 + | struct MixedStruct;
|
1689 + | impl SerializableStruct for MixedStruct {
|
1690 + | fn serialize_members(&self, s: &mut dyn ShapeSerializer) -> Result<(), SerdeError> {
|
1691 + | s.write_string(&BOUND_MEMBER, "in-header")?;
|
1692 + | s.write_string(&UNBOUND_MEMBER, "in-body")
|
1693 + | }
|
1694 + | }
|
1695 + |
|
1696 + | #[test]
|
1697 + | fn bound_members_not_in_body() {
|
1698 + | let request = make_protocol()
|
1699 + | .serialize_request(
|
1700 + | &MixedStruct,
|
1701 + | &MIXED_SCHEMA,
|
1702 + | "https://example.com",
|
1703 + | &ConfigBag::base(),
|
1704 + | )
|
1705 + | .unwrap();
|
1706 + | let body = std::str::from_utf8(request.body().bytes().unwrap()).unwrap();
|
1707 + | assert!(
|
1708 + | body.contains("in-body"),
|
1709 + | "body should contain unbound member"
|
1710 + | );
|
1711 + | assert!(
|
1712 + | !body.contains("in-header"),
|
1713 + | "body should NOT contain header-bound member"
|
1714 + | );
|
1715 + | assert_eq!(request.headers().get("X-Val").unwrap(), "in-header");
|
1716 + | }
|
1717 + | }
|