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 without requiring those traits on T; 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 for JsonStringValueCodec<T>

fn clone(&self) -> Self

Copies the stateless marker without requiring T: Clone.

Returns

Returns another marker bound to the same value type.

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

Performs copy-assignment from source.

impl<T> 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 for JsonStringValueCodec<T>

fn default() -> Self

Creates the stateless marker without requiring T: Default.

Returns

Returns a codec bound to the value type T.

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 a map key cannot be represented as a JSON object key.