View Javadoc

1   /*
2   
3       stax  Stack API for XML.
4       Copyright (c) 2001-2006 held jointly by the individual authors.
5   
6       This library is free software; you can redistribute it and/or modify it
7       under the terms of the GNU Lesser General Public License as published
8       by the Free Software Foundation; either version 2.1 of the License, or (at
9       your option) any later version.
10  
11      This library is distributed in the hope that it will be useful, but WITHOUT
12      ANY WARRANTY; with out even the implied warranty of MERCHANTABILITY or
13      FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
14      License for more details.
15  
16      You should have received a copy of the GNU Lesser General Public License
17      along with this library;  if not, write to the Free Software Foundation,
18      Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA.
19  
20      > http://www.gnu.org/copyleft/lesser.html
21      > http://www.opensource.org/licenses/lgpl-license.php
22  
23  */
24  package net.sf.stax;
25  
26  import org.xml.sax.SAXException;
27  
28  /***
29   * Interface which exposes delegation services offered by a StAX
30   * event source.
31   *
32   * @author  Thomas Down
33   * @author  Matthew Pocock
34   * @author  Michael Heuer
35   * @version $Revision: 1.2 $ $Date: 2006/01/02 20:37:34 $
36   */
37  public interface StAXDelegationContext
38      extends StAXContext
39  {
40      /***
41       * Delegate to the specified StAXContentHandler.
42       *
43       * @param handler content handler to delegate to
44       * @throws SAXException any SAX exception, possibly wrapping another exception
45       */
46      void delegate(StAXContentHandler handler)
47          throws SAXException;
48  
49      /***
50       * Push the specified subcontext on the stack of contexts.
51       *
52       * @param subContext subcontext to push
53       * @throws SAXException any SAX exception, possibly wrapping another exception
54       */
55      void pushContext(String subContext)
56          throws SAXException;
57  }
58