207 lines
6.1 KiB
Java
207 lines
6.1 KiB
Java
// Class.java - Representation of a Java class.
|
|
|
|
/* Copyright (C) 1998, 1999, 2000 Cygnus Solutions
|
|
|
|
This file is part of libgcj.
|
|
|
|
This software is copyrighted work licensed under the terms of the
|
|
Libgcj License. Please consult the file "LIBGCJ_LICENSE" for
|
|
details. */
|
|
|
|
package java.lang;
|
|
import java.io.Serializable;
|
|
import java.io.InputStream;
|
|
import java.lang.reflect.*;
|
|
|
|
/**
|
|
* @author Tom Tromey <tromey@cygnus.com>
|
|
* @date October 1, 1998
|
|
*/
|
|
|
|
/* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
|
|
* "The Java Language Specification", ISBN 0-201-63451-1
|
|
* plus online API docs for JDK 1.2 beta from http://www.javasoft.com.
|
|
* plus gcj compiler sources (to determine object layout)
|
|
* Status: Sufficient for our purposes, but some methods missing
|
|
* and some not implemented.
|
|
*/
|
|
|
|
public final class Class implements Serializable
|
|
{
|
|
public static native Class forName (String className)
|
|
throws ClassNotFoundException;
|
|
public native Class[] getClasses ();
|
|
public native ClassLoader getClassLoader ();
|
|
public native Class getComponentType ();
|
|
|
|
public native Constructor getConstructor (Class[] parameterTypes)
|
|
throws NoSuchMethodException, SecurityException;
|
|
|
|
// This is used to implement getConstructors and
|
|
// getDeclaredConstructors.
|
|
private native Constructor[] _getConstructors (boolean declared)
|
|
throws SecurityException;
|
|
|
|
public Constructor[] getConstructors () throws SecurityException
|
|
{
|
|
return _getConstructors (false);
|
|
}
|
|
|
|
public native Constructor getDeclaredConstructor (Class[] parameterTypes)
|
|
throws NoSuchMethodException, SecurityException;
|
|
|
|
public native Class[] getDeclaredClasses () throws SecurityException;
|
|
|
|
public Constructor[] getDeclaredConstructors () throws SecurityException
|
|
{
|
|
return _getConstructors (true);
|
|
}
|
|
|
|
public native Field getDeclaredField (String fieldName)
|
|
throws NoSuchFieldException, SecurityException;
|
|
public native Field[] getDeclaredFields () throws SecurityException;
|
|
public native Method getDeclaredMethod (String methodName,
|
|
Class[] parameterTypes)
|
|
throws NoSuchMethodException, SecurityException;
|
|
public native Method[] getDeclaredMethods () throws SecurityException;
|
|
|
|
// This is marked as unimplemented in the JCL book.
|
|
public native Class getDeclaringClass ();
|
|
|
|
private native Field getField (String fieldName, int hash)
|
|
throws NoSuchFieldException, SecurityException;
|
|
|
|
public Field getField (String fieldName)
|
|
throws NoSuchFieldException, SecurityException
|
|
{
|
|
SecurityManager s = System.getSecurityManager();
|
|
if (s != null)
|
|
s.checkMemberAccess (this, java.lang.reflect.Member.DECLARED);
|
|
Field fld = getField(fieldName, fieldName.hashCode());
|
|
if (fld == null)
|
|
throw new NoSuchFieldException(fieldName);
|
|
return fld;
|
|
}
|
|
|
|
private native Field[] _getFields (Field[] result, int offset);
|
|
public native Field[] getFields () throws SecurityException;
|
|
|
|
public native Class[] getInterfaces ();
|
|
|
|
private final native void getSignature (StringBuffer buffer);
|
|
private static final native String getSignature (Class[] parameterTypes,
|
|
boolean is_construtor);
|
|
|
|
public native Method getMethod (String methodName, Class[] parameterTypes)
|
|
throws NoSuchMethodException, SecurityException;
|
|
private native int _getMethods (Method[] result, int offset);
|
|
public native Method[] getMethods () throws SecurityException;
|
|
|
|
public native int getModifiers ();
|
|
public native String getName ();
|
|
|
|
public java.net.URL getResource (String resourceName)
|
|
{
|
|
String name = resourcePath (resourceName);
|
|
ClassLoader loader = getClassLoader ();
|
|
if (loader == null)
|
|
return ClassLoader.getSystemResource (name);
|
|
else
|
|
return loader.getResource (name);
|
|
}
|
|
|
|
public java.io.InputStream getResourceAsStream (String resourceName)
|
|
{
|
|
String name = resourcePath (resourceName);
|
|
ClassLoader loader = getClassLoader ();
|
|
if (loader == null)
|
|
return ClassLoader.getSystemResourceAsStream (name);
|
|
else
|
|
return loader.getResourceAsStream (name);
|
|
}
|
|
|
|
private String resourcePath (String resourceName)
|
|
{
|
|
if (resourceName.startsWith ("/"))
|
|
return resourceName.substring (1);
|
|
|
|
Class c = this;
|
|
while (c.isArray ())
|
|
c = c.getComponentType ();
|
|
|
|
String packageName = c.getName ().replace ('.', '/');
|
|
int end = packageName.lastIndexOf ('/');
|
|
if (end == -1)
|
|
return resourceName;
|
|
else
|
|
return packageName.substring (0, end+1) + resourceName;
|
|
}
|
|
|
|
// FIXME: implement. Requires java.security.
|
|
public Object[] getSigners ()
|
|
{
|
|
return null;
|
|
}
|
|
|
|
public native Class getSuperclass ();
|
|
public native boolean isArray ();
|
|
public native boolean isAssignableFrom (Class cls);
|
|
public native boolean isInstance (Object obj);
|
|
public native boolean isInterface ();
|
|
public native boolean isPrimitive ();
|
|
public native Object newInstance ()
|
|
throws InstantiationException, IllegalAccessException;
|
|
|
|
public String toString ()
|
|
{
|
|
if (isPrimitive ())
|
|
return getName ();
|
|
return (isInterface () ? "interface " : "class ") + getName ();
|
|
}
|
|
|
|
// Don't allow new classes to be made.
|
|
private Class ()
|
|
{
|
|
}
|
|
|
|
// Do a security check.
|
|
private void checkMemberAccess (int flags)
|
|
{
|
|
SecurityManager sm = System.getSecurityManager();
|
|
if (sm != null)
|
|
sm.checkMemberAccess(this, flags);
|
|
}
|
|
|
|
// FIXME: this method exists only because we cannot catch Java
|
|
// exceptions from C++ code. This is a helper for initializeClass.
|
|
private Throwable hackTrampoline (int what, Throwable old_exception)
|
|
{
|
|
Throwable new_val = null;
|
|
try
|
|
{
|
|
if (what == 0)
|
|
initializeClass ();
|
|
else if (what == 1)
|
|
hackRunInitializers ();
|
|
else if (what == 2)
|
|
new_val = new ExceptionInInitializerError (old_exception);
|
|
}
|
|
catch (Throwable t)
|
|
{
|
|
new_val = t;
|
|
}
|
|
return new_val;
|
|
}
|
|
|
|
// FIXME: this is a hack to let us run the class initializers. We
|
|
// could do it inline in initializeClass() if we could catch Java
|
|
// exceptions from C++.
|
|
private native void hackRunInitializers ();
|
|
|
|
// Initialize the class.
|
|
private native void initializeClass ();
|
|
|
|
// finalization
|
|
protected native void finalize ();
|
|
}
|