Class McpTextResourceContents

java.lang.Object

com.soklet.McpTextResourceContents

All Implemented Interfaces:

McpResourceContents

@ThreadSafe
public final class McpTextResourceContents
extends Object
implements McpResourceContents

Immutable UTF-16 Java text contents for one MCP resource.

Construction rejects unpaired UTF-16 surrogates with IllegalArgumentException. Well-formed text is retained exactly, without normalization or replacement. Text must fit the independent JSON string/token and complete-response limits described by McpJsonString; construction does not prevalidate its eventual serialized size.

Author:

Mark Allen

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull McpAppResourceMetadata>	getAppResourceMetadata()	Returns separately configured Apps policy and presentation hints.
@NonNull McpJsonObject	getMetadata()	Returns protocol extension metadata associated with this resource.
@NonNull Optional<@NonNull String>	getMimeType()	Returns the resource MIME type, if one was supplied.
@NonNull String	getText()
@NonNull URI	getUri()	Returns the URI that identifies this resource.
int	hashCode()
static @NonNull McpTextResourceContents.Builder	withUriAndText(@NonNull URI uri, @NonNull String text)	Vends a builder primed with the resource URI and text.

Methods inherited from class Object

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

Method Details

withUriAndText

public static @NonNull McpTextResourceContents.Builder withUriAndText(@NonNull URI uri,
 @NonNull String text)

Vends a builder primed with the resource URI and text.

Parameters:

uri - absolute normalized resource URI in ASCII wire form

text - resource text

Returns:

resource-content builder

Throws:

IllegalArgumentException - if the URI is relative, not normalized, or not in ASCII wire form, or the text contains an unpaired surrogate

getUri

public @NonNull URI getUri()

Returns the URI that identifies this resource.

Specified by:

getUri in interface McpResourceContents

Returns:

absolute normalized resource URI in ASCII wire form

getText

public @NonNull String getText()

Returns:

resource text

getMimeType

public @NonNull Optional<@NonNull String> getMimeType()

Returns the resource MIME type, if one was supplied.

Specified by:

getMimeType in interface McpResourceContents

Returns:

resource MIME type, if available

getAppResourceMetadata

public @NonNull Optional<@NonNull McpAppResourceMetadata> getAppResourceMetadata()

Returns separately configured Apps policy and presentation hints.

Specified by:

getAppResourceMetadata in interface McpResourceContents

Returns:

typed Apps resource metadata, if supplied

getMetadata

public @NonNull McpJsonObject getMetadata()

Returns protocol extension metadata associated with this resource.

Specified by:

getMetadata in interface McpResourceContents

Returns:

immutable metadata object

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every resource-content property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural resource-content hash code