Struct ModelPlugins

pub struct ModelPlugins<P>(/* private fields */);

A wrapper struct for composing model plugins. It operates identically to HttpPlugins; see its documentation.

Implementations

impl ModelPlugins<IdentityPlugin>

pub fn new() -> Self

Create an empty ModelPlugins.

You can use ModelPlugins::push to add plugins to it.

impl<P> ModelPlugins<P>

pub fn push<NewPlugin: ModelMarker>( self, new_plugin: NewPlugin, ) -> ModelPlugins<PluginStack<NewPlugin, P>>

Apply a new model plugin after the ones that have already been registered.

use aws_smithy_http_server::plugin::ModelPlugins;

let model_plugins = ModelPlugins::new().push(LoggingPlugin).push(MetricsPlugin);

The plugins’ runtime logic is executed in registration order. In our example above, LoggingPlugin would run first, while MetricsPlugin is executed last.

Implementation notes

Plugins are applied to the underlying Service in opposite order compared to their registration order.

As an example:

#[derive(Debug)]
pub struct PrintPlugin;

impl<Ser, Op, S> Plugin<Ser, Op, T> for PrintPlugin
// [...]
{
    // [...]
    fn apply(&self, inner: T) -> Self::Service {
        PrintService {
            inner,
            service_id: Ser::ID,
            operation_id: Op::ID
        }
    }
}

pub fn layer<L>(self, layer: L) -> ModelPlugins<PluginStack<LayerPlugin<L>, P>>

Applies a single [tower::Layer] to all operations before they are deserialized.

Trait Implementations

impl<P: Debug> Debug for ModelPlugins<P>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ModelPlugins<IdentityPlugin>

fn default() -> Self

Returns the “default value” for a type.

impl<Ser, Op, T, InnerPlugin> Plugin<Ser, Op, T> for ModelPlugins<InnerPlugin>

where InnerPlugin: Plugin<Ser, Op, T>,

type Output = <InnerPlugin as Plugin<Ser, Op, T>>::Output

The type of the new Service.

fn apply(&self, input: T) -> Self::Output

Maps a Service to another.

impl<InnerPlugin> ModelMarker for ModelPlugins<InnerPlugin>

where InnerPlugin: ModelMarker,