k8s_openapi/v1_33/api/discovery/v1/
endpoint_hints.rs

1// Generated from definition io.k8s.api.discovery.v1.EndpointHints
2
3/// EndpointHints provides hints describing how an endpoint should be consumed.
4#[derive(Clone, Debug, Default, PartialEq)]
5pub struct EndpointHints {
6    /// forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
7    pub for_nodes: Option<std::vec::Vec<crate::api::discovery::v1::ForNode>>,
8
9    /// forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
10    pub for_zones: Option<std::vec::Vec<crate::api::discovery::v1::ForZone>>,
11}
12
13impl crate::DeepMerge for EndpointHints {
14    fn merge_from(&mut self, other: Self) {
15        crate::merge_strategies::list::atomic(&mut self.for_nodes, other.for_nodes);
16        crate::merge_strategies::list::atomic(&mut self.for_zones, other.for_zones);
17    }
18}
19
20impl<'de> crate::serde::Deserialize<'de> for EndpointHints {
21    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
22        #[allow(non_camel_case_types)]
23        enum Field {
24            Key_for_nodes,
25            Key_for_zones,
26            Other,
27        }
28
29        impl<'de> crate::serde::Deserialize<'de> for Field {
30            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
31                struct Visitor;
32
33                impl crate::serde::de::Visitor<'_> for Visitor {
34                    type Value = Field;
35
36                    fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
37                        f.write_str("field identifier")
38                    }
39
40                    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E> where E: crate::serde::de::Error {
41                        Ok(match v {
42                            "forNodes" => Field::Key_for_nodes,
43                            "forZones" => Field::Key_for_zones,
44                            _ => Field::Other,
45                        })
46                    }
47                }
48
49                deserializer.deserialize_identifier(Visitor)
50            }
51        }
52
53        struct Visitor;
54
55        impl<'de> crate::serde::de::Visitor<'de> for Visitor {
56            type Value = EndpointHints;
57
58            fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
59                f.write_str("EndpointHints")
60            }
61
62            fn visit_map<A>(self, mut map: A) -> Result<Self::Value, A::Error> where A: crate::serde::de::MapAccess<'de> {
63                let mut value_for_nodes: Option<std::vec::Vec<crate::api::discovery::v1::ForNode>> = None;
64                let mut value_for_zones: Option<std::vec::Vec<crate::api::discovery::v1::ForZone>> = None;
65
66                while let Some(key) = crate::serde::de::MapAccess::next_key::<Field>(&mut map)? {
67                    match key {
68                        Field::Key_for_nodes => value_for_nodes = crate::serde::de::MapAccess::next_value(&mut map)?,
69                        Field::Key_for_zones => value_for_zones = crate::serde::de::MapAccess::next_value(&mut map)?,
70                        Field::Other => { let _: crate::serde::de::IgnoredAny = crate::serde::de::MapAccess::next_value(&mut map)?; },
71                    }
72                }
73
74                Ok(EndpointHints {
75                    for_nodes: value_for_nodes,
76                    for_zones: value_for_zones,
77                })
78            }
79        }
80
81        deserializer.deserialize_struct(
82            "EndpointHints",
83            &[
84                "forNodes",
85                "forZones",
86            ],
87            Visitor,
88        )
89    }
90}
91
92impl crate::serde::Serialize for EndpointHints {
93    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: crate::serde::Serializer {
94        let mut state = serializer.serialize_struct(
95            "EndpointHints",
96            self.for_nodes.as_ref().map_or(0, |_| 1) +
97            self.for_zones.as_ref().map_or(0, |_| 1),
98        )?;
99        if let Some(value) = &self.for_nodes {
100            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "forNodes", value)?;
101        }
102        if let Some(value) = &self.for_zones {
103            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "forZones", value)?;
104        }
105        crate::serde::ser::SerializeStruct::end(state)
106    }
107}
108
109#[cfg(feature = "schemars")]
110impl crate::schemars::JsonSchema for EndpointHints {
111    fn schema_name() -> std::string::String {
112        "io.k8s.api.discovery.v1.EndpointHints".into()
113    }
114
115    fn json_schema(__gen: &mut crate::schemars::gen::SchemaGenerator) -> crate::schemars::schema::Schema {
116        crate::schemars::schema::Schema::Object(crate::schemars::schema::SchemaObject {
117            metadata: Some(std::boxed::Box::new(crate::schemars::schema::Metadata {
118                description: Some("EndpointHints provides hints describing how an endpoint should be consumed.".into()),
119                ..Default::default()
120            })),
121            instance_type: Some(crate::schemars::schema::SingleOrVec::Single(std::boxed::Box::new(crate::schemars::schema::InstanceType::Object))),
122            object: Some(std::boxed::Box::new(crate::schemars::schema::ObjectValidation {
123                properties: [
124                    (
125                        "forNodes".into(),
126                        crate::schemars::schema::Schema::Object(crate::schemars::schema::SchemaObject {
127                            metadata: Some(std::boxed::Box::new(crate::schemars::schema::Metadata {
128                                description: Some("forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.".into()),
129                                ..Default::default()
130                            })),
131                            instance_type: Some(crate::schemars::schema::SingleOrVec::Single(std::boxed::Box::new(crate::schemars::schema::InstanceType::Array))),
132                            array: Some(std::boxed::Box::new(crate::schemars::schema::ArrayValidation {
133                                items: Some(crate::schemars::schema::SingleOrVec::Single(std::boxed::Box::new(__gen.subschema_for::<crate::api::discovery::v1::ForNode>()))),
134                                ..Default::default()
135                            })),
136                            ..Default::default()
137                        }),
138                    ),
139                    (
140                        "forZones".into(),
141                        crate::schemars::schema::Schema::Object(crate::schemars::schema::SchemaObject {
142                            metadata: Some(std::boxed::Box::new(crate::schemars::schema::Metadata {
143                                description: Some("forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.".into()),
144                                ..Default::default()
145                            })),
146                            instance_type: Some(crate::schemars::schema::SingleOrVec::Single(std::boxed::Box::new(crate::schemars::schema::InstanceType::Array))),
147                            array: Some(std::boxed::Box::new(crate::schemars::schema::ArrayValidation {
148                                items: Some(crate::schemars::schema::SingleOrVec::Single(std::boxed::Box::new(__gen.subschema_for::<crate::api::discovery::v1::ForZone>()))),
149                                ..Default::default()
150                            })),
151                            ..Default::default()
152                        }),
153                    ),
154                ].into(),
155                ..Default::default()
156            })),
157            ..Default::default()
158        })
159    }
160}