Struct FederatedQueryHandler 

pub struct FederatedQueryHandler<'a> {
    pub local_quins: &'a [NQuin],
    pub endpoints: [Option<ServiceEndpoint>; 16],
    pub endpoint_count: u8,
    pub cache_enabled: bool,
    /* private fields */
}

SPARQL Federated Query Handler — a DID-registry front over the URL-based FederatedQueryEngine. It maps a DID to a concrete endpoint URL string and dispatches remote SPARQL requests through the same real HTTP transport.

Fields

local_quins: &'a [NQuin]

endpoints: [Option<ServiceEndpoint>; 16]

endpoint_count: u8

cache_enabled: bool

Implementations

impl<'a> FederatedQueryHandler<'a>

pub fn new(quins: &'a [NQuin]) -> Self

pub fn set_endpoint_url(&mut self, did: u64, url: &str)

Associate a DID with a concrete endpoint URL so remote queries can actually be dispatched over HTTP (the ServiceEndpoint.endpoint_url hash is not reversible).

pub fn register_endpoint( &mut self, endpoint: ServiceEndpoint, ) -> Result<u8, String>

Register a federated endpoint

pub fn resolve_did(&self, did: u64) -> Result<u64, String>

Resolve DID to endpoint URL

pub fn execute_service( &self, did: u64, query: &str, _format: &str, ) -> Result<FederatedResult, String>

Execute a federated query against the endpoint registered for did, over the real HTTP SPARQL 1.1 Protocol transport.

Requires a resolvable endpoint URL registered via set_endpoint_url (the ServiceEndpoint.endpoint_url hash is not reversible to a URL). Authenticated (DID-LD/JWT) endpoints must be signed by the identity layer; only the no-auth path is dispatched here — no fabricated auth header. Network egress: makes a real outbound request.

pub fn execute_federated( &self, _service_did: u64, _service_query: &str, _local_pattern: PatternId, _ctx: &SparqlQueryContext, ) -> Result<Vec<BindingRow>, String>

Execute federated query with local data

pub fn check_cors_allowed( &self, did: u64, origin_did: u64, ) -> Result<bool, String>

Check CORS using DID-based authentication

pub fn generate_cors_headers(&self, did: u64) -> Result<Vec<(u64, u64)>, String>

Generate CORS headers using DID

Trait Implementations

impl<'a> Default for FederatedQueryHandler<'a>

fn default() -> Self

Returns the “default value” for a type.