KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > cocoon > components > sax > XMLDeserializer


1 /*
2  * Copyright 1999-2004 The Apache Software Foundation.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 package org.apache.cocoon.components.sax;
17
18 import org.apache.avalon.framework.component.Component;
19 import org.apache.cocoon.xml.XMLProducer;
20 import org.xml.sax.SAXException JavaDoc;
21
22 /**
23  * This interfaces identifies classes that deserialize XML data, sending SAX
24  * events to the configured <code>XMLConsumer</code> (or SAX
25  * <code>ContentHandler</code> and <code>LexicalHandler</code>).
26  * <br>
27  * The production of the xml data is started by passing an
28  * the xml information to the <code>deserialize</code>
29  * method.
30  * It is beyond the scope of this interface to specify the format of
31  * the serialized data.
32  *
33  * @author <a HREF="mailto:cziegeler@apache.org">Carsten Ziegeler</a>
34  * @version CVS $Id: XMLDeserializer.java 30932 2004-07-29 17:35:38Z vgritsenko $
35  */
36 public interface XMLDeserializer extends XMLProducer, Component {
37
38     String JavaDoc ROLE = XMLDeserializer.class.getName();
39
40     /**
41      * Deserialize the xml data and stream it.
42      *
43      * @param saxFragment The xml data.
44     */
45     void deserialize(Object JavaDoc saxFragment)
46     throws SAXException JavaDoc;
47     
48 }
49
Popular Tags