com.bigdata.rdf.sparql.ast.service

Class ServiceCallUtility

java.lang.Object

com.bigdata.rdf.sparql.ast.service.ServiceCallUtility

public class ServiceCallUtility
extends Object

Helper class for ServiceCall invocations.

Version:

$Id$

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
ServiceCallUtility()

Method Summary

Methods

Modifier and Type	Method and Description
static org.openrdf.query.BindingSet	bigdata2Openrdf(LexiconRelation lex, Set<IVariable<?>> vars, IBindingSet in) Convert the IBindingSet into an openrdf BindingSet.
static org.openrdf.query.BindingSet[]	convert(LexiconRelation lex, Set<IVariable<?>> projectedVars, IBindingSet[] in) Convert IBindingSet[] to openrdf BindingSet[].
static BigdataURI	getConstantServiceURI(IVariableOrConstant<?> serviceRef) Return the effective service URI IFF the value expression for the service reference is a constant.
static BigdataURI	getServiceURI(IVariableOrConstant<?> serviceRef, IBindingSet bset) Return the effective service URI.
static IBindingSet[]	resolve(AbstractTripleStore db, org.openrdf.query.BindingSet[] serviceResults) Batch resolve BigdataValues to IVs.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceCallUtility

public ServiceCallUtility()

Method Detail

getConstantServiceURI

public static BigdataURI getConstantServiceURI(IVariableOrConstant<?> serviceRef)

Return the effective service URI IFF the value expression for the service reference is a constant.

Returns:

The effective service URI IFF it is a constant and otherwise null.

Throws:

RuntimeException - if the service reference is a constant but does not evaluate to a URI.

NotMaterializedException - if the service reference evaluates to an IV which is not materialized.

getServiceURI

public static BigdataURI getServiceURI(IVariableOrConstant<?> serviceRef,
                       IBindingSet bset)

Return the effective service URI.

Parameters:

bset - A solution which will be used to evaluate the service reference value expression.

Returns:

Throws:

RuntimeException - if the service reference is not bound.

RuntimeException - if the service reference does not evaluate to a URI.

NotMaterializedException - if the service reference evaluates to an IV which is not materialized.

bigdata2Openrdf

public static org.openrdf.query.BindingSet bigdata2Openrdf(LexiconRelation lex,
                                           Set<IVariable<?>> vars,
                                           IBindingSet in)

Convert the IBindingSet into an openrdf BindingSet.

Note: The IVCache MUST be set for non-inline IVs.

Parameters:

vars - The set of variables which are to be projected (optional). When given, only the projected variables are in the returned BindingSet.

in - A bigdata IBindingSet with materialized values.

Throws:

NotMaterializedException - if a non-inline IV has not had its IVCache set.

convert

public static org.openrdf.query.BindingSet[] convert(LexiconRelation lex,
                                     Set<IVariable<?>> projectedVars,
                                     IBindingSet[] in)

Convert IBindingSet[] to openrdf BindingSet[].

Parameters:

projectedVars - When given, variables which are not projected will not be present in the returned solutions (optional).

in - The solutions to be converted (required).

resolve

public static IBindingSet[] resolve(AbstractTripleStore db,
                    org.openrdf.query.BindingSet[] serviceResults)

Batch resolve BigdataValues to IVs. This is necessary in order to have subsequent JOINs succeed when they join on variables which are bound to terms which are in the lexicon.

Note: This will be a distributed operation on a cluster.