Visitor 特性如何只允许部分实现?

How does the Vistor trait allow only partial implementation?

在我对 Rust 有限的理解中,我认为特征就像接口一样 - 当你实现一个时,你需要实现所有的方法。

我现在正在编写自定义 serde::Deserializer。

正在查看https://docs.serde.rs/serde/de/trait.Visitor.html#example

/// A visitor that deserializes a long string - a string containing at least
/// some minimum number of bytes.
struct LongString {
    min: usize,
}

impl<'de> Visitor<'de> for LongString {
    type Value = String;

    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
        write!(formatter, "a string containing at least {} bytes", self.min)
    }

    fn visit_str<E>(self, s: &str) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        if s.len() >= self.min {
            Ok(s.to_owned())
        } else {
            Err(de::Error::invalid_value(Unexpected::Str(s), &self))
        }
    }
}

https://serde.rs/impl-deserialize.html

use std::fmt;

use serde::de::{self, Visitor};

struct I32Visitor;

impl<'de> Visitor<'de> for I32Visitor {
    type Value = i32;

    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
        formatter.write_str("an integer between -2^31 and 2^31")
    }

    fn visit_i8<E>(self, value: i8) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        Ok(i32::from(value))
    }

    fn visit_i32<E>(self, value: i32) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        Ok(value)
    }

    fn visit_i64<E>(self, value: i64) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        use std::i32;
        if value >= i64::from(i32::MIN) && value <= i64::from(i32::MAX) {
            Ok(value as i32)
        } else {
            Err(E::custom(format!("i32 out of range: {}", value)))
        }
    }

    // Similar for other methods:
    //   - visit_i16
    //   - visit_u8
    //   - visit_u16
    //   - visit_u32
    //   - visit_u64
}

Visitor trait 似乎很神奇 - 您只需要实现您想要实现的方法,其他方法默认为某种形式的错误。

这个魔法是如何工作的?

特征方法可以有默认实现。具有默认实现的方法在文档中称为“提供的方法”,并且可以选择由实现覆盖它们。

你可以看到default implementations for the Visitor trait in the source code。并非所有 return 错误,但有些也有合理的默认实现,例如较小的数字类型遵循 visit_i64()visit_u64(),因此您只需定义这两种方法即可获得所有整数类型的合理实现。