KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > oracle > toplink > libraries > asm > tree > TreeClassAdapter


1 /***
2  * ASM: a very small and fast Java bytecode manipulation framework
3  * Copyright (c) 2000,2002,2003 INRIA, France Telecom
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in the
13  * documentation and/or other materials provided with the distribution.
14  * 3. Neither the name of the copyright holders nor the names of its
15  * contributors may be used to endorse or promote products derived from
16  * this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
28  * THE POSSIBILITY OF SUCH DAMAGE.
29  */
30
31 package oracle.toplink.libraries.asm.tree;
32
33 import oracle.toplink.libraries.asm.ClassAdapter;
34 import oracle.toplink.libraries.asm.CodeVisitor;
35 import oracle.toplink.libraries.asm.ClassVisitor;
36 import oracle.toplink.libraries.asm.Attribute;
37
38 /**
39  * A {@link ClassAdapter ClassAdapter} that constructs a tree representation of
40  * the classes it vists. Each <tt>visit</tt><i>XXX</i> method of this class
41  * constructs an <i>XXX</i><tt>Node</tt> and adds it to the {@link #classNode
42  * classNode} node (except the {@link #visitEnd visitEnd} method, which just
43  * makes the {@link #cv cv} class visitor visit the tree that has just been
44  * constructed).
45  * <p>
46  * In order to implement a usefull class adapter based on a tree representation
47  * of classes, one just need to override the {@link #visitEnd visitEnd} method
48  * with a method of the following form:
49  * <pre>
50  * public void visitEnd () {
51  * // ...
52  * // code to modify the classNode tree, can be arbitrary complex
53  * // ...
54  * // makes the cv visitor visit this modified class:
55  * classNode.accept(cv);
56  * }
57  * </pre>
58  *
59  * @author Eric Bruneton
60  */
61
62 public class TreeClassAdapter extends ClassAdapter {
63
64   /**
65    * A tree representation of the class that is being visited by this visitor.
66    */
67
68   public ClassNode classNode;
69
70   /**
71    * Constructs a new {@link TreeClassAdapter TreeClassAdapter} object.
72    *
73    * @param cv the class visitor to which this adapter must delegate calls.
74    */
75
76   public TreeClassAdapter (final ClassVisitor cv) {
77     super(cv);
78   }
79
80   public void visit (
81     final int version,
82     final int access,
83     final String JavaDoc name,
84     final String JavaDoc superName,
85     final String JavaDoc[] interfaces,
86     final String JavaDoc sourceFile)
87   {
88     classNode = new ClassNode(version, access, name, superName, interfaces, sourceFile);
89   }
90
91   public void visitInnerClass (
92     final String JavaDoc name,
93     final String JavaDoc outerName,
94     final String JavaDoc innerName,
95     final int access)
96   {
97     InnerClassNode icn = new InnerClassNode(name, outerName, innerName, access);
98     classNode.innerClasses.add(icn);
99   }
100
101   public void visitField (
102     final int access,
103     final String JavaDoc name,
104     final String JavaDoc desc,
105     final Object JavaDoc value,
106     final Attribute attrs)
107   {
108     FieldNode fn = new FieldNode(access, name, desc, value, attrs);
109     classNode.fields.add(fn);
110   }
111
112   public CodeVisitor visitMethod (
113     final int access,
114     final String JavaDoc name,
115     final String JavaDoc desc,
116     final String JavaDoc[] exceptions,
117     final Attribute attrs)
118   {
119     MethodNode mn = new MethodNode(access, name, desc, exceptions, attrs);
120     classNode.methods.add(mn);
121     return new TreeCodeAdapter(mn);
122   }
123
124   public void visitAttribute (final Attribute attr) {
125     attr.next = classNode.attrs;
126     classNode.attrs = attr;
127   }
128
129   public void visitEnd () {
130     if( cv!=null) {
131       classNode.accept(cv);
132     }
133   }
134 }
135
Popular Tags