src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 90,99 ****
--- 90,100 ----
  
  
      /**
       * Construct an XML filter with the specified parent.
       *
+      * @param parent the specified parent
       * @see #setParent
       * @see #getParent
       */
      public XMLFilterImpl (XMLReader parent)
      {
*** 150,162 ****
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The feature name.
       * @param value The requested feature value.
!      * @exception org.xml.sax.SAXNotRecognizedException If the feature
       *            value can't be assigned or retrieved from the parent.
!      * @exception org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the feature name but
       *            cannot set the requested value.
       */
      public void setFeature (String name, boolean value)
          throws SAXNotRecognizedException, SAXNotSupportedException
--- 151,163 ----
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The feature name.
       * @param value The requested feature value.
!      * @throws org.xml.sax.SAXNotRecognizedException If the feature
       *            value can't be assigned or retrieved from the parent.
!      * @throws org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the feature name but
       *            cannot set the requested value.
       */
      public void setFeature (String name, boolean value)
          throws SAXNotRecognizedException, SAXNotSupportedException
*** 174,186 ****
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The feature name.
       * @return The current value of the feature.
!      * @exception org.xml.sax.SAXNotRecognizedException If the feature
       *            value can't be assigned or retrieved from the parent.
!      * @exception org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the feature name but
       *            cannot determine its value at this time.
       */
      public boolean getFeature (String name)
          throws SAXNotRecognizedException, SAXNotSupportedException
--- 175,187 ----
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The feature name.
       * @return The current value of the feature.
!      * @throws org.xml.sax.SAXNotRecognizedException If the feature
       *            value can't be assigned or retrieved from the parent.
!      * @throws org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the feature name but
       *            cannot determine its value at this time.
       */
      public boolean getFeature (String name)
          throws SAXNotRecognizedException, SAXNotSupportedException
*** 198,210 ****
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The property name.
       * @param value The requested property value.
!      * @exception org.xml.sax.SAXNotRecognizedException If the property
       *            value can't be assigned or retrieved from the parent.
!      * @exception org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the property name but
       *            cannot set the requested value.
       */
      public void setProperty (String name, Object value)
          throws SAXNotRecognizedException, SAXNotSupportedException
--- 199,211 ----
       *
       * <p>This will always fail if the parent is null.</p>
       *
       * @param name The property name.
       * @param value The requested property value.
!      * @throws org.xml.sax.SAXNotRecognizedException If the property
       *            value can't be assigned or retrieved from the parent.
!      * @throws org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the property name but
       *            cannot set the requested value.
       */
      public void setProperty (String name, Object value)
          throws SAXNotRecognizedException, SAXNotSupportedException
*** 220,232 ****
      /**
       * Look up the value of a property.
       *
       * @param name The property name.
       * @return The current value of the property.
!      * @exception org.xml.sax.SAXNotRecognizedException If the property
       *            value can't be assigned or retrieved from the parent.
!      * @exception org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the property name but
       *            cannot determine its value at this time.
       */
      public Object getProperty (String name)
          throws SAXNotRecognizedException, SAXNotSupportedException
--- 221,233 ----
      /**
       * Look up the value of a property.
       *
       * @param name The property name.
       * @return The current value of the property.
!      * @throws org.xml.sax.SAXNotRecognizedException If the property
       *            value can't be assigned or retrieved from the parent.
!      * @throws org.xml.sax.SAXNotSupportedException When the
       *            parent recognizes the property name but
       *            cannot determine its value at this time.
       */
      public Object getProperty (String name)
          throws SAXNotRecognizedException, SAXNotSupportedException
*** 329,341 ****
  
      /**
       * Parse a document.
       *
       * @param input The input source for the document entity.
!      * @exception org.xml.sax.SAXException Any SAX exception, possibly
       *            wrapping another exception.
!      * @exception java.io.IOException An IO exception from the parser,
       *            possibly from a byte stream or character stream
       *            supplied by the application.
       */
      public void parse (InputSource input)
          throws SAXException, IOException
--- 330,342 ----
  
      /**
       * Parse a document.
       *
       * @param input The input source for the document entity.
!      * @throws org.xml.sax.SAXException Any SAX exception, possibly
       *            wrapping another exception.
!      * @throws java.io.IOException An IO exception from the parser,
       *            possibly from a byte stream or character stream
       *            supplied by the application.
       */
      public void parse (InputSource input)
          throws SAXException, IOException
*** 347,359 ****
  
      /**
       * Parse a document.
       *
       * @param systemId The system identifier as a fully-qualified URI.
!      * @exception org.xml.sax.SAXException Any SAX exception, possibly
       *            wrapping another exception.
!      * @exception java.io.IOException An IO exception from the parser,
       *            possibly from a byte stream or character stream
       *            supplied by the application.
       */
      public void parse (String systemId)
          throws SAXException, IOException
--- 348,360 ----
  
      /**
       * Parse a document.
       *
       * @param systemId The system identifier as a fully-qualified URI.
!      * @throws org.xml.sax.SAXException Any SAX exception, possibly
       *            wrapping another exception.
!      * @throws java.io.IOException An IO exception from the parser,
       *            possibly from a byte stream or character stream
       *            supplied by the application.
       */
      public void parse (String systemId)
          throws SAXException, IOException
*** 372,384 ****
       * Filter an external entity resolution.
       *
       * @param publicId The entity's public identifier, or null.
       * @param systemId The entity's system identifier.
       * @return A new InputSource or null for the default.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
!      * @exception java.io.IOException The client may throw an
       *            I/O-related exception while obtaining the
       *            new InputSource.
       */
      public InputSource resolveEntity (String publicId, String systemId)
          throws SAXException, IOException
--- 373,385 ----
       * Filter an external entity resolution.
       *
       * @param publicId The entity's public identifier, or null.
       * @param systemId The entity's system identifier.
       * @return A new InputSource or null for the default.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
!      * @throws java.io.IOException The client may throw an
       *            I/O-related exception while obtaining the
       *            new InputSource.
       */
      public InputSource resolveEntity (String publicId, String systemId)
          throws SAXException, IOException
*** 401,411 ****
       * Filter a notation declaration event.
       *
       * @param name The notation name.
       * @param publicId The notation's public identifier, or null.
       * @param systemId The notation's system identifier, or null.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void notationDecl (String name, String publicId, String systemId)
          throws SAXException
      {
--- 402,412 ----
       * Filter a notation declaration event.
       *
       * @param name The notation name.
       * @param publicId The notation's public identifier, or null.
       * @param systemId The notation's system identifier, or null.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void notationDecl (String name, String publicId, String systemId)
          throws SAXException
      {
*** 420,430 ****
       *
       * @param name The entity name.
       * @param publicId The entity's public identifier, or null.
       * @param systemId The entity's system identifier, or null.
       * @param notationName The name of the associated notation.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void unparsedEntityDecl (String name, String publicId,
                                      String systemId, String notationName)
          throws SAXException
--- 421,431 ----
       *
       * @param name The entity name.
       * @param publicId The entity's public identifier, or null.
       * @param systemId The entity's system identifier, or null.
       * @param notationName The name of the associated notation.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void unparsedEntityDecl (String name, String publicId,
                                      String systemId, String notationName)
          throws SAXException
*** 457,467 ****
  
  
      /**
       * Filter a start document event.
       *
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startDocument ()
          throws SAXException
      {
--- 458,468 ----
  
  
      /**
       * Filter a start document event.
       *
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startDocument ()
          throws SAXException
      {
*** 472,482 ****
  
  
      /**
       * Filter an end document event.
       *
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endDocument ()
          throws SAXException
      {
--- 473,483 ----
  
  
      /**
       * Filter an end document event.
       *
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endDocument ()
          throws SAXException
      {
*** 489,499 ****
      /**
       * Filter a start Namespace prefix mapping event.
       *
       * @param prefix The Namespace prefix.
       * @param uri The Namespace URI.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startPrefixMapping (String prefix, String uri)
          throws SAXException
      {
--- 490,500 ----
      /**
       * Filter a start Namespace prefix mapping event.
       *
       * @param prefix The Namespace prefix.
       * @param uri The Namespace URI.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startPrefixMapping (String prefix, String uri)
          throws SAXException
      {
*** 505,515 ****
  
      /**
       * Filter an end Namespace prefix mapping event.
       *
       * @param prefix The Namespace prefix.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endPrefixMapping (String prefix)
          throws SAXException
      {
--- 506,516 ----
  
      /**
       * Filter an end Namespace prefix mapping event.
       *
       * @param prefix The Namespace prefix.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endPrefixMapping (String prefix)
          throws SAXException
      {
*** 525,535 ****
       * @param uri The element's Namespace URI, or the empty string.
       * @param localName The element's local name, or the empty string.
       * @param qName The element's qualified (prefixed) name, or the empty
       *        string.
       * @param atts The element's attributes.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startElement (String uri, String localName, String qName,
                                Attributes atts)
          throws SAXException
--- 526,536 ----
       * @param uri The element's Namespace URI, or the empty string.
       * @param localName The element's local name, or the empty string.
       * @param qName The element's qualified (prefixed) name, or the empty
       *        string.
       * @param atts The element's attributes.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void startElement (String uri, String localName, String qName,
                                Attributes atts)
          throws SAXException
*** 545,555 ****
       *
       * @param uri The element's Namespace URI, or the empty string.
       * @param localName The element's local name, or the empty string.
       * @param qName The element's qualified (prefixed) name, or the empty
       *        string.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endElement (String uri, String localName, String qName)
          throws SAXException
      {
--- 546,556 ----
       *
       * @param uri The element's Namespace URI, or the empty string.
       * @param localName The element's local name, or the empty string.
       * @param qName The element's qualified (prefixed) name, or the empty
       *        string.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void endElement (String uri, String localName, String qName)
          throws SAXException
      {
*** 563,573 ****
       * Filter a character data event.
       *
       * @param ch An array of characters.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void characters (char ch[], int start, int length)
          throws SAXException
      {
--- 564,574 ----
       * Filter a character data event.
       *
       * @param ch An array of characters.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void characters (char ch[], int start, int length)
          throws SAXException
      {
*** 581,591 ****
       * Filter an ignorable whitespace event.
       *
       * @param ch An array of characters.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void ignorableWhitespace (char ch[], int start, int length)
          throws SAXException
      {
--- 582,592 ----
       * Filter an ignorable whitespace event.
       *
       * @param ch An array of characters.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void ignorableWhitespace (char ch[], int start, int length)
          throws SAXException
      {
*** 598,608 ****
      /**
       * Filter a processing instruction event.
       *
       * @param target The processing instruction target.
       * @param data The text following the target.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void processingInstruction (String target, String data)
          throws SAXException
      {
--- 599,609 ----
      /**
       * Filter a processing instruction event.
       *
       * @param target The processing instruction target.
       * @param data The text following the target.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void processingInstruction (String target, String data)
          throws SAXException
      {
*** 614,624 ****
  
      /**
       * Filter a skipped entity event.
       *
       * @param name The name of the skipped entity.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void skippedEntity (String name)
          throws SAXException
      {
--- 615,625 ----
  
      /**
       * Filter a skipped entity event.
       *
       * @param name The name of the skipped entity.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void skippedEntity (String name)
          throws SAXException
      {
*** 636,646 ****
  
      /**
       * Filter a warning event.
       *
       * @param e The warning as an exception.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void warning (SAXParseException e)
          throws SAXException
      {
--- 637,647 ----
  
      /**
       * Filter a warning event.
       *
       * @param e The warning as an exception.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void warning (SAXParseException e)
          throws SAXException
      {
*** 652,662 ****
  
      /**
       * Filter an error event.
       *
       * @param e The error as an exception.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void error (SAXParseException e)
          throws SAXException
      {
--- 653,663 ----
  
      /**
       * Filter an error event.
       *
       * @param e The error as an exception.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void error (SAXParseException e)
          throws SAXException
      {
*** 668,678 ****
  
      /**
       * Filter a fatal error event.
       *
       * @param e The error as an exception.
!      * @exception org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void fatalError (SAXParseException e)
          throws SAXException
      {
--- 669,679 ----
  
      /**
       * Filter a fatal error event.
       *
       * @param e The error as an exception.
!      * @throws org.xml.sax.SAXException The client may throw
       *            an exception during processing.
       */
      public void fatalError (SAXParseException e)
          throws SAXException
      {