Struct Operation 

pub struct Operation { /* private fields */ }

Available on crate feature openapi only.

What a client needs to know about one operation beyond its method and path. Schemas are JSON text, normally from JsonSchema.

Implementations

impl Operation

pub fn new(summary: impl Into<String>) -> Self

An operation with a one-line summary.

pub fn description(self, description: impl Into<String>) -> Self

A longer description (CommonMark).

pub fn operation_id(self, id: impl Into<String>) -> Self

A unique operationId (client generators name methods after it).

pub fn tag(self, tag: impl Into<String>) -> Self

Group the operation under tag.

pub fn deprecated(self) -> Self

Mark the operation deprecated.

pub fn path_param<T: JsonSchema + ?Sized>(self, name: &str) -> Self

Path parameter name holds a T (default: a string).

pub fn path_param_schema( self, name: &str, schema: &str, description: &str, ) -> Self

Path parameter name with an explicit schema and description.

pub fn query<T: JsonSchema + ?Sized>(self) -> Self

Query parameters: one per property of T (a struct), required as the struct requires them — the type a handler parses the query into.

pub fn query_param(self, name: &str, schema: &str, required: bool) -> Self

One query parameter with an explicit schema.

pub fn body<T: JsonSchema + ?Sized>(self) -> Self

A required application/json request body holding a T.

pub fn body_schema( self, content_type: &str, schema: &str, required: bool, ) -> Self

A request body of content_type with an explicit schema.

pub fn response<T: JsonSchema + ?Sized>( self, status: u16, description: &str, ) -> Self

Response status with an application/json body holding a T.

pub fn response_schema( self, status: u16, description: &str, content_type: &str, schema: &str, ) -> Self

Response status with a body of content_type and an explicit schema.

pub fn status(self, status: u16, description: &str) -> Self

Response status without a documented body (an error, 204, …).

Trait Implementations

impl Clone for Operation

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Operation

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

Formats the value using the given formatter.

impl Default for Operation

fn default() -> Self

Returns the “default value” for a type.