org.topbraid.jenax.functions

Class CurrentThreadFunctionRegistry

java.lang.Object

org.apache.jena.sparql.function.FunctionRegistry

org.topbraid.jenax.functions.CurrentThreadFunctionRegistry

public class CurrentThreadFunctionRegistry
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 CurrentThreadFunctions object that was registered before. So a typical block would be:

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

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

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

and (for SPIN) do the same for the SPINThreadPropertyFunctionRegistry.

Author:

Holger Knublauch

Constructor Summary

Constructors

Constructor and Description
CurrentThreadFunctionRegistry(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 CurrentThreadFunctions	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 CurrentThreadFunctions	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(CurrentThreadFunctions 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

CurrentThreadFunctionRegistry

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

Method Detail

register

public static CurrentThreadFunctions 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(CurrentThreadFunctions old)

Unregisters the current Model for the current Thread.

Parameters:

old - the old functions that shall be restored or null

getFunctions

public static CurrentThreadFunctions 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