Package com.stardog.stark.io

Class ParserOptions

java.lang.Object
com.stardog.stark.io.ParserOptions
public final class ParserOptions extends Object

Options for RDF parsing.

Since:
1.0
Version:
1.0
Author:
Michael Grove

  • Field Details

    • BASE_IRI

      public static final Option<String> BASE_IRI

    • NAMESPACES

      public static final Option<Iterable<Namespace>> NAMESPACES

    • VERIFY_DATATYPES

      public static final Option<Boolean> VERIFY_DATATYPES

    • VERIFY_LANG

      public static final Option<Boolean> VERIFY_LANG

    • VERIFY_RELATIVE_IRIS

      public static final Option<Boolean> VERIFY_RELATIVE_IRIS

    • VERIFY_IRI_SYNTAX

      public static final Option<Boolean> VERIFY_IRI_SYNTAX

    • NORMALIZE_DATATYPES

      public static final Option<Boolean> NORMALIZE_DATATYPES

    • NORMALIZE_LANG

      public static final Option<Boolean> NORMALIZE_LANG

    • LANG_HANDLER

      public static final Option<LanguageHandler> LANG_HANDLER
      Lnaguage handler that will be used for verification and normalization.

    • PRESERVE_BNODE_IDS

      public static final Option<Boolean> PRESERVE_BNODE_IDS

      This option controls if the parser should preserve bnode identifiers specified in the source. Preserving bnode identifiers help speed parsing and loading time but it also has an important side-effect that if two distinct files using the same bnode identifier are loaded to the same database, the bnode in different files will end up pointing to the same node in the database. If the input files do not use bnode identifiers (e.g. in Turtle syntax only [] are used for bnodes) then this configuration option has no effect since such bnodes are always assigned a unique identifier. But if input files use explicit bnode identifiers (e.g. _:bnode1 in Turtle syntax) and multiple files may use same bnode identifiers then this configuration option should be turned off.

    • CASE_INSENSITIVE_DIRECTIVES

      public static final Option<Boolean> CASE_INSENSITIVE_DIRECTIVES

    • FAIL_ON_INVALID_LINES

      public static final Option<Boolean> FAIL_ON_INVALID_LINES

    • SECURE_PROCESSING

      public static final Option<Boolean> SECURE_PROCESSING
      Parser setting for the secure processing feature of XML parsers to avoid DOS and XXE attacks. Setting this option will enable the XMLConstants.FEATURE_SECURE_PROCESSING setting for the XML parser and disable the following settings that can be used in XML External Entity (XXE) attacks:
      • http://apache.org/xml/features/nonvalidating/load-external-dtd
      • http://xml.org/sax/features/external-general-entities
      • http://xml.org/sax/features/external-parameter-entities
      WARNING:Disabling this option is strongly discouraged as it would create a security vulnerability. Secure processing should be disabled only in cases where the input XML files are known to be coming from a trustworthy location.

      Defaults to true

    • FAIL_ON_SAX_NON_FATAL_ERRORS

      public static final Option<Boolean> FAIL_ON_SAX_NON_FATAL_ERRORS
      Parser setting to determine whether to ignore non-fatal errors that come from SAX parsers.

      Defaults to true

    • FAIL_ON_NON_STANDARD_ATTRIBUTES

      public static final Option<Boolean> FAIL_ON_NON_STANDARD_ATTRIBUTES
      Parser setting to determine whether to ignore non-standard attributes that are found in an XML document.

      Defaults to true

    • FAIL_ON_INVALID_NCNAME

      public static final Option<Boolean> FAIL_ON_INVALID_NCNAME
      Parser setting to determine whether to ignore XML documents containing invalid NCNAMEs.

      Defaults to true

    • FAIL_ON_DUPLICATE_RDF_ID

      public static final Option<Boolean> FAIL_ON_DUPLICATE_RDF_ID
      Parser setting to determine whether to throw an error for duplicate uses of rdf:ID in a single document.

      Defaults to true

    • FAIL_ON_INVALID_QNAME

      public static final Option<Boolean> FAIL_ON_INVALID_QNAME
      Parser setting to determine whether to ignore XML documents containing invalid QNAMEs.

      Defaults to true

    • FAIL_ON_MISMATCHED_TAGS

      public static final Option<Boolean> FAIL_ON_MISMATCHED_TAGS
      Parser setting to determine whether to throw an error for XML documents containing mismatched tags

      Defaults to true

  • Method Details

    • defaults

      @Nonnull public static Options defaults()
      Default parser options
      Returns:
      the default options

    • namespaces

      @Nonnull public static Options namespaces(@Nonnull Iterable<Namespace> theNamespaces)
      Return the default options with namespaces set to the given value
      Parameters:
      theNamespaces - the namespaces
      Returns:
      the options

    • baseIRI

      @Nonnull public static Options baseIRI(@Nonnull String theIRI)
      Return the default options with the base IRI set to the given value
      Parameters:
      theIRI - the base IRI
      Returns:
      the options

    • strict

      @Nonnull public static Options strict()
      Return a set of `Options` which correspond to default settings for a strict RDF parsing mode
      Returns:
      strict parsing options

    • lax

      @Nonnull public static Options lax()
      Return a set of `Options` which correspond to default settings for a strict RDF parsing mode
      Returns:
      strict parsing options