Example5c.java: TIMEOUTとGRACEFUL TIMEOUTを使用するSPARQL問合せ

ここでは、「Example5.java: JOIN_METHODを使用するSPARQL問合せ」と同じSPARQL問合せに、タイムアウト設定(TIMEOUT=1、秒単位)などの機能を追加した例を示します。正常なタイムアウト設定(BEST_EFFORT_QUERY=T)を追加してこのコードを変更すれば、エラーの発生を回避し、タイムアウトまでに見つかったすべてのトリプルを取得できます。

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();    
  }
}

この例をコンパイルして実行するコマンドと、正常なタイムアウトが設定されていない場合に想定される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.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

正常なタイムアウトを設定した場合のJavaコマンドで想定される出力は、次のとおりです。

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