KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > excalibur > xml > dom > DOMParser


1 /*
2  * Copyright 2002-2004 The Apache Software Foundation
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
12  * implied.
13  *
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */

17 package org.apache.excalibur.xml.dom;
18
19 import java.io.IOException JavaDoc;
20
21 import org.w3c.dom.Document JavaDoc;
22 import org.xml.sax.InputSource JavaDoc;
23 import org.xml.sax.SAXException JavaDoc;
24
25 /**
26  * The parser can be used to parse any XML document given
27  * by a {@link InputSource} object.
28  * It can create a DOM from the parsed document.
29  *
30  * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a>
31  * @version CVS $Revision: 1.4 $ $Date: 2004/02/28 11:47:31 $
32  */

33 public interface DOMParser
34 {
35     String JavaDoc ROLE = DOMParser.class.getName();
36
37     /**
38      * Parse the {@link InputSource} and create
39      * a DOM out of it.
40      */

41     Document JavaDoc parseDocument( InputSource JavaDoc in )
42         throws SAXException JavaDoc, IOException JavaDoc;
43
44     /**
45      * Return a new {@link Document}.
46      */

47     Document JavaDoc createDocument() throws SAXException JavaDoc;
48 }
49
Popular Tags