Struct CallContext 

pub struct CallContext { /* private fields */ }

Metadata about the current server-side method call.

Passed to ServerInterceptor::before and ServerInterceptor::after.

Implementations

impl CallContext

pub fn method(&self) -> &str

Returns the JSON-RPC method name.

pub fn caller_identity(&self) -> Option<&str>

Returns the caller identity, once something has established one.

pub fn set_caller_identity(&self, identity: impl Into<String>) -> bool

Records who the caller is, if nothing has yet.

Returns true when this call set the identity and false when one was already present — in which case the existing identity stands and the argument is dropped.

Takes &self deliberately: the caller is established by an authentication interceptor, and ServerInterceptor::before receives a shared reference. Anything that needs &mut here is unreachable from the place that has the answer.

Example

use a2a_protocol_server::CallContext;

let ctx = CallContext::new("SendMessage");
assert!(ctx.set_caller_identity("user@example.com"));
assert_eq!(ctx.caller_identity(), Some("user@example.com"));

// A second interceptor does not get to overwrite it.
assert!(!ctx.set_caller_identity("someone-else"));
assert_eq!(ctx.caller_identity(), Some("user@example.com"));

pub fn extensions(&self) -> &[String]

Returns the active extension URIs.

pub fn request_id(&self) -> Option<&str>

Returns the request/trace ID if set.

pub const fn http_headers(&self) -> &HashMap<String, String>

Returns the HTTP request headers (read-only).

impl CallContext

pub fn new(method: impl Into<String>) -> Self

Creates a new CallContext for the given method.

pub fn with_caller_identity(self, identity: String) -> Self

Sets the caller identity at construction.

For a caller building a context directly. An interceptor holding &CallContext wants set_caller_identity.

pub fn with_extensions(self, extensions: Vec<String>) -> Self

Sets the active extensions.

pub fn with_request_id(self, id: impl Into<String>) -> Self

Sets the request/trace ID explicitly.

pub fn with_http_headers(self, headers: HashMap<String, String>) -> Self

Sets the HTTP headers map (replacing any existing headers).

Automatically extracts x-request-id into request_id if present.

pub fn with_http_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Adds a single HTTP header (key is lowercased for case-insensitive matching).

If the key is x-request-id, also populates request_id.

Trait Implementations

impl Clone for CallContext

fn clone(&self) -> CallContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallContext

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

Formats the value using the given formatter.