Struct FilesystemResourceHandler 

pub struct FilesystemResourceHandler { /* private fields */ }

Resource handler implementation for the filesystem provider.

Trait Implementations

impl Clone for FilesystemResourceHandler

fn clone(&self) -> FilesystemResourceHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilesystemResourceHandler

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

Formats the value using the given formatter.

impl ResourceHandler for FilesystemResourceHandler

fn definition(&self) -> Resource

Returns the resource definition.

fn template(&self) -> Option<ResourceTemplate>

Returns the resource template definition, if this resource uses a URI template.

fn final_template_definition(&self) -> Option<FinalResourceTemplate>

Returns an exact final resource-template catalog definition, when this handler owns a template. This keeps final metadata immutable at router registration rather than reconstructing it from the legacy template.

fn read_async<'a>( &'a self, ctx: &'a McpContext, ) -> BoxFuture<'a, McpOutcome<Vec<ResourceContent>>>

Reads the resource content asynchronously.

fn read_async_with_uri<'a>( &'a self, ctx: &'a McpContext, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<Vec<ResourceContent>>>

Reads the resource content asynchronously with the matched URI and parameters.

fn read(&self, ctx: &McpContext) -> McpResult<Vec<ResourceContent>>

Reads the resource content synchronously.

fn read_with_uri( &self, ctx: &McpContext, uri: &str, params: &HashMap<String, String>, ) -> McpResult<Vec<ResourceContent>>

Reads the resource content synchronously with the matched URI and parameters.

fn final_client_direct_https(&self) -> bool

Returns whether locally authored final resource identities may use HTTPS at client-direct use sites. Exact MCP 2024-11-05 dispatch never consults this declaration.

fn declares_final_mrtr(&self) -> bool

Declares whether this handler can use final MRTR continuations.

fn on_subscribe(&self, _ctx: &McpContext, _uri: &str) -> McpResult<()>

Called after a session admits resources/subscribe for this URI.

fn on_unsubscribe(&self, _ctx: &McpContext, _uri: &str) -> McpResult<()>

Called after a session removes resources/subscribe for this URI.

fn final_definition(&self) -> Option<FinalResource>

Returns an exact final resource catalog definition, when this handler owns one. This bypasses lossy projection through Resource, retaining final-only fields such as size, full icons, annotations, and _meta.

fn final_title(&self) -> Option<&str>

Returns the final display title for this concrete resource.

fn final_icons(&self) -> Option<&[RawIcon]>

Returns the final icon set for this concrete resource.

fn final_annotations(&self) -> Option<&Annotations>

Returns the final annotations for this concrete resource.

fn final_metadata(&self) -> Option<&OpenMetadata>

Returns final open metadata for this concrete resource.

fn final_template_title(&self) -> Option<&str>

Returns the final display title for this resource template.

fn final_template_icons(&self) -> Option<&[RawIcon]>

Returns the final icon set for this resource template.

fn final_template_annotations(&self) -> Option<&Annotations>

Returns the final annotations for this resource template.

fn final_template_metadata(&self) -> Option<&OpenMetadata>

Returns final open metadata for this resource template.

fn icon(&self) -> Option<&Icon>

Returns the resource’s icon, if any.

fn version(&self) -> Option<&str>

Returns the resource’s version, if any.

fn tags(&self) -> &[String]

Returns the resource’s tags for filtering and organization.

fn timeout(&self) -> Option<Duration>

Returns the resource’s custom timeout duration.

fn read_final( &self, ctx: &McpContext, ) -> McpResult<CompleteResult<FinalReadResourceResult>>

Reads the resource through the final MCP 2026-07-28 result surface.

fn final_resource_read_cache_hint_provenance( &self, ) -> FinalResourceReadCacheHintProvenance

Returns the provenance of complete final resource-read cache hints.

fn read_final_with_uri( &self, ctx: &McpContext, uri: &str, params: &HashMap<String, String>, ) -> McpResult<CompleteResult<FinalReadResourceResult>>

Reads the resource through the final result surface with URI parameters.

fn read_final_outcome( &self, ctx: &McpContext, ) -> McpResult<FinalMethodOutcome<FinalReadResourceResult>>

Reads the resource through the complete-or-input-required final algebra.

fn read_final_outcome_with_uri( &self, ctx: &McpContext, uri: &str, params: &HashMap<String, String>, ) -> McpResult<FinalMethodOutcome<FinalReadResourceResult>>

Reads the resource through the complete-or-input-required final algebra with URI parameters.

fn read_final_async<'a>( &'a self, ctx: &'a McpContext, ) -> BoxFuture<'a, McpOutcome<CompleteResult<FinalReadResourceResult>>>

Asynchronously reads the resource through the final result surface.

fn read_final_async_with_uri<'a>( &'a self, ctx: &'a McpContext, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<CompleteResult<FinalReadResourceResult>>>

Asynchronously reads the resource through the final result surface with URI parameters.

fn read_final_outcome_async<'a>( &'a self, ctx: &'a McpContext, ) -> BoxFuture<'a, McpOutcome<FinalMethodOutcome<FinalReadResourceResult>>>

Asynchronously reads the resource through the complete-or-input-required final algebra.

fn read_final_outcome_async_with_uri<'a>( &'a self, ctx: &'a McpContext, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<FinalMethodOutcome<FinalReadResourceResult>>>

Asynchronously reads the resource through the complete-or-input-required final algebra with URI parameters.

fn read_async_with_uri_in_request<'a>( &'a self, ctx: &'a McpContext, _request_cx: &'a Cx, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<Vec<ResourceContent>>>

Reads the resource from a request-owned structured child.

fn read_final_async_with_uri_in_request<'a>( &'a self, ctx: &'a McpContext, _request_cx: &'a Cx, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<CompleteResult<FinalReadResourceResult>>>

Reads the resource’s final result from a request-owned structured child.

fn read_final_outcome_async_with_uri_in_request<'a>( &'a self, ctx: &'a McpContext, _request_cx: &'a Cx, uri: &'a str, params: &'a HashMap<String, String>, ) -> BoxFuture<'a, McpOutcome<FinalMethodOutcome<FinalReadResourceResult>>>

Reads the resource’s complete-or-input-required final outcome from a request-owned structured child.

fn read_final_outcome_async_with_uri_resuming_in_request<'a>( &'a self, ctx: &'a McpContext, request_cx: &'a Cx, uri: &'a str, params: &'a HashMap<String, String>, _resume_inputs: Option<&'a MrtrCompletedInputs>, ) -> BoxFuture<'a, McpOutcome<FinalMethodOutcome<FinalReadResourceResult>>>

Resumes a final resource read after framework-admitted MRTR input.