KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > xml > transform > sax > TemplatesHandler


1 // $Id: TemplatesHandler.java,v 1.1.26.1 2004/07/13 22:27:50 jsuttor Exp $
2 /*
3  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
4  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
5  */
6
7 /*
8  * @(#)TemplatesHandler.java 1.14 04/07/13
9  */
10 package javax.xml.transform.sax;
11
12 import javax.xml.transform.*;
13
14 import org.xml.sax.ContentHandler JavaDoc;
15
16 /**
17  * A SAX ContentHandler that may be used to process SAX
18  * parse events (parsing transformation instructions) into a Templates object.
19  *
20  * <p>Note that TemplatesHandler does not need to implement LexicalHandler.</p>
21  */
22 public interface TemplatesHandler extends ContentHandler JavaDoc {
23
24     /**
25      * When a TemplatesHandler object is used as a ContentHandler
26      * for the parsing of transformation instructions, it creates a Templates object,
27      * which the caller can get once the SAX events have been completed.
28      *
29      * @return The Templates object that was created during
30      * the SAX event process, or null if no Templates object has
31      * been created.
32      *
33      */
34     public Templates getTemplates();
35
36     /**
37      * Set the base ID (URI or system ID) for the Templates object
38      * created by this builder. This must be set in order to
39      * resolve relative URIs in the stylesheet. This must be
40      * called before the startDocument event.
41      *
42      * @param systemID Base URI for this stylesheet.
43      */
44     public void setSystemId(String JavaDoc systemID);
45
46     /**
47      * Get the base ID (URI or system ID) from where relative
48      * URLs will be resolved.
49      * @return The systemID that was set with {@link #setSystemId}.
50      */
51     public String JavaDoc getSystemId();
52 }
53
Popular Tags