comparison jvmci/jdk.vm.ci.meta/src/jdk/vm/ci/meta/MemoryAccessProvider.java @ 23341:67c84a8b19cc

fixed javadoc and implementation of MemoryAccessProvider methods to only throw IllegalArgumentException (JDK-8152024)
author Doug Simon <doug.simon@oracle.com>
date Wed, 30 Mar 2016 16:06:48 +0200
parents 1bbd4a7c274b
children 73ceb487b9ca
comparison
equal deleted inserted replaced
23340:22c3bdf28fff 23341:67c84a8b19cc
33 * 33 *
34 * @param base the base address from which the value is read. 34 * @param base the base address from which the value is read.
35 * @param displacement the displacement within the object in bytes 35 * @param displacement the displacement within the object in bytes
36 * @return the read value encapsulated in a {@link JavaConstant} object, or {@code null} if the 36 * @return the read value encapsulated in a {@link JavaConstant} object, or {@code null} if the
37 * value cannot be read. 37 * value cannot be read.
38 * @throws IllegalArgumentException if {@code kind} is {@link JavaKind#Void} or not
39 * {@linkplain JavaKind#isPrimitive() primitive} kind
38 */ 40 */
39 JavaConstant readUnsafeConstant(JavaKind kind, JavaConstant base, long displacement); 41 JavaConstant readUnsafeConstant(JavaKind kind, JavaConstant base, long displacement) throws IllegalArgumentException;
40 42
41 /** 43 /**
42 * Reads a primitive value using a base address and a displacement. 44 * Reads a primitive value using a base address and a displacement.
43 * 45 *
44 * @param kind the {@link JavaKind} of the returned {@link JavaConstant} object 46 * @param kind the {@link JavaKind} of the returned {@link JavaConstant} object
45 * @param base the base address from which the value is read 47 * @param base the base address from which the value is read
46 * @param displacement the displacement within the object in bytes 48 * @param displacement the displacement within the object in bytes
47 * @param bits the number of bits to read from memory 49 * @param bits the number of bits to read from memory
48 * @return the read value encapsulated in a {@link JavaConstant} object of {@link JavaKind} kind 50 * @return the read value encapsulated in a {@link JavaConstant} object of {@link JavaKind} kind
51 * @throws IllegalArgumentException if {@code kind} is {@link JavaKind#Void} or not
52 * {@linkplain JavaKind#isPrimitive() primitive} kind or {@code bits} is not 8, 16,
53 * 32 or 64
49 */ 54 */
50 JavaConstant readPrimitiveConstant(JavaKind kind, Constant base, long displacement, int bits); 55 JavaConstant readPrimitiveConstant(JavaKind kind, Constant base, long displacement, int bits) throws IllegalArgumentException;
51 56
52 /** 57 /**
53 * Reads a Java {@link Object} value using a base address and a displacement. 58 * Reads a Java {@link Object} value using a base address and a displacement.
54 * 59 *
55 * @param base the base address from which the value is read 60 * @param base the base address from which the value is read