1 /* 2 * Copyright (C) The Apache Software Foundation. All rights reserved. 3 * 4 * This software is published under the terms of the Apache Software License 5 * version 1.1, a copy of which has been included with this distribution in 6 * the LICENSE.txt file. 7 */ 8 package org.apache.avalon.excalibur.xml; 9 10 import org.xml.sax.ContentHandler; 11 import org.xml.sax.SAXException; 12 13 /** 14 * This interface can be implemented by classes willing to provide an XML representation 15 * of their current state as SAX events. 16 * 17 * @author <a HREF="mailto:sylvain@apache.org">Sylvain Wallez</a> 18 * @version CVS $Revision: 1.3 $ $Date: 2001/12/11 09:53:38 $ 19 */ 20 21 public interface XMLizable { 22 /** 23 * Generates SAX events representing the object's state.<br/> 24 * <b>NOTE</b> : if the implementation can produce lexical events, care should be taken 25 * that <code>handler</code> can actually be a {@link XMLConsumer} that accepts such 26 * events or directly implements the LexicalHandler interface! 27 */ 28 void toSAX(ContentHandler handler) throws SAXException; 29 30 } 31