You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
4.5 KiB
123 lines
4.5 KiB
/* RuntimeEnvironment Copyright (C) 1999-2002 Jochen Hoenicke.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation; either version 2, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program 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 for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with this program; see the file COPYING.LESSER. If not, write to
|
|
* the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*
|
|
* $Id$
|
|
*/
|
|
|
|
package net.sf.jode.jvm;
|
|
import net.sf.jode.bytecode.Reference;
|
|
import java.lang.reflect.InvocationTargetException;
|
|
|
|
/**
|
|
* This interface is used by the Interpreter to actually modify objects,
|
|
* invoke methods, etc. <br>
|
|
*
|
|
* The objects used in this runtime environment need not to be of the
|
|
* real type, but can be some other type of your choice. But some
|
|
* mappings must be preserved, since they are used inside the
|
|
* Interpreter:
|
|
* <ul> <li>boolean, byte, short, char and int are mapped to Integer. </li>
|
|
* <li> float, long, double are mapped to Float, Long, Double resp. </li>
|
|
* <li> array of primitive type is mapped to itself (not array of Integer)</li>
|
|
* <li> array of other types are mapped to array of mapped other type </li>
|
|
* </ul>
|
|
*
|
|
* @author Jochen Hoenicke
|
|
* @see SimpleRuntimeEnvironment
|
|
*/
|
|
public interface RuntimeEnvironment {
|
|
/**
|
|
* Get the value of a field member.
|
|
* @param fieldref the Reference of the field.
|
|
* @param obj the object of which the field should be taken, null
|
|
* if the field is static.
|
|
* @return the field value. Primitive types are wrapped to
|
|
* Object.
|
|
* @exception InterpreterException if the field does not exists, the
|
|
* object is not supported etc.
|
|
*/
|
|
public Object getField(Reference fieldref, Object obj)
|
|
throws InterpreterException;
|
|
|
|
/**
|
|
* Set the value of a field member.
|
|
* @param fieldref the Reference of the field.
|
|
* @param obj the object of which the field should be taken, null
|
|
* if the field is static.
|
|
* @param value the field value. Primitive types are wrapped to
|
|
* Object.
|
|
* @exception InterpreterException if the field does not exists, the
|
|
* object is not supported etc.
|
|
*/
|
|
public void putField(Reference fieldref, Object obj, Object value)
|
|
throws InterpreterException;
|
|
|
|
|
|
/**
|
|
* Invoke a method.
|
|
* @param methodRef the reference to the method.
|
|
* @param isVirtual true, iff the call is virtual
|
|
* @param cls the object on which the method should be called, null
|
|
* if the method is static.
|
|
* @param params the params of the method.
|
|
* @return the return value of the method. Void type is ignored,
|
|
* may be null.
|
|
* @exception InterpreterException if the field does not exists, the
|
|
* object is not supported etc. */
|
|
public Object invokeMethod(Reference methodRef, boolean isVirtual,
|
|
Object cls, Object[] params)
|
|
throws InterpreterException, InvocationTargetException;
|
|
|
|
/**
|
|
* Create a new instance of an object.
|
|
* @param methodRef the reference of the constructor to invoke
|
|
* @param params the params of the method.
|
|
* @return the new object.
|
|
*/
|
|
public Object invokeConstructor(Reference methodRef, Object[] params)
|
|
throws InterpreterException, InvocationTargetException;
|
|
|
|
/**
|
|
* Check if obj is an instance of className
|
|
* @param className the type signature of the class.
|
|
* @return true, if obj is an instance of className, false otherwise.
|
|
*/
|
|
public boolean instanceOf(Object obj, String className)
|
|
throws InterpreterException;
|
|
|
|
/**
|
|
* Create a new multidimensional Array.
|
|
* @param type the type of the elements.
|
|
* @param dimensions the size in every dimension.
|
|
* @return the new array (this must be an array, see class comment).
|
|
*/
|
|
public Object newArray(String type, int[] dimensions)
|
|
throws InterpreterException;
|
|
|
|
/**
|
|
* Enter a monitor.
|
|
* @param obj the object whose monitor should be taken.
|
|
*/
|
|
public void enterMonitor(Object obj)
|
|
throws InterpreterException;
|
|
/**
|
|
* Exit a monitor.
|
|
* @param obj the object whose monitor should be freed.
|
|
*/
|
|
public void exitMonitor(Object obj)
|
|
throws InterpreterException;
|
|
}
|
|
|
|
|