< prev index next >
src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java
Print this page
@@ -1,7 +1,7 @@
/*
- * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
+ * 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,10 +90,11 @@
/**
* Construct an XML filter with the specified parent.
*
+ * @param parent the specified parent
* @see #setParent
* @see #getParent
*/
public XMLFilterImpl (XMLReader parent)
{
@@ -150,13 +151,13 @@
*
* <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
+ * @throws org.xml.sax.SAXNotRecognizedException If the feature
* value can't be assigned or retrieved from the parent.
- * @exception org.xml.sax.SAXNotSupportedException When the
+ * @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,13 +175,13 @@
*
* <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
+ * @throws org.xml.sax.SAXNotRecognizedException If the feature
* value can't be assigned or retrieved from the parent.
- * @exception org.xml.sax.SAXNotSupportedException When the
+ * @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,13 +199,13 @@
*
* <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
+ * @throws org.xml.sax.SAXNotRecognizedException If the property
* value can't be assigned or retrieved from the parent.
- * @exception org.xml.sax.SAXNotSupportedException When the
+ * @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,13 +221,13 @@
/**
* 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
+ * @throws org.xml.sax.SAXNotRecognizedException If the property
* value can't be assigned or retrieved from the parent.
- * @exception org.xml.sax.SAXNotSupportedException When the
+ * @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,13 +330,13 @@
/**
* Parse a document.
*
* @param input The input source for the document entity.
- * @exception org.xml.sax.SAXException Any SAX exception, possibly
+ * @throws org.xml.sax.SAXException Any SAX exception, possibly
* wrapping another exception.
- * @exception java.io.IOException An IO exception from the parser,
+ * @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,13 +348,13 @@
/**
* Parse a document.
*
* @param systemId The system identifier as a fully-qualified URI.
- * @exception org.xml.sax.SAXException Any SAX exception, possibly
+ * @throws org.xml.sax.SAXException Any SAX exception, possibly
* wrapping another exception.
- * @exception java.io.IOException An IO exception from the parser,
+ * @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,13 +373,13 @@
* 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
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
- * @exception java.io.IOException The client may throw an
+ * @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,11 +402,11 @@
* 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
+ * @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,11 +421,11 @@
*
* @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
+ * @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,11 +458,11 @@
/**
* Filter a start document event.
*
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void startDocument ()
throws SAXException
{
@@ -472,11 +473,11 @@
/**
* Filter an end document event.
*
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void endDocument ()
throws SAXException
{
@@ -489,11 +490,11 @@
/**
* 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
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void startPrefixMapping (String prefix, String uri)
throws SAXException
{
@@ -505,11 +506,11 @@
/**
* Filter an end Namespace prefix mapping event.
*
* @param prefix The Namespace prefix.
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void endPrefixMapping (String prefix)
throws SAXException
{
@@ -525,11 +526,11 @@
* @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
+ * @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,11 +546,11 @@
*
* @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
+ * @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,11 +564,11 @@
* 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
+ * @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,11 +582,11 @@
* 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
+ * @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,11 +599,11 @@
/**
* 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
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void processingInstruction (String target, String data)
throws SAXException
{
@@ -614,11 +615,11 @@
/**
* Filter a skipped entity event.
*
* @param name The name of the skipped entity.
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void skippedEntity (String name)
throws SAXException
{
@@ -636,11 +637,11 @@
/**
* Filter a warning event.
*
* @param e The warning as an exception.
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void warning (SAXParseException e)
throws SAXException
{
@@ -652,11 +653,11 @@
/**
* Filter an error event.
*
* @param e The error as an exception.
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void error (SAXParseException e)
throws SAXException
{
@@ -668,11 +669,11 @@
/**
* Filter a fatal error event.
*
* @param e The error as an exception.
- * @exception org.xml.sax.SAXException The client may throw
+ * @throws org.xml.sax.SAXException The client may throw
* an exception during processing.
*/
public void fatalError (SAXParseException e)
throws SAXException
{
< prev index next >