Class McpResourceDescriptor

java.lang.Object

com.soklet.McpResourceDescriptor

@ThreadSafe
public final class McpResourceDescriptor
extends Object

Immutable concrete resource descriptor emitted by resources/list.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpResourceDescriptor.Builder	Mutable builder for an immutable resource descriptor.

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull McpContentAnnotations>	getAnnotations()
@NonNull Optional<@NonNull String>	getDescription()
@NonNull List<@NonNull McpIcon>	getIcons()
@NonNull McpJsonObject	getMetadata()
@NonNull Optional<@NonNull String>	getMimeType()
@NonNull String	getName()
@NonNull Optional<@NonNull Long>	getSizeInBytes()
@NonNull Optional<@NonNull String>	getTitle()
@NonNull URI	getUri()
int	hashCode()
static @NonNull McpResourceDescriptor.Builder	withUriAndName(@NonNull URI uri, @NonNull String name)	Vends a builder primed with the concrete resource URI and name.

Methods inherited from class Object

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

Method Details

withUriAndName

public static @NonNull McpResourceDescriptor.Builder withUriAndName(@NonNull URI uri,
 @NonNull String name)

Vends a builder primed with the concrete resource URI and name.

Parameters:

uri - absolute normalized resource URI in ASCII wire form

name - nonblank resource name

Returns:

resource-descriptor builder

Throws:

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

getUri

public @NonNull URI getUri()

Returns:

absolute normalized resource URI in ASCII wire form

getName

public @NonNull String getName()

Returns:

nonblank resource name

getTitle

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

Returns:

human-readable title, if configured

getDescription

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

Returns:

human-readable description, if configured

getMimeType

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

Returns:

resource MIME type, if configured

getIcons

public @NonNull List<@NonNull McpIcon> getIcons()

Returns:

immutable icon list in insertion order

getAnnotations

public @NonNull Optional<@NonNull McpContentAnnotations> getAnnotations()

Returns:

content annotations, if configured

getSizeInBytes

public @NonNull Optional<@NonNull Long> getSizeInBytes()

Returns:

resource size in bytes, if configured

getMetadata

public @NonNull McpJsonObject getMetadata()

Returns:

immutable protocol extension metadata

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every descriptor property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural descriptor hash code