Struct Schema 

#[non_exhaustive]
pub struct Schema {

    pub type: Type,
    pub format: String,
    pub title: String,
    pub description: String,
    pub nullable: bool,
    pub default: Option<Value>,
    pub items: Option<Box<Schema>>,
    pub min_items: i64,
    pub max_items: i64,
    pub enum: Vec<String>,
    pub properties: HashMap<String, Schema>,
    pub property_ordering: Vec<String>,
    pub required: Vec<String>,
    pub min_properties: i64,
    pub max_properties: i64,
    pub minimum: f64,
    pub maximum: f64,
    pub min_length: i64,
    pub max_length: i64,
    pub pattern: String,
    pub example: Option<Value>,
    pub any_of: Vec<Schema>,
    pub additional_properties: Option<Value>,
    pub ref: String,
    pub defs: HashMap<String, Schema>,
    /* private fields */
}

Available on crate features gen-ai-cache-service or llm-utility-service or prediction-service only.

Schema is used to define the format of input/output data. Represents a select subset of an OpenAPI 3.0 schema object. More fields may be added in the future as needed.

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.

type: Type

Optional. The type of the data.

format: String

Optional. The format of the data. Supported formats: for NUMBER type: “float”, “double” for INTEGER type: “int32”, “int64” for STRING type: “email”, “byte”, etc

title: String

Optional. The title of the Schema.

description: String

Optional. The description of the data.

nullable: bool

Optional. Indicates if the value may be null.

default: Option<Value>

Optional. Default value of the data.

items: Option<Box<Schema>>

Optional. SCHEMA FIELDS FOR TYPE ARRAY Schema of the elements of Type.ARRAY.

min_items: i64

Optional. Minimum number of the elements for Type.ARRAY.

max_items: i64

Optional. Maximum number of the elements for Type.ARRAY.

enum: Vec<String>

Optional. Possible values of the element of primitive type with enum format. Examples:

1. We can define direction as : {type:STRING, format:enum, enum:[“EAST”, NORTH“, “SOUTH”, “WEST”]}
2. We can define apartment number as : {type:INTEGER, format:enum, enum:[“101”, “201”, “301”]}

properties: HashMap<String, Schema>

Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.

property_ordering: Vec<String>

Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.

required: Vec<String>

Optional. Required properties of Type.OBJECT.

min_properties: i64

Optional. Minimum number of the properties for Type.OBJECT.

max_properties: i64

Optional. Maximum number of the properties for Type.OBJECT.

minimum: f64

Optional. SCHEMA FIELDS FOR TYPE INTEGER and NUMBER Minimum value of the Type.INTEGER and Type.NUMBER

maximum: f64

Optional. Maximum value of the Type.INTEGER and Type.NUMBER

min_length: i64

Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the Type.STRING

max_length: i64

Optional. Maximum length of the Type.STRING

pattern: String

Optional. Pattern of the Type.STRING to restrict a string to a regular expression.

example: Option<Value>

Optional. Example of the object. Will only populated when the object is the root.

any_of: Vec<Schema>

Optional. The value should be validated against any (one or more) of the subschemas in the list.

additional_properties: Option<Value>

Optional. Can either be a boolean or an object; controls the presence of additional properties.

ref: String

Optional. Allows indirect references between schema nodes. The value should be a valid reference to a child of the root defs.

For example, the following schema defines a reference to a schema node named “Pet”:

type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string

The value of the “pet” property is a reference to the schema node named “Pet”. See details in https://json-schema.org/understanding-json-schema/structuring

defs: HashMap<String, Schema>

Optional. A map of definitions for use by ref Only allowed at the root of the schema.

Implementations

impl Schema

pub fn new() -> Self

pub fn set_type<T: Into<Type>>(self, v: T) -> Self

Sets the value of r#type.

Example

use google_cloud_aiplatform_v1::model::Type;
let x0 = Schema::new().set_type(Type::String);
let x1 = Schema::new().set_type(Type::Number);
let x2 = Schema::new().set_type(Type::Integer);

pub fn set_format<T: Into<String>>(self, v: T) -> Self

Sets the value of format.

Example

let x = Schema::new().set_format("example");

pub fn set_title<T: Into<String>>(self, v: T) -> Self

Sets the value of title.

Example

let x = Schema::new().set_title("example");

pub fn set_description<T: Into<String>>(self, v: T) -> Self

Sets the value of description.

Example

let x = Schema::new().set_description("example");

pub fn set_nullable<T: Into<bool>>(self, v: T) -> Self

Sets the value of nullable.

Example

let x = Schema::new().set_nullable(true);

pub fn set_default<T>(self, v: T) -> Self

where T: Into<Value>,

Sets the value of default.

Example

use wkt::Value;
let x = Schema::new().set_default(Value::default()/* use setters */);

pub fn set_or_clear_default<T>(self, v: Option<T>) -> Self

where T: Into<Value>,

Sets or clears the value of default.

Example

use wkt::Value;
let x = Schema::new().set_or_clear_default(Some(Value::default()/* use setters */));
let x = Schema::new().set_or_clear_default(None::<Value>);

pub fn set_items<T>(self, v: T) -> Self

where T: Into<Schema>,

Sets the value of items.

Example

let x = Schema::new().set_items(Schema::default()/* use setters */);

pub fn set_or_clear_items<T>(self, v: Option<T>) -> Self

where T: Into<Schema>,

Sets or clears the value of items.

Example

let x = Schema::new().set_or_clear_items(Some(Schema::default()/* use setters */));
let x = Schema::new().set_or_clear_items(None::<Schema>);

pub fn set_min_items<T: Into<i64>>(self, v: T) -> Self

Sets the value of min_items.

Example

let x = Schema::new().set_min_items(42);

pub fn set_max_items<T: Into<i64>>(self, v: T) -> Self

Sets the value of max_items.

Example

let x = Schema::new().set_max_items(42);

pub fn set_enum<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of r#enum.

Example

let x = Schema::new().set_enum(["a", "b", "c"]);

pub fn set_properties<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<Schema>,

Sets the value of properties.

Example

let x = Schema::new().set_properties([
    ("key0", Schema::default()/* use setters */),
    ("key1", Schema::default()/* use (different) setters */),
]);

pub fn set_property_ordering<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of property_ordering.

Example

let x = Schema::new().set_property_ordering(["a", "b", "c"]);

pub fn set_required<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of required.

Example

let x = Schema::new().set_required(["a", "b", "c"]);

pub fn set_min_properties<T: Into<i64>>(self, v: T) -> Self

Sets the value of min_properties.

Example

let x = Schema::new().set_min_properties(42);

pub fn set_max_properties<T: Into<i64>>(self, v: T) -> Self

Sets the value of max_properties.

Example

let x = Schema::new().set_max_properties(42);

pub fn set_minimum<T: Into<f64>>(self, v: T) -> Self

Sets the value of minimum.

Example

let x = Schema::new().set_minimum(42.0);

pub fn set_maximum<T: Into<f64>>(self, v: T) -> Self

Sets the value of maximum.

Example

let x = Schema::new().set_maximum(42.0);

pub fn set_min_length<T: Into<i64>>(self, v: T) -> Self

Sets the value of min_length.

Example

let x = Schema::new().set_min_length(42);

pub fn set_max_length<T: Into<i64>>(self, v: T) -> Self

Sets the value of max_length.

Example

let x = Schema::new().set_max_length(42);

pub fn set_pattern<T: Into<String>>(self, v: T) -> Self

Sets the value of pattern.

Example

let x = Schema::new().set_pattern("example");

pub fn set_example<T>(self, v: T) -> Self

where T: Into<Value>,

Sets the value of example.

Example

use wkt::Value;
let x = Schema::new().set_example(Value::default()/* use setters */);

pub fn set_or_clear_example<T>(self, v: Option<T>) -> Self

where T: Into<Value>,

Sets or clears the value of example.

Example

use wkt::Value;
let x = Schema::new().set_or_clear_example(Some(Value::default()/* use setters */));
let x = Schema::new().set_or_clear_example(None::<Value>);

pub fn set_any_of<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Schema>,

Sets the value of any_of.

Example

let x = Schema::new()
    .set_any_of([
        Schema::default()/* use setters */,
        Schema::default()/* use (different) setters */,
    ]);

pub fn set_additional_properties<T>(self, v: T) -> Self

where T: Into<Value>,

Sets the value of additional_properties.

Example

use wkt::Value;
let x = Schema::new().set_additional_properties(Value::default()/* use setters */);

pub fn set_or_clear_additional_properties<T>(self, v: Option<T>) -> Self

where T: Into<Value>,

Sets or clears the value of additional_properties.

Example

use wkt::Value;
let x = Schema::new().set_or_clear_additional_properties(Some(Value::default()/* use setters */));
let x = Schema::new().set_or_clear_additional_properties(None::<Value>);

pub fn set_ref<T: Into<String>>(self, v: T) -> Self

Sets the value of r#ref.

Example

let x = Schema::new().set_ref("example");

pub fn set_defs<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<Schema>,

Sets the value of defs.

Example

let x = Schema::new().set_defs([
    ("key0", Schema::default()/* use setters */),
    ("key1", Schema::default()/* use (different) setters */),
]);

Trait Implementations

impl Clone for Schema

fn clone(&self) -> Schema

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Schema

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

Formats the value using the given formatter.

impl Default for Schema

fn default() -> Schema

Returns the “default value” for a type.

impl Message for Schema

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Schema

fn eq(&self, other: &Schema) -> 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 StructuralPartialEq for Schema