Struct JsonStringValueCodec 

pub struct JsonStringValueCodec<T> { /* private fields */ }

Encodes and decodes one serializable value through UTF-8 JSON strings.

This type combines JsonStringValueEncoder and JsonStringValueDecoder for registry-backed or bidirectional call sites. It holds no state between calls, so it is Copy and Default, and encoding and decoding can share one value through ValueEncoder and ValueDecoder.

Type Parameters

• T: Value type serialized to a JSON string and recovered from it.

Examples

use qubit_codec::JsonStringValueCodec;
use qubit_codec::ValueDecoder;
use qubit_codec::ValueEncoder;

let mut codec = JsonStringValueCodec::<String>::new();
assert_eq!(codec.encode(&"hello".to_string()).unwrap(), r#""hello""#.to_string());
assert_eq!(codec.decode(r#""hello""#).unwrap(), "hello");

Implementations

impl<T> JsonStringValueCodec<T>

pub const fn new() -> Self

Creates a bidirectional JSON string codec for values of type T.

Returns

Returns a stateless codec bound to values of type T.

Trait Implementations

impl<T: Clone> Clone for JsonStringValueCodec<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy> Copy for JsonStringValueCodec<T>

impl<T: Debug> Debug for JsonStringValueCodec<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for JsonStringValueCodec<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> ValueDecoder<str> for JsonStringValueCodec<T>

where T: DeserializeOwned,

type Error = Error

JSON syntax or target-value deserialization failure.

type Output = T

Owned value deserialized independently of the input string lifetime.

fn decode(&mut self, input: &str) -> Result<Self::Output, Self::Error>

Deserializes input from a JSON string.

The codec holds no state, so this delegates to a freshly created JsonStringValueDecoder and self stays usable for further calls.

Parameters

• input: Complete JSON value to deserialize.

Returns

Returns an owned T deserialized independently of input’s lifetime.

Errors

Returns serde_json::Error when input is not valid JSON or when a valid JSON document does not match the shape required by T.

impl<T> ValueEncoder<T> for JsonStringValueCodec<T>

where T: Serialize,

type Error = Error

Serialization failure reported by Serde JSON.

type Output = String

Newly allocated UTF-8 JSON string owned by the caller.

fn encode(&mut self, input: &T) -> Result<Self::Output, Self::Error>

Serializes input into a JSON string.

The codec holds no state, so this delegates to a freshly created JsonStringValueEncoder and self stays usable for further calls.

Parameters

• input: Value to serialize as JSON.

Returns

Returns the serialized JSON text as an owned UTF-8 string.

Errors

Returns serde_json::Error when input cannot be serialized to JSON, including when a custom Serialize implementation fails or when the value contains a map key that is not a string.