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.sax; 18 19 import org.xml.sax.ContentHandler; 20 import org.xml.sax.SAXException; 21 22 /** 23 * This interface can be implemented by classes willing to provide an XML representation 24 * of their current state as SAX events. 25 * 26 * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a> 27 * @version CVS $Revision: 1.4 $ $Date: 2004/02/28 11:47:20 $ 28 */ 29 public interface XMLizable 30 { 31 /** 32 * Generates SAX events representing the object's state. 33 * <b>NOTE</b> : if the implementation can produce lexical events, care should be taken 34 * that <code>handler</code> can actually be a {@link XMLConsumer} that accepts such 35 * events or directly implements the LexicalHandler interface! 36 */ 37 void toSAX( ContentHandler handler ) throws SAXException; 38 } 39