Class DocumentFactory

Object
DocumentFactory

public class DocumentFactory extends Object
This is the main entry point into the XSI parsing routines.

Example Use:

     Object x = DocumentFactory.getInstance(new URI("MyInstanceDocumentURI");
 

A selection of the hints available to configure parsing:

Author:
dzwiers, Refractions Research, Inc. http://www.refractions.net
  • Field Details

    • VALIDATION_HINT

      public static final String VALIDATION_HINT
      When this hint is contained and set to Boolean.FALSE, element ordering will not be validated. This key may also affect data validation within the parse routines. The inherent safety of the resulting objects is weekend by turning this param to false.
      See Also:
    • DISABLE_EXTERNAL_ENTITIES

      public static final String DISABLE_EXTERNAL_ENTITIES
      When this hint is contained and set to Boolean.TRUE, external entities will be disabled. This setting is used to alivate XXE attacks, preventing both VALIDATION_HINT and XMLHandlerHints.ENTITY_RESOLVER from being effective.
      See Also:
  • Constructor Details

    • DocumentFactory

      public DocumentFactory()
  • Method Details

    • getInstance

      public static Object getInstance(URI desiredDocument, Map<String,Object> hints) throws SAXException
      calls getInstance(URI,Level) with Level.WARNING
      Parameters:
      hints - May be null.
      Returns:
      Object
      Throws:
      SAXException
      See Also:
    • getInstance

      public static Object getInstance(URI desiredDocument, Map<String,Object> hints, Level level) throws SAXException
      Parses the instance data provided. This method assumes that the XML document is fully described using XML Schemas. Failure to be fully described as Schemas will result in errors, as opposed to a vid parse.
      Parameters:
      hints - May be null.
      Returns:
      Object
      Throws:
      SAXException
      See Also:
      • DocumentFactory#getInstance(URI, Map, Level, boolean)
    • getInstance

      public static Object getInstance(InputStream is, Map<String,Object> hints, Level level) throws SAXException
      Parses the instance data provided. This method assumes that the XML document is fully described using XML Schemas. Failure to be fully described as Schemas will result in errors, as opposed to a vid parse.
      Parameters:
      hints - May be null.
      Returns:
      Object
      Throws:
      SAXException
      See Also:
      • DocumentFactory#getInstance(InputStream, Map, Level, boolean)