Class SPARQLResultsODSWriter

java.lang.Object

org.eclipse.rdf4j.query.resultio.sparqlods.SPARQLResultsODSWriter

All Implemented Interfaces:

QueryResultHandler, QueryResultWriter, TupleQueryResultWriter, TupleQueryResultHandler

public class SPARQLResultsODSWriter
extends Object
implements TupleQueryResultWriter

Render a SPARQL result set into an ODF spreadsheet file (.ods) by manually generating the XML content and ZIP structure. NOTE: This implementation manually creates XML and does not use any ODF library. It is more complex and potentially less robust than using a dedicated library. Auto-sizing columns is not implemented as it's typically handled by the viewing application.

Author:

Adapted from SPARQLResultsXLSXWriter by Jerven Bolleman

Constructor Summary

Constructors

Constructor	Description
SPARQLResultsODSWriter(OutputStream out)

Method Summary

Modifier and Type	Method	Description
void	endHeader()	Indicates the end of the header.
void	endQueryResult()	Indicates the end of a sequence of solutions.
QueryResultFormat	getQueryResultFormat()	Gets the query result format that this writer uses.
Collection<RioSetting<?>>	getSupportedSettings()
TupleQueryResultFormat	getTupleQueryResultFormat()	Gets the query result format that this writer uses.
WriterConfig	getWriterConfig()	Retrieves the current writer configuration as a single object.
void	handleBoolean(boolean value)	Handles the specified boolean value.
void	handleLinks(List<String> linkUrls)	Handles the links elements which are present in SPARQL Results JSON and SPARQL Results XML documents in the header.
void	handleNamespace(String prefix, String uri)	Handles a namespace prefix declaration.
void	handleSolution(BindingSet bindingSet)	Handles a solution.
void	handleStylesheet(String stylesheetUrl)	Handles a stylesheet URL.
void	setWriterConfig(WriterConfig config)	Sets all supplied writer configuration options.
void	startDocument()	Indicates the start of the document.
void	startHeader()	Indicates the start of the header.
void	startQueryResult(List<String> bindingNames)	Indicates the start of a sequence of Solutions.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SPARQLResultsODSWriter

public SPARQLResultsODSWriter(OutputStream out)

Method Details

startDocument

public void startDocument()
                   throws QueryResultHandlerException

Description copied from interface: QueryResultWriter

Indicates the start of the document.

Specified by:

startDocument in interface QueryResultWriter

Throws:

QueryResultHandlerException - If there was an error starting the writing of the results.

handleNamespace

public void handleNamespace(String prefix,
 String uri)
                     throws QueryResultHandlerException

Description copied from interface: QueryResultWriter

Handles a namespace prefix declaration. If this is called, it should be called before QueryResultWriter.startDocument() to ensure that it has a document wide effect.

NOTE: If the format does not support namespaces, it must silently ignore calls to this method.

Specified by:

handleNamespace in interface QueryResultWriter

Parameters:

prefix - The prefix to use for the namespace

uri - The full URI that is to be represented by the prefix.

Throws:

QueryResultHandlerException

startQueryResult

public void startQueryResult(List<String> bindingNames)
                      throws TupleQueryResultHandlerException

Description copied from interface: QueryResultHandler

Indicates the start of a sequence of Solutions. The supplied bindingNames are an indication of the values that are in the Solutions. For example, a SPARQL query like select ?X ?Y where { ?X ?P ?Y } will have binding names X and Y.

Specified by:

startQueryResult in interface QueryResultHandler

Parameters:

bindingNames - An ordered set of binding names.

Throws:

TupleQueryResultHandlerException - If there was an error during the starting of the query result handler. This exception may be thrown if the QueryResultHandler.handleBoolean(boolean) method was called before this method and the handler cannot process both boolean and tuple results simultaneously.

handleSolution

public void handleSolution(BindingSet bindingSet)
                    throws TupleQueryResultHandlerException

Description copied from interface: QueryResultHandler

Handles a solution.

Specified by:

handleSolution in interface QueryResultHandler

Parameters:

bindingSet - A single set of tuple results, with binding names bound to values. Each of the binding names in the solution must have previously been registered with the QueryResultHandler.startQueryResult(List) method.

Throws:

TupleQueryResultHandlerException - If there was an error during the handling of the query solution. This exception may be thrown if the QueryResultHandler.handleBoolean(boolean) method was called before this method and the handler cannot process both boolean and tuple results simultaneously.

endQueryResult

public void endQueryResult()
                    throws TupleQueryResultHandlerException

Description copied from interface: QueryResultHandler

Indicates the end of a sequence of solutions.

Specified by:

endQueryResult in interface QueryResultHandler

Throws:

TupleQueryResultHandlerException - If there was an error during the ending of the query result handler. This exception may be thrown if the QueryResultHandler.handleBoolean(boolean) method was called before this method and the handler cannot process both boolean and tuple results simultaneously.

handleBoolean

public void handleBoolean(boolean value)
                   throws QueryResultHandlerException

Description copied from interface: QueryResultHandler

Handles the specified boolean value.

Specified by:

handleBoolean in interface QueryResultHandler

Parameters:

value - The boolean value to handle.

Throws:

QueryResultHandlerException - If there was an error during the handling of this value. This exception may be thrown if the QueryResultHandler.startQueryResult(List), QueryResultHandler.handleSolution(BindingSet) or QueryResultHandler.endQueryResult() methods were called before this method was called, and the handler cannot process both boolean and tuple results simultaneously.

handleLinks

public void handleLinks(List<String> linkUrls)
                 throws QueryResultHandlerException

Description copied from interface: QueryResultHandler

Handles the links elements which are present in SPARQL Results JSON and SPARQL Results XML documents in the header.

NOTE: If the format does not support links, it must silently ignore a call to this method.

An accumulating handler should accumulate these links.

Specified by:

handleLinks in interface QueryResultHandler

Parameters:

linkUrls - The URLs of the links to handle.

Throws:

QueryResultHandlerException - If there was an error handling the set of link URLs. This error is not thrown in cases where links are not supported.

See Also:

• "link"

getQueryResultFormat

public QueryResultFormat getQueryResultFormat()

Description copied from interface: QueryResultWriter

Gets the query result format that this writer uses.

Specified by:

getQueryResultFormat in interface QueryResultWriter

getTupleQueryResultFormat

public TupleQueryResultFormat getTupleQueryResultFormat()

Description copied from interface: TupleQueryResultWriter

Gets the query result format that this writer uses.

Specified by:

getTupleQueryResultFormat in interface TupleQueryResultWriter

setWriterConfig

public void setWriterConfig(WriterConfig config)

Description copied from interface: QueryResultWriter

Sets all supplied writer configuration options.

Specified by:

setWriterConfig in interface QueryResultWriter

Parameters:

config - a writer configuration object.

getWriterConfig

public WriterConfig getWriterConfig()

Description copied from interface: QueryResultWriter

Retrieves the current writer configuration as a single object.

Specified by:

getWriterConfig in interface QueryResultWriter

Returns:

a writer configuration object representing the current configuration of the writer.

getSupportedSettings

public Collection<RioSetting<?>> getSupportedSettings()

Specified by:

getSupportedSettings in interface QueryResultWriter

Returns:

A collection of RioSettings that are supported by this QueryResultWriter.

handleStylesheet

public void handleStylesheet(String stylesheetUrl)
                      throws QueryResultHandlerException

Description copied from interface: QueryResultWriter

Handles a stylesheet URL. If this is called, it must be called after QueryResultWriter.startDocument() and before QueryResultWriter.startHeader().

NOTE: If the format does not support stylesheets, it must silently ignore calls to this method.

Specified by:

handleStylesheet in interface QueryResultWriter

Parameters:

stylesheetUrl - The URL of the stylesheet to be used to style the results.

Throws:

QueryResultHandlerException - If there was an error handling the stylesheet. This error is not thrown in cases where stylesheets are not supported.

startHeader

public void startHeader()
                 throws QueryResultHandlerException

Description copied from interface: QueryResultWriter

Indicates the start of the header.

Specified by:

startHeader in interface QueryResultWriter

Throws:

QueryResultHandlerException - If there was an error writing the start of the header.

See Also:

• SPARQL Query Results XML Format documentation for head element.

endHeader

public void endHeader()
               throws QueryResultHandlerException

Description copied from interface: QueryResultWriter

Indicates the end of the header. This must be called after QueryResultWriter.startHeader() and before any calls to QueryResultHandler.handleSolution(BindingSet).

Specified by:

endHeader in interface QueryResultWriter

Throws:

QueryResultHandlerException - If there was an error writing the end of the header.