Package org.dspace.rdf

Class RDFizer

  • public class RDFizer
extends Object
    This class manages the handling of RDF data in DSpace. It generates identifiers, it loads data, it manages the conversion of DSpace Objects into RDF data. It can be used as instantiated object as well as CLI.
    Author:
    Pascal-Nicolas Becker (dspace -at- pascal -hyphen- becker -dot- de)

    • Field Detail

      • stdout

        protected boolean stdout

      • verbose

        protected boolean verbose

      • dryrun

        protected boolean dryrun

      • context

        protected Context context

      • processed

        protected Set<UUID> processed
        Set to remember with DSpaceObject were converted or deleted from the triplestore already. This set is helpful when converting or deleting multiple DSpaceObjects (e.g. Communities with all sub-Communities and Items).

    • Constructor Detail

      • RDFizer

        public RDFizer()

    • Method Detail

      • overrideContext

        protected void overrideContext​(Context context)
        This method allows you to override the context used for conversion and to determine which DSpaceObjects should be deleted from the triplestore, consider well if this is really necessary. If this method is not used the context of an anonymous user will be used.

        Please consider: If your triplestore offers a public sparql endpoint all information readable with the provided context will be exposed to public! If you store your data in a private triplestore that does not provides public access, you might consider to use this method to convert all data stored in your repository.

        Parameters:
        context - The relevant DSpace Context.

      • isStdout

        public boolean isStdout()
        Returns whether all converted data is printed to stdout. Turtle will be used as serialization.
        Returns:
        true if print all generated data is to be printed to stdout

      • setStdout

        public void setStdout​(boolean stdout)
        Set this to true to print all generated data to stdout. The data will be stored as well, unless dryrun is set true. Turtle will be used as serialization.
        Parameters:
        stdout - if true, print all data to standard output

      • isVerbose

        public boolean isVerbose()
        Returns whether verbose information is printed to System.err. Probably this is helpful for CLI only.
        Returns:
        true if verbose mode is on

      • setVerbose

        public void setVerbose​(boolean verbose)
        Set this to true to print verbose information to System.err. Probably this is helpful for CLI only.
        Parameters:
        verbose - print verbose information to stderr

      • isDryrun

        public boolean isDryrun()
        Returns whether this is a dry run. Probably this is helpful for CLI only.
        Returns:
        true if dry-run mode is on

      • setDryrun

        public void setDryrun​(boolean dryrun)
        Set this true to prevent any changes on the triple store. Probably this is helpful for CLI usage only.
        Parameters:
        dryrun - test run without any changes to the triple store

      • deleteAll

        public void deleteAll()
        Deletes all data stored in the triplestore (drops all named graphs and cleans the default graph).

      • delete

        public void delete​(DSpaceObject dso,
                   boolean reset)
            throws SQLException
        Delete the data about the DSpaceObject from the triplestore. All data about descendent Subcommunities, Collections and Items will be deleted as well.
        Parameters:
        dso - DSpace object
        reset - reset processed status (converted or deleted from the triplestore)
        Throws:
        SQLException - An exception that provides information on a database access error or other errors.

      • convertAll

        public void convertAll()
                throws SQLException
        Converts and stores all DSpaceObjects that are readable for an anonymous user.
        Throws:
        SQLException - An exception that provides information on a database access error or other errors.

      • isProcessed

        protected boolean isProcessed​(DSpaceObject dso)

      • markProcessed

        protected void markProcessed​(DSpaceObject dso)

      • report

        protected void report​(String message)

      • runCLI

        protected void runCLI​(String[] args)

      • createOptions

        protected org.apache.commons.cli.Options createOptions()

      • usage

        protected static void usage​(org.apache.commons.cli.Options options)

      • main

        public static void main​(String[] args)