Class Rio


  • public class Rio
    extends java.lang.Object
    Static methods for parsing and writing RDF for all available syntaxes.

    It includes methods for searching for RDFFormats based on MIME types and file extensions, creating RDFParsers and RDFWriters, and directly parsing and writing.

    • Constructor Summary

      Constructors 
      Constructor Description
      Rio()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static RDFParser createParser​(RDFFormat format)
      Convenience methods for creating RDFParser objects.This method uses the registry returned by RDFParserRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate parser.
      static RDFParser createParser​(RDFFormat format, ValueFactory valueFactory)
      Convenience methods for creating RDFParser objects that use the specified ValueFactory to create RDF model objects.
      static RDFWriter createWriter​(RDFFormat format, java.io.OutputStream out)
      Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
      static RDFWriter createWriter​(RDFFormat format, java.io.OutputStream out, java.lang.String baseURI)
      Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
      static RDFWriter createWriter​(RDFFormat format, java.io.Writer writer)
      Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
      static RDFWriter createWriter​(RDFFormat format, java.io.Writer writer, java.lang.String baseURI)
      Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
      static java.util.Optional<RDFFormat> getParserFormatForFileName​(java.lang.String fileName)
      Tries to match the extension of a file name against the list of RDF formats that can be parsed.
      static java.util.Optional<RDFFormat> getParserFormatForMIMEType​(java.lang.String mimeType)
      Tries to match a MIME type against the list of RDF formats that can be parsed.
      static java.util.Optional<RDFFormat> getWriterFormatForFileName​(java.lang.String fileName)
      Tries to match the extension of a file name against the list of RDF formats that can be written.
      static java.util.Optional<RDFFormat> getWriterFormatForMIMEType​(java.lang.String mimeType)
      Tries to match a MIME type against the list of RDF formats that can be written.
      static void main​(java.lang.String[] args)  
      static Model parse​(java.io.InputStream in, java.lang.String baseURI, RDFFormat dataFormat, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.InputStream in, java.lang.String baseURI, RDFFormat dataFormat, ParserConfig settings, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.InputStream in, java.lang.String baseURI, RDFFormat dataFormat, ParserConfig settings, ValueFactory valueFactory, ParseErrorListener errors, ModelFactory modelFactory, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.InputStream in, java.lang.String baseURI, RDFFormat dataFormat, ParserConfig settings, ValueFactory valueFactory, ParseErrorListener errors, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.InputStream in, RDFFormat dataFormat, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.InputStream in, RDFFormat dataFormat, ParserConfig settings, Resource... contexts)
      Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.Reader reader, java.lang.String baseURI, RDFFormat dataFormat, Resource... contexts)
      Adds RDF data from a Reader to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.Reader reader, java.lang.String baseURI, RDFFormat dataFormat, ParserConfig settings, ValueFactory valueFactory, ParseErrorListener errors, ModelFactory modelFactory, Resource... contexts)
      Adds RDF data from a Reader to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.Reader reader, java.lang.String baseURI, RDFFormat dataFormat, ParserConfig settings, ValueFactory valueFactory, ParseErrorListener errors, Resource... contexts)
      Adds RDF data from a Reader to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.Reader reader, RDFFormat dataFormat, Resource... contexts)
      Adds RDF data from a Reader to a Model, optionally to one or more named contexts.
      static Model parse​(java.io.Reader reader, RDFFormat dataFormat, ParserConfig settings, Resource... contexts)
      Adds RDF data from a Reader to a Model, optionally to one or more named contexts.
      static java.util.function.Supplier<UnsupportedRDFormatException> unsupportedFormat​(java.lang.String unsupportedFormat)
      Helper method to use to create a lambda for Optional.orElseThrow(Supplier) to indicate a format is unsupported.
      static java.util.function.Supplier<UnsupportedRDFormatException> unsupportedFormat​(RDFFormat unsupportedFormat)
      Helper method to use to create a lambda for Optional.orElseThrow(Supplier) to indicate a format is unsupported.
      static void write​(java.lang.Iterable<Statement> model, java.io.OutputStream output, java.lang.String baseURI, RDFFormat dataFormat)
      Writes the given statements to the given OutputStream in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.OutputStream output, java.lang.String baseURI, RDFFormat dataFormat, WriterConfig settings)
      Writes the given statements to the given OutputStream in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.OutputStream output, RDFFormat dataFormat)
      Writes the given statements to the given OutputStream in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.OutputStream output, RDFFormat dataFormat, WriterConfig settings)
      Writes the given statements to the given OutputStream in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.Writer output, java.lang.String baseURI, RDFFormat dataFormat)
      Writes the given statements to the given Writer in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.Writer output, java.lang.String baseURI, RDFFormat dataFormat, WriterConfig settings)
      Writes the given statements to the given Writer in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.Writer output, RDFFormat dataFormat)
      Writes the given statements to the given Writer in the given format.
      static void write​(java.lang.Iterable<Statement> model, java.io.Writer output, RDFFormat dataFormat, WriterConfig settings)
      Writes the given statements to the given Writer in the given format.
      static void write​(java.lang.Iterable<Statement> model, RDFHandler writer)
      Writes the given statements to the given RDFHandler.
      static void write​(Statement st, java.io.OutputStream output, RDFFormat dataFormat)
      Writes the given statement to the given OutputStream in the given format.
      static void write​(Statement st, java.io.OutputStream output, RDFFormat dataFormat, WriterConfig settings)
      Writes the given single statement to the given OutputStream in the given format.
      static void write​(Statement statement, java.io.Writer output, RDFFormat dataFormat)
      Writes the given single statement to the given Writer in the given format.
      static void write​(Statement statement, java.io.Writer output, RDFFormat dataFormat, WriterConfig settings)
      Writes the given single statement to the given Writer in the given format.
      static void write​(Statement statement, RDFHandler writer)
      Writes the given single statement to the given RDFHandler.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Rio

        public Rio()
    • Method Detail

      • getParserFormatForMIMEType

        public static java.util.Optional<RDFFormat> getParserFormatForMIMEType​(java.lang.String mimeType)
        Tries to match a MIME type against the list of RDF formats that can be parsed.
        Parameters:
        mimeType - A MIME type, e.g. "application/rdf+xml".
        Returns:
        An RDFFormat object if a match was found, or Optional.empty() otherwise.
      • getParserFormatForFileName

        public static java.util.Optional<RDFFormat> getParserFormatForFileName​(java.lang.String fileName)
        Tries to match the extension of a file name against the list of RDF formats that can be parsed.
        Parameters:
        fileName - A file name.
        Returns:
        An RDFFormat object if a match was found, or Optional.empty() otherwise.
      • getWriterFormatForMIMEType

        public static java.util.Optional<RDFFormat> getWriterFormatForMIMEType​(java.lang.String mimeType)
        Tries to match a MIME type against the list of RDF formats that can be written.
        Parameters:
        mimeType - A MIME type, e.g. "application/rdf+xml".
        Returns:
        An RDFFormat object if a match was found, or Optional.empty() otherwise.
      • getWriterFormatForFileName

        public static java.util.Optional<RDFFormat> getWriterFormatForFileName​(java.lang.String fileName)
        Tries to match the extension of a file name against the list of RDF formats that can be written.
        Parameters:
        fileName - A file name.
        Returns:
        An RDFFormat object if a match was found, or Optional.empty() otherwise.
      • createWriter

        public static RDFWriter createWriter​(RDFFormat format,
                                             java.io.OutputStream out,
                                             java.lang.String baseURI)
                                      throws UnsupportedRDFormatException,
                                             java.net.URISyntaxException
        Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
        Parameters:
        format -
        out -
        baseURI -
        Returns:
        RDF Writer
        Throws:
        UnsupportedRDFormatException - If no writer is available for the specified RDF format.
        java.net.URISyntaxException - If the baseURI is invalid
      • createWriter

        public static RDFWriter createWriter​(RDFFormat format,
                                             java.io.Writer writer,
                                             java.lang.String baseURI)
                                      throws UnsupportedRDFormatException,
                                             java.net.URISyntaxException
        Convenience methods for creating RDFWriter objects.This method uses the registry returned by RDFWriterRegistry.getInstance() to get a factory for the specified format and uses this factory to create the appropriate writer.
        Parameters:
        format -
        writer -
        baseURI -
        Returns:
        RDF Writer
        Throws:
        UnsupportedRDFormatException - If no writer is available for the specified RDF format.
        java.net.URISyntaxException - If the baseURI is invalid
      • parse

        public static Model parse​(java.io.InputStream in,
                                  RDFFormat dataFormat,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        dataFormat - The serialization format of the data.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
        Since:
        3.5.0
      • parse

        public static Model parse​(java.io.InputStream in,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
        Since:
        4.0.0
      • parse

        public static Model parse​(java.io.InputStream in,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • parse

        public static Model parse​(java.io.InputStream in,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
        Since:
        4.0.0
      • parse

        public static Model parse​(java.io.InputStream in,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  ValueFactory valueFactory,
                                  ParseErrorListener errors,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        valueFactory - The ValueFactory used by the parser to create statements.
        errors - The ParseErrorListener used by the parser to signal errors, including errors that do not generate an RDFParseException.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • parse

        public static Model parse​(java.io.InputStream in,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  ValueFactory valueFactory,
                                  ParseErrorListener errors,
                                  ModelFactory modelFactory,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from an InputStream to a Model, optionally to one or more named contexts.
        Parameters:
        in - An InputStream from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        valueFactory - The ValueFactory used by the parser to create statements.
        errors - The ParseErrorListener used by the parser to signal errors, including errors that do not generate an RDFParseException.
        modelFactory - the ModelFactory used to instantiate the model that gets returned.
        contexts - The contexts to add the data to. If one or more contexts are supplied the method ignores contextual information in the actual data. If no contexts are supplied the contextual information in the input stream is used, if no context information is available the data is added without any context.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the input stream.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • parse

        public static Model parse​(java.io.Reader reader,
                                  RDFFormat dataFormat,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from a Reader to a Model, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.
        Parameters:
        reader - A Reader from which RDF data can be read.
        dataFormat - The serialization format of the data.
        contexts - The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the reader.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
        Since:
        3.5.0
      • parse

        public static Model parse​(java.io.Reader reader,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from a Reader to a Model, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.
        Parameters:
        reader - A Reader from which RDF data can be read.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        contexts - The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the reader.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
        Since:
        4.0.0
      • parse

        public static Model parse​(java.io.Reader reader,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from a Reader to a Model, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.
        Parameters:
        reader - A Reader from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        contexts - The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the reader.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • parse

        public static Model parse​(java.io.Reader reader,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  ValueFactory valueFactory,
                                  ParseErrorListener errors,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from a Reader to a Model, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.
        Parameters:
        reader - A Reader from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        valueFactory - The ValueFactory used by the parser to create statements.
        errors - The ParseErrorListener used by the parser to signal errors, including errors that do not generate an RDFParseException.
        contexts - The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the reader.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • parse

        public static Model parse​(java.io.Reader reader,
                                  java.lang.String baseURI,
                                  RDFFormat dataFormat,
                                  ParserConfig settings,
                                  ValueFactory valueFactory,
                                  ParseErrorListener errors,
                                  ModelFactory modelFactory,
                                  Resource... contexts)
                           throws java.io.IOException,
                                  RDFParseException,
                                  UnsupportedRDFormatException
        Adds RDF data from a Reader to a Model, optionally to one or more named contexts. Note: using a Reader to upload byte-based data means that you have to be careful not to destroy the data's character encoding by enforcing a default character encoding upon the bytes. If possible, adding such data using an InputStream is to be preferred.
        Parameters:
        reader - A Reader from which RDF data can be read.
        baseURI - The base URI to resolve any relative URIs that are in the data against. May be null.
        dataFormat - The serialization format of the data.
        settings - The ParserConfig containing settings for configuring the parser.
        valueFactory - The ValueFactory used by the parser to create statements.
        errors - The ParseErrorListener used by the parser to signal errors, including errors that do not generate an RDFParseException.
        modelFactory - the ModelFactory used to instantiate the model that gets returned.
        contexts - The contexts to add the data to. If one or more contexts are specified the data is added to these contexts, ignoring any context information in the data itself.
        Returns:
        A Model containing the parsed statements.
        Throws:
        java.io.IOException - If an I/O error occurred while reading from the reader.
        UnsupportedRDFormatException - If no RDFParser is available for the specified RDF format.
        RDFParseException - If an error was found while parsing the RDF data.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.OutputStream output,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException
        Writes the given statements to the given OutputStream in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The OutputStream to write the statements to.
        dataFormat - The RDFFormat to use when writing the statements.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.OutputStream output,
                                 java.lang.String baseURI,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException,
                                 UnsupportedRDFormatException,
                                 java.net.URISyntaxException
        Writes the given statements to the given OutputStream in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The OutputStream to write the statements to.
        baseURI - The base URI to relativize IRIs against.
        dataFormat - The RDFFormat to use when writing the statements.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        java.net.URISyntaxException - If the baseURI is invalid
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.Writer output,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException
        Writes the given statements to the given Writer in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The Writer to write the statements to.
        dataFormat - The RDFFormat to use when writing the statements.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.Writer output,
                                 java.lang.String baseURI,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException,
                                 UnsupportedRDFormatException,
                                 java.net.URISyntaxException
        Writes the given statements to the given Writer in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The Writer to write the statements to.
        baseURI - The base URI to relativize IRIs against.
        dataFormat - The RDFFormat to use when writing the statements.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        java.net.URISyntaxException - If the baseURI is invalid
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.OutputStream output,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException
        Writes the given statements to the given OutputStream in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The OutputStream to write the statements to.
        dataFormat - The RDFFormat to use when writing the statements.
        settings - The WriterConfig containing settings for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.OutputStream output,
                                 java.lang.String baseURI,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException,
                                 UnsupportedRDFormatException,
                                 java.net.URISyntaxException
        Writes the given statements to the given OutputStream in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The OutputStream to write the statements to.
        baseURI - The base URI to relativize IRIs against.
        dataFormat - The RDFFormat to use when writing the statements.
        settings - The WriterConfig containing settings for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        java.net.URISyntaxException - If the baseURI is invalid
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.Writer output,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException
        Writes the given statements to the given Writer in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The Writer to write the statements to.
        dataFormat - The RDFFormat to use when writing the statements.
        settings - The WriterConfig containing settings for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 java.io.Writer output,
                                 java.lang.String baseURI,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException,
                                 UnsupportedRDFormatException,
                                 java.net.URISyntaxException
        Writes the given statements to the given Writer in the given format.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        output - The Writer to write the statements to.
        baseURI - The base URI to relativize IRIs against.
        dataFormat - The RDFFormat to use when writing the statements.
        settings - The WriterConfig containing settings for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
        java.net.URISyntaxException - If the baseURI is invalid
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(java.lang.Iterable<Statement> model,
                                 RDFHandler writer)
                          throws RDFHandlerException
        Writes the given statements to the given RDFHandler.

        If the collection is a Model, its namespaces will also be written.

        Parameters:
        model - A collection of statements, such as a Model, to be written.
        writer -
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statements.
      • write

        public static void write​(Statement st,
                                 java.io.OutputStream output,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException
        Writes the given statement to the given OutputStream in the given format.

        Parameters:
        st - The statement to be written.
        output - The OutputStream to write the statement to.
        dataFormat - The RDFFormat to use when writing the statement.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statement.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(Statement st,
                                 java.io.OutputStream output,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException
        Writes the given single statement to the given OutputStream in the given format.
        Parameters:
        st - The statement to be written.
        output - The OutputStream to write the statement to.
        dataFormat - The RDFFormat to use when writing the statement.
        settings - The WriterConfig containing setting for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statement.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(Statement statement,
                                 java.io.Writer output,
                                 RDFFormat dataFormat)
                          throws RDFHandlerException
        Writes the given single statement to the given Writer in the given format.

        Parameters:
        statement - A statement to be written.
        output - The Writer to write the statement to.
        dataFormat - The RDFFormat to use when writing the statement.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statement.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • write

        public static void write​(Statement statement,
                                 java.io.Writer output,
                                 RDFFormat dataFormat,
                                 WriterConfig settings)
                          throws RDFHandlerException
        Writes the given single statement to the given Writer in the given format.

        Parameters:
        statement - A statement to be written.
        output - The Writer to write the statement to.
        dataFormat - The RDFFormat to use when writing the statement.
        settings - The WriterConfig containing settings for configuring the writer.
        Throws:
        RDFHandlerException - Thrown if there is an error writing the statement.
        UnsupportedRDFormatException - If no RDFWriter is available for the specified RDF format.
      • unsupportedFormat

        public static java.util.function.Supplier<UnsupportedRDFormatException> unsupportedFormat​(RDFFormat unsupportedFormat)
        Helper method to use to create a lambda for Optional.orElseThrow(Supplier) to indicate a format is unsupported.
        Parameters:
        unsupportedFormat - The format that was not found.
        Returns:
        A lambda that can be used to generate an exception if the format is not found.
      • unsupportedFormat

        public static java.util.function.Supplier<UnsupportedRDFormatException> unsupportedFormat​(java.lang.String unsupportedFormat)
        Helper method to use to create a lambda for Optional.orElseThrow(Supplier) to indicate a format is unsupported.
        Parameters:
        unsupportedFormat - The format that was not found.
        Returns:
        A lambda that can be used to generate an exception if the format is not found.