io.modelcontextprotocol.json

接口 McpJsonMapper

所有已知实现类:

JacksonMcpJsonMapper

public interface McpJsonMapper

Abstraction for JSON serialization/deserialization to decouple the SDK from any specific JSON library. A default implementation backed by Jackson is provided in io.modelcontextprotocol.spec.json.jackson.JacksonJsonMapper.

方法概要

限定符和类型	方法和说明
<T> T	convertValue(java.lang.Object fromValue, java.lang.Class<T> type) Convert a value to a given type, useful for mapping nested JSON structures.
<T> T	convertValue(java.lang.Object fromValue, TypeRef<T> type) Convert a value to a given parameterized type.
static McpJsonMapper	createDefault() Creates a new default McpJsonMapper.
static McpJsonMapper	getDefault() Returns the default McpJsonMapper.
<T> T	readValue(byte[] content, java.lang.Class<T> type) Deserialize JSON bytes into a target type.
<T> T	readValue(byte[] content, TypeRef<T> type) Deserialize JSON bytes into a parameterized target type.
<T> T	readValue(java.lang.String content, java.lang.Class<T> type) Deserialize JSON string into a target type.
<T> T	readValue(java.lang.String content, TypeRef<T> type) Deserialize JSON string into a parameterized target type.
byte[]	writeValueAsBytes(java.lang.Object value) Serialize an object to JSON bytes.
java.lang.String	writeValueAsString(java.lang.Object value) Serialize an object to JSON string.

方法详细资料

readValue

<T> T readValue(java.lang.String content,
                java.lang.Class<T> type)
         throws java.io.IOException

Deserialize JSON string into a target type.

类型参数:

T - generic type

参数:

content - JSON as String

type - target class

返回:

deserialized instance

抛出:

java.io.IOException - on parse errors

readValue

<T> T readValue(byte[] content,
                java.lang.Class<T> type)
         throws java.io.IOException

Deserialize JSON bytes into a target type.

类型参数:

T - generic type

参数:

content - JSON as bytes

type - target class

返回:

deserialized instance

抛出:

java.io.IOException - on parse errors

readValue

<T> T readValue(java.lang.String content,
                TypeRef<T> type)
         throws java.io.IOException

Deserialize JSON string into a parameterized target type.

类型参数:

T - generic type

参数:

content - JSON as String

type - parameterized type reference

返回:

deserialized instance

抛出:

java.io.IOException - on parse errors

readValue

<T> T readValue(byte[] content,
                TypeRef<T> type)
         throws java.io.IOException

Deserialize JSON bytes into a parameterized target type.

类型参数:

T - generic type

参数:

content - JSON as bytes

type - parameterized type reference

返回:

deserialized instance

抛出:

java.io.IOException - on parse errors

convertValue

<T> T convertValue(java.lang.Object fromValue,
                   java.lang.Class<T> type)

Convert a value to a given type, useful for mapping nested JSON structures.

类型参数:

T - generic type

参数:

fromValue - source value

type - target class

返回:

converted value

convertValue

<T> T convertValue(java.lang.Object fromValue,
                   TypeRef<T> type)

Convert a value to a given parameterized type.

类型参数:

T - generic type

参数:

fromValue - source value

type - target type reference

返回:

converted value

writeValueAsString

java.lang.String writeValueAsString(java.lang.Object value)
                             throws java.io.IOException

Serialize an object to JSON string.

参数:

value - object to serialize

返回:

JSON as String

抛出:

java.io.IOException - on serialization errors

writeValueAsBytes

byte[] writeValueAsBytes(java.lang.Object value)
                  throws java.io.IOException

Serialize an object to JSON bytes.

参数:

value - object to serialize

返回:

JSON as bytes

抛出:

java.io.IOException - on serialization errors

getDefault

static McpJsonMapper getDefault()

Returns the default McpJsonMapper.

返回:

The default McpJsonMapper

抛出:

java.lang.IllegalStateException - If no McpJsonMapper implementation exists on the classpath.

createDefault

static McpJsonMapper createDefault()

Creates a new default McpJsonMapper.

返回:

The default McpJsonMapper

抛出:

java.lang.IllegalStateException - If no McpJsonMapper implementation exists on the classpath.