Struct Resource 

pub struct Resource {
    pub uri: String,
    pub name: String,
    pub title: Option<String>,
    pub description: Option<String>,
    pub mime_type: Option<String>,
    pub icons: Option<Vec<ToolIcon>>,
    pub size: Option<u64>,
    /* private fields */
}

A complete resource definition with service-based execution.

Resources are implemented as Tower services internally, enabling middleware composition via the builder’s .layer() method. The service is wrapped in ResourceCatchError to convert any errors (from handlers or middleware) into error result responses.

Fields

uri: String

Resource URI

name: String

Human-readable name

title: Option<String>

Human-readable title for display purposes

description: Option<String>

Optional description

mime_type: Option<String>

Optional MIME type

icons: Option<Vec<ToolIcon>>

Optional icons for display in user interfaces

size: Option<u64>

Optional size in bytes

Implementations

impl Resource

pub fn builder(uri: impl Into<String>) -> ResourceBuilder

Create a new resource builder

pub fn definition(&self) -> ResourceDefinition

Get the resource definition for resources/list

pub fn read(&self) -> BoxFuture<'static, ReadResourceResult>

Read the resource without context

Creates a dummy request context. For full context support, use read_with_context.

pub fn read_with_context( &self, ctx: RequestContext, ) -> BoxFuture<'static, ReadResourceResult>

Read the resource with request context

The context provides progress reporting, cancellation support, and access to client requests (for sampling, etc.).

Note

This method returns ReadResourceResult directly (not Result<ReadResourceResult>). Any errors from the handler or middleware are converted to error responses in the result contents.

Trait Implementations

impl Clone for Resource

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Resource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Filterable for Resource

fn name(&self) -> &str

Returns the name of this capability.

impl Send for Resource

impl Sync for Resource