Class McpJsonObject

java.lang.Object

com.soklet.McpJsonObject

All Implemented Interfaces:

McpJsonValue

@ThreadSafe
public final class McpJsonObject
extends Object
implements McpJsonValue

An immutable JSON object.

Member names are retained exactly, without normalization or replacement. Factories and builder setters reject names containing unpaired UTF-16 surrogates with IllegalArgumentException. The independent string/token and response-size limits described by McpJsonString are checked when the object is serialized.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpJsonObject.Builder	Mutable builder for McpJsonObject.

Method Summary

Modifier and Type	Method	Description
static @NonNull McpJsonObject.Builder	builder()	Vends a mutable builder.
static @NonNull McpJsonObject	emptyInstance()	Returns the shared empty object.
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull McpJsonValue>	find(@NonNull String name)	Looks up a member by name.
static @NonNull McpJsonObject	fromMembers(@NonNull Map<@NonNull String, ? extends @NonNull McpJsonValue> members)	Creates an object from the supplied members.
@NonNull Map<@NonNull String, @NonNull McpJsonValue>	getMembers()	Returns the immutable members in their original insertion order.
int	hashCode()

Methods inherited from class Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

emptyInstance

public static @NonNull McpJsonObject emptyInstance()

Returns the shared empty object.

Returns:

empty JSON object

builder

public static @NonNull McpJsonObject.Builder builder()

Vends a mutable builder.

Returns:

JSON object builder

fromMembers

public static @NonNull McpJsonObject fromMembers(@NonNull Map<@NonNull String, ? extends @NonNull McpJsonValue> members)

Creates an object from the supplied members.

Parameters:

members - object members

Returns:

immutable JSON object

Throws:

IllegalArgumentException - if a member name contains an unpaired surrogate

getMembers

public @NonNull Map<@NonNull String, @NonNull McpJsonValue> getMembers()

Returns the immutable members in their original insertion order.

Returns:

object members in insertion order

find

public @NonNull Optional<@NonNull McpJsonValue> find(@NonNull String name)

Looks up a member by name.

Parameters:

name - member name

Returns:

member value, if present

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether this object has structurally equal members

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural member hash code