org.apache.xerces.util

## Class EntityResolver2Wrapper

- java.lang.Object
- - org.apache.xerces.util.EntityResolver2Wrapper

- All Implemented Interfaces:
    ExternalSubsetResolver, org.apache.xerces.xni.parser.XMLEntityResolver

      public class EntityResolver2Wrapper
      extends java.lang.Object
      implements ExternalSubsetResolver

  This class wraps a SAX entity resolver (EntityResolver2) in an XNI entity resolver.

  Version:
    $Id: EntityResolver2Wrapper.java 699902 2008-09-28 21:40:49Z mrglavas $
  Author:
    Michael Glavassevich, IBM

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `protected org.xml.sax.ext.EntityResolver2` | `fEntityResolver` An instance of SAX2 Extensions 1.1's EntityResolver2.

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `EntityResolver2Wrapper()` Default constructor.
    `EntityResolver2Wrapper(org.xml.sax.ext.EntityResolver2 entityResolver)` Creates a new instance wrapping the given SAX entity resolver.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `org.xml.sax.ext.EntityResolver2` | `getEntityResolver()` Returns the SAX entity resolver wrapped by this object.
    `org.apache.xerces.xni.parser.XMLInputSource` | `getExternalSubset(org.apache.xerces.xni.grammars.XMLDTDDescription grammarDescription)` Locates an external subset for documents which do not explicitly provide one.
    `org.apache.xerces.xni.parser.XMLInputSource` | `resolveEntity(org.apache.xerces.xni.XMLResourceIdentifier resourceIdentifier)` Resolves an external parsed entity.
    `void` | `setEntityResolver(org.xml.sax.ext.EntityResolver2 entityResolver)` Sets the SAX entity resolver wrapped by this object.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### fEntityResolver

          protected org.xml.sax.ext.EntityResolver2 fEntityResolver

      An instance of SAX2 Extensions 1.1's EntityResolver2.

  - ### Constructor Detail

    - #### EntityResolver2Wrapper

          public EntityResolver2Wrapper()

      Default constructor.

    - #### EntityResolver2Wrapper

          public EntityResolver2Wrapper(org.xml.sax.ext.EntityResolver2 entityResolver)

      Creates a new instance wrapping the given SAX entity resolver.

      Parameters:
        `entityResolver` - the SAX entity resolver to wrap

  - ### Method Detail

    - #### setEntityResolver

          public void setEntityResolver(org.xml.sax.ext.EntityResolver2 entityResolver)

      Sets the SAX entity resolver wrapped by this object.

      Parameters:
        `entityResolver` - the SAX entity resolver to wrap

    - #### getEntityResolver

          public org.xml.sax.ext.EntityResolver2 getEntityResolver()

      Returns the SAX entity resolver wrapped by this object.

      Returns:
        the SAX entity resolver wrapped by this object

    - #### getExternalSubset

          public org.apache.xerces.xni.parser.XMLInputSource getExternalSubset(org.apache.xerces.xni.grammars.XMLDTDDescription grammarDescription)
                                                                        throws org.apache.xerces.xni.XNIException,
                                                                               java.io.IOException

      Locates an external subset for documents which do not explicitly provide one. If no external subset is provided, this method should return `null`.

      Specified by:
        `getExternalSubset` in interface `ExternalSubsetResolver`
      Parameters:
        `grammarDescription` - a description of the DTD
      Throws:
        `org.apache.xerces.xni.XNIException` - Thrown on general error.
        `java.io.IOException` - Thrown if resolved entity stream cannot be opened or some other i/o error occurs.

    - #### resolveEntity

          public org.apache.xerces.xni.parser.XMLInputSource resolveEntity(org.apache.xerces.xni.XMLResourceIdentifier resourceIdentifier)
                                                                    throws org.apache.xerces.xni.XNIException,
                                                                           java.io.IOException

      Resolves an external parsed entity. If the entity cannot be resolved, this method should return null.
      Specified by:
        `resolveEntity` in interface `org.apache.xerces.xni.parser.XMLEntityResolver`
      Parameters:
        `resourceIdentifier` - contains the physical co-ordinates of the resource to be resolved
      Throws:
        `org.apache.xerces.xni.XNIException` - Thrown on general error.
        `java.io.IOException` - Thrown if resolved entity stream cannot be opened or some other i/o error occurs.
      See Also:
        `XMLResourceIdentifier`

Copyright © 1999-2022 The Apache Software Foundation. All Rights Reserved.