Enum JsonData 

#[non_exhaustive]
pub enum JsonData {
    Null,
    Bool(bool),
    Integer(i64),
    Float(f64),
    String(String),
    Array(Vec<JsonData>),
    Object(HashMap<String, JsonData>),
}

Domain-specific representation of JSON-like data This replaces serde_json::Value to maintain Clean Architecture principles

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Null

Null value

Bool(bool)

Boolean value

Integer(i64)

Integer value

Float(f64)

Float value (stored as f64 for simplicity)

String(String)

String value

Array(Vec<JsonData>)

Array of JsonData values

Object(HashMap<String, JsonData>)

Object with string keys and JsonData values

Implementations

impl JsonData

pub fn null() -> JsonData

Create a new null value

pub fn bool(value: bool) -> JsonData

Create a new boolean value

pub fn integer(value: i64) -> JsonData

Create a new integer value

pub fn float(value: f64) -> Result<JsonData, DomainError>

Create a new float value.

Returns Err when value is NaN or infinite. JSON (RFC 8259 §6) does not allow non-finite numbers, so a JsonData containing one could never be serialized to valid JSON.

Examples

use pjson_rs_domain::value_objects::JsonData;

assert!(JsonData::float(3.14).is_ok());
assert!(JsonData::float(f64::NAN).is_err());
assert!(JsonData::float(f64::INFINITY).is_err());

pub fn string<S>(value: S) -> JsonData

where S: Into<String>,

Create a new string value

pub fn array(values: Vec<JsonData>) -> JsonData

Create a new array value

pub fn object(values: HashMap<String, JsonData>) -> JsonData

Create a new object value

pub fn is_null(&self) -> bool

Check if value is null

pub fn is_bool(&self) -> bool

Check if value is boolean

pub fn is_integer(&self) -> bool

Check if value is integer

pub fn is_float(&self) -> bool

Check if value is float

pub fn is_number(&self) -> bool

Check if value is number (integer or float)

pub fn is_string(&self) -> bool

Check if value is string

pub fn is_array(&self) -> bool

Check if value is array

pub fn is_object(&self) -> bool

Check if value is object

pub fn as_bool(&self) -> Option<bool>

Get boolean value if this is a boolean

pub fn as_i64(&self) -> Option<i64>

Get integer value if this is an integer

pub fn as_f64(&self) -> Option<f64>

Get float value if this is a float

pub fn as_str(&self) -> Option<&str>

Get string value if this is a string

pub fn as_array(&self) -> Option<&Vec<JsonData>>

Get array value if this is an array

pub fn as_array_mut(&mut self) -> Option<&mut Vec<JsonData>>

Get mutable array value if this is an array

pub fn as_object(&self) -> Option<&HashMap<String, JsonData>>

Get object value if this is an object

pub fn as_object_mut(&mut self) -> Option<&mut HashMap<String, JsonData>>

Get mutable object value if this is an object

pub fn get(&self, key: &str) -> Option<&JsonData>

Get value by key (if this is an object)

pub fn path(&self, path: &str) -> Option<&JsonData>

Get nested value by path (dot notation)

pub fn set_path(&mut self, path: &str, value: JsonData) -> bool

Set nested value by path (dot notation)

pub fn memory_size(&self) -> usize

Estimate memory size in bytes

Trait Implementations

impl Clone for JsonData

fn clone(&self) -> JsonData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonData

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

Formats the value using the given formatter.

impl Default for JsonData

fn default() -> JsonData

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for JsonData

Deserializes JSON input directly into JsonData, skipping the intermediate serde_json::Value tree that From<serde_json::Value> would otherwise require building and then walking a second time.

The implementation drives a Visitor through Deserializer::deserialize_any, so it works with any self-describing format (not just serde_json) and constructs each JsonData variant in a single pass over the input.

Examples

use pjson_rs_domain::value_objects::JsonData;

let data: JsonData = serde_json::from_str(r#"{"a": 1, "b": [true, null]}"#).unwrap();
assert!(data.is_object());
assert_eq!(data.get("a").and_then(JsonData::as_i64), Some(1));

fn deserialize<D>( deserializer: D, ) -> Result<JsonData, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for JsonData

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

Formats the value using the given formatter.

impl Eq for JsonData

impl From<&str> for JsonData

fn from(value: &str) -> JsonData

Converts to this type from the input type.

impl From<HashMap<String, JsonData>> for JsonData

fn from(value: HashMap<String, JsonData>) -> JsonData

Converts to this type from the input type.

impl From<String> for JsonData

fn from(value: String) -> JsonData

Converts to this type from the input type.

impl From<Value> for JsonData

fn from(value: Value) -> JsonData

Converts to this type from the input type.

impl From<Vec<JsonData>> for JsonData

fn from(value: Vec<JsonData>) -> JsonData

Converts to this type from the input type.

impl From<bool> for JsonData

fn from(value: bool) -> JsonData

Converts to this type from the input type.

impl From<i64> for JsonData

fn from(value: i64) -> JsonData

Converts to this type from the input type.

impl Hash for JsonData

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for JsonData

fn eq(&self, other: &JsonData) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for JsonData

Serializes JsonData as a plain JSON value rather than as a Rust enum (which would wrap every non-unit variant in a {"VariantName": ...} tag). This keeps the wire representation identical to what a client actually sent, and symmetric with the Deserialize impl below, which expects plain JSON on the way in.

Examples

use pjson_rs_domain::value_objects::JsonData;
use std::collections::HashMap;

let data = JsonData::object(HashMap::from([
    ("a".to_string(), JsonData::integer(1)),
]));
assert_eq!(serde_json::to_string(&data).unwrap(), r#"{"a":1}"#);

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for JsonData