2. RDFox Features and Requirements¶
2.1. RDFox Features¶
RDFox provides the following main functionality:
RDFox can import RDF triples, rules, and OWL 2 and SWRL axioms either programmatically or from files of certain formats (see Section 3 for a quick introduction). Additionally, RDFox can access information from external data sources, such as csv files, relational databases, or Apache Solr (see Section 6).
Triples, rules and axioms can be exported into a number of different formats. Furthermore, the contents of the system can be incrementally saved into a binary file, which can later be loaded to restore the system’s state.
RDFox supports ACID transactional updates (see Section 7 for further details on transactions).
Individual information elements in the system can be assigned different access permissions for different users (see Section 9 for further details on access control).
RDFox can answer SPARQL 1.1 queries (see Section 4) and provides functionality for monitoring query answering and accessing query plans.
RDFox supports materialization-based reasoning, where all triples that logically follow from the facts and rules in the system are materialized as new triples (see Section 5) . Materializations can be incrementally updated, which means that reasoning does not need to be performed from scratch once the information in the system is updated. Furthermore, the results of reasoning can be explained, which means that RDFox is able to return proofs for any new fact added to the store through materialization.
2.2. Software Archive¶
RDFox is distributed as an archive containing the following files and directories:
RDFox.exe(Windows): a stand-alone executable that can be used to run RDFox on the command line.
lib: a directory containing the following libraries:
JRDFox.jar: the Java bridge to the native RDFox engine.
libRDFox.dll(Windows): a dynamic library that implements the native methods of JRDFox.
examples: a directory containing demonstration programs that show how to call RDFox as a library from Java. The
examples/Java/build.xmlApache Ant script can be used to compile and run the Java demonstration program.
Users and developers can interact with RDFox through the following interfaces:
RDFox comes with a built-in shell that can be used to interact with and control the local RDFox server. The shell can be accessed by running the RDFox executable in
sandboxmodes as described in Section 10.
- RESTful API
When RDFox’s endpoint is running, clients can interact with the associated RDFox server via the RESTful API documented in Section 8. The endpoint can be started by running the RDFox executable in
daemonmode or by invoking the
endpointcommand from the RDFox shell as described in Section 10.
- Java API
RDFox can be embedded into Java applications and called via the Java API described in Section 8 and Section 14. To use JRDFox in your project, simply add
JRDFox.jarto your classpath, and make sure that the path to the dynamic library is correctly specified when starting your program using the following JVM option:
-Djava.library.path=<path to the dynamic library>
- GUI (EXPERIMENTAL)
As well as serving the REST API, RDFox’s endpoint serves the RDFox Console, an experimental graphical browser application supporting basic querying and visualization of data store content. When the endpoint is running, the Console can be loaded by visiting
<port>are the host name and port number at which the endpoint can be reached.
2.4. System Requirements¶
2.4.1. Operating Systems¶
RDFox supports the following operating system versions:
Windows 8 or higher
macOS 10.14 or higher
Centos 7 or higher
Ubuntu 16.04 or higher
Fedora 27 or higher
Additionally, RDFox can be run using Docker. See Section 11 for details.
RDFox is a main-memory data store and as such its performance is heavily dependent on access to a suitable amount of RAM. Oxford Semantic Technologies recommends that users ensure that RDFox has unpaged access to between 60 and 110 bytes of RAM per triple that their store will contain. This includes both explicitly imported triples and those materialized via reasoning.
2.4.3. License Key¶
Creating an RDFox Server requires a time-limited license key issued by Oxford Semantic Technologies. At server creation time, RDFox will search the following locations, in the order shown, for the license key:
the value of the
license-contentserver parameter, if set
[RDFox executable only] the value of the
RDFOX_LICENSE_CONTENTenvironment variable, if set
the content of the file specified via
license-fileserver parameter, if set
[RDFox executable only] the content of the file specified via the
RDFOX_LICENSE_FILEenvironment variable, if set
[RDFox executable only] the content of the file
RDFox.licin the directory containing the running executable, if the file exists
the content of the file
RDFox.licin the configured server directory, if the file exists
If a candidate key is found in one location, the remaining locations will not be checked even if the candidate turns out to be invalid or expired.
See Section 10.1 for details of how to specify server parameters when starting the RDFox executable. When using JRDFox, server
parameters must be specified via
tech.oxfordsemantic.jrdfox.client.ConnectionFactory.startLocalServer(...). For example:
Map<String, String> serverParams = new HashMap<>(); serverParams.put("license-file", "/home/user/rdfox.lic"); ConnectionFactory.startLocalServer(serverParams);