Struct AnyOf 

#[non_exhaustive]
pub struct AnyOf {
    pub items: Vec<RefOr<Schema>>,
    pub schema_type: SchemaType,
    pub title: Option<String>,
    pub description: Option<String>,
    pub default_value: Option<Value>,
    pub examples: Vec<Value>,
    pub discriminator: Option<Discriminator>,
    pub extensions: PropMap<String, Value>,
}

AnyOf Composite Object component holds multiple components together where API endpoint will return a combination of all of them.

See Schema::AnyOf for more details.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

items: Vec<RefOr<Schema>>

Components of AnyOf component.

schema_type: SchemaType

Type of AnyOf e.g. SchemaType::basic(BasicType::Object) for object.

By default this is SchemaType::AnyValue as the type is defined by items themselves.

title: Option<String>

Changes the AnyOf title.

description: Option<String>

Description of the AnyOf. Markdown syntax is supported.

default_value: Option<Value>

Default value which is provided when user has not provided the input in Swagger UI.

examples: Vec<Value>

Examples shown in UI of the value for richer documentation.

discriminator: Option<Discriminator>

Optional discriminator field can be used to aid deserialization, serialization and validation of a specific schema.

extensions: PropMap<String, Value>

Optional extensions x-something.

Implementations

impl AnyOf

pub fn new() -> Self

Construct a new empty AnyOf. This is effectively same as calling AnyOf::default.

pub fn with_capacity(capacity: usize) -> Self

Construct a new AnyOf component with given capacity.

AnyOf component is then able to contain number of components without reallocating.

Examples

Create AnyOf component with initial capacity of 5.

let one_of = AnyOf::with_capacity(5);

pub fn item<I: Into<RefOr<Schema>>>(self, component: I) -> Self

Adds a given Schema to AnyOf Composite Object

pub fn schema_type<T: Into<SchemaType>>(self, schema_type: T) -> Self

Add or change type of the object e.g. to change type to string use value SchemaType::Type(Type::String).

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

Add or change the title of the AnyOf.

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

Add or change optional description for AnyOf component.

pub fn default_value(self, default: Value) -> Self

Add or change default value for the object which is provided when user has not provided the input in Swagger UI.

pub fn add_example<V: Into<Value>>(self, example: V) -> Self

Add or change example shown in UI of the value for richer documentation.

pub fn discriminator(self, discriminator: Discriminator) -> Self

Add or change discriminator field of the composite AnyOf type.

pub fn add_extension<K: Into<String>>(self, key: K, value: Value) -> Self

Add openapi extension (x-something) for AnyOf.

pub fn to_array(self) -> Array

Convert type to Array.

Trait Implementations

impl Clone for AnyOf

fn clone(&self) -> AnyOf

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnyOf

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

Formats the value using the given formatter.

impl Default for AnyOf

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AnyOf

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<AnyOf> for RefOr<Schema>

fn from(one_of: AnyOf) -> Self

Converts to this type from the input type.

impl From<AnyOf> for Schema

fn from(one_of: AnyOf) -> Self

Converts to this type from the input type.

impl PartialEq for AnyOf

fn eq(&self, other: &AnyOf) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AnyOf

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AnyOf