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