Class McpResourceOutput

java.lang.Object

com.soklet.McpResourceOutput

All Implemented Interfaces:

McpCompletePayload

@ThreadSafe
public final class McpResourceOutput
extends Object
implements McpCompletePayload

Immutable output of one completed MCP resource-read request.

The matching resource registration owns the fixed cache scope and default time to live. An output may override only the time to live for this response. A localization-enabled server conservatively publishes a private, zero-time-to-live policy regardless of an output override.

Author:

Mark Allen

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
static @NonNull McpResourceOutput	fromContent(@NonNull McpResourceContents resourceContents)	Creates output containing exactly one resource value.
static @NonNull McpResourceOutput	fromContents(@NonNull List<? extends @NonNull McpResourceContents> resourceContents)	Creates output from an ordered snapshot of resource contents.
@NonNull Optional<@NonNull Duration>	getCacheTimeToLiveOverride()	Returns this response's time-to-live override.
@NonNull List<@NonNull McpResourceContents>	getContents()
int	hashCode()
static @NonNull McpResourceOutput.Builder	withContent(@NonNull McpResourceContents resourceContents)	Vends a builder containing its required first resource value.
static @NonNull McpResourceOutput.Builder	withContents(@NonNull List<? extends @NonNull McpResourceContents> resourceContents)	Vends a builder containing an ordered snapshot of resource contents.

Methods inherited from class Object

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

Method Details

withContent

public static @NonNull McpResourceOutput.Builder withContent(@NonNull McpResourceContents resourceContents)

Vends a builder containing its required first resource value.

Parameters:

resourceContents - resource contents

Returns:

resource-output builder

Throws:

NullPointerException - if resourceContents is null

fromContent

public static @NonNull McpResourceOutput fromContent(@NonNull McpResourceContents resourceContents)

Creates output containing exactly one resource value.

Parameters:

resourceContents - resource contents

Returns:

immutable resource output

Throws:

NullPointerException - if resourceContents is null

withContents

public static @NonNull McpResourceOutput.Builder withContents(@NonNull List<? extends @NonNull McpResourceContents> resourceContents)

Vends a builder containing an ordered snapshot of resource contents.

Parameters:

resourceContents - nonempty resource contents in response order

Returns:

resource-output builder

Throws:

NullPointerException - if the list or any item is null

IllegalArgumentException - if the list is empty

fromContents

public static @NonNull McpResourceOutput fromContents(@NonNull List<? extends @NonNull McpResourceContents> resourceContents)

Creates output from an ordered snapshot of resource contents.

Parameters:

resourceContents - nonempty resource contents in response order

Returns:

immutable resource output

Throws:

NullPointerException - if the list or any item is null

IllegalArgumentException - if the list is empty

getContents

public @NonNull List<@NonNull McpResourceContents> getContents()

Returns:

immutable resource contents in insertion order

getCacheTimeToLiveOverride

public @NonNull Optional<@NonNull Duration> getCacheTimeToLiveOverride()

Returns this response's time-to-live override.

Returns:

override, or empty to use the registration default

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether contents and cache override are structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural resource-output hash code