Example5c.java: SPARQL query with TIMEOUT and GRACEFUL TIMEOUT

This example shows the SPARQL query from Example5.java: SPARQL query with JOIN_METHOD with additional features including a timeout setting (TIMEOUT=1, in seconds). You can modify this code by adding a graceful timeout setting (BEST_EFFORT_QUERY=T) in order to avoid getting an error and retrieve all triples found until timeout.

import com.hp.hpl.jena.query.*;
import org.openjena.riot.Lang;
import com.hp.hpl.jena.sparql.core.DatasetImpl;
import oracle.rdf.kv.client.jena.*;

public class Example5c
{
  
  public static void main(String[] args) throws Exception
  {
    
String szStoreName  = args[0];
String szHostName   = args[1];
String szHostPort   = args[2];
   
// create connection
OracleNoSqlConnection conn 
= OracleNoSqlConnection.createInstance(szStoreName,
                                       szHostName, 
                                       szHostPort);

// Create datasetgraph  
OracleGraphNoSql graph = new OracleGraphNoSql(conn);
DatasetGraphNoSql datasetGraph = DatasetGraphNoSql.createFrom(graph);
   
// Close graph, as it is no longer needed
graph.close();
    
// Clear the dataset
datasetGraph.clearRepository();
    
Dataset ds = DatasetImpl.wrap(datasetGraph);
    
// Load data from file into the dataset
DatasetGraphNoSql.load("example.nt", Lang.NQUADS, conn, 
                       "http://example.com");    
   
// Add a hint best_effort_query=t to use a graceful timeout policy   
String szQuery = 
" PREFIX ORACLE_SEM_FS_NS: "                         +
" <http://oracle.com/semtech#timeout=1>"             +
" PREFIX foaf: <http://xmlns.com/foaf/0.1/>"         +
" SELECT ?name1 ?name2 ?homepage2 "                  +
" WHERE { "                                          +
"   graph <http://example.org/alice/foaf.rdf> { "    +
"     ?person1 foaf:knows ?person2 . "               +
"     ?person1 foaf:name ?name1 . "                  +
"     ?person2 foaf:name ?name2 . "                  +
"     ?person2 foaf:homepage ?homepage2 . "          +
"   } "                                              +
" } ";
    
System.out.println("Execute query " + szQuery);
    
Query query = QueryFactory.create(szQuery);
QueryExecution qexec = QueryExecutionFactory.create(query, ds);
    
try {
      ResultSet results = qexec.execSelect();
      ResultSetFormatter.out(System.out, results, query);
    }
    
finally {
      qexec.close();
    }
    
ds.close();
conn.dispose();    
  }
}

The following are the commands to compile and run this example, as well as the expected output of the java command if no graceful timeout is set.

javac -classpath ./:./jena-core-2.7.4.jar:./jena-arq-2.9.4.jar: \
./sdordfnosqlclient.jar:./kvclient.jar:./xercesImpl-2.10.0.jar: \
./slf4j-api-1.6.4.jar: ./slf4j-log4j12-1.6.4.jar:./log4j/1.2.16.jar: \
./jena-iri-0.9.4.jar:./xml-apis-1.4.01.jar Example5c.java

javac -classpath ./:./jena-core-2.7.4.jar:./jena-arq-2.9.4.jar: \
./sdordfnosqlclient.jar:./kvclient.jar:./xercesImpl-2.10.0.jar: \
./slf4j-api-1.6.4.jar:./slf4j-log4j12-1.6.4.jar:./log4j/1.2.16.jar: 
./jena-iri-0.9.4.jar:./xml-apis-1.4.01.jar Example5c <store_name> \
<host_name> <host_port>
Exception in thread "main" com.hp.hpl.jena.shared.JenaException: 
com.hp.hpl.jena.shared.JenaException: Timeout exceeded, user requested to 
end data retrieval

The following represents the expected output of the java command if a graceful timeout is set.

-----------------------------------------------
| name1   | name2 | homepage2                 |
===============================================
| "Alice" | "Bob" | <http://example.org/bob/> |
-----------------------------------------------