The following steps describe how to deploy the prebundled joseki.war into Apache Tomcat or Oracle WebLogic Server.

This section describes how to deploy the SPARQL Service endpoint using Apache Tomcat 7.0. Apache Tomcat is an open source web server implementing Java Servlet and JavaServer Pages (JSP) and providing an HTTP web server environment to run Web applications. Further information and support on Apache Tomcat can be found in http://tomcat.apache.org/.

You should see a page titled Oracle NoSQL Database SPARQL Endpoint Query Results. There may or may not be any results, depending on the underlying semantic model against which the query is executed.

This section describes how to deploy the SPARQL Service endpoint using Oracle WebLogic Server 12c. For information about Oracle WebLogic Server please refer to http://www.oracle.com/technology/products/weblogic/.

By default, the joseki-config.ttl file contains an oracle-nosql:Dataset definition using all graphs stored in the Oracle NoSQL Database. The following snippet shows the configuration.

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 3;  ## Number of concurrent connections allowed 
                    ## to this dataset.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
oracle-nosql:storeName "mystore";
oracle-nosql:hostPort "5000";
];
oracle-nosql:allGraphs [] .       ## Graph descriptions

The oracle-nosql:allGraphs predicate denotes that the SPARQL Service endpoint will serve queries using all named graphs (including the default graph) stored in an Oracle NoSQL Database. You can also specify the rulebase(s) to use when serving queries. In the following example, the oracle:ruleBaseID predicate denotes that the SPARQL Service endpoint should serve queries using all named graphs (including asserted and inferred triples marked with the rulebase ID 1.

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 3;  ## Number of concurrent connections allowed
                    ## to this dataset.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
oracle-nosql:storeName "mystore";
oracle-nosql:hostPort "5000";
];
oracle-nosql:allGraphs [ oracle-nosql:ruleBaseID "1" .  ] . 
## Graph descriptions

If you require the SPARQL Service endpoint to serve queries using only a specified set of graph names, then use the oracle-nosql:namedGraph predicate instead of oracle-nosql:allGraphs. Further details can be found in Configuring the SPARQL Service: Oracle NoSQL Database.

You can add a few example triples and quads to test the named graph functions using the following Java code snippet:

public static void main(String[] args) throws Exception
{
String szStoreName  = args[0];
String szHostName   = args[1];
String szHostPort   = args[2];
    
System.out.println("Create Oracle NoSQL connection");
OracleNoSqlConnection conn  =         
OracleNoSqlConnection.createInstance(szStoreName,
                                     szHostName,   
                                     szHostPort);   
System.out.println("Create Oracle NoSQL graph and dataset ");
OracleGraphNoSql graph = new OracleGraphNoSql(conn);
DatasetGraphNoSql datasetGraph = DatasetGraphNoSql.createFrom(graph);

// Close graph, as it is no longer needed
graph.close();  

// add data to the bob named graph
datasetGraph.add(new Quad(
        Node.createURI("http://example.org/bob"), // graph name
        Node.createURI("urn:bob"),
        Node.createURI("http://xmlns.com/foaf/0.1/name"),
        Node.createLiteral("Bob")));
    
// add data to the alice named graph
datasetGraph.add(new Quad(
        Node.createURI("http://example.org/alice"), // graph name
        Node.createURI("urn:alice"),
        Node.createURI("http://xmlns.com/foaf/0.1/name"),
        Node.createLiteral("Alice")));
ds.close();
conn.dispose();   
}

After inserting the quads, go to http://<hostname>:7001/joseki (Oracle WebLogic Server) or http://<hostname>:8080/joseki (Apache Tomcat), type the following SPARQL query, and click Submit Query:

SELECT ?g ?s ?p ?o
WHERE 
{ GRAPH ?g 
   { ?s ?p ?o} 
}

The result should be an HTML table with four columns and two sets of result bindings.

This page also contains a JSON Output option. If this option is selected (enabled), the SPARQL query response is converted to JSON format.

To configure the connections to the Oracle NoSQL Database, you must modify Apache Jena Joseki's configuration file (joseki-config.ttl) file located in /tmp/joseki.war to include the store name, host name, and host port to access the Oracle NoSQL Database. This data is used by the SPARQL Service endpoint to establish connections to the Oracle NoSQL Database and execute update and query operations.

To define this data, refer to the oracle-nosql:connection predicate in the joseki-config.ttl. This predicate denotes that the SPARQL service endpoint will connect to an Oracle NoSQL Database named <store_name> accessible through the host name <host_name> and port <host_port>. The following snippet shows the configuration.

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 1;  ## Number of concurrent connections allowed to 
                    ## this data set.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName <host_name>;
oracle-nosql:storeName <store_name>;
oracle-nosql:hostPort <host_port>;
];
...

By default, the SPARQL Service endpoint assumes that queries are going to be executed against all named graphs (including the default graph) stored in the specified Oracle NoSQL database. Users can configure these settings to serve queries using only the default graph or a subset of named graphs by editing the joseki-config.ttl configuration file, which is in <domain_name>/autodeploy/joseki.war.

The supplied joseki-config.ttl file includes a section similar to the following for the Oracle NoSQL Database data set:

#
## Datasets
#
[] ja:loadClass 
"oracle.spatial.rdf.client.jena.assembler.OracleAssemblerVocab" . 

oracle-nosql:Dataset rdfs:subClassOf ja:RDFDataset . 
      
<#oracle> rdf:type oracle-nosql:Dataset;
## Number of concurrent connections allowed to this dataset.
joseki:poolSize 1;  
	
oracle-nosql:connection  ## connection to an Oracle NoSQL Database
 	[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
  		oracle-nosql:storeName "mystore";
       oracle-nosql:hostPort "5000";
];

oracle-nosql:allGraphs [] .

In this section of the file, you can: