KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > xalan > trace > TraceListener


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 /*
17  * $Id: TraceListener.java,v 1.8 2004/02/16 23:00:27 minchau Exp $
18  */
19 package org.apache.xalan.trace;
20
21
22 /**
23  * Interface the XSL processor calls when it matches a source node, selects a set of source nodes,
24  * or generates a result node.
25  * If you want an object instance to be called when a trace event occurs, use the TransformerImpl setTraceListener method.
26  * @see org.apache.xalan.trace.TracerEvent
27  * @see org.apache.xalan.trace.TraceManager#addTraceListener
28  * @xsl.usage advanced
29  */
30 public interface TraceListener extends java.util.EventListener JavaDoc
31 {
32
33   /**
34    * Method that is called when a trace event occurs.
35    * The method is blocking. It must return before processing continues.
36    *
37    * @param ev the trace event.
38    */
39   public void trace(TracerEvent ev);
40
41   /**
42    * Method that is called just after the formatter listener is called.
43    *
44    * @param ev the generate event.
45    *
46    * @throws javax.xml.transform.TransformerException
47    */
48   public void selected(SelectionEvent ev) throws javax.xml.transform.TransformerException JavaDoc;
49
50   /**
51    * Method that is called just after the formatter listener is called.
52    *
53    * @param ev the generate event.
54    */
55   public void generated(GenerateEvent ev);
56 }
57
Popular Tags