RDF::Query::Plan::Service - Executable query plan for remote SPARQL queries.
This document describes RDF::Query::Plan::Service version 2.918.
Beyond the methods documented below, this class inherits methods from the
RDF::Query::Plan class.
- "new ( $endpoint, $plan, $silent, $sparql, [ \%logging_keys ]
)"
- Returns a new SERVICE (remote endpoint call) query plan object.
"<$endpoint"> is the URL of the
endpoint (as a node object).
"<$plan"> is the query plan
representing the query to be sent to the remote endpoint (needed for cost
estimates). "<$sparql"> is the
serialized SPARQL query to be sent to the remote endpoint. Finally, if
present, "<%logging_keys"> is a
HASH containing the keys to use in logging the execution of this plan.
Valid HASH keys are:
* bf - The bound/free string representing C<<$plan>>
- "new_from_plan ( $endpoint, $plan, $context )"
- Returns a new SERVICE query plan object.
"<$endpoint"> is the URL of the
endpoint (as a string). "<$plan">
is the query plan representing the query to be sent to the remote
endpoint. The exact SPARQL serialization that will be used is obtained by
getting the originating RDF::Query::Algebra object from
"<$plan">, and serializing it
(with the aid of the RDF::Query::ExecutionContext object
"<$context">).
- "execute ( $execution_context )"
- "next"
- "close"
- "endpoint"
- "sparql"
- Returns the SPARQL query (as a string) that will be sent to the remote
endpoint.
- "lhs"
- "silent"
- Returns a boolean value indicating whether the service plan will ignore
errors.
- "pattern"
- Returns the query plan that will be used in the remote service call.
- "distinct"
- Returns true if the pattern is guaranteed to return distinct results.
- "ordered"
- Returns true if the pattern is guaranteed to return ordered results.
- "plan_node_name"
- Returns the string name of this plan node, suitable for use in
serialization.
- "plan_prototype"
- Returns a list of scalar identifiers for the type of the content
(children) nodes of this plan node. See RDF::Query::Plan for a list of the
allowable identifiers.
- "plan_node_data"
- Returns the data for this plan node that corresponds to the values
described by the signature returned by
"plan_prototype".
- "graph ( $g )"
- "explain"
- Returns a string serialization of the query plan appropriate for display
on the command line.
Gregory Todd Williams <gwilliams@cpan.org>