added unknown variable exception + method for fetching integer size

This commit is contained in:
fros4943 2008-02-11 14:02:29 +00:00
parent 74df59e4a2
commit 47165456ca

View file

@ -24,7 +24,7 @@
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* *
* $Id: AddressMemory.java,v 1.1 2007/02/02 11:02:14 fros4943 Exp $ * $Id: AddressMemory.java,v 1.2 2008/02/11 14:02:29 fros4943 Exp $
*/ */
package se.sics.cooja; package se.sics.cooja;
@ -47,69 +47,79 @@ public interface AddressMemory {
/** /**
* Returns address of variable with given name. * Returns address of variable with given name.
* *
* @param varName * @param varName Variable name
* Variable name * @return Variable address
* @return Address of given variable, or -1 * @throws UnknownVariableException Variable does not exist
*/ */
public int getVariableAddress(String varName); public int getVariableAddress(String varName) throws UnknownVariableException;
/** /**
* Returns a value of the byte variable with the given name. * Returns a value of the byte variable with the given name.
* *
* @param varName * @param varName Name of byte variable
* Name of byte variable
* @return Value of byte variable * @return Value of byte variable
* @throws UnknownVariableException Variable does not exist
*/ */
public byte getByteValueOf(String varName); public byte getByteValueOf(String varName) throws UnknownVariableException;
/** /**
* Set byte value of variable with given name. * Set byte value of variable with given name.
* *
* @param varName * @param varName Name of byte variable
* Name of byte variable * @param newVal New value of byte
* @param newVal * @throws UnknownVariableException Variable does not exist
* New value to set
*/ */
public void setByteValueOf(String varName, byte newVal); public void setByteValueOf(String varName, byte newVal) throws UnknownVariableException;
/** /**
* Returns byte array of given length and with the given name. * Returns byte array of given length and with the given name.
* *
* @param varName * @param varName Name of array
* Name of array * @param length Length of array
* @param length
* Length of array
* @return Data of array * @return Data of array
* @throws UnknownVariableException Variable does not exist
*/ */
public byte[] getByteArray(String varName, int length); public byte[] getByteArray(String varName, int length) throws UnknownVariableException;
/** /**
* Set byte array of the variable with the given name. * Set byte array of the variable with the given name.
* *
* @param varName * @param varName Name of array
* Name of array * @param data New data of array
* @param data * @throws UnknownVariableException Variable does not exist
* New data of array
*/ */
public void setByteArray(String varName, byte[] data); public void setByteArray(String varName, byte[] data) throws UnknownVariableException;
/**
* @return Number of bytes in an integer
*/
public int getIntegerLength();
/** /**
* Returns a value of the integer variable with the given name. * Returns a value of the integer variable with the given name.
* *
* @param varName * @param varName Name of integer variable
* Name of integer variable
* @return Value of integer variable * @return Value of integer variable
* @throws UnknownVariableException Variable does not exist
*/ */
public int getIntValueOf(String varName); public int getIntValueOf(String varName) throws UnknownVariableException;
/** /**
* Set integer value of variable with given name. * Set integer value of variable with given name.
* *
* @param varName * @param varName Name of integer variable
* Name of integer variable * @param newVal New integer value
* @param newVal * @throws UnknownVariableException Variable does not exist
* New value to set
*/ */
public void setIntValueOf(String varName, int newVal); public void setIntValueOf(String varName, int newVal) throws UnknownVariableException;
/**
* Unknown variable name exception.
*/
public class UnknownVariableException extends RuntimeException {
public UnknownVariableException(String varName) {
super("Unknown variable name: " + varName);
}
}
} }