Class: JavaClass::ClassFile::ConstantPool

Inherits:
Object
  • Object
show all
Defined in:
lib/javaclass/classfile/constant_pool.rb

Overview

Container of the constant pool’s constants.

Author

Peter Kofler

Constant Summary collapse

CONSTANT_TYPE_TAGS =

Types of constants by their tag.

{
  CLASS_TAG     = 7 => Constants::ConstantClass,
  FIELD_TAG     = 9 => Constants::ConstantField,
  METHOD_TAG    = 10 => Constants::ConstantMethod,
  INTERFACE_METHOD_TAG = 11 => Constants::ConstantInterfaceMethod,
  STRING_TAG    = 8 => Constants::ConstantString,
  INT_TAG       = 3 => Constants::ConstantInt,
  FLOAT_TAG     = 4 => Constants::ConstantFloat,
  LONG_TAG      = 5 => Constants::ConstantLong,
  DOUBLE_TAG    = 6 => Constants::ConstantDouble,
  NAME_AND_TYPE_TAG = 12 => Constants::ConstantNameAndType,
  ASCIZ_TAG     = 1 => Constants::ConstantAsciz,
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(data, start = 8) ⇒ ConstantPool

Parse the constant pool from the bytes data beginning at position start (which is usually 8).



33
34
35
36
37
38
39
40
41
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 33

def initialize(data, start=8)
  creator = PoolCreator.new(data, start)
  creator.create!
  
  @pool = creator.pool # cnt (Fixnum) => constant class
  @item_count = creator.item_count
  
  @size = @pool.values.inject(0) { |sum, constant| sum + constant.size } + 2
end

Instance Attribute Details

#size ⇒ Object (readonly)

Size of the whole constant pool in bytes.



30
31
32
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 30

def size
  @size
end

Instance Method Details

#[](index) ⇒ Object

Return the index’th pool item. index is the real index in the pool which may skip numbers.



50
51
52
53
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 50

def[](index)
  check_index(index)
  @pool[index]
end

#class_item(index) ⇒ Object

Return the constant class from index’th pool item.



83
84
85
86
87
88
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 83

def class_item(index)
  if self[index] && !self[index].const_class?
    raise ClassFormatError, "inconsistent constant pool entry #{index} for class, should be Constant Class"
  end
  self[index]
end

#dump ⇒ Object

Return a debug output of the whole pool.



78
79
80
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 78

def dump
  ["  Constant pool:"] + @pool.keys.sort.collect { |k| "const ##{k} = #{self[k].dump}"}
end

#field_item(index) ⇒ Object

Return the constant field from index’th pool item.



91
92
93
94
95
96
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 91

def field_item(index)
  if self[index] && !self[index].const_field?
    raise ClassFormatError, "inconsistent constant pool entry #{index} for field, should be Constant Field"
  end
  self[index]
end

#find(*tags) ⇒ Object

Return an array of all constants of the given tags types.



68
69
70
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 68

def find(*tags)
  items.find_all { |item| tags.include? item.tag }
end

#item_count ⇒ Object

Return the number of pool items. This number might be larger than items available, because long and double constants take two slots.



45
46
47
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 45

def item_count
  @item_count - 1
end

#items ⇒ Object

Return an array of the ordered list of constants.



63
64
65
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 63

def items
  @pool.keys.sort.collect { |k| self[k] }
end

#method_item(index) ⇒ Object

Return the constant method from index’th pool item.



99
100
101
102
103
104
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 99

def method_item(index)
  if self[index] && !self[index].const_method?
    raise ClassFormatError, "inconsistent constant pool entry #{index} for method, should be Constant Method"
  end
  self[index]
end

#strings ⇒ Object

Return all string constants.



73
74
75
 
# File 'lib/javaclass/classfile/constant_pool.rb', line 73

def strings
  find(STRING_TAG)
end