Wed, 02 Jun 2010 19:08:47 -0700
6933147: Provided new utility visitors supporting SourceVersion.RELEASE_7
Reviewed-by: jjg
1 /*
2 * Copyright (c) 2002, 2008, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
26 package com.sun.tools.javah;
28 import java.io.OutputStream;
29 import java.io.PrintWriter;
30 import java.util.ArrayList;
31 import java.util.List;
32 import javax.lang.model.element.Element;
33 import javax.lang.model.element.ExecutableElement;
34 import javax.lang.model.element.Modifier;
35 import javax.lang.model.element.TypeElement;
36 import javax.lang.model.element.VariableElement;
37 import javax.lang.model.type.ArrayType;
38 import javax.lang.model.type.TypeMirror;
39 import javax.lang.model.util.ElementFilter;
42 /**
43 * Header file generator for JNI.
44 *
45 * <p><b>This is NOT part of any API supported by Sun Microsystems.
46 * If you write code that depends on this, you do so at your own
47 * risk. This code and its internal interfaces are subject to change
48 * or deletion without notice.</b></p>
49 *
50 * @author Sucheta Dambalkar(Revised)
51 */
52 public class JNI extends Gen {
53 JNI(Util util) {
54 super(util);
55 }
57 public String getIncludes() {
58 return "#include <jni.h>";
59 }
61 public void write(OutputStream o, TypeElement clazz) throws Util.Exit {
62 String cname = mangler.mangle(clazz.getQualifiedName(), Mangle.Type.CLASS);
63 PrintWriter pw = wrapWriter(o);
64 pw.println(guardBegin(cname));
65 pw.println(cppGuardBegin());
67 /* Write statics. */
68 List<VariableElement> classfields = getAllFields(clazz);
70 for (VariableElement v: classfields) {
71 if (!v.getModifiers().contains(Modifier.STATIC))
72 continue;
73 String s = null;
74 s = defineForStatic(clazz, v);
75 if (s != null) {
76 pw.println(s);
77 }
78 }
80 /* Write methods. */
81 List<ExecutableElement> classmethods = ElementFilter.methodsIn(clazz.getEnclosedElements());
82 for (ExecutableElement md: classmethods) {
83 if(md.getModifiers().contains(Modifier.NATIVE)){
84 TypeMirror mtr = types.erasure(md.getReturnType());
85 String sig = signature(md);
86 TypeSignature newtypesig = new TypeSignature(elems);
87 CharSequence methodName = md.getSimpleName();
88 boolean longName = false;
89 for (ExecutableElement md2: classmethods) {
90 if ((md2 != md)
91 && (methodName.equals(md2.getSimpleName()))
92 && (md2.getModifiers().contains(Modifier.NATIVE)))
93 longName = true;
95 }
96 pw.println("/*");
97 pw.println(" * Class: " + cname);
98 pw.println(" * Method: " +
99 mangler.mangle(methodName, Mangle.Type.FIELDSTUB));
100 pw.println(" * Signature: " + newtypesig.getTypeSignature(sig, mtr));
101 pw.println(" */");
102 pw.println("JNIEXPORT " + jniType(mtr) +
103 " JNICALL " +
104 mangler.mangleMethod(md, clazz,
105 (longName) ?
106 Mangle.Type.METHOD_JNI_LONG :
107 Mangle.Type.METHOD_JNI_SHORT));
108 pw.print(" (JNIEnv *, ");
109 List<? extends VariableElement> paramargs = md.getParameters();
110 List<TypeMirror> args = new ArrayList<TypeMirror>();
111 for (VariableElement p: paramargs) {
112 args.add(types.erasure(p.asType()));
113 }
114 if (md.getModifiers().contains(Modifier.STATIC))
115 pw.print("jclass");
116 else
117 pw.print("jobject");
119 for (TypeMirror arg: args) {
120 pw.print(", ");
121 pw.print(jniType(arg));
122 }
123 pw.println(");" + lineSep);
124 }
125 }
126 pw.println(cppGuardEnd());
127 pw.println(guardEnd(cname));
128 }
131 protected final String jniType(TypeMirror t) throws Util.Exit {
132 TypeElement throwable = elems.getTypeElement("java.lang.Throwable");
133 TypeElement jClass = elems.getTypeElement("java.lang.Class");
134 TypeElement jString = elems.getTypeElement("java.lang.String");
135 Element tclassDoc = types.asElement(t);
138 switch (t.getKind()) {
139 case ARRAY: {
140 TypeMirror ct = ((ArrayType) t).getComponentType();
141 switch (ct.getKind()) {
142 case BOOLEAN: return "jbooleanArray";
143 case BYTE: return "jbyteArray";
144 case CHAR: return "jcharArray";
145 case SHORT: return "jshortArray";
146 case INT: return "jintArray";
147 case LONG: return "jlongArray";
148 case FLOAT: return "jfloatArray";
149 case DOUBLE: return "jdoubleArray";
150 case ARRAY:
151 case DECLARED: return "jobjectArray";
152 default: throw new Error(ct.toString());
153 }
154 }
156 case VOID: return "void";
157 case BOOLEAN: return "jboolean";
158 case BYTE: return "jbyte";
159 case CHAR: return "jchar";
160 case SHORT: return "jshort";
161 case INT: return "jint";
162 case LONG: return "jlong";
163 case FLOAT: return "jfloat";
164 case DOUBLE: return "jdouble";
166 case DECLARED: {
167 if (tclassDoc.equals(jString))
168 return "jstring";
169 else if (types.isAssignable(t, throwable.asType()))
170 return "jthrowable";
171 else if (types.isAssignable(t, jClass.asType()))
172 return "jclass";
173 else
174 return "jobject";
175 }
176 }
178 util.bug("jni.unknown.type");
179 return null; /* dead code. */
180 }
181 }