org.jace.parser.attribute.ConstantValueAttribute Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jace-core-java Show documentation
Jace core module, Java source-code
There is a newer version: 1.2.22
package org.jace.parser.attribute;

import org.jace.parser.ConstantPool;
import org.jace.parser.constant.Constant;
import org.jace.parser.constant.UTF8Constant;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;

/**
 * A ConstantValueAttribute represents a constant value for a static ClassField.
 *
 * A ConstantValueAttribute may represent any constant type. 
 *
 * @author Toby Reyelts
 * @author Gili Tzabari
 */
public class ConstantValueAttribute implements Attribute
{
	/* From the JVM specification.
	 *
	 * (u1 represents an unsigned byte)
	 * (u2 represents an unsigned short)
	 * (u4 represents an unsigned int)
	 *
	 * attribute_info {
	 *   u2 attribute_name_index;
	 *   u4 attribute_length;
	 *   u2 constantvalue_index;
	 * }
	 */
	private int nameIndex;
	private int length;
	private int valueIndex;
	private ConstantPool pool;

	/**
	 * Creates a new ConstantValueAttribute.
	 *
	 * @param stream the stream to read from
	 * @param nameIndex the attribute index in the constant pool
	 * @param pool the constant pool to read from
	 * @throws IOException if an I/O error occurs while reading the attribute
	 */
	public ConstantValueAttribute(InputStream stream, int nameIndex, ConstantPool pool)
		throws IOException
	{
		this.pool = pool;
		this.nameIndex = nameIndex;

		// Read the name for this constant.
		// From the VM spec, we know it must be equal to "ConstantValue"
		Constant c = pool.getConstantAt(nameIndex);

		if (c instanceof UTF8Constant)
		{
			String name = c.getValue().toString();

			if (!name.equals("ConstantValue"))
			{
				throw new ClassFormatError("While reading a ConstantValueAttribute, the name ConstantValue was expected, "
																	 + "but the name " + name + " was encountered.");
			}
		}
		else
		{
			throw new ClassFormatError("While reading a ConstantValueAttribute, a UTF8Constant was expected, "
																 + "but a constant of type " + c.getClass().getName()
																 + " was encountered.");
		}
		DataInputStream input = new DataInputStream(stream);

		// Read the length of the attribute.
		// From the VM spec, we know that length must = 2
		length = input.readInt();

		if (length != 2)
		{
			throw new ClassFormatError("While reading a ConstantValueAttribute, an attribute length of size 2 was expected, "
																 + "but an attribute length of size " + length
																 + " was encountered.");
		}
		valueIndex = input.readUnsignedShort();
	}

	@Override
	public String getName()
	{
		return pool.getConstantAt(nameIndex).toString();
	}

	/**
	 * Returns the Constant that represents the value of this ConstantValueAttribute.
	 *
	 * Based on the type of the ClassField this ConstantValueAttribute belongs to,
	 * the Constant may be one of the following:
	 *
	 *   long - LongConstant
	 *   float - FloatConstant
	 *   double - DoubleConstant
	 *   int, short, char, byte, boolean - IntegerConstant
	 *   String - StringConstant
	 *
	 * @return the Constant that represents the value of this ConstantValueAttribute
	 */
	public Constant getValue()
	{
		return pool.getConstantAt(valueIndex);
	}

	/**
	 * Returns the length of this Attribute.
	 *
	 * @return the length of this Attribute
	 */
	public int getLength()
	{
		return length;
	}

	@Override
	public void write(DataOutputStream output) throws IOException
	{
		output.writeShort(nameIndex);
		output.writeInt(length);
		output.writeShort(valueIndex);
	}

	@Override
	public String toString()
	{
		return getClass() + " " + getValue();
	}
}