Package edu.cornell.mannlib.vitro.webapp.rdfservice.impl.jena

Class RDFServiceJena

    • Field Detail

      • rebuildGraphURICache

        protected volatile boolean rebuildGraphURICache

      • isRebuildGraphURICacheRunning

        protected volatile boolean isRebuildGraphURICacheRunning

      • graphURIs

        protected final List<String> graphURIs

    • Constructor Detail

      • RDFServiceJena

        public RDFServiceJena()

    • Method Detail

      • getDatasetWrapper

        protected abstract DatasetWrapper getDatasetWrapper()

      • changeSetUpdate

        public abstract boolean changeSetUpdate​(ChangeSet changeSet)
                                 throws RDFServiceException
        Description copied from interface: RDFService
        Performs a series of additions to and or removals from specified graphs in the RDF store. preConditionSparql is executed against the union of all the graphs in the knowledge base before any updates are made. If the precondition query returns a non-empty result, no updates are made made.
        Specified by:
        changeSetUpdate in interface RDFService
        Parameters:
        changeSet - - a set of changes to be performed on the RDF store.
        Returns:
        boolean - indicates whether the precondition was satisfied
        Throws:
        RDFServiceException

      • notifyListenersOfPreChangeEvents

        protected void notifyListenersOfPreChangeEvents​(ChangeSet changeSet)

      • applyChangeSetToModel

        protected void applyChangeSetToModel​(ChangeSet changeSet,
                                     org.apache.jena.query.Dataset dataset)

      • notifyListenersOfPostChangeEvents

        protected void notifyListenersOfPostChangeEvents​(ChangeSet changeSet)

      • operateOnModel

        protected void operateOnModel​(org.apache.jena.rdf.model.Model model,
                              ModelChange modelChange)

      • sparqlConstructQuery

        public InputStream sparqlConstructQuery​(String query,
                                        RDFService.ModelSerializationFormat resultFormat)
                                 throws RDFServiceException
        Description copied from interface: RDFService
        Performs a SPARQL construct query against the knowledge base. The query may have an embedded graph identifier. If the query does not contain a graph identifier the query is executed against the union of all named and unnamed graphs in the store.
        Specified by:
        sparqlConstructQuery in interface RDFService
        Parameters:
        query - - the SPARQL query to be executed against the RDF store
        resultFormat - - type of serialization for RDF result of the SPARQL query
        Returns:
        InputStream - the result of the query
        Throws:
        RDFServiceException

      • sparqlConstructQuery

        public void sparqlConstructQuery​(String query,
                                 org.apache.jena.rdf.model.Model model)
                          throws RDFServiceException
        Description copied from interface: RDFService
        Performs a SPARQL construct query against the knowledge base. The query may have an embedded graph identifier. If the query does not contain a graph identifier the query is executed against the union of all named and unnamed graphs in the store.
        Specified by:
        sparqlConstructQuery in interface RDFService
        Parameters:
        query - - the SPARQL query to be executed against the RDF store
        model - - the Model to add the statements to
        Throws:
        RDFServiceException

      • sparqlDescribeQuery

        public InputStream sparqlDescribeQuery​(String query,
                                       RDFService.ModelSerializationFormat resultFormat)
                                throws RDFServiceException
        Description copied from interface: RDFService
        Performs a SPARQL describe query against the knowledge base. The query may have an embedded graph identifier. If the query does not contain a graph identifier the query is executed against the union of all named and unnamed graphs in the store.
        Specified by:
        sparqlDescribeQuery in interface RDFService
        Parameters:
        query - - the SPARQL query to be executed against the RDF store
        resultFormat - - type of serialization for RDF result of the SPARQL query
        Returns:
        InputStream - the result of the query
        Throws:
        RDFServiceException

      • sparqlSelectQuery

        public void sparqlSelectQuery​(String query,
                              ResultSetConsumer consumer)
                       throws RDFServiceException
        Description copied from interface: RDFService
        Performs a SPARQL select query against the knowledge base. The query may have an embedded graph identifier. If the query does not contain a graph identifier the query is executed against the union of all named and unnamed graphs in the store.
        Specified by:
        sparqlSelectQuery in interface RDFService
        Parameters:
        query - - the SPARQL query to be executed against the RDF store
        consumer - - the class to consume the results of the query
        Throws:
        RDFServiceException

      • sparqlAskQuery

        public boolean sparqlAskQuery​(String query)
                       throws RDFServiceException
        Description copied from interface: RDFService
        Performs a SPARQL ASK query against the knowledge base. The query may have an embedded graph identifier. If the query does not contain a graph identifier the query is executed against the union of all named and unnamed graphs in the store.
        Specified by:
        sparqlAskQuery in interface RDFService
        Parameters:
        query - - the SPARQL ASK query to be executed against the RDF store
        Returns:
        boolean - the result of the SPARQL ASK query
        Throws:
        RDFServiceException

      • rebuildGraphUris

        protected void rebuildGraphUris()

      • serializeAll

        public void serializeAll​(OutputStream outputStream)
                  throws RDFServiceException
        Description copied from interface: RDFService
        Serializes the union of all named and unnamed graphs in the store to the supplied OutputStream, in N-Quads format. This method is designed for exporting data from VIVO, so any filters should be bypassed. If possible, this should be done without buffering in memory, so arbitrarily large graphs can be exported.
        Specified by:
        serializeAll in interface RDFService
        Parameters:
        outputStream - - receives the serialized result.
        Throws:
        RDFServiceException

      • serializeGraph

        public void serializeGraph​(String graphURI,
                           OutputStream outputStream)
                    throws RDFServiceException
        Description copied from interface: RDFService
        Serializes the contents of the named graph to the supplied OutputStream, in N-Triples format. This method is designed for exporting data from VIVO, so any filters should be bypassed. If possible, this should be done without buffering in memory, so arbitrarily large graphs can be exported.
        Specified by:
        serializeGraph in interface RDFService
        Parameters:
        graphURI - - the URI of the desired graph. May not be null.
        outputStream - - receives the serialized result.
        Throws:
        RDFServiceException

      • isEquivalentGraph

        public boolean isEquivalentGraph​(String graphURI,
                                 InputStream serializedGraph,
                                 RDFService.ModelSerializationFormat serializationFormat)
                          throws RDFServiceException
        The basic version. Parse the model from the file, read the model from the tripleStore, and ask whether they are isomorphic.
        Specified by:
        isEquivalentGraph in interface RDFService
        Parameters:
        graphURI - - the URI of the graph to test against. May not be null.
        serializedGraph - - the contents to be compared with the existing graph. May not be null.
        serializationFormat - - May not be null.
        Throws:
        RDFServiceException

      • isEquivalentGraph

        public boolean isEquivalentGraph​(String graphURI,
                                 org.apache.jena.rdf.model.Model graph)
                          throws RDFServiceException
        The basic version. Parse the model from the file, read the model from the tripleStore, and ask whether they are isomorphic.
        Specified by:
        isEquivalentGraph in interface RDFService
        Parameters:
        graphURI - - the URI of the graph to test against. May not be null.
        graph - - the contents to be compared with the existing graph. May not be null.
        Throws:
        RDFServiceException

      • close

        public void close()
        Description copied from interface: RDFService
        Frees any resources held by this RDFService object The implementation of this method should be idempotent so that multiple invocations do not cause an error.
        Specified by:
        close in interface RDFService

      • createQueryExecution

        protected org.apache.jena.query.QueryExecution createQueryExecution​(String queryString,
                                                                    org.apache.jena.query.Query q,
                                                                    org.apache.jena.query.Dataset d)