01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.collections;
27:
28: import org.jicarilla.lang.Assert;
29: import org.xml.sax.SAXException;
30:
31: import javax.xml.parsers.SAXParser;
32: import java.io.IOException;
33: import java.io.InputStream;
34:
35: /**
36: * Builds ValueNode trees from SAX events.
37: *
38: * @author <a href="lsimons at jicarilla dot org">Leo Simons</a>
39: * @version $Id: NodeBuilder.java,v 1.4 2004/03/23 13:37:48 lsimons Exp $
40: */
41: public class NodeBuilder {
42: private final static String PREFIX = "urn:jicarilla:context-key:";
43:
44: public final static String LOCATION_CONTEXT_KEY = PREFIX
45: + "java.lang.String:location";
46: public final static String STRING_CONTENTS_CONTEXT_KEY = PREFIX
47: + "java.lang.String:contents";
48:
49: /*public final static String PARSER_CONTEXT_KEY =
50: "urn:jicarilla:context-key:javax.xml.parsers.SAXParser:parser";
51: public final static String HANDLER_CONTEXT_KEY =
52: "urn:jicarilla:context-key:org.jicarilla.collections.AbstractXMLContextHandler:handler";*/
53:
54: private SAXParser m_parser;
55: private AbstractXMLNodeHandler m_handler;
56:
57: public NodeBuilder(final SAXParser parser,
58: final AbstractXMLNodeHandler handler) {
59: Assert.assertNotNull("parser argument may not be null", parser);
60: Assert.assertNotNull("handler argument may not be null",
61: handler);
62:
63: m_parser = parser;
64: m_handler = handler;
65: }
66:
67: public Node treeFromXML(final InputStream stream)
68: throws SAXException, IOException {
69: getHandler().recycle();
70: getParser().parse(stream, getHandler());
71: return getHandler().getNode();
72: }
73:
74: protected SAXParser getParser() {
75: return m_parser;
76: }
77:
78: protected AbstractXMLNodeHandler getHandler() {
79: return m_handler;
80: }
81: }
|