Struct JsonSerializer 

pub struct JsonSerializer { /* private fields */ }

JSON serializer with configurable formatting options.

Implementations

impl JsonSerializer

pub fn new() -> Self

Create a new JSON serializer with default (compact) options.

pub fn with_options(options: SerializeOptions) -> Self

Create a new JSON serializer with the given options.

pub fn finish(self) -> Vec<u8>

Consume the serializer and return the output bytes.

Trait Implementations

impl Default for JsonSerializer

fn default() -> Self

Returns the “default value” for a type.

impl FormatSerializer for JsonSerializer

type Error = JsonSerializeError

Format-specific error type.

fn begin_struct(&mut self) -> Result<(), Self::Error>

Begin a map/object/struct.

fn field_key(&mut self, key: &str) -> Result<(), Self::Error>

Emit a field key within a struct.

fn end_struct(&mut self) -> Result<(), Self::Error>

End a map/object/struct.

fn begin_seq(&mut self) -> Result<(), Self::Error>

Begin a sequence/array.

fn end_seq(&mut self) -> Result<(), Self::Error>

End a sequence/array.

fn scalar(&mut self, scalar: ScalarValue<'_>) -> Result<(), Self::Error>

Emit a scalar value.

fn raw_serialize_shape(&self) -> Option<&'static Shape>

Returns the shape of the format’s raw capture type for serialization.

fn raw_scalar(&mut self, content: &str) -> Result<(), Self::Error>

Emit a raw scalar value (for RawJson, etc.) without any encoding/escaping.

fn field_metadata(&mut self, _field: &FieldItem) -> Result<(), Self::Error>

Optional: Provide field metadata before field_key is called. This allows formats like XML to extract namespace information. Default implementation does nothing.

fn struct_metadata(&mut self, _shape: &Shape) -> Result<(), Self::Error>

Optional: Provide struct/enum type metadata when beginning to serialize it. This allows formats to extract container-level attributes like xml::ns_all. Default implementation does nothing.

fn variant_metadata( &mut self, _variant: &'static Variant, ) -> Result<(), Self::Error>

Optional: Provide variant metadata before serializing an enum variant. This allows formats like XML to use the variant name as the element name for xml::elements serialization. Default implementation does nothing.

fn preferred_field_order(&self) -> FieldOrdering

Preferred field ordering for this format. Formats like XML can request attributes-first ordering to avoid buffering. Default is declaration order.

fn begin_seq_with_len(&mut self, _len: usize) -> Result<(), Self::Error>

Begin a sequence with known length.

fn typed_scalar( &mut self, scalar_type: ScalarType, value: Peek<'_, '_>, ) -> Result<(), Self::Error>

Serialize a scalar with full type information.

fn begin_option_some(&mut self) -> Result<(), Self::Error>

Begin serializing Option::Some(value).

fn serialize_none(&mut self) -> Result<(), Self::Error>

Serialize Option::None.

fn begin_enum_variant( &mut self, _variant_index: usize, _variant_name: &'static str, ) -> Result<(), Self::Error>

Begin an enum variant with its index and name.