org.topbraid.spin.arq

Class SPINThreadFunctionRegistry

java.lang.Object

org.apache.jena.sparql.function.FunctionRegistry

org.topbraid.spin.arq.SPINThreadFunctionRegistry

public class SPINThreadFunctionRegistry
extends org.apache.jena.sparql.function.FunctionRegistry

An ARQ FunctionRegistry that can be used to associate functions with Threads, so that additional functions from a given Model can be made visible depending on the SPARQL query thread.

Note that this concept only works if ARQ has been set to single threading, which is done by the static block below.

The contract of this class is very strict to prevent memory leaks: Users always need to make sure that unregister is called as soon as a query (block) ends, and to restore any old SPINThreadFunctions object that was registered before. So a typical block would be:

Model model = ... a Model with extra SPIN functions SPINThreadFunctions old = SPINThreadFunctionRegistry.register(model); try { // run SPARQL queries here } finally { SPINThreadFunctionRegistry.unregister(old); }

In preparation of the above, the application should start up with code such as

FunctionRegistry oldFR = FunctionRegistry.get(); SPINThreadFunctionRegistry threadFR = new SPINThreadFunctionRegistry(oldFR); FunctionRegistry.set(ARQ.getContext(), threadFR);

and do the same for the SPINThreadPropertyFunctionRegistry.

Author:

Holger Knublauch

Constructor Summary

Constructors

Constructor and Description
SPINThreadFunctionRegistry(org.apache.jena.sparql.function.FunctionRegistry base)

Method Summary

Modifier and Type	Method and Description
org.apache.jena.sparql.function.FunctionFactory	get(String uri)
static SPINThreadFunctions	getFunctions()
boolean	isRegistered(String uri)
Iterator<String>	keys()
void	put(String uri, Class<?> funcClass)
void	put(String uri, org.apache.jena.sparql.function.FunctionFactory f)
static SPINThreadFunctions	register(org.apache.jena.rdf.model.Model model) Registers a set of extra SPIN functions from a given Model for the current Thread.
org.apache.jena.sparql.function.FunctionFactory	remove(String uri)
static void	unregister(SPINThreadFunctions old) Unregisters the current Model for the current Thread.

Methods inherited from class org.apache.jena.sparql.function.FunctionRegistry

get, get, init, set, standardRegistry

Methods inherited from class java.lang.Object

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

Constructor Detail

SPINThreadFunctionRegistry

public SPINThreadFunctionRegistry(org.apache.jena.sparql.function.FunctionRegistry base)

Method Detail

register

public static SPINThreadFunctions register(org.apache.jena.rdf.model.Model model)

Registers a set of extra SPIN functions from a given Model for the current Thread.

Parameters:

model - the Model containing the SPIN functions

Returns:

any old object that was registered for the current Thread, so that the old value can be restored when done.

unregister

public static void unregister(SPINThreadFunctions old)

Unregisters the current Model for the current Thread.

Parameters:

old - the old functions that shall be restored or null

getFunctions

public static SPINThreadFunctions getFunctions()

get

public org.apache.jena.sparql.function.FunctionFactory get(String uri)

Overrides:

get in class org.apache.jena.sparql.function.FunctionRegistry

isRegistered

public boolean isRegistered(String uri)

Overrides:

isRegistered in class org.apache.jena.sparql.function.FunctionRegistry

keys

public Iterator<String> keys()

Overrides:

keys in class org.apache.jena.sparql.function.FunctionRegistry

put

public void put(String uri,
                Class<?> funcClass)

Overrides:

put in class org.apache.jena.sparql.function.FunctionRegistry

put

public void put(String uri,
                org.apache.jena.sparql.function.FunctionFactory f)

Overrides:

put in class org.apache.jena.sparql.function.FunctionRegistry

remove

public org.apache.jena.sparql.function.FunctionFactory remove(String uri)

Overrides:

remove in class org.apache.jena.sparql.function.FunctionRegistry