Class McpBlobResourceContents

java.lang.Object

com.soklet.McpBlobResourceContents

All Implemented Interfaces:

McpResourceContents

@ThreadSafe
public final class McpBlobResourceContents
extends Object
implements McpResourceContents

Immutable binary contents for one MCP resource.

The built-in server can send at most 786,432 raw bytes per binary content item: Base64 encoding must fit the 1,048,576-character JSON string limit. The complete response must also fit the 4 MiB UTF-8 JSON limit. Construction defensively copies data but does not prevalidate the eventual response size. Prefer McpResourceLink for larger payloads; an MCP resource read returning these contents remains subject to the same limits.

Author:

Mark Allen

Nested Class Summary

Nested Classes

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

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.
byte @NonNull []	getData()	Returns a defensive copy of the resource bytes.
@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 URI	getUri()	Returns the URI that identifies this resource.
int	hashCode()
static @NonNull McpBlobResourceContents.Builder	withUriAndData(@NonNull URI uri, byte @NonNull [] data)	Vends a builder primed with the resource URI and binary data.

Methods inherited from class Object

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

Method Details

withUriAndData

public static @NonNull McpBlobResourceContents.Builder withUriAndData(@NonNull URI uri,
 byte @NonNull [] data)

Vends a builder primed with the resource URI and binary data.

Parameters:

uri - absolute normalized resource URI in ASCII wire form

data - resource bytes, defensively copied

Returns:

resource-content builder

Throws:

IllegalArgumentException - if the URI is relative, not normalized, or not in ASCII wire form

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

getData

public byte @NonNull [] getData()

Returns a defensive copy of the resource bytes.

Returns:

resource bytes

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