org.apache.marmotta.platform.sparql.services.sparql

Class SparqlServiceImpl

java.lang.Object

org.apache.marmotta.platform.sparql.services.sparql.SparqlServiceImpl

All Implemented Interfaces:

SparqlService

@ApplicationScoped
public class SparqlServiceImpl
extends Object
implements SparqlService

Sparql Service implementation

Author:

Sebastian Schaffert, Sergio Fernández

Constructor Summary

Constructors

Constructor and Description
SparqlServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	ask(org.openrdf.query.QueryLanguage queryLanguage, String query) Evaluate a SPARQL ASK query on the KiWi TripleStore see http://www.w3.org/TR/sparql11-query/
void	createServiceDescription(org.openrdf.rio.RDFWriter writer, String requestURL, boolean isUpdate) Write a SparqlServiceDescription of the Service to the provided RDFWriter.
QueryType	getQueryType(org.openrdf.query.QueryLanguage language, String query) Parse and return the concrete query type
void	initialize()
org.openrdf.query.Query	parseQuery(org.openrdf.query.QueryLanguage language, String query) Parse query
List<Map<String,org.openrdf.model.Value>>	query(org.openrdf.query.QueryLanguage queryLanguage, String query) Evaluate a SPARQL query on the LMF TripleStore.
void	query(org.openrdf.query.QueryLanguage language, String query, OutputStream output, String format, int timeoutInSeconds) Evaluate a SPARQL query on the KiWi TripleStore.
void	query(org.openrdf.query.QueryLanguage queryLanguage, String query, org.openrdf.query.resultio.QueryResultWriter writer, int timeoutInSeconds) Deprecated.
void	query(org.openrdf.query.QueryLanguage queryLanguage, String query, org.openrdf.query.resultio.TupleQueryResultWriter tupleWriter, org.openrdf.query.resultio.BooleanQueryResultWriter booleanWriter, SPARQLGraphResultWriter graphWriter, int timeoutInSeconds) Deprecated.
void	update(org.openrdf.query.QueryLanguage queryLanguage, String query) Execute a SPARQL update on the LMF TripleStore.

Methods inherited from class java.lang.Object

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

Constructor Detail

SparqlServiceImpl

public SparqlServiceImpl()

Method Detail

initialize

@PostConstruct
public void initialize()

parseQuery

public org.openrdf.query.Query parseQuery(org.openrdf.query.QueryLanguage language,
                                 String query)
                                   throws org.openrdf.repository.RepositoryException,
                                          org.openrdf.query.MalformedQueryException

Description copied from interface: SparqlService

Parse query

Specified by:

parseQuery in interface SparqlService

Parameters:

language - language

query - query

Returns:

query parsed

Throws:

org.openrdf.repository.RepositoryException

org.openrdf.query.MalformedQueryException

getQueryType

public QueryType getQueryType(org.openrdf.query.QueryLanguage language,
                     String query)
                       throws org.openrdf.query.MalformedQueryException

Description copied from interface: SparqlService

Parse and return the concrete query type

Specified by:

getQueryType in interface SparqlService

Returns:

Throws:

org.openrdf.query.MalformedQueryException

query

@Deprecated
public void query(org.openrdf.query.QueryLanguage queryLanguage,
                    String query,
                    org.openrdf.query.resultio.TupleQueryResultWriter tupleWriter,
                    org.openrdf.query.resultio.BooleanQueryResultWriter booleanWriter,
                    SPARQLGraphResultWriter graphWriter,
                    int timeoutInSeconds)
           throws org.apache.marmotta.platform.core.exception.MarmottaException,
                  org.openrdf.query.MalformedQueryException,
                  org.openrdf.query.QueryEvaluationException,
                  TimeoutException

Deprecated.

Description copied from interface: SparqlService

Evaluate a SPARQL query, writing the results on the required writer.

Specified by:

query in interface SparqlService

Throws:

org.apache.marmotta.platform.core.exception.MarmottaException

org.openrdf.query.MalformedQueryException

org.openrdf.query.QueryEvaluationException

TimeoutException

query

@Deprecated
public void query(org.openrdf.query.QueryLanguage queryLanguage,
                    String query,
                    org.openrdf.query.resultio.QueryResultWriter writer,
                    int timeoutInSeconds)
           throws org.apache.marmotta.platform.core.exception.MarmottaException,
                  org.openrdf.query.MalformedQueryException,
                  org.openrdf.query.QueryEvaluationException,
                  TimeoutException

Deprecated.

Description copied from interface: SparqlService

Evaluate a SPARQL query, writing the results on the writer.

Specified by:

query in interface SparqlService

Throws:

org.apache.marmotta.platform.core.exception.MarmottaException

org.openrdf.query.MalformedQueryException

org.openrdf.query.QueryEvaluationException

TimeoutException

query

public void query(org.openrdf.query.QueryLanguage language,
         String query,
         OutputStream output,
         String format,
         int timeoutInSeconds)
           throws org.apache.marmotta.platform.core.exception.MarmottaException,
                  TimeoutException,
                  org.openrdf.query.MalformedQueryException

Description copied from interface: SparqlService

Evaluate a SPARQL query on the KiWi TripleStore. Writes the query results to the stream passed in the format requested.

Specified by:

query in interface SparqlService

query - query

output - strem to write

format - mimetype

Throws:

org.apache.marmotta.platform.core.exception.MarmottaException

TimeoutException

org.openrdf.query.MalformedQueryException

query

public List<Map<String,org.openrdf.model.Value>> query(org.openrdf.query.QueryLanguage queryLanguage,
                                              String query)
                                                throws org.apache.marmotta.platform.core.exception.MarmottaException

Evaluate a SPARQL query on the LMF TripleStore. Returns the results as a list of result maps, each element a KiWiNode.

see http://www.w3.org/TR/sparql11-query/

Specified by:

query in interface SparqlService

Parameters:

queryLanguage - the query language to use

query - the SPARQL query to evaluate in SPARQL 1.1 syntax

Throws:

org.apache.marmotta.platform.core.exception.MarmottaException

update

public void update(org.openrdf.query.QueryLanguage queryLanguage,
          String query)
            throws org.apache.marmotta.platform.core.exception.MarmottaException

Execute a SPARQL update on the LMF TripleStore. Throws a KiWiException in case the update execution fails.

see http://www.w3.org/TR/sparql11-update/

Specified by:

update in interface SparqlService

Parameters:

queryLanguage -

query - a string representing the update query in SPARQL Update 1.1 syntax

Throws:

Exception

org.apache.marmotta.platform.core.exception.MarmottaException

ask

public boolean ask(org.openrdf.query.QueryLanguage queryLanguage,
          String query)
            throws org.apache.marmotta.platform.core.exception.MarmottaException

Description copied from interface: SparqlService

Evaluate a SPARQL ASK query on the KiWi TripleStore see http://www.w3.org/TR/sparql11-query/

Specified by:

ask in interface SparqlService

Parameters:

queryLanguage - the query language to use

query - the SPARQL query to evaluate in SPARQL 1.1 syntax

Throws:

org.apache.marmotta.platform.core.exception.MarmottaException - if the query evaluation fails

createServiceDescription

public void createServiceDescription(org.openrdf.rio.RDFWriter writer,
                            String requestURL,
                            boolean isUpdate)
                              throws org.openrdf.rio.RDFHandlerException

Description copied from interface: SparqlService

Write a SparqlServiceDescription of the Service to the provided RDFWriter.

Specified by:

createServiceDescription in interface SparqlService

Parameters:

writer - the RDFWriter to write the description to

requestURL - the URI of the SPARQL Endpoint

isUpdate - if the endpoint is a update or select/query endpoint

Throws:

org.openrdf.rio.RDFHandlerException

See Also:

http://www.w3.org/TR/sparql11-service-description/