Vistor trait 如何只允许部分实现?

fad*_*bee 3 visitor rust serde

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

我现在正在编写一个自定义的 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))
        }
    }
}
Run Code Online (Sandbox Code Playgroud)

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
}
Run Code Online (Sandbox Code Playgroud)

似乎访问者特征很神奇——你只需要实现你想要实现的方法,而其他方法默认为某种形式的错误。

这个魔法是如何运作的?

Sve*_*ach 7

Trait 方法可以有默认实现。具有默认实现的方法在文档中称为“提供的方法”,它们可以被实现选择性地覆盖。

您可以在源代码中查看Visitortrait默认实现。并非所有这些都返回错误,但有些也有合理的默认实现,例如较小的数字类型遵循visit_i64()visit_u64(),因此您只需定义这两个方法即可获得所有整数类型的合理实现。

  • 尽管应该指出的是,这基本上与特征或接口无关,只是 *Java*(和 C#)历史上没有(现在都是:它们是在 Java 8.0 和 C# 8.0 中添加的)。 (2认同)