jaroslav@56
|
1 |
/*
|
jaroslav@56
|
2 |
* Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
|
jaroslav@56
|
3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
jaroslav@56
|
4 |
*
|
jaroslav@56
|
5 |
* This code is free software; you can redistribute it and/or modify it
|
jaroslav@56
|
6 |
* under the terms of the GNU General Public License version 2 only, as
|
jaroslav@56
|
7 |
* published by the Free Software Foundation. Oracle designates this
|
jaroslav@56
|
8 |
* particular file as subject to the "Classpath" exception as provided
|
jaroslav@56
|
9 |
* by Oracle in the LICENSE file that accompanied this code.
|
jaroslav@56
|
10 |
*
|
jaroslav@56
|
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT
|
jaroslav@56
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
jaroslav@56
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
jaroslav@56
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that
|
jaroslav@56
|
15 |
* accompanied this code).
|
jaroslav@56
|
16 |
*
|
jaroslav@56
|
17 |
* You should have received a copy of the GNU General Public License version
|
jaroslav@56
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation,
|
jaroslav@56
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
jaroslav@56
|
20 |
*
|
jaroslav@56
|
21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
jaroslav@56
|
22 |
* or visit www.oracle.com if you need additional information or have any
|
jaroslav@56
|
23 |
* questions.
|
jaroslav@56
|
24 |
*/
|
jaroslav@56
|
25 |
|
jaroslav@56
|
26 |
package java.lang;
|
jaroslav@56
|
27 |
|
jaroslav@266
|
28 |
import org.apidesign.bck2brwsr.emul.AnnotationImpl;
|
jaroslav@122
|
29 |
import java.io.InputStream;
|
jaroslav@56
|
30 |
import java.lang.annotation.Annotation;
|
jaroslav@261
|
31 |
import java.lang.reflect.Field;
|
jaroslav@261
|
32 |
import java.lang.reflect.Method;
|
jaroslav@260
|
33 |
import java.lang.reflect.TypeVariable;
|
jaroslav@225
|
34 |
import org.apidesign.bck2brwsr.core.JavaScriptBody;
|
jaroslav@391
|
35 |
import org.apidesign.bck2brwsr.emul.MethodImpl;
|
jaroslav@56
|
36 |
|
jaroslav@56
|
37 |
/**
|
jaroslav@56
|
38 |
* Instances of the class {@code Class} represent classes and
|
jaroslav@56
|
39 |
* interfaces in a running Java application. An enum is a kind of
|
jaroslav@56
|
40 |
* class and an annotation is a kind of interface. Every array also
|
jaroslav@56
|
41 |
* belongs to a class that is reflected as a {@code Class} object
|
jaroslav@56
|
42 |
* that is shared by all arrays with the same element type and number
|
jaroslav@56
|
43 |
* of dimensions. The primitive Java types ({@code boolean},
|
jaroslav@56
|
44 |
* {@code byte}, {@code char}, {@code short},
|
jaroslav@56
|
45 |
* {@code int}, {@code long}, {@code float}, and
|
jaroslav@56
|
46 |
* {@code double}), and the keyword {@code void} are also
|
jaroslav@56
|
47 |
* represented as {@code Class} objects.
|
jaroslav@56
|
48 |
*
|
jaroslav@56
|
49 |
* <p> {@code Class} has no public constructor. Instead {@code Class}
|
jaroslav@56
|
50 |
* objects are constructed automatically by the Java Virtual Machine as classes
|
jaroslav@56
|
51 |
* are loaded and by calls to the {@code defineClass} method in the class
|
jaroslav@56
|
52 |
* loader.
|
jaroslav@56
|
53 |
*
|
jaroslav@56
|
54 |
* <p> The following example uses a {@code Class} object to print the
|
jaroslav@56
|
55 |
* class name of an object:
|
jaroslav@56
|
56 |
*
|
jaroslav@56
|
57 |
* <p> <blockquote><pre>
|
jaroslav@56
|
58 |
* void printClassName(Object obj) {
|
jaroslav@56
|
59 |
* System.out.println("The class of " + obj +
|
jaroslav@56
|
60 |
* " is " + obj.getClass().getName());
|
jaroslav@56
|
61 |
* }
|
jaroslav@56
|
62 |
* </pre></blockquote>
|
jaroslav@56
|
63 |
*
|
jaroslav@56
|
64 |
* <p> It is also possible to get the {@code Class} object for a named
|
jaroslav@56
|
65 |
* type (or for void) using a class literal. See Section 15.8.2 of
|
jaroslav@56
|
66 |
* <cite>The Java™ Language Specification</cite>.
|
jaroslav@56
|
67 |
* For example:
|
jaroslav@56
|
68 |
*
|
jaroslav@56
|
69 |
* <p> <blockquote>
|
jaroslav@56
|
70 |
* {@code System.out.println("The name of class Foo is: "+Foo.class.getName());}
|
jaroslav@56
|
71 |
* </blockquote>
|
jaroslav@56
|
72 |
*
|
jaroslav@56
|
73 |
* @param <T> the type of the class modeled by this {@code Class}
|
jaroslav@56
|
74 |
* object. For example, the type of {@code String.class} is {@code
|
jaroslav@56
|
75 |
* Class<String>}. Use {@code Class<?>} if the class being modeled is
|
jaroslav@56
|
76 |
* unknown.
|
jaroslav@56
|
77 |
*
|
jaroslav@56
|
78 |
* @author unascribed
|
jaroslav@56
|
79 |
* @see java.lang.ClassLoader#defineClass(byte[], int, int)
|
jaroslav@56
|
80 |
* @since JDK1.0
|
jaroslav@56
|
81 |
*/
|
jaroslav@56
|
82 |
public final
|
jaroslav@260
|
83 |
class Class<T> implements java.io.Serializable,
|
jaroslav@260
|
84 |
java.lang.reflect.GenericDeclaration,
|
jaroslav@260
|
85 |
java.lang.reflect.Type,
|
jaroslav@260
|
86 |
java.lang.reflect.AnnotatedElement {
|
jaroslav@56
|
87 |
private static final int ANNOTATION= 0x00002000;
|
jaroslav@56
|
88 |
private static final int ENUM = 0x00004000;
|
jaroslav@56
|
89 |
private static final int SYNTHETIC = 0x00001000;
|
jaroslav@56
|
90 |
|
jaroslav@56
|
91 |
/*
|
jaroslav@56
|
92 |
* Constructor. Only the Java Virtual Machine creates Class
|
jaroslav@56
|
93 |
* objects.
|
jaroslav@56
|
94 |
*/
|
jaroslav@56
|
95 |
private Class() {}
|
jaroslav@56
|
96 |
|
jaroslav@56
|
97 |
|
jaroslav@56
|
98 |
/**
|
jaroslav@56
|
99 |
* Converts the object to a string. The string representation is the
|
jaroslav@56
|
100 |
* string "class" or "interface", followed by a space, and then by the
|
jaroslav@56
|
101 |
* fully qualified name of the class in the format returned by
|
jaroslav@56
|
102 |
* {@code getName}. If this {@code Class} object represents a
|
jaroslav@56
|
103 |
* primitive type, this method returns the name of the primitive type. If
|
jaroslav@56
|
104 |
* this {@code Class} object represents void this method returns
|
jaroslav@56
|
105 |
* "void".
|
jaroslav@56
|
106 |
*
|
jaroslav@56
|
107 |
* @return a string representation of this class object.
|
jaroslav@56
|
108 |
*/
|
jaroslav@56
|
109 |
public String toString() {
|
jaroslav@56
|
110 |
return (isInterface() ? "interface " : (isPrimitive() ? "" : "class "))
|
jaroslav@56
|
111 |
+ getName();
|
jaroslav@56
|
112 |
}
|
jaroslav@56
|
113 |
|
jaroslav@56
|
114 |
|
jaroslav@56
|
115 |
/**
|
jaroslav@56
|
116 |
* Returns the {@code Class} object associated with the class or
|
jaroslav@56
|
117 |
* interface with the given string name. Invoking this method is
|
jaroslav@56
|
118 |
* equivalent to:
|
jaroslav@56
|
119 |
*
|
jaroslav@56
|
120 |
* <blockquote>
|
jaroslav@56
|
121 |
* {@code Class.forName(className, true, currentLoader)}
|
jaroslav@56
|
122 |
* </blockquote>
|
jaroslav@56
|
123 |
*
|
jaroslav@56
|
124 |
* where {@code currentLoader} denotes the defining class loader of
|
jaroslav@56
|
125 |
* the current class.
|
jaroslav@56
|
126 |
*
|
jaroslav@56
|
127 |
* <p> For example, the following code fragment returns the
|
jaroslav@56
|
128 |
* runtime {@code Class} descriptor for the class named
|
jaroslav@56
|
129 |
* {@code java.lang.Thread}:
|
jaroslav@56
|
130 |
*
|
jaroslav@56
|
131 |
* <blockquote>
|
jaroslav@56
|
132 |
* {@code Class t = Class.forName("java.lang.Thread")}
|
jaroslav@56
|
133 |
* </blockquote>
|
jaroslav@56
|
134 |
* <p>
|
jaroslav@56
|
135 |
* A call to {@code forName("X")} causes the class named
|
jaroslav@56
|
136 |
* {@code X} to be initialized.
|
jaroslav@56
|
137 |
*
|
jaroslav@56
|
138 |
* @param className the fully qualified name of the desired class.
|
jaroslav@56
|
139 |
* @return the {@code Class} object for the class with the
|
jaroslav@56
|
140 |
* specified name.
|
jaroslav@56
|
141 |
* @exception LinkageError if the linkage fails
|
jaroslav@56
|
142 |
* @exception ExceptionInInitializerError if the initialization provoked
|
jaroslav@56
|
143 |
* by this method fails
|
jaroslav@56
|
144 |
* @exception ClassNotFoundException if the class cannot be located
|
jaroslav@56
|
145 |
*/
|
jaroslav@56
|
146 |
public static Class<?> forName(String className)
|
jaroslav@56
|
147 |
throws ClassNotFoundException {
|
jaroslav@322
|
148 |
Class<?> c = loadCls(className, className.replace('.', '_'));
|
jaroslav@321
|
149 |
if (c == null) {
|
jaroslav@400
|
150 |
throw new ClassNotFoundException(className);
|
jaroslav@321
|
151 |
}
|
jaroslav@321
|
152 |
return c;
|
jaroslav@56
|
153 |
}
|
jaroslav@321
|
154 |
|
jaroslav@322
|
155 |
@JavaScriptBody(args = {"n", "c" }, body =
|
jaroslav@322
|
156 |
"if (vm[c]) return vm[c].$class;\n"
|
jaroslav@322
|
157 |
+ "if (vm.loadClass) {\n"
|
jaroslav@322
|
158 |
+ " vm.loadClass(n);\n"
|
jaroslav@322
|
159 |
+ " if (vm[c]) return vm[c].$class;\n"
|
jaroslav@322
|
160 |
+ "}\n"
|
jaroslav@322
|
161 |
+ "return null;"
|
jaroslav@321
|
162 |
)
|
jaroslav@322
|
163 |
private static native Class<?> loadCls(String n, String c);
|
jaroslav@56
|
164 |
|
jaroslav@56
|
165 |
|
jaroslav@56
|
166 |
/**
|
jaroslav@56
|
167 |
* Creates a new instance of the class represented by this {@code Class}
|
jaroslav@56
|
168 |
* object. The class is instantiated as if by a {@code new}
|
jaroslav@56
|
169 |
* expression with an empty argument list. The class is initialized if it
|
jaroslav@56
|
170 |
* has not already been initialized.
|
jaroslav@56
|
171 |
*
|
jaroslav@56
|
172 |
* <p>Note that this method propagates any exception thrown by the
|
jaroslav@56
|
173 |
* nullary constructor, including a checked exception. Use of
|
jaroslav@56
|
174 |
* this method effectively bypasses the compile-time exception
|
jaroslav@56
|
175 |
* checking that would otherwise be performed by the compiler.
|
jaroslav@56
|
176 |
* The {@link
|
jaroslav@56
|
177 |
* java.lang.reflect.Constructor#newInstance(java.lang.Object...)
|
jaroslav@56
|
178 |
* Constructor.newInstance} method avoids this problem by wrapping
|
jaroslav@56
|
179 |
* any exception thrown by the constructor in a (checked) {@link
|
jaroslav@56
|
180 |
* java.lang.reflect.InvocationTargetException}.
|
jaroslav@56
|
181 |
*
|
jaroslav@56
|
182 |
* @return a newly allocated instance of the class represented by this
|
jaroslav@56
|
183 |
* object.
|
jaroslav@56
|
184 |
* @exception IllegalAccessException if the class or its nullary
|
jaroslav@56
|
185 |
* constructor is not accessible.
|
jaroslav@56
|
186 |
* @exception InstantiationException
|
jaroslav@56
|
187 |
* if this {@code Class} represents an abstract class,
|
jaroslav@56
|
188 |
* an interface, an array class, a primitive type, or void;
|
jaroslav@56
|
189 |
* or if the class has no nullary constructor;
|
jaroslav@56
|
190 |
* or if the instantiation fails for some other reason.
|
jaroslav@56
|
191 |
* @exception ExceptionInInitializerError if the initialization
|
jaroslav@56
|
192 |
* provoked by this method fails.
|
jaroslav@56
|
193 |
* @exception SecurityException
|
jaroslav@56
|
194 |
* If a security manager, <i>s</i>, is present and any of the
|
jaroslav@56
|
195 |
* following conditions is met:
|
jaroslav@56
|
196 |
*
|
jaroslav@56
|
197 |
* <ul>
|
jaroslav@56
|
198 |
*
|
jaroslav@56
|
199 |
* <li> invocation of
|
jaroslav@56
|
200 |
* {@link SecurityManager#checkMemberAccess
|
jaroslav@56
|
201 |
* s.checkMemberAccess(this, Member.PUBLIC)} denies
|
jaroslav@56
|
202 |
* creation of new instances of this class
|
jaroslav@56
|
203 |
*
|
jaroslav@56
|
204 |
* <li> the caller's class loader is not the same as or an
|
jaroslav@56
|
205 |
* ancestor of the class loader for the current class and
|
jaroslav@56
|
206 |
* invocation of {@link SecurityManager#checkPackageAccess
|
jaroslav@56
|
207 |
* s.checkPackageAccess()} denies access to the package
|
jaroslav@56
|
208 |
* of this class
|
jaroslav@56
|
209 |
*
|
jaroslav@56
|
210 |
* </ul>
|
jaroslav@56
|
211 |
*
|
jaroslav@56
|
212 |
*/
|
jaroslav@397
|
213 |
@JavaScriptBody(args = { "self", "illegal" }, body =
|
jaroslav@397
|
214 |
"\nvar c = self.cnstr;"
|
jaroslav@397
|
215 |
+ "\nif (c['cons__V']) {"
|
jaroslav@397
|
216 |
+ "\n if ((c.cons__V.access & 0x1) != 0) {"
|
jaroslav@397
|
217 |
+ "\n var inst = c();"
|
jaroslav@397
|
218 |
+ "\n c.cons__V(inst);"
|
jaroslav@397
|
219 |
+ "\n return inst;"
|
jaroslav@397
|
220 |
+ "\n }"
|
jaroslav@397
|
221 |
+ "\n return illegal;"
|
jaroslav@397
|
222 |
+ "\n}"
|
jaroslav@397
|
223 |
+ "\nreturn null;"
|
jaroslav@231
|
224 |
)
|
jaroslav@397
|
225 |
private static native Object newInstance0(Class<?> self, Object illegal);
|
jaroslav@397
|
226 |
|
jaroslav@56
|
227 |
public T newInstance()
|
jaroslav@56
|
228 |
throws InstantiationException, IllegalAccessException
|
jaroslav@56
|
229 |
{
|
jaroslav@397
|
230 |
Object illegal = new Object();
|
jaroslav@397
|
231 |
Object inst = newInstance0(this, illegal);
|
jaroslav@397
|
232 |
if (inst == null) {
|
jaroslav@397
|
233 |
throw new InstantiationException(getName());
|
jaroslav@397
|
234 |
}
|
jaroslav@397
|
235 |
if (inst == illegal) {
|
jaroslav@397
|
236 |
throw new IllegalAccessException();
|
jaroslav@397
|
237 |
}
|
jaroslav@397
|
238 |
return (T)inst;
|
jaroslav@56
|
239 |
}
|
jaroslav@56
|
240 |
|
jaroslav@56
|
241 |
/**
|
jaroslav@56
|
242 |
* Determines if the specified {@code Object} is assignment-compatible
|
jaroslav@56
|
243 |
* with the object represented by this {@code Class}. This method is
|
jaroslav@56
|
244 |
* the dynamic equivalent of the Java language {@code instanceof}
|
jaroslav@56
|
245 |
* operator. The method returns {@code true} if the specified
|
jaroslav@56
|
246 |
* {@code Object} argument is non-null and can be cast to the
|
jaroslav@56
|
247 |
* reference type represented by this {@code Class} object without
|
jaroslav@56
|
248 |
* raising a {@code ClassCastException.} It returns {@code false}
|
jaroslav@56
|
249 |
* otherwise.
|
jaroslav@56
|
250 |
*
|
jaroslav@56
|
251 |
* <p> Specifically, if this {@code Class} object represents a
|
jaroslav@56
|
252 |
* declared class, this method returns {@code true} if the specified
|
jaroslav@56
|
253 |
* {@code Object} argument is an instance of the represented class (or
|
jaroslav@56
|
254 |
* of any of its subclasses); it returns {@code false} otherwise. If
|
jaroslav@56
|
255 |
* this {@code Class} object represents an array class, this method
|
jaroslav@56
|
256 |
* returns {@code true} if the specified {@code Object} argument
|
jaroslav@56
|
257 |
* can be converted to an object of the array class by an identity
|
jaroslav@56
|
258 |
* conversion or by a widening reference conversion; it returns
|
jaroslav@56
|
259 |
* {@code false} otherwise. If this {@code Class} object
|
jaroslav@56
|
260 |
* represents an interface, this method returns {@code true} if the
|
jaroslav@56
|
261 |
* class or any superclass of the specified {@code Object} argument
|
jaroslav@56
|
262 |
* implements this interface; it returns {@code false} otherwise. If
|
jaroslav@56
|
263 |
* this {@code Class} object represents a primitive type, this method
|
jaroslav@56
|
264 |
* returns {@code false}.
|
jaroslav@56
|
265 |
*
|
jaroslav@56
|
266 |
* @param obj the object to check
|
jaroslav@56
|
267 |
* @return true if {@code obj} is an instance of this class
|
jaroslav@56
|
268 |
*
|
jaroslav@56
|
269 |
* @since JDK1.1
|
jaroslav@56
|
270 |
*/
|
jaroslav@56
|
271 |
public native boolean isInstance(Object obj);
|
jaroslav@56
|
272 |
|
jaroslav@56
|
273 |
|
jaroslav@56
|
274 |
/**
|
jaroslav@56
|
275 |
* Determines if the class or interface represented by this
|
jaroslav@56
|
276 |
* {@code Class} object is either the same as, or is a superclass or
|
jaroslav@56
|
277 |
* superinterface of, the class or interface represented by the specified
|
jaroslav@56
|
278 |
* {@code Class} parameter. It returns {@code true} if so;
|
jaroslav@56
|
279 |
* otherwise it returns {@code false}. If this {@code Class}
|
jaroslav@56
|
280 |
* object represents a primitive type, this method returns
|
jaroslav@56
|
281 |
* {@code true} if the specified {@code Class} parameter is
|
jaroslav@56
|
282 |
* exactly this {@code Class} object; otherwise it returns
|
jaroslav@56
|
283 |
* {@code false}.
|
jaroslav@56
|
284 |
*
|
jaroslav@56
|
285 |
* <p> Specifically, this method tests whether the type represented by the
|
jaroslav@56
|
286 |
* specified {@code Class} parameter can be converted to the type
|
jaroslav@56
|
287 |
* represented by this {@code Class} object via an identity conversion
|
jaroslav@56
|
288 |
* or via a widening reference conversion. See <em>The Java Language
|
jaroslav@56
|
289 |
* Specification</em>, sections 5.1.1 and 5.1.4 , for details.
|
jaroslav@56
|
290 |
*
|
jaroslav@56
|
291 |
* @param cls the {@code Class} object to be checked
|
jaroslav@56
|
292 |
* @return the {@code boolean} value indicating whether objects of the
|
jaroslav@56
|
293 |
* type {@code cls} can be assigned to objects of this class
|
jaroslav@56
|
294 |
* @exception NullPointerException if the specified Class parameter is
|
jaroslav@56
|
295 |
* null.
|
jaroslav@56
|
296 |
* @since JDK1.1
|
jaroslav@56
|
297 |
*/
|
jaroslav@56
|
298 |
public native boolean isAssignableFrom(Class<?> cls);
|
jaroslav@56
|
299 |
|
jaroslav@56
|
300 |
|
jaroslav@56
|
301 |
/**
|
jaroslav@56
|
302 |
* Determines if the specified {@code Class} object represents an
|
jaroslav@56
|
303 |
* interface type.
|
jaroslav@56
|
304 |
*
|
jaroslav@56
|
305 |
* @return {@code true} if this object represents an interface;
|
jaroslav@56
|
306 |
* {@code false} otherwise.
|
jaroslav@56
|
307 |
*/
|
jaroslav@355
|
308 |
public boolean isInterface() {
|
jaroslav@355
|
309 |
return (getAccess() & 0x200) != 0;
|
jaroslav@355
|
310 |
}
|
jaroslav@355
|
311 |
|
jaroslav@355
|
312 |
@JavaScriptBody(args = "self", body = "return self.access;")
|
jaroslav@355
|
313 |
private native int getAccess();
|
jaroslav@56
|
314 |
|
jaroslav@56
|
315 |
|
jaroslav@56
|
316 |
/**
|
jaroslav@56
|
317 |
* Determines if this {@code Class} object represents an array class.
|
jaroslav@56
|
318 |
*
|
jaroslav@56
|
319 |
* @return {@code true} if this object represents an array class;
|
jaroslav@56
|
320 |
* {@code false} otherwise.
|
jaroslav@56
|
321 |
* @since JDK1.1
|
jaroslav@56
|
322 |
*/
|
jaroslav@228
|
323 |
public boolean isArray() {
|
jaroslav@228
|
324 |
return false;
|
jaroslav@228
|
325 |
}
|
jaroslav@56
|
326 |
|
jaroslav@56
|
327 |
|
jaroslav@56
|
328 |
/**
|
jaroslav@56
|
329 |
* Determines if the specified {@code Class} object represents a
|
jaroslav@56
|
330 |
* primitive type.
|
jaroslav@56
|
331 |
*
|
jaroslav@56
|
332 |
* <p> There are nine predefined {@code Class} objects to represent
|
jaroslav@56
|
333 |
* the eight primitive types and void. These are created by the Java
|
jaroslav@56
|
334 |
* Virtual Machine, and have the same names as the primitive types that
|
jaroslav@56
|
335 |
* they represent, namely {@code boolean}, {@code byte},
|
jaroslav@56
|
336 |
* {@code char}, {@code short}, {@code int},
|
jaroslav@56
|
337 |
* {@code long}, {@code float}, and {@code double}.
|
jaroslav@56
|
338 |
*
|
jaroslav@56
|
339 |
* <p> These objects may only be accessed via the following public static
|
jaroslav@56
|
340 |
* final variables, and are the only {@code Class} objects for which
|
jaroslav@56
|
341 |
* this method returns {@code true}.
|
jaroslav@56
|
342 |
*
|
jaroslav@56
|
343 |
* @return true if and only if this class represents a primitive type
|
jaroslav@56
|
344 |
*
|
jaroslav@56
|
345 |
* @see java.lang.Boolean#TYPE
|
jaroslav@56
|
346 |
* @see java.lang.Character#TYPE
|
jaroslav@56
|
347 |
* @see java.lang.Byte#TYPE
|
jaroslav@56
|
348 |
* @see java.lang.Short#TYPE
|
jaroslav@56
|
349 |
* @see java.lang.Integer#TYPE
|
jaroslav@56
|
350 |
* @see java.lang.Long#TYPE
|
jaroslav@56
|
351 |
* @see java.lang.Float#TYPE
|
jaroslav@56
|
352 |
* @see java.lang.Double#TYPE
|
jaroslav@56
|
353 |
* @see java.lang.Void#TYPE
|
jaroslav@56
|
354 |
* @since JDK1.1
|
jaroslav@56
|
355 |
*/
|
jaroslav@354
|
356 |
@JavaScriptBody(args = "self", body =
|
jaroslav@354
|
357 |
"if (self.primitive) return true;"
|
jaroslav@354
|
358 |
+ "else return false;"
|
jaroslav@354
|
359 |
)
|
jaroslav@56
|
360 |
public native boolean isPrimitive();
|
jaroslav@56
|
361 |
|
jaroslav@56
|
362 |
/**
|
jaroslav@56
|
363 |
* Returns true if this {@code Class} object represents an annotation
|
jaroslav@56
|
364 |
* type. Note that if this method returns true, {@link #isInterface()}
|
jaroslav@56
|
365 |
* would also return true, as all annotation types are also interfaces.
|
jaroslav@56
|
366 |
*
|
jaroslav@56
|
367 |
* @return {@code true} if this class object represents an annotation
|
jaroslav@56
|
368 |
* type; {@code false} otherwise
|
jaroslav@56
|
369 |
* @since 1.5
|
jaroslav@56
|
370 |
*/
|
jaroslav@56
|
371 |
public boolean isAnnotation() {
|
jaroslav@56
|
372 |
return (getModifiers() & ANNOTATION) != 0;
|
jaroslav@56
|
373 |
}
|
jaroslav@56
|
374 |
|
jaroslav@56
|
375 |
/**
|
jaroslav@56
|
376 |
* Returns {@code true} if this class is a synthetic class;
|
jaroslav@56
|
377 |
* returns {@code false} otherwise.
|
jaroslav@56
|
378 |
* @return {@code true} if and only if this class is a synthetic class as
|
jaroslav@56
|
379 |
* defined by the Java Language Specification.
|
jaroslav@56
|
380 |
* @since 1.5
|
jaroslav@56
|
381 |
*/
|
jaroslav@56
|
382 |
public boolean isSynthetic() {
|
jaroslav@56
|
383 |
return (getModifiers() & SYNTHETIC) != 0;
|
jaroslav@56
|
384 |
}
|
jaroslav@56
|
385 |
|
jaroslav@56
|
386 |
/**
|
jaroslav@56
|
387 |
* Returns the name of the entity (class, interface, array class,
|
jaroslav@56
|
388 |
* primitive type, or void) represented by this {@code Class} object,
|
jaroslav@56
|
389 |
* as a {@code String}.
|
jaroslav@56
|
390 |
*
|
jaroslav@56
|
391 |
* <p> If this class object represents a reference type that is not an
|
jaroslav@56
|
392 |
* array type then the binary name of the class is returned, as specified
|
jaroslav@56
|
393 |
* by
|
jaroslav@56
|
394 |
* <cite>The Java™ Language Specification</cite>.
|
jaroslav@56
|
395 |
*
|
jaroslav@56
|
396 |
* <p> If this class object represents a primitive type or void, then the
|
jaroslav@56
|
397 |
* name returned is a {@code String} equal to the Java language
|
jaroslav@56
|
398 |
* keyword corresponding to the primitive type or void.
|
jaroslav@56
|
399 |
*
|
jaroslav@56
|
400 |
* <p> If this class object represents a class of arrays, then the internal
|
jaroslav@56
|
401 |
* form of the name consists of the name of the element type preceded by
|
jaroslav@56
|
402 |
* one or more '{@code [}' characters representing the depth of the array
|
jaroslav@56
|
403 |
* nesting. The encoding of element type names is as follows:
|
jaroslav@56
|
404 |
*
|
jaroslav@56
|
405 |
* <blockquote><table summary="Element types and encodings">
|
jaroslav@56
|
406 |
* <tr><th> Element Type <th> <th> Encoding
|
jaroslav@56
|
407 |
* <tr><td> boolean <td> <td align=center> Z
|
jaroslav@56
|
408 |
* <tr><td> byte <td> <td align=center> B
|
jaroslav@56
|
409 |
* <tr><td> char <td> <td align=center> C
|
jaroslav@56
|
410 |
* <tr><td> class or interface
|
jaroslav@56
|
411 |
* <td> <td align=center> L<i>classname</i>;
|
jaroslav@56
|
412 |
* <tr><td> double <td> <td align=center> D
|
jaroslav@56
|
413 |
* <tr><td> float <td> <td align=center> F
|
jaroslav@56
|
414 |
* <tr><td> int <td> <td align=center> I
|
jaroslav@56
|
415 |
* <tr><td> long <td> <td align=center> J
|
jaroslav@56
|
416 |
* <tr><td> short <td> <td align=center> S
|
jaroslav@56
|
417 |
* </table></blockquote>
|
jaroslav@56
|
418 |
*
|
jaroslav@56
|
419 |
* <p> The class or interface name <i>classname</i> is the binary name of
|
jaroslav@56
|
420 |
* the class specified above.
|
jaroslav@56
|
421 |
*
|
jaroslav@56
|
422 |
* <p> Examples:
|
jaroslav@56
|
423 |
* <blockquote><pre>
|
jaroslav@56
|
424 |
* String.class.getName()
|
jaroslav@56
|
425 |
* returns "java.lang.String"
|
jaroslav@56
|
426 |
* byte.class.getName()
|
jaroslav@56
|
427 |
* returns "byte"
|
jaroslav@56
|
428 |
* (new Object[3]).getClass().getName()
|
jaroslav@56
|
429 |
* returns "[Ljava.lang.Object;"
|
jaroslav@56
|
430 |
* (new int[3][4][5][6][7][8][9]).getClass().getName()
|
jaroslav@56
|
431 |
* returns "[[[[[[[I"
|
jaroslav@56
|
432 |
* </pre></blockquote>
|
jaroslav@56
|
433 |
*
|
jaroslav@56
|
434 |
* @return the name of the class or interface
|
jaroslav@56
|
435 |
* represented by this object.
|
jaroslav@56
|
436 |
*/
|
jaroslav@56
|
437 |
public String getName() {
|
jaroslav@225
|
438 |
return jvmName().replace('/', '.');
|
jaroslav@56
|
439 |
}
|
jaroslav@56
|
440 |
|
jaroslav@225
|
441 |
@JavaScriptBody(args = "self", body = "return self.jvmName;")
|
jaroslav@225
|
442 |
private native String jvmName();
|
jaroslav@225
|
443 |
|
jaroslav@260
|
444 |
|
jaroslav@260
|
445 |
/**
|
jaroslav@260
|
446 |
* Returns an array of {@code TypeVariable} objects that represent the
|
jaroslav@260
|
447 |
* type variables declared by the generic declaration represented by this
|
jaroslav@260
|
448 |
* {@code GenericDeclaration} object, in declaration order. Returns an
|
jaroslav@260
|
449 |
* array of length 0 if the underlying generic declaration declares no type
|
jaroslav@260
|
450 |
* variables.
|
jaroslav@260
|
451 |
*
|
jaroslav@260
|
452 |
* @return an array of {@code TypeVariable} objects that represent
|
jaroslav@260
|
453 |
* the type variables declared by this generic declaration
|
jaroslav@260
|
454 |
* @throws java.lang.reflect.GenericSignatureFormatError if the generic
|
jaroslav@260
|
455 |
* signature of this generic declaration does not conform to
|
jaroslav@260
|
456 |
* the format specified in
|
jaroslav@260
|
457 |
* <cite>The Java™ Virtual Machine Specification</cite>
|
jaroslav@260
|
458 |
* @since 1.5
|
jaroslav@260
|
459 |
*/
|
jaroslav@260
|
460 |
public TypeVariable<Class<T>>[] getTypeParameters() {
|
jaroslav@260
|
461 |
throw new UnsupportedOperationException();
|
jaroslav@260
|
462 |
}
|
jaroslav@260
|
463 |
|
jaroslav@56
|
464 |
/**
|
jaroslav@56
|
465 |
* Returns the {@code Class} representing the superclass of the entity
|
jaroslav@56
|
466 |
* (class, interface, primitive type or void) represented by this
|
jaroslav@56
|
467 |
* {@code Class}. If this {@code Class} represents either the
|
jaroslav@56
|
468 |
* {@code Object} class, an interface, a primitive type, or void, then
|
jaroslav@56
|
469 |
* null is returned. If this object represents an array class then the
|
jaroslav@56
|
470 |
* {@code Class} object representing the {@code Object} class is
|
jaroslav@56
|
471 |
* returned.
|
jaroslav@56
|
472 |
*
|
jaroslav@56
|
473 |
* @return the superclass of the class represented by this object.
|
jaroslav@56
|
474 |
*/
|
jaroslav@230
|
475 |
@JavaScriptBody(args = "self", body = "return self.superclass;")
|
jaroslav@56
|
476 |
public native Class<? super T> getSuperclass();
|
jaroslav@56
|
477 |
|
jaroslav@56
|
478 |
/**
|
jaroslav@56
|
479 |
* Returns the Java language modifiers for this class or interface, encoded
|
jaroslav@56
|
480 |
* in an integer. The modifiers consist of the Java Virtual Machine's
|
jaroslav@56
|
481 |
* constants for {@code public}, {@code protected},
|
jaroslav@56
|
482 |
* {@code private}, {@code final}, {@code static},
|
jaroslav@56
|
483 |
* {@code abstract} and {@code interface}; they should be decoded
|
jaroslav@56
|
484 |
* using the methods of class {@code Modifier}.
|
jaroslav@56
|
485 |
*
|
jaroslav@56
|
486 |
* <p> If the underlying class is an array class, then its
|
jaroslav@56
|
487 |
* {@code public}, {@code private} and {@code protected}
|
jaroslav@56
|
488 |
* modifiers are the same as those of its component type. If this
|
jaroslav@56
|
489 |
* {@code Class} represents a primitive type or void, its
|
jaroslav@56
|
490 |
* {@code public} modifier is always {@code true}, and its
|
jaroslav@56
|
491 |
* {@code protected} and {@code private} modifiers are always
|
jaroslav@56
|
492 |
* {@code false}. If this object represents an array class, a
|
jaroslav@56
|
493 |
* primitive type or void, then its {@code final} modifier is always
|
jaroslav@56
|
494 |
* {@code true} and its interface modifier is always
|
jaroslav@56
|
495 |
* {@code false}. The values of its other modifiers are not determined
|
jaroslav@56
|
496 |
* by this specification.
|
jaroslav@56
|
497 |
*
|
jaroslav@56
|
498 |
* <p> The modifier encodings are defined in <em>The Java Virtual Machine
|
jaroslav@56
|
499 |
* Specification</em>, table 4.1.
|
jaroslav@56
|
500 |
*
|
jaroslav@56
|
501 |
* @return the {@code int} representing the modifiers for this class
|
jaroslav@56
|
502 |
* @see java.lang.reflect.Modifier
|
jaroslav@56
|
503 |
* @since JDK1.1
|
jaroslav@56
|
504 |
*/
|
jaroslav@56
|
505 |
public native int getModifiers();
|
jaroslav@56
|
506 |
|
jaroslav@56
|
507 |
|
jaroslav@56
|
508 |
/**
|
jaroslav@56
|
509 |
* Returns the simple name of the underlying class as given in the
|
jaroslav@56
|
510 |
* source code. Returns an empty string if the underlying class is
|
jaroslav@56
|
511 |
* anonymous.
|
jaroslav@56
|
512 |
*
|
jaroslav@56
|
513 |
* <p>The simple name of an array is the simple name of the
|
jaroslav@56
|
514 |
* component type with "[]" appended. In particular the simple
|
jaroslav@56
|
515 |
* name of an array whose component type is anonymous is "[]".
|
jaroslav@56
|
516 |
*
|
jaroslav@56
|
517 |
* @return the simple name of the underlying class
|
jaroslav@56
|
518 |
* @since 1.5
|
jaroslav@56
|
519 |
*/
|
jaroslav@56
|
520 |
public String getSimpleName() {
|
jaroslav@229
|
521 |
if (isArray())
|
jaroslav@229
|
522 |
return getComponentType().getSimpleName()+"[]";
|
jaroslav@229
|
523 |
|
jaroslav@229
|
524 |
String simpleName = getSimpleBinaryName();
|
jaroslav@229
|
525 |
if (simpleName == null) { // top level class
|
jaroslav@229
|
526 |
simpleName = getName();
|
jaroslav@229
|
527 |
return simpleName.substring(simpleName.lastIndexOf(".")+1); // strip the package name
|
jaroslav@229
|
528 |
}
|
jaroslav@229
|
529 |
// According to JLS3 "Binary Compatibility" (13.1) the binary
|
jaroslav@229
|
530 |
// name of non-package classes (not top level) is the binary
|
jaroslav@229
|
531 |
// name of the immediately enclosing class followed by a '$' followed by:
|
jaroslav@229
|
532 |
// (for nested and inner classes): the simple name.
|
jaroslav@229
|
533 |
// (for local classes): 1 or more digits followed by the simple name.
|
jaroslav@229
|
534 |
// (for anonymous classes): 1 or more digits.
|
jaroslav@229
|
535 |
|
jaroslav@229
|
536 |
// Since getSimpleBinaryName() will strip the binary name of
|
jaroslav@229
|
537 |
// the immediatly enclosing class, we are now looking at a
|
jaroslav@229
|
538 |
// string that matches the regular expression "\$[0-9]*"
|
jaroslav@229
|
539 |
// followed by a simple name (considering the simple of an
|
jaroslav@229
|
540 |
// anonymous class to be the empty string).
|
jaroslav@229
|
541 |
|
jaroslav@229
|
542 |
// Remove leading "\$[0-9]*" from the name
|
jaroslav@229
|
543 |
int length = simpleName.length();
|
jaroslav@229
|
544 |
if (length < 1 || simpleName.charAt(0) != '$')
|
jaroslav@229
|
545 |
throw new IllegalStateException("Malformed class name");
|
jaroslav@229
|
546 |
int index = 1;
|
jaroslav@229
|
547 |
while (index < length && isAsciiDigit(simpleName.charAt(index)))
|
jaroslav@229
|
548 |
index++;
|
jaroslav@229
|
549 |
// Eventually, this is the empty string iff this is an anonymous class
|
jaroslav@229
|
550 |
return simpleName.substring(index);
|
jaroslav@56
|
551 |
}
|
jaroslav@56
|
552 |
|
jaroslav@56
|
553 |
/**
|
jaroslav@229
|
554 |
* Returns the "simple binary name" of the underlying class, i.e.,
|
jaroslav@229
|
555 |
* the binary name without the leading enclosing class name.
|
jaroslav@229
|
556 |
* Returns {@code null} if the underlying class is a top level
|
jaroslav@229
|
557 |
* class.
|
jaroslav@229
|
558 |
*/
|
jaroslav@229
|
559 |
private String getSimpleBinaryName() {
|
jaroslav@229
|
560 |
Class<?> enclosingClass = null; // XXX getEnclosingClass();
|
jaroslav@229
|
561 |
if (enclosingClass == null) // top level class
|
jaroslav@229
|
562 |
return null;
|
jaroslav@229
|
563 |
// Otherwise, strip the enclosing class' name
|
jaroslav@229
|
564 |
try {
|
jaroslav@229
|
565 |
return getName().substring(enclosingClass.getName().length());
|
jaroslav@229
|
566 |
} catch (IndexOutOfBoundsException ex) {
|
jaroslav@229
|
567 |
throw new IllegalStateException("Malformed class name");
|
jaroslav@229
|
568 |
}
|
jaroslav@229
|
569 |
}
|
jaroslav@261
|
570 |
|
jaroslav@261
|
571 |
/**
|
jaroslav@261
|
572 |
* Returns an array containing {@code Field} objects reflecting all
|
jaroslav@261
|
573 |
* the accessible public fields of the class or interface represented by
|
jaroslav@261
|
574 |
* this {@code Class} object. The elements in the array returned are
|
jaroslav@261
|
575 |
* not sorted and are not in any particular order. This method returns an
|
jaroslav@261
|
576 |
* array of length 0 if the class or interface has no accessible public
|
jaroslav@261
|
577 |
* fields, or if it represents an array class, a primitive type, or void.
|
jaroslav@261
|
578 |
*
|
jaroslav@261
|
579 |
* <p> Specifically, if this {@code Class} object represents a class,
|
jaroslav@261
|
580 |
* this method returns the public fields of this class and of all its
|
jaroslav@261
|
581 |
* superclasses. If this {@code Class} object represents an
|
jaroslav@261
|
582 |
* interface, this method returns the fields of this interface and of all
|
jaroslav@261
|
583 |
* its superinterfaces.
|
jaroslav@261
|
584 |
*
|
jaroslav@261
|
585 |
* <p> The implicit length field for array class is not reflected by this
|
jaroslav@261
|
586 |
* method. User code should use the methods of class {@code Array} to
|
jaroslav@261
|
587 |
* manipulate arrays.
|
jaroslav@261
|
588 |
*
|
jaroslav@261
|
589 |
* <p> See <em>The Java Language Specification</em>, sections 8.2 and 8.3.
|
jaroslav@261
|
590 |
*
|
jaroslav@261
|
591 |
* @return the array of {@code Field} objects representing the
|
jaroslav@261
|
592 |
* public fields
|
jaroslav@261
|
593 |
* @exception SecurityException
|
jaroslav@261
|
594 |
* If a security manager, <i>s</i>, is present and any of the
|
jaroslav@261
|
595 |
* following conditions is met:
|
jaroslav@261
|
596 |
*
|
jaroslav@261
|
597 |
* <ul>
|
jaroslav@261
|
598 |
*
|
jaroslav@261
|
599 |
* <li> invocation of
|
jaroslav@261
|
600 |
* {@link SecurityManager#checkMemberAccess
|
jaroslav@261
|
601 |
* s.checkMemberAccess(this, Member.PUBLIC)} denies
|
jaroslav@261
|
602 |
* access to the fields within this class
|
jaroslav@261
|
603 |
*
|
jaroslav@261
|
604 |
* <li> the caller's class loader is not the same as or an
|
jaroslav@261
|
605 |
* ancestor of the class loader for the current class and
|
jaroslav@261
|
606 |
* invocation of {@link SecurityManager#checkPackageAccess
|
jaroslav@261
|
607 |
* s.checkPackageAccess()} denies access to the package
|
jaroslav@261
|
608 |
* of this class
|
jaroslav@261
|
609 |
*
|
jaroslav@261
|
610 |
* </ul>
|
jaroslav@261
|
611 |
*
|
jaroslav@261
|
612 |
* @since JDK1.1
|
jaroslav@261
|
613 |
*/
|
jaroslav@261
|
614 |
public Field[] getFields() throws SecurityException {
|
jaroslav@261
|
615 |
throw new SecurityException();
|
jaroslav@261
|
616 |
}
|
jaroslav@261
|
617 |
|
jaroslav@261
|
618 |
/**
|
jaroslav@261
|
619 |
* Returns an array containing {@code Method} objects reflecting all
|
jaroslav@261
|
620 |
* the public <em>member</em> methods of the class or interface represented
|
jaroslav@261
|
621 |
* by this {@code Class} object, including those declared by the class
|
jaroslav@261
|
622 |
* or interface and those inherited from superclasses and
|
jaroslav@261
|
623 |
* superinterfaces. Array classes return all the (public) member methods
|
jaroslav@261
|
624 |
* inherited from the {@code Object} class. The elements in the array
|
jaroslav@261
|
625 |
* returned are not sorted and are not in any particular order. This
|
jaroslav@261
|
626 |
* method returns an array of length 0 if this {@code Class} object
|
jaroslav@261
|
627 |
* represents a class or interface that has no public member methods, or if
|
jaroslav@261
|
628 |
* this {@code Class} object represents a primitive type or void.
|
jaroslav@261
|
629 |
*
|
jaroslav@261
|
630 |
* <p> The class initialization method {@code <clinit>} is not
|
jaroslav@261
|
631 |
* included in the returned array. If the class declares multiple public
|
jaroslav@261
|
632 |
* member methods with the same parameter types, they are all included in
|
jaroslav@261
|
633 |
* the returned array.
|
jaroslav@261
|
634 |
*
|
jaroslav@261
|
635 |
* <p> See <em>The Java Language Specification</em>, sections 8.2 and 8.4.
|
jaroslav@261
|
636 |
*
|
jaroslav@261
|
637 |
* @return the array of {@code Method} objects representing the
|
jaroslav@261
|
638 |
* public methods of this class
|
jaroslav@261
|
639 |
* @exception SecurityException
|
jaroslav@261
|
640 |
* If a security manager, <i>s</i>, is present and any of the
|
jaroslav@261
|
641 |
* following conditions is met:
|
jaroslav@261
|
642 |
*
|
jaroslav@261
|
643 |
* <ul>
|
jaroslav@261
|
644 |
*
|
jaroslav@261
|
645 |
* <li> invocation of
|
jaroslav@261
|
646 |
* {@link SecurityManager#checkMemberAccess
|
jaroslav@261
|
647 |
* s.checkMemberAccess(this, Member.PUBLIC)} denies
|
jaroslav@261
|
648 |
* access to the methods within this class
|
jaroslav@261
|
649 |
*
|
jaroslav@261
|
650 |
* <li> the caller's class loader is not the same as or an
|
jaroslav@261
|
651 |
* ancestor of the class loader for the current class and
|
jaroslav@261
|
652 |
* invocation of {@link SecurityManager#checkPackageAccess
|
jaroslav@261
|
653 |
* s.checkPackageAccess()} denies access to the package
|
jaroslav@261
|
654 |
* of this class
|
jaroslav@261
|
655 |
*
|
jaroslav@261
|
656 |
* </ul>
|
jaroslav@261
|
657 |
*
|
jaroslav@261
|
658 |
* @since JDK1.1
|
jaroslav@261
|
659 |
*/
|
jaroslav@261
|
660 |
public Method[] getMethods() throws SecurityException {
|
jaroslav@392
|
661 |
return MethodImpl.findMethods(this, 0x01);
|
jaroslav@261
|
662 |
}
|
jaroslav@261
|
663 |
|
jaroslav@261
|
664 |
/**
|
jaroslav@261
|
665 |
* Returns a {@code Field} object that reflects the specified public
|
jaroslav@261
|
666 |
* member field of the class or interface represented by this
|
jaroslav@261
|
667 |
* {@code Class} object. The {@code name} parameter is a
|
jaroslav@261
|
668 |
* {@code String} specifying the simple name of the desired field.
|
jaroslav@261
|
669 |
*
|
jaroslav@261
|
670 |
* <p> The field to be reflected is determined by the algorithm that
|
jaroslav@261
|
671 |
* follows. Let C be the class represented by this object:
|
jaroslav@261
|
672 |
* <OL>
|
jaroslav@261
|
673 |
* <LI> If C declares a public field with the name specified, that is the
|
jaroslav@261
|
674 |
* field to be reflected.</LI>
|
jaroslav@261
|
675 |
* <LI> If no field was found in step 1 above, this algorithm is applied
|
jaroslav@261
|
676 |
* recursively to each direct superinterface of C. The direct
|
jaroslav@261
|
677 |
* superinterfaces are searched in the order they were declared.</LI>
|
jaroslav@261
|
678 |
* <LI> If no field was found in steps 1 and 2 above, and C has a
|
jaroslav@261
|
679 |
* superclass S, then this algorithm is invoked recursively upon S.
|
jaroslav@261
|
680 |
* If C has no superclass, then a {@code NoSuchFieldException}
|
jaroslav@261
|
681 |
* is thrown.</LI>
|
jaroslav@261
|
682 |
* </OL>
|
jaroslav@261
|
683 |
*
|
jaroslav@261
|
684 |
* <p> See <em>The Java Language Specification</em>, sections 8.2 and 8.3.
|
jaroslav@261
|
685 |
*
|
jaroslav@261
|
686 |
* @param name the field name
|
jaroslav@261
|
687 |
* @return the {@code Field} object of this class specified by
|
jaroslav@261
|
688 |
* {@code name}
|
jaroslav@261
|
689 |
* @exception NoSuchFieldException if a field with the specified name is
|
jaroslav@261
|
690 |
* not found.
|
jaroslav@261
|
691 |
* @exception NullPointerException if {@code name} is {@code null}
|
jaroslav@261
|
692 |
* @exception SecurityException
|
jaroslav@261
|
693 |
* If a security manager, <i>s</i>, is present and any of the
|
jaroslav@261
|
694 |
* following conditions is met:
|
jaroslav@261
|
695 |
*
|
jaroslav@261
|
696 |
* <ul>
|
jaroslav@261
|
697 |
*
|
jaroslav@261
|
698 |
* <li> invocation of
|
jaroslav@261
|
699 |
* {@link SecurityManager#checkMemberAccess
|
jaroslav@261
|
700 |
* s.checkMemberAccess(this, Member.PUBLIC)} denies
|
jaroslav@261
|
701 |
* access to the field
|
jaroslav@261
|
702 |
*
|
jaroslav@261
|
703 |
* <li> the caller's class loader is not the same as or an
|
jaroslav@261
|
704 |
* ancestor of the class loader for the current class and
|
jaroslav@261
|
705 |
* invocation of {@link SecurityManager#checkPackageAccess
|
jaroslav@261
|
706 |
* s.checkPackageAccess()} denies access to the package
|
jaroslav@261
|
707 |
* of this class
|
jaroslav@261
|
708 |
*
|
jaroslav@261
|
709 |
* </ul>
|
jaroslav@261
|
710 |
*
|
jaroslav@261
|
711 |
* @since JDK1.1
|
jaroslav@261
|
712 |
*/
|
jaroslav@261
|
713 |
public Field getField(String name)
|
jaroslav@261
|
714 |
throws SecurityException {
|
jaroslav@261
|
715 |
throw new SecurityException();
|
jaroslav@261
|
716 |
}
|
jaroslav@229
|
717 |
|
jaroslav@261
|
718 |
|
jaroslav@261
|
719 |
/**
|
jaroslav@261
|
720 |
* Returns a {@code Method} object that reflects the specified public
|
jaroslav@261
|
721 |
* member method of the class or interface represented by this
|
jaroslav@261
|
722 |
* {@code Class} object. The {@code name} parameter is a
|
jaroslav@261
|
723 |
* {@code String} specifying the simple name of the desired method. The
|
jaroslav@261
|
724 |
* {@code parameterTypes} parameter is an array of {@code Class}
|
jaroslav@261
|
725 |
* objects that identify the method's formal parameter types, in declared
|
jaroslav@261
|
726 |
* order. If {@code parameterTypes} is {@code null}, it is
|
jaroslav@261
|
727 |
* treated as if it were an empty array.
|
jaroslav@261
|
728 |
*
|
jaroslav@261
|
729 |
* <p> If the {@code name} is "{@code <init>};"or "{@code <clinit>}" a
|
jaroslav@261
|
730 |
* {@code NoSuchMethodException} is raised. Otherwise, the method to
|
jaroslav@261
|
731 |
* be reflected is determined by the algorithm that follows. Let C be the
|
jaroslav@261
|
732 |
* class represented by this object:
|
jaroslav@261
|
733 |
* <OL>
|
jaroslav@261
|
734 |
* <LI> C is searched for any <I>matching methods</I>. If no matching
|
jaroslav@261
|
735 |
* method is found, the algorithm of step 1 is invoked recursively on
|
jaroslav@261
|
736 |
* the superclass of C.</LI>
|
jaroslav@261
|
737 |
* <LI> If no method was found in step 1 above, the superinterfaces of C
|
jaroslav@261
|
738 |
* are searched for a matching method. If any such method is found, it
|
jaroslav@261
|
739 |
* is reflected.</LI>
|
jaroslav@261
|
740 |
* </OL>
|
jaroslav@261
|
741 |
*
|
jaroslav@261
|
742 |
* To find a matching method in a class C: If C declares exactly one
|
jaroslav@261
|
743 |
* public method with the specified name and exactly the same formal
|
jaroslav@261
|
744 |
* parameter types, that is the method reflected. If more than one such
|
jaroslav@261
|
745 |
* method is found in C, and one of these methods has a return type that is
|
jaroslav@261
|
746 |
* more specific than any of the others, that method is reflected;
|
jaroslav@261
|
747 |
* otherwise one of the methods is chosen arbitrarily.
|
jaroslav@261
|
748 |
*
|
jaroslav@261
|
749 |
* <p>Note that there may be more than one matching method in a
|
jaroslav@261
|
750 |
* class because while the Java language forbids a class to
|
jaroslav@261
|
751 |
* declare multiple methods with the same signature but different
|
jaroslav@261
|
752 |
* return types, the Java virtual machine does not. This
|
jaroslav@261
|
753 |
* increased flexibility in the virtual machine can be used to
|
jaroslav@261
|
754 |
* implement various language features. For example, covariant
|
jaroslav@261
|
755 |
* returns can be implemented with {@linkplain
|
jaroslav@261
|
756 |
* java.lang.reflect.Method#isBridge bridge methods}; the bridge
|
jaroslav@261
|
757 |
* method and the method being overridden would have the same
|
jaroslav@261
|
758 |
* signature but different return types.
|
jaroslav@261
|
759 |
*
|
jaroslav@261
|
760 |
* <p> See <em>The Java Language Specification</em>, sections 8.2 and 8.4.
|
jaroslav@261
|
761 |
*
|
jaroslav@261
|
762 |
* @param name the name of the method
|
jaroslav@261
|
763 |
* @param parameterTypes the list of parameters
|
jaroslav@261
|
764 |
* @return the {@code Method} object that matches the specified
|
jaroslav@261
|
765 |
* {@code name} and {@code parameterTypes}
|
jaroslav@261
|
766 |
* @exception NoSuchMethodException if a matching method is not found
|
jaroslav@261
|
767 |
* or if the name is "<init>"or "<clinit>".
|
jaroslav@261
|
768 |
* @exception NullPointerException if {@code name} is {@code null}
|
jaroslav@261
|
769 |
* @exception SecurityException
|
jaroslav@261
|
770 |
* If a security manager, <i>s</i>, is present and any of the
|
jaroslav@261
|
771 |
* following conditions is met:
|
jaroslav@261
|
772 |
*
|
jaroslav@261
|
773 |
* <ul>
|
jaroslav@261
|
774 |
*
|
jaroslav@261
|
775 |
* <li> invocation of
|
jaroslav@261
|
776 |
* {@link SecurityManager#checkMemberAccess
|
jaroslav@261
|
777 |
* s.checkMemberAccess(this, Member.PUBLIC)} denies
|
jaroslav@261
|
778 |
* access to the method
|
jaroslav@261
|
779 |
*
|
jaroslav@261
|
780 |
* <li> the caller's class loader is not the same as or an
|
jaroslav@261
|
781 |
* ancestor of the class loader for the current class and
|
jaroslav@261
|
782 |
* invocation of {@link SecurityManager#checkPackageAccess
|
jaroslav@261
|
783 |
* s.checkPackageAccess()} denies access to the package
|
jaroslav@261
|
784 |
* of this class
|
jaroslav@261
|
785 |
*
|
jaroslav@261
|
786 |
* </ul>
|
jaroslav@261
|
787 |
*
|
jaroslav@261
|
788 |
* @since JDK1.1
|
jaroslav@261
|
789 |
*/
|
jaroslav@261
|
790 |
public Method getMethod(String name, Class<?>... parameterTypes)
|
jaroslav@261
|
791 |
throws SecurityException {
|
jaroslav@391
|
792 |
Method m = MethodImpl.findMethod(this, name, parameterTypes);
|
jaroslav@262
|
793 |
if (m == null) {
|
jaroslav@262
|
794 |
throw new SecurityException(); // XXX: NoSuchMethodException
|
jaroslav@262
|
795 |
}
|
jaroslav@262
|
796 |
return m;
|
jaroslav@261
|
797 |
}
|
jaroslav@261
|
798 |
|
jaroslav@229
|
799 |
/**
|
jaroslav@56
|
800 |
* Character.isDigit answers {@code true} to some non-ascii
|
jaroslav@56
|
801 |
* digits. This one does not.
|
jaroslav@56
|
802 |
*/
|
jaroslav@56
|
803 |
private static boolean isAsciiDigit(char c) {
|
jaroslav@56
|
804 |
return '0' <= c && c <= '9';
|
jaroslav@56
|
805 |
}
|
jaroslav@56
|
806 |
|
jaroslav@56
|
807 |
/**
|
jaroslav@56
|
808 |
* Returns the canonical name of the underlying class as
|
jaroslav@56
|
809 |
* defined by the Java Language Specification. Returns null if
|
jaroslav@56
|
810 |
* the underlying class does not have a canonical name (i.e., if
|
jaroslav@56
|
811 |
* it is a local or anonymous class or an array whose component
|
jaroslav@56
|
812 |
* type does not have a canonical name).
|
jaroslav@56
|
813 |
* @return the canonical name of the underlying class if it exists, and
|
jaroslav@56
|
814 |
* {@code null} otherwise.
|
jaroslav@56
|
815 |
* @since 1.5
|
jaroslav@56
|
816 |
*/
|
jaroslav@56
|
817 |
public String getCanonicalName() {
|
jaroslav@228
|
818 |
if (isArray()) {
|
jaroslav@228
|
819 |
String canonicalName = getComponentType().getCanonicalName();
|
jaroslav@228
|
820 |
if (canonicalName != null)
|
jaroslav@228
|
821 |
return canonicalName + "[]";
|
jaroslav@228
|
822 |
else
|
jaroslav@228
|
823 |
return null;
|
jaroslav@228
|
824 |
}
|
jaroslav@65
|
825 |
// if (isLocalOrAnonymousClass())
|
jaroslav@65
|
826 |
// return null;
|
jaroslav@65
|
827 |
// Class<?> enclosingClass = getEnclosingClass();
|
jaroslav@228
|
828 |
Class<?> enclosingClass = null;
|
jaroslav@228
|
829 |
if (enclosingClass == null) { // top level class
|
jaroslav@228
|
830 |
return getName();
|
jaroslav@228
|
831 |
} else {
|
jaroslav@228
|
832 |
String enclosingName = enclosingClass.getCanonicalName();
|
jaroslav@228
|
833 |
if (enclosingName == null)
|
jaroslav@228
|
834 |
return null;
|
jaroslav@228
|
835 |
return enclosingName + "." + getSimpleName();
|
jaroslav@228
|
836 |
}
|
jaroslav@56
|
837 |
}
|
jaroslav@56
|
838 |
|
jaroslav@56
|
839 |
/**
|
jaroslav@56
|
840 |
* Finds a resource with a given name. The rules for searching resources
|
jaroslav@56
|
841 |
* associated with a given class are implemented by the defining
|
jaroslav@56
|
842 |
* {@linkplain ClassLoader class loader} of the class. This method
|
jaroslav@56
|
843 |
* delegates to this object's class loader. If this object was loaded by
|
jaroslav@56
|
844 |
* the bootstrap class loader, the method delegates to {@link
|
jaroslav@56
|
845 |
* ClassLoader#getSystemResourceAsStream}.
|
jaroslav@56
|
846 |
*
|
jaroslav@56
|
847 |
* <p> Before delegation, an absolute resource name is constructed from the
|
jaroslav@56
|
848 |
* given resource name using this algorithm:
|
jaroslav@56
|
849 |
*
|
jaroslav@56
|
850 |
* <ul>
|
jaroslav@56
|
851 |
*
|
jaroslav@56
|
852 |
* <li> If the {@code name} begins with a {@code '/'}
|
jaroslav@56
|
853 |
* (<tt>'\u002f'</tt>), then the absolute name of the resource is the
|
jaroslav@56
|
854 |
* portion of the {@code name} following the {@code '/'}.
|
jaroslav@56
|
855 |
*
|
jaroslav@56
|
856 |
* <li> Otherwise, the absolute name is of the following form:
|
jaroslav@56
|
857 |
*
|
jaroslav@56
|
858 |
* <blockquote>
|
jaroslav@56
|
859 |
* {@code modified_package_name/name}
|
jaroslav@56
|
860 |
* </blockquote>
|
jaroslav@56
|
861 |
*
|
jaroslav@56
|
862 |
* <p> Where the {@code modified_package_name} is the package name of this
|
jaroslav@56
|
863 |
* object with {@code '/'} substituted for {@code '.'}
|
jaroslav@56
|
864 |
* (<tt>'\u002e'</tt>).
|
jaroslav@56
|
865 |
*
|
jaroslav@56
|
866 |
* </ul>
|
jaroslav@56
|
867 |
*
|
jaroslav@56
|
868 |
* @param name name of the desired resource
|
jaroslav@56
|
869 |
* @return A {@link java.io.InputStream} object or {@code null} if
|
jaroslav@56
|
870 |
* no resource with this name is found
|
jaroslav@56
|
871 |
* @throws NullPointerException If {@code name} is {@code null}
|
jaroslav@56
|
872 |
* @since JDK1.1
|
jaroslav@56
|
873 |
*/
|
jaroslav@122
|
874 |
public InputStream getResourceAsStream(String name) {
|
jaroslav@122
|
875 |
name = resolveName(name);
|
jaroslav@122
|
876 |
ClassLoader cl = getClassLoader0();
|
jaroslav@122
|
877 |
if (cl==null) {
|
jaroslav@122
|
878 |
// A system class.
|
jaroslav@122
|
879 |
return ClassLoader.getSystemResourceAsStream(name);
|
jaroslav@122
|
880 |
}
|
jaroslav@122
|
881 |
return cl.getResourceAsStream(name);
|
jaroslav@122
|
882 |
}
|
jaroslav@56
|
883 |
|
jaroslav@56
|
884 |
/**
|
jaroslav@56
|
885 |
* Finds a resource with a given name. The rules for searching resources
|
jaroslav@56
|
886 |
* associated with a given class are implemented by the defining
|
jaroslav@56
|
887 |
* {@linkplain ClassLoader class loader} of the class. This method
|
jaroslav@56
|
888 |
* delegates to this object's class loader. If this object was loaded by
|
jaroslav@56
|
889 |
* the bootstrap class loader, the method delegates to {@link
|
jaroslav@56
|
890 |
* ClassLoader#getSystemResource}.
|
jaroslav@56
|
891 |
*
|
jaroslav@56
|
892 |
* <p> Before delegation, an absolute resource name is constructed from the
|
jaroslav@56
|
893 |
* given resource name using this algorithm:
|
jaroslav@56
|
894 |
*
|
jaroslav@56
|
895 |
* <ul>
|
jaroslav@56
|
896 |
*
|
jaroslav@56
|
897 |
* <li> If the {@code name} begins with a {@code '/'}
|
jaroslav@56
|
898 |
* (<tt>'\u002f'</tt>), then the absolute name of the resource is the
|
jaroslav@56
|
899 |
* portion of the {@code name} following the {@code '/'}.
|
jaroslav@56
|
900 |
*
|
jaroslav@56
|
901 |
* <li> Otherwise, the absolute name is of the following form:
|
jaroslav@56
|
902 |
*
|
jaroslav@56
|
903 |
* <blockquote>
|
jaroslav@56
|
904 |
* {@code modified_package_name/name}
|
jaroslav@56
|
905 |
* </blockquote>
|
jaroslav@56
|
906 |
*
|
jaroslav@56
|
907 |
* <p> Where the {@code modified_package_name} is the package name of this
|
jaroslav@56
|
908 |
* object with {@code '/'} substituted for {@code '.'}
|
jaroslav@56
|
909 |
* (<tt>'\u002e'</tt>).
|
jaroslav@56
|
910 |
*
|
jaroslav@56
|
911 |
* </ul>
|
jaroslav@56
|
912 |
*
|
jaroslav@56
|
913 |
* @param name name of the desired resource
|
jaroslav@56
|
914 |
* @return A {@link java.net.URL} object or {@code null} if no
|
jaroslav@56
|
915 |
* resource with this name is found
|
jaroslav@56
|
916 |
* @since JDK1.1
|
jaroslav@56
|
917 |
*/
|
jaroslav@122
|
918 |
public java.net.URL getResource(String name) {
|
jaroslav@122
|
919 |
name = resolveName(name);
|
jaroslav@122
|
920 |
ClassLoader cl = getClassLoader0();
|
jaroslav@122
|
921 |
if (cl==null) {
|
jaroslav@122
|
922 |
// A system class.
|
jaroslav@122
|
923 |
return ClassLoader.getSystemResource(name);
|
jaroslav@122
|
924 |
}
|
jaroslav@122
|
925 |
return cl.getResource(name);
|
jaroslav@122
|
926 |
}
|
jaroslav@56
|
927 |
|
jaroslav@56
|
928 |
|
jaroslav@122
|
929 |
/**
|
jaroslav@122
|
930 |
* Add a package name prefix if the name is not absolute Remove leading "/"
|
jaroslav@122
|
931 |
* if name is absolute
|
jaroslav@122
|
932 |
*/
|
jaroslav@122
|
933 |
private String resolveName(String name) {
|
jaroslav@122
|
934 |
if (name == null) {
|
jaroslav@122
|
935 |
return name;
|
jaroslav@122
|
936 |
}
|
jaroslav@122
|
937 |
if (!name.startsWith("/")) {
|
jaroslav@122
|
938 |
Class<?> c = this;
|
jaroslav@122
|
939 |
while (c.isArray()) {
|
jaroslav@122
|
940 |
c = c.getComponentType();
|
jaroslav@122
|
941 |
}
|
jaroslav@122
|
942 |
String baseName = c.getName();
|
jaroslav@122
|
943 |
int index = baseName.lastIndexOf('.');
|
jaroslav@122
|
944 |
if (index != -1) {
|
jaroslav@122
|
945 |
name = baseName.substring(0, index).replace('.', '/')
|
jaroslav@122
|
946 |
+"/"+name;
|
jaroslav@122
|
947 |
}
|
jaroslav@122
|
948 |
} else {
|
jaroslav@122
|
949 |
name = name.substring(1);
|
jaroslav@122
|
950 |
}
|
jaroslav@122
|
951 |
return name;
|
jaroslav@122
|
952 |
}
|
jaroslav@122
|
953 |
|
jaroslav@122
|
954 |
/**
|
jaroslav@122
|
955 |
* Returns the class loader for the class. Some implementations may use
|
jaroslav@122
|
956 |
* null to represent the bootstrap class loader. This method will return
|
jaroslav@122
|
957 |
* null in such implementations if this class was loaded by the bootstrap
|
jaroslav@122
|
958 |
* class loader.
|
jaroslav@122
|
959 |
*
|
jaroslav@122
|
960 |
* <p> If a security manager is present, and the caller's class loader is
|
jaroslav@122
|
961 |
* not null and the caller's class loader is not the same as or an ancestor of
|
jaroslav@122
|
962 |
* the class loader for the class whose class loader is requested, then
|
jaroslav@122
|
963 |
* this method calls the security manager's {@code checkPermission}
|
jaroslav@122
|
964 |
* method with a {@code RuntimePermission("getClassLoader")}
|
jaroslav@122
|
965 |
* permission to ensure it's ok to access the class loader for the class.
|
jaroslav@122
|
966 |
*
|
jaroslav@122
|
967 |
* <p>If this object
|
jaroslav@122
|
968 |
* represents a primitive type or void, null is returned.
|
jaroslav@122
|
969 |
*
|
jaroslav@122
|
970 |
* @return the class loader that loaded the class or interface
|
jaroslav@122
|
971 |
* represented by this object.
|
jaroslav@122
|
972 |
* @throws SecurityException
|
jaroslav@122
|
973 |
* if a security manager exists and its
|
jaroslav@122
|
974 |
* {@code checkPermission} method denies
|
jaroslav@122
|
975 |
* access to the class loader for the class.
|
jaroslav@122
|
976 |
* @see java.lang.ClassLoader
|
jaroslav@122
|
977 |
* @see SecurityManager#checkPermission
|
jaroslav@122
|
978 |
* @see java.lang.RuntimePermission
|
jaroslav@122
|
979 |
*/
|
jaroslav@122
|
980 |
public ClassLoader getClassLoader() {
|
jaroslav@122
|
981 |
throw new SecurityException();
|
jaroslav@122
|
982 |
}
|
jaroslav@122
|
983 |
|
jaroslav@122
|
984 |
// Package-private to allow ClassLoader access
|
jaroslav@122
|
985 |
native ClassLoader getClassLoader0();
|
jaroslav@56
|
986 |
|
jaroslav@122
|
987 |
/**
|
jaroslav@122
|
988 |
* Returns the {@code Class} representing the component type of an
|
jaroslav@122
|
989 |
* array. If this class does not represent an array class this method
|
jaroslav@122
|
990 |
* returns null.
|
jaroslav@122
|
991 |
*
|
jaroslav@122
|
992 |
* @return the {@code Class} representing the component type of this
|
jaroslav@122
|
993 |
* class if this class is an array
|
jaroslav@122
|
994 |
* @see java.lang.reflect.Array
|
jaroslav@122
|
995 |
* @since JDK1.1
|
jaroslav@122
|
996 |
*/
|
jaroslav@228
|
997 |
public Class<?> getComponentType() {
|
jaroslav@228
|
998 |
return null;
|
jaroslav@228
|
999 |
}
|
jaroslav@56
|
1000 |
|
jaroslav@56
|
1001 |
/**
|
jaroslav@56
|
1002 |
* Returns true if and only if this class was declared as an enum in the
|
jaroslav@56
|
1003 |
* source code.
|
jaroslav@56
|
1004 |
*
|
jaroslav@56
|
1005 |
* @return true if and only if this class was declared as an enum in the
|
jaroslav@56
|
1006 |
* source code
|
jaroslav@56
|
1007 |
* @since 1.5
|
jaroslav@56
|
1008 |
*/
|
jaroslav@56
|
1009 |
public boolean isEnum() {
|
jaroslav@56
|
1010 |
// An enum must both directly extend java.lang.Enum and have
|
jaroslav@56
|
1011 |
// the ENUM bit set; classes for specialized enum constants
|
jaroslav@56
|
1012 |
// don't do the former.
|
jaroslav@56
|
1013 |
return (this.getModifiers() & ENUM) != 0 &&
|
jaroslav@56
|
1014 |
this.getSuperclass() == java.lang.Enum.class;
|
jaroslav@56
|
1015 |
}
|
jaroslav@56
|
1016 |
|
jaroslav@56
|
1017 |
/**
|
jaroslav@56
|
1018 |
* Casts an object to the class or interface represented
|
jaroslav@56
|
1019 |
* by this {@code Class} object.
|
jaroslav@56
|
1020 |
*
|
jaroslav@56
|
1021 |
* @param obj the object to be cast
|
jaroslav@56
|
1022 |
* @return the object after casting, or null if obj is null
|
jaroslav@56
|
1023 |
*
|
jaroslav@56
|
1024 |
* @throws ClassCastException if the object is not
|
jaroslav@56
|
1025 |
* null and is not assignable to the type T.
|
jaroslav@56
|
1026 |
*
|
jaroslav@56
|
1027 |
* @since 1.5
|
jaroslav@56
|
1028 |
*/
|
jaroslav@56
|
1029 |
public T cast(Object obj) {
|
jaroslav@56
|
1030 |
if (obj != null && !isInstance(obj))
|
jaroslav@56
|
1031 |
throw new ClassCastException(cannotCastMsg(obj));
|
jaroslav@56
|
1032 |
return (T) obj;
|
jaroslav@56
|
1033 |
}
|
jaroslav@56
|
1034 |
|
jaroslav@56
|
1035 |
private String cannotCastMsg(Object obj) {
|
jaroslav@56
|
1036 |
return "Cannot cast " + obj.getClass().getName() + " to " + getName();
|
jaroslav@56
|
1037 |
}
|
jaroslav@56
|
1038 |
|
jaroslav@56
|
1039 |
/**
|
jaroslav@56
|
1040 |
* Casts this {@code Class} object to represent a subclass of the class
|
jaroslav@56
|
1041 |
* represented by the specified class object. Checks that that the cast
|
jaroslav@56
|
1042 |
* is valid, and throws a {@code ClassCastException} if it is not. If
|
jaroslav@56
|
1043 |
* this method succeeds, it always returns a reference to this class object.
|
jaroslav@56
|
1044 |
*
|
jaroslav@56
|
1045 |
* <p>This method is useful when a client needs to "narrow" the type of
|
jaroslav@56
|
1046 |
* a {@code Class} object to pass it to an API that restricts the
|
jaroslav@56
|
1047 |
* {@code Class} objects that it is willing to accept. A cast would
|
jaroslav@56
|
1048 |
* generate a compile-time warning, as the correctness of the cast
|
jaroslav@56
|
1049 |
* could not be checked at runtime (because generic types are implemented
|
jaroslav@56
|
1050 |
* by erasure).
|
jaroslav@56
|
1051 |
*
|
jaroslav@56
|
1052 |
* @return this {@code Class} object, cast to represent a subclass of
|
jaroslav@56
|
1053 |
* the specified class object.
|
jaroslav@56
|
1054 |
* @throws ClassCastException if this {@code Class} object does not
|
jaroslav@56
|
1055 |
* represent a subclass of the specified class (here "subclass" includes
|
jaroslav@56
|
1056 |
* the class itself).
|
jaroslav@56
|
1057 |
* @since 1.5
|
jaroslav@56
|
1058 |
*/
|
jaroslav@56
|
1059 |
public <U> Class<? extends U> asSubclass(Class<U> clazz) {
|
jaroslav@56
|
1060 |
if (clazz.isAssignableFrom(this))
|
jaroslav@56
|
1061 |
return (Class<? extends U>) this;
|
jaroslav@56
|
1062 |
else
|
jaroslav@56
|
1063 |
throw new ClassCastException(this.toString());
|
jaroslav@56
|
1064 |
}
|
jaroslav@56
|
1065 |
|
jaroslav@235
|
1066 |
@JavaScriptBody(args = { "self", "ac" },
|
jaroslav@235
|
1067 |
body =
|
jaroslav@235
|
1068 |
"if (self.anno) {"
|
jaroslav@235
|
1069 |
+ " return self.anno['L' + ac.jvmName + ';'];"
|
jaroslav@266
|
1070 |
+ "} else return null;"
|
jaroslav@235
|
1071 |
)
|
jaroslav@235
|
1072 |
private Object getAnnotationData(Class<?> annotationClass) {
|
jaroslav@235
|
1073 |
throw new UnsupportedOperationException();
|
jaroslav@235
|
1074 |
}
|
jaroslav@237
|
1075 |
/**
|
jaroslav@237
|
1076 |
* @throws NullPointerException {@inheritDoc}
|
jaroslav@237
|
1077 |
* @since 1.5
|
jaroslav@237
|
1078 |
*/
|
jaroslav@56
|
1079 |
public <A extends Annotation> A getAnnotation(Class<A> annotationClass) {
|
jaroslav@235
|
1080 |
Object data = getAnnotationData(annotationClass);
|
jaroslav@235
|
1081 |
return data == null ? null : AnnotationImpl.create(annotationClass, data);
|
jaroslav@56
|
1082 |
}
|
jaroslav@56
|
1083 |
|
jaroslav@56
|
1084 |
/**
|
jaroslav@56
|
1085 |
* @throws NullPointerException {@inheritDoc}
|
jaroslav@56
|
1086 |
* @since 1.5
|
jaroslav@56
|
1087 |
*/
|
jaroslav@235
|
1088 |
@JavaScriptBody(args = { "self", "ac" },
|
jaroslav@235
|
1089 |
body = "if (self.anno && self.anno['L' + ac.jvmName + ';']) { return true; }"
|
jaroslav@235
|
1090 |
+ "else return false;"
|
jaroslav@235
|
1091 |
)
|
jaroslav@56
|
1092 |
public boolean isAnnotationPresent(
|
jaroslav@56
|
1093 |
Class<? extends Annotation> annotationClass) {
|
jaroslav@56
|
1094 |
if (annotationClass == null)
|
jaroslav@56
|
1095 |
throw new NullPointerException();
|
jaroslav@56
|
1096 |
|
jaroslav@56
|
1097 |
return getAnnotation(annotationClass) != null;
|
jaroslav@56
|
1098 |
}
|
jaroslav@56
|
1099 |
|
jaroslav@238
|
1100 |
@JavaScriptBody(args = "self", body = "return self.anno;")
|
jaroslav@238
|
1101 |
private Object getAnnotationData() {
|
jaroslav@238
|
1102 |
throw new UnsupportedOperationException();
|
jaroslav@238
|
1103 |
}
|
jaroslav@56
|
1104 |
|
jaroslav@56
|
1105 |
/**
|
jaroslav@56
|
1106 |
* @since 1.5
|
jaroslav@56
|
1107 |
*/
|
jaroslav@56
|
1108 |
public Annotation[] getAnnotations() {
|
jaroslav@238
|
1109 |
Object data = getAnnotationData();
|
jaroslav@238
|
1110 |
return data == null ? new Annotation[0] : AnnotationImpl.create(data);
|
jaroslav@56
|
1111 |
}
|
jaroslav@56
|
1112 |
|
jaroslav@56
|
1113 |
/**
|
jaroslav@56
|
1114 |
* @since 1.5
|
jaroslav@56
|
1115 |
*/
|
jaroslav@56
|
1116 |
public Annotation[] getDeclaredAnnotations() {
|
jaroslav@65
|
1117 |
throw new UnsupportedOperationException();
|
jaroslav@56
|
1118 |
}
|
jaroslav@56
|
1119 |
|
jaroslav@353
|
1120 |
@JavaScriptBody(args = "type", body = ""
|
jaroslav@353
|
1121 |
+ "var c = vm.java_lang_Class(true);"
|
jaroslav@353
|
1122 |
+ "c.jvmName = type;"
|
jaroslav@354
|
1123 |
+ "c.primitive = true;"
|
jaroslav@353
|
1124 |
+ "return c;"
|
jaroslav@353
|
1125 |
)
|
jaroslav@353
|
1126 |
native static Class getPrimitiveClass(String type);
|
jaroslav@88
|
1127 |
|
jaroslav@88
|
1128 |
public boolean desiredAssertionStatus() {
|
jaroslav@88
|
1129 |
return false;
|
jaroslav@88
|
1130 |
}
|
jaroslav@56
|
1131 |
}
|