001: /***
002: * ASM: a very small and fast Java bytecode manipulation framework
003: * Copyright (c) 2000-2005 INRIA, France Telecom
004: * All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: * 1. Redistributions of source code must retain the above copyright
010: * notice, this list of conditions and the following disclaimer.
011: * 2. Redistributions in binary form must reproduce the above copyright
012: * notice, this list of conditions and the following disclaimer in the
013: * documentation and/or other materials provided with the distribution.
014: * 3. Neither the name of the copyright holders nor the names of its
015: * contributors may be used to endorse or promote products derived from
016: * this software without specific prior written permission.
017: *
018: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
019: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
020: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
021: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
022: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
023: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
024: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
025: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
026: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
027: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
028: * THE POSSIBILITY OF SUCH DAMAGE.
029: */package com.tc.asm.tree;
030:
031: import java.util.ArrayList;
032: import java.util.List;
033:
034: import com.tc.asm.AnnotationVisitor;
035:
036: /**
037: * A node that represents an annotationn.
038: *
039: * @author Eric Bruneton
040: */
041: public class AnnotationNode implements AnnotationVisitor {
042:
043: /**
044: * The class descriptor of the annotation class.
045: */
046: public String desc;
047:
048: /**
049: * The name value pairs of this annotation. Each name value pair is stored
050: * as two consecutive elements in the list. The name is a {@link String},
051: * and the value may be a {@link Byte}, {@link Boolean}, {@link Character},
052: * {@link Short}, {@link Integer}, {@link Long}, {@link Float},
053: * {@link Double}, {@link String} or {@link com.tc.asm.Type}, or an
054: * two elements String array (for enumeration values), a
055: * {@link AnnotationNode}, or a {@link List} of values of one of the
056: * preceding types. The list may be <tt>null</tt> if there is no name
057: * value pair.
058: */
059: public List values;
060:
061: /**
062: * Constructs a new {@link AnnotationNode}.
063: *
064: * @param desc the class descriptor of the annotation class.
065: */
066: public AnnotationNode(final String desc) {
067: this .desc = desc;
068: }
069:
070: /**
071: * Constructs a new {@link AnnotationNode} to visit an array value.
072: *
073: * @param values where the visited values must be stored.
074: */
075: AnnotationNode(final List values) {
076: this .values = values;
077: }
078:
079: // ------------------------------------------------------------------------
080: // Implementation of the AnnotationVisitor interface
081: // ------------------------------------------------------------------------
082:
083: public void visit(final String name, final Object value) {
084: if (values == null) {
085: values = new ArrayList(this .desc != null ? 2 : 1);
086: }
087: if (this .desc != null) {
088: values.add(name);
089: }
090: values.add(value);
091: }
092:
093: public void visitEnum(final String name, final String desc,
094: final String value) {
095: if (values == null) {
096: values = new ArrayList(this .desc != null ? 2 : 1);
097: }
098: if (this .desc != null) {
099: values.add(name);
100: }
101: values.add(new String[] { desc, value });
102: }
103:
104: public AnnotationVisitor visitAnnotation(final String name,
105: final String desc) {
106: if (values == null) {
107: values = new ArrayList(this .desc != null ? 2 : 1);
108: }
109: if (this .desc != null) {
110: values.add(name);
111: }
112: AnnotationNode annotation = new AnnotationNode(desc);
113: values.add(annotation);
114: return annotation;
115: }
116:
117: public AnnotationVisitor visitArray(final String name) {
118: if (values == null) {
119: values = new ArrayList(this .desc != null ? 2 : 1);
120: }
121: if (this .desc != null) {
122: values.add(name);
123: }
124: List array = new ArrayList();
125: values.add(array);
126: return new AnnotationNode(array);
127: }
128:
129: public void visitEnd() {
130: }
131:
132: // ------------------------------------------------------------------------
133: // Accept methods
134: // ------------------------------------------------------------------------
135:
136: /**
137: * Makes the given visitor visit this annotation.
138: *
139: * @param av an annotation visitor. Maybe <tt>null</tt>.
140: */
141: public void accept(final AnnotationVisitor av) {
142: if (av != null) {
143: if (values != null) {
144: for (int i = 0; i < values.size(); i += 2) {
145: String name = (String) values.get(i);
146: Object value = values.get(i + 1);
147: accept(av, name, value);
148: }
149: }
150: av.visitEnd();
151: }
152: }
153:
154: /**
155: * Makes the given visitor visit a given annotation value.
156: *
157: * @param av an annotation visitor. Maybe <tt>null</tt>.
158: * @param name the value name.
159: * @param value the actual value.
160: */
161: static void accept(final AnnotationVisitor av, final String name,
162: final Object value) {
163: if (av != null) {
164: if (value instanceof String[]) {
165: String[] typeconst = (String[]) value;
166: av.visitEnum(name, typeconst[0], typeconst[1]);
167: } else if (value instanceof AnnotationNode) {
168: AnnotationNode an = (AnnotationNode) value;
169: an.accept(av.visitAnnotation(name, an.desc));
170: } else if (value instanceof List) {
171: AnnotationVisitor v = av.visitArray(name);
172: List array = (List) value;
173: for (int j = 0; j < array.size(); ++j) {
174: accept(v, null, array.get(j));
175: }
176: v.visitEnd();
177: } else {
178: av.visit(name, value);
179: }
180: }
181: }
182: }
|