/*
 * Copyright (c) 2000, 2008, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 *
 */

package sun.jvm.hotspot.types;

import java.util.*;

This is the top-level interface which describes C++ classes and primitive types as well as enough about Java primitive and object types to allow the oop hierarchy to be constructed.
/** This is the top-level interface which describes C++ classes and primitive types as well as enough about Java primitive and object types to allow the oop hierarchy to be constructed. */
public interface Type { public String getName(); /* The supertype of this type. May be null for top-level classes and primitive types. NOTE that multiple inheritance is currently not handled. However, it could (probably) be by making this return a list and adding appropriate routines to cast an address of one type to another. */ public Type getSuperclass();
The size in bytes, at the machine level, of this type. This should be equivalent to the sizeof operator -- i.e., should include any compiler-inserted fields like the vtbl for C++ types.
/** The size in bytes, at the machine level, of this type. This should be equivalent to the sizeof operator -- i.e., should include any compiler-inserted fields like the vtbl for C++ types. */
public long getSize();
Indicates whether this type is a C integer type -- regardless of size or signedness.
/** Indicates whether this type is a C integer type -- regardless of size or signedness. */
public boolean isCIntegerType();
Indicates whether this type is const char*.
/** Indicates whether this type is const char*. */
public boolean isCStringType();
Indicates whether this type is one of the Java primitive types.
/** Indicates whether this type is one of the Java primitive types. */
public boolean isJavaPrimitiveType();
Indicates whether this type is an oop type in the VM.
/** Indicates whether this type is an oop type in the VM. */
public boolean isOopType();
Indicates whether this type is a pointer type.
/** Indicates whether this type is a pointer type. */
public boolean isPointerType();
This is permissive and returns the CField regardless of its type as long as it is present. Returns null if the field was not found, unless throwExceptionIfNotFound is true, in which case a RuntimeException is thrown (for debugging purposes).
/** This is permissive and returns the CField regardless of its type as long as it is present. Returns null if the field was not found, unless throwExceptionIfNotFound is true, in which case a RuntimeException is thrown (for debugging purposes). */
public Field getField(String fieldName, boolean searchSuperclassFields, boolean throwExceptionIfNotFound);
This is permissive and returns the CField regardless of its type as long as it is present -- it is equivalent to getField(fieldName, searchSuperclassFields, true). Throws a RuntimeException if the field was not found.
/** This is permissive and returns the CField regardless of its type as long as it is present -- it is equivalent to getField(fieldName, searchSuperclassFields, true). Throws a RuntimeException if the field was not found. */
public Field getField(String fieldName, boolean searchSuperclassFields);
This is permissive and returns the CField regardless of its type as long as it is present. This does not search superclasses' fields; it is equivalent to getField(fieldName, false). Throws a RuntimeException if the field was not found.
/** This is permissive and returns the CField regardless of its type as long as it is present. This does not search superclasses' fields; it is equivalent to getField(fieldName, false). Throws a RuntimeException if the field was not found. */
public Field getField(String fieldName);
If there is a mismatch between the declared type and the type which would otherwise be returned from this routine, it throws a WrongTypeException. declaredType must not be null. Throws a RuntimeException if field was otherwise not found.
/** If there is a mismatch between the declared type and the type which would otherwise be returned from this routine, it throws a WrongTypeException. declaredType must not be null. Throws a RuntimeException if field was otherwise not found. */
public Field getField(String fieldName, Type declaredType, boolean searchSuperclassFields) throws WrongTypeException;
If there is a mismatch between the declared type and the type which would otherwise be returned from this routine, it throws a WrongTypeException. declaredType must not be null. This does not search superclasses' fields; it is equivalent to getField(fieldName, declaredType, false). Throws a RuntimeException if field was otherwise not found.
/** If there is a mismatch between the declared type and the type which would otherwise be returned from this routine, it throws a WrongTypeException. declaredType must not be null. This does not search superclasses' fields; it is equivalent to getField(fieldName, declaredType, false). Throws a RuntimeException if field was otherwise not found. */
public Field getField(String fieldName, Type declaredType) throws WrongTypeException;
Iterate over all of the fields in this type but not in any of its superclasses. The returned Iterator's "remove" method must not be called.
/** Iterate over all of the fields in this type but <B>not</B> in any of its superclasses. The returned Iterator's "remove" method must not be called. */
public Iterator getFields();

These accessors are designed to allow strong type checking of certain well-known types of fields, specifically Java primitive and oop types. Specialized fields for all primitive types, as well as oop fields, are required to have strong type checking and a WrongTypeException should be thrown if the given field is not precisely of the given type. Address and Oop fields are more permissive to reduce the complexity of the initial implementation.

These accessors do not search the superclass's fields.

/** <P> These accessors are designed to allow strong type checking of certain well-known types of fields, specifically Java primitive and oop types. Specialized fields for all primitive types, as well as oop fields, are required to have strong type checking and a WrongTypeException should be thrown if the given field is not precisely of the given type. Address and Oop fields are more permissive to reduce the complexity of the initial implementation. </P> <P> These accessors do not search the superclass's fields. </P> */
public JBooleanField getJBooleanField (String fieldName) throws WrongTypeException; public JByteField getJByteField (String fieldName) throws WrongTypeException; public JCharField getJCharField (String fieldName) throws WrongTypeException; public JDoubleField getJDoubleField (String fieldName) throws WrongTypeException; public JFloatField getJFloatField (String fieldName) throws WrongTypeException; public JIntField getJIntField (String fieldName) throws WrongTypeException; public JLongField getJLongField (String fieldName) throws WrongTypeException; public JShortField getJShortField (String fieldName) throws WrongTypeException; public CIntegerField getCIntegerField (String fieldName) throws WrongTypeException; public OopField getOopField (String fieldName) throws WrongTypeException; public NarrowOopField getNarrowOopField (String fieldName) throws WrongTypeException; public AddressField getAddressField (String fieldName); }