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 org.objectweb.asm.tree;
030:
031: import java.util.ArrayList;
032: import java.util.List;
033:
034: import org.objectweb.asm.AnnotationVisitor;
035:
036: /**
037: * A node that represents an annotationn.
038: *
039: * @author Eric Bruneton
040: */
041: @SuppressWarnings("unchecked")
042: public class AnnotationNode implements AnnotationVisitor {
043:
044: /**
045: * The class descriptor of the annotation class.
046: */
047: public String desc;
048:
049: /**
050: * The name value pairs of this annotation. Each name value pair is stored
051: * as two consecutive elements in the list. The name is a {@link String},
052: * and the value may be a {@link Byte}, {@link Boolean}, {@link Character},
053: * {@link Short}, {@link Integer}, {@link Long}, {@link Float},
054: * {@link Double}, {@link String} or {@link org.objectweb.asm.Type}, or an
055: * two elements String array (for enumeration values), a
056: * {@link AnnotationNode}, or a {@link List} of values of one of the
057: * preceding types. The list may be <tt>null</tt> if there is no name
058: * value pair.
059: */
060: public List values;
061:
062: /**
063: * Constructs a new {@link AnnotationNode}.
064: *
065: * @param desc the class descriptor of the annotation class.
066: */
067: public AnnotationNode(final String desc) {
068: this .desc = desc;
069: }
070:
071: /**
072: * Constructs a new {@link AnnotationNode} to visit an array value.
073: *
074: * @param values where the visited values must be stored.
075: */
076: AnnotationNode(final List values) {
077: this .values = values;
078: }
079:
080: // ------------------------------------------------------------------------
081: // Implementation of the AnnotationVisitor interface
082: // ------------------------------------------------------------------------
083:
084: public void visit(final String name, final Object value) {
085: if (values == null) {
086: values = new ArrayList(this .desc != null ? 2 : 1);
087: }
088: if (this .desc != null) {
089: values.add(name);
090: }
091: values.add(value);
092: }
093:
094: public void visitEnum(final String name, final String desc,
095: final String value) {
096: if (values == null) {
097: values = new ArrayList(this .desc != null ? 2 : 1);
098: }
099: if (this .desc != null) {
100: values.add(name);
101: }
102: values.add(new String[] { desc, value });
103: }
104:
105: public AnnotationVisitor visitAnnotation(final String name,
106: final String desc) {
107: if (values == null) {
108: values = new ArrayList(this .desc != null ? 2 : 1);
109: }
110: if (this .desc != null) {
111: values.add(name);
112: }
113: AnnotationNode annotation = new AnnotationNode(desc);
114: values.add(annotation);
115: return annotation;
116: }
117:
118: public AnnotationVisitor visitArray(final String name) {
119: if (values == null) {
120: values = new ArrayList(this .desc != null ? 2 : 1);
121: }
122: if (this .desc != null) {
123: values.add(name);
124: }
125: List array = new ArrayList();
126: values.add(array);
127: return new AnnotationNode(array);
128: }
129:
130: public void visitEnd() {
131: }
132:
133: // ------------------------------------------------------------------------
134: // Accept methods
135: // ------------------------------------------------------------------------
136:
137: /**
138: * Makes the given visitor visit this annotation.
139: *
140: * @param av an annotation visitor.
141: */
142: public void accept(final AnnotationVisitor av) {
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: * Makes the given visitor visit a given annotation value.
155: *
156: * @param av an annotation visitor.
157: * @param name the value name.
158: * @param value the actual value.
159: */
160: static void accept(final AnnotationVisitor av, final String name,
161: final Object value) {
162: if (value instanceof String[]) {
163: String[] typeconst = (String[]) value;
164: av.visitEnum(name, typeconst[0], typeconst[1]);
165: } else if (value instanceof AnnotationNode) {
166: AnnotationNode an = (AnnotationNode) value;
167: an.accept(av.visitAnnotation(name, an.desc));
168: } else if (value instanceof List) {
169: AnnotationVisitor v = av.visitArray(name);
170: List array = (List) value;
171: for (int j = 0; j < array.size(); ++j) {
172: accept(v, null, array.get(j));
173: }
174: v.visitEnd();
175: } else {
176: av.visit(name, value);
177: }
178: }
179: }
|