src/java.xml/share/classes/javax/xml/parsers/SAXParser.java

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2013, 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, 2015, 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
*** 551,556 ****
--- 551,605 ----
              + "\" version \""
              + this.getClass().getPackage().getSpecificationVersion()
              + "\""
              );
      }
+ 
+ 
+     /**
+      * Stops the parsing process.
+      * <p>
+      * This method can be called anywhere from any event method of a SAX
+      * handler. Once called, it does not terminate the parsing process
+      * immediately. Instead, it will continue finishing and returning the
+      * current event, and marking the state before it stops parsing. The
+      * parsing state is maintained after the process is stopped.
+      * <p>
+      * The event from which the method is called is considered parsed. In case
+      * the parsing process is subsequently resumed, it will start at the next
+      * event.
+      *
+      * @implSpec
+      * The method in the {@code javax.xml.parsers} API does nothing and returns
+      * false by default. Implementations that implement this method may choose
+      * to continue to a state for possible resumption of the operation. It is
+      * recommended that the current event be returned before terminating
+      * the parsing process.
+      * <p>
+      * The method shall return true once it has notified the parser to stop
+      * parsing.
+      *
+      * @return true if the parsing process can be stopped, false otherwise
+      */
+     public boolean stop() {
+         return false;
+     }
+ 
+     /**
+      * Resumes the parsing process that has been stopped by the {@link #stop()}
+      * method. The method will simply return if parsing is not stopped.
+      *
+      * @implSpec
+      * The method in the {@code javax.xml.parsers} API does nothing and returns
+      * false by default. Implementations that implement this method shall
+      * check the state to determine whether the parsing process can be resumed.
+      * It shall return true after it restarted the parsing regardless of what
+      * may happen in the rest of the parsing process, that is, the return value
+      * only indicates that the parsing can be and has been resumed.
+      *
+      * @return true if the parsing process is resumed successfully, false
+      * otherwise
+      */
+     public boolean resume() {
+         return false;
+     }
  }