javaclass 0.0.2 → 0.0.3

data/test/ts_all_tests.rb

@@ -1,7 +1,6 @@
 #! ruby
 require 'test/unit/testsuite'
-#require 'test/unit/ui/tk/testrunner'
-#require 'test/unit/ui/console/testrunner'
+require 'test/unit' if $0 == __FILE__
 
 require File.dirname(__FILE__) + '/test_string_ux'
 # require File.dirname(__FILE__) + '/test_class_magic'
@@ -11,26 +10,48 @@ require File.dirname(__FILE__) + '/test_constant_pool'
 require File.dirname(__FILE__) + '/test_references'
 require File.dirname(__FILE__) + '/test_access_flags'
 require File.dirname(__FILE__) + '/test_java_class_header'
+require File.dirname(__FILE__) + '/test_jar_classpath'
+require File.dirname(__FILE__) + '/test_folder_classpath'
+require File.dirname(__FILE__) + '/test_java_home_classpath'
+require File.dirname(__FILE__) + '/test_composite_classpath'
+require File.dirname(__FILE__) + '/test_jar_searcher'
+require File.dirname(__FILE__) + '/test_list'
+require File.dirname(__FILE__) + '/test_class_entry'
+require File.dirname(__FILE__) + '/test_package_entry'
+require File.dirname(__FILE__) + '/test_java_name.rb'
+require File.dirname(__FILE__) + '/test_javaclass.rb'
 
-module TestJavaClass
-  
-  class TestSuite_AllTests
-    def self.suite
-      suite = Test::Unit::TestSuite.new("Ruby Java Class Parser")
-      
-      suite << TestString.suite
-      suite << TestClassVersion.suite
-      suite << TestBase.suite
-      suite << TestConstantPool.suite
-      suite << TestReferences.suite
-      suite << TestAccessFlags
-      suite << TestJavaClassHeader.suite
-      
-      return suite
-    end
+class TsAllTests
+  def self.suite
+    suite = Test::Unit::TestSuite.new("Ruby Java Class")
+    
+    suite << TestString.suite
+    
+    # Java class parser
+    suite << TestJavaClass::TestClassFile::TestClassVersion.suite
+    suite << TestJavaClass::TestClassFile::TestConstants::TestBase.suite
+    suite << TestJavaClass::TestClassFile::TestConstantPool.suite
+    suite << TestJavaClass::TestClassFile::TestReferences.suite
+    suite << TestJavaClass::TestClassFile::TestAccessFlags.suite
+    suite << TestJavaClass::TestClassFile::TestJavaClassHeader.suite
+    
+    # classpath parser
+    suite << TestJavaClass::TestClasspath::TestJarClasspath.suite
+    suite << TestJavaClass::TestClasspath::TestFolderClasspath.suite
+    suite << TestJavaClass::TestClasspath::TestJavaHomeClasspath.suite
+    suite << TestJavaClass::TestClasspath::TestCompositeClasspath.suite
+    
+    # class list
+    suite << TestJavaClass::TestClassList::TestJarSearcher.suite
+    suite << TestJavaClass::TestClassList::TestList.suite
+    suite << TestJavaClass::TestClassList::TestClassEntry.suite
+    suite << TestJavaClass::TestClassList::TestPackageEntry.suite
+    
+    # general
+    suite << TestJavaClass::TestJavaName.suite
+    suite << TestJavaClass::TestJavaClassFacade.suite
+    
+    return suite
   end
   
 end
-
-#Test::Unit::UI::Tk::TestRunner.run(TestSuite_AllTests)
-#Test::Unit::UI::Console::TestRunner.run(TestSuite_AllTests)

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: javaclass
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Peter Kofler
@@ -9,98 +14,214 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-21 00:00:00 +02:00
+date: 2010-10-03 00:00:00 +02:00
 default_executable: 
-dependencies: []
-
-description: 
-email: bruno41 at rubyforge dot org
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubyzip
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 1
+        version: 0.9.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 4
+        version: 0.8.4
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: ZenTest
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 4
+        - 4
+        - 0
+        version: 4.4.0
+  type: :development
+  version_requirements: *id003
+description: Provides access to the package, protected, and public fields and methods of the classes passed to it together with a list of all outgoing references.
+email: peter dot kofler at code minus cop dot org
 executables: []
 
 extensions: []
 
-extra_rdoc_files: []
-
+extra_rdoc_files: 
+- Readme.txt
+- history.txt
 files: 
 - Readme.txt
-- lib/javaclass/access_flags.rb
-- lib/javaclass/class_magic.rb
-- lib/javaclass/class_version.rb
-- lib/javaclass/constants/base.rb
-- lib/javaclass/constants/double_reference.rb
-- lib/javaclass/constants/single_reference.rb
-- lib/javaclass/constants/value.rb
-- lib/javaclass/constant_pool.rb
-- lib/javaclass/java_class_header.rb
-- lib/javaclass/references.rb
+- lib/javaclass/classfile/access_flags.rb
+- lib/javaclass/classfile/class_magic.rb
+- lib/javaclass/classfile/class_version.rb
+- lib/javaclass/classfile/constants/base.rb
+- lib/javaclass/classfile/constants/double_reference.rb
+- lib/javaclass/classfile/constants/single_reference.rb
+- lib/javaclass/classfile/constants/value.rb
+- lib/javaclass/classfile/constant_pool.rb
+- lib/javaclass/classfile/java_class_header.rb
+- lib/javaclass/classfile/references.rb
+- lib/javaclass/classlist/class_entry.rb
+- lib/javaclass/classlist/jar_searcher.rb
+- lib/javaclass/classlist/list.rb
+- lib/javaclass/classlist/package_entry.rb
+- lib/javaclass/classpath/classpaths.txt
+- lib/javaclass/classpath/composite_classpath.rb
+- lib/javaclass/classpath/folder_classpath.rb
+- lib/javaclass/classpath/jar_classpath.rb
+- lib/javaclass/classpath/java_home_classpath.rb
+- lib/javaclass/classpath/port_ClassPathEntry.java
+- lib/javaclass/classpath/port_ClassPathEntryFactory.java
+- lib/javaclass/classpath/port_DirectoryRepository.java
+- lib/javaclass/java_name.rb
+- lib/javaclass/metric/ccd.rb
+- lib/javaclass/metric/class_usage.rb
+- lib/javaclass/metric/metrics.txt
 - lib/javaclass/string_ux.rb
 - lib/javaclass.rb
-- test/data/AccessFlagsTestAbstract.class
-- test/data/AccessFlagsTestAbstract.java
-- test/data/AccessFlagsTestFinal.class
-- test/data/AccessFlagsTestFinal.java
-- test/data/AccessFlagsTestInterface.class
-- test/data/AccessFlagsTestInterface.java
-- test/data/AccessFlagsTestPackage.class
-- test/data/AccessFlagsTestPackage.java
-- test/data/AccessFlagsTestPublic$InnerClass.class
-- test/data/AccessFlagsTestPublic.class
-- test/data/AccessFlagsTestPublic.java
-- test/data/ClassVersionTest.java
-- test/data/ClassVersionTest10.class
-- test/data/ClassVersionTest11.class
-- test/data/ClassVersionTest12.class
-- test/data/ClassVersionTest13.class
-- test/data/ClassVersionTest14.class
-- test/data/ClassVersionTest15.class
-- test/data/ClassVersionTest16.class
-- test/data/ConstantPoolTest.class
-- test/data/ConstantPoolTest.java
-- test/data/makeAccessFlagsTest.bat
-- test/data/makeClassVersionTest.bat
-- test/data/makeConstantPoolTest.bat
+- test/data/access_flags/AccessFlagsTestAbstract.class
+- test/data/access_flags/AccessFlagsTestAbstract.java
+- test/data/access_flags/AccessFlagsTestFinal.class
+- test/data/access_flags/AccessFlagsTestFinal.java
+- test/data/access_flags/AccessFlagsTestInterface.class
+- test/data/access_flags/AccessFlagsTestInterface.java
+- test/data/access_flags/AccessFlagsTestPackage.class
+- test/data/access_flags/AccessFlagsTestPackage.java
+- test/data/access_flags/AccessFlagsTestPublic$Inner.class
+- test/data/access_flags/AccessFlagsTestPublic$InnerInterface.class
+- test/data/access_flags/AccessFlagsTestPublic$StaticInner.class
+- test/data/access_flags/AccessFlagsTestPublic.class
+- test/data/access_flags/AccessFlagsTestPublic.java
+- test/data/access_flags/AccessFlagsTestPublic_javap.txt
+- test/data/access_flags/make.bat
+- test/data/class_version/ClassVersionTest.java
+- test/data/class_version/ClassVersionTest10.class
+- test/data/class_version/ClassVersionTest11.class
+- test/data/class_version/ClassVersionTest12.class
+- test/data/class_version/ClassVersionTest13.class
+- test/data/class_version/ClassVersionTest14.class
+- test/data/class_version/ClassVersionTest15.class
+- test/data/class_version/ClassVersionTest16.class
+- test/data/class_version/make.bat
+- test/data/constant_pool/ConstantPoolTest.class
+- test/data/constant_pool/ConstantPoolTest.java
+- test/data/constant_pool/make.bat
+- test/data/folder_classpath/JarClasspathTestFolder/ClassVersionTest10.class
+- test/data/folder_classpath/JarClasspathTestFolder/package/ClassVersionTest11.class
+- test/data/jar_classpath/JarClasspathTest.jar
+- test/data/jar_classpath/JarClasspathTest.zip
+- test/data/jar_classpath/JarClasspathTestManifest.jar
+- test/data/jar_classpath/JarClasspathTestMultiManifest.jar
+- test/data/jar_classpath/make.bat
+- test/data/jar_searcher/JarClassListTest.jar
+- test/data/jar_searcher/make.bat
+- test/data/jar_searcher/PublicClass.java
+- test/data/jar_searcher/PublicInterface.java
+- test/data/java_home_classpath/jdk/jre/lib/rt.jar
+- test/data/java_home_classpath/jre/lib/rt.jar
+- test/data/java_home_classpath/jre-ext/lib/ext/ext.jar
+- test/data/java_home_classpath/jre-ext/lib/rt.jar
+- test/data/java_home_classpath/make.bat
+- test/data/references/make.bat
+- test/data/references/ReferencesTest.class
+- test/data/references/ReferencesTest.java
+- test/data/ShortClientData$1-4000Wert.class
 - test/setup.rb
 - test/test_access_flags.rb
 - test/test_base.rb
+- test/test_class_entry.rb
 - test/test_class_version.rb
+- test/test_composite_classpath.rb
 - test/test_constant_pool.rb
+- test/test_folder_classpath.rb
+- test/test_jar_classpath.rb
+- test/test_jar_searcher.rb
+- test/test_javaclass.rb
 - test/test_java_class_header.rb
+- test/test_java_home_classpath.rb
+- test/test_java_name.rb
+- test/test_list.rb
+- test/test_package_entry.rb
 - test/test_references.rb
 - test/test_string_ux.rb
 - test/ts_all_tests.rb
+- examples/generate_class_lists.rb
 - history.txt
 - Rakefile
 has_rdoc: true
-homepage: http://javaclass.rubyforge.org/
-post_install_message: 
-rdoc_options: []
+homepage: http://code.google.com/p/javaclass-rb/
+licenses: []
 
+post_install_message: 
+rdoc_options: 
+- --title
+- javaclass-0.0.3 Documentation
+- --main
+- Readme.txt
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+      segments: 
+      - 1
+      - 8
+      - 6
+      version: 1.8.6
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: javaclass
-rubygems_version: 1.3.1
+rubygems_version: 1.3.7
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: A parser and disassembler for Java class files
 test_files: 
 - test/test_access_flags.rb
 - test/test_base.rb
+- test/test_class_entry.rb
 - test/test_class_version.rb
+- test/test_composite_classpath.rb
 - test/test_constant_pool.rb
+- test/test_folder_classpath.rb
+- test/test_jar_classpath.rb
+- test/test_jar_searcher.rb
+- test/test_javaclass.rb
 - test/test_java_class_header.rb
+- test/test_java_home_classpath.rb
+- test/test_java_name.rb
+- test/test_list.rb
+- test/test_package_entry.rb
 - test/test_references.rb
 - test/test_string_ux.rb

data/lib/javaclass/access_flags.rb

@@ -1,44 +0,0 @@
-require 'javaclass/string_ux'
-
-module JavaClass
-  
-  # The access flags of a class or interface.
-  # Author::   Peter Kofler
-  class AccessFlags
-    
-    # Access flags as defined by JVM spec.
-    ACC_PUBLIC = 0x0001    
-    ACC_FINAL = 0x0010    
-    ACC_SUPER = 0x0020 # old invokespecial instruction semantics    
-    ACC_INTERFACE = 0x0200    
-    ACC_ABSTRACT = 0x0400
-    ACC_OTHER = 0xffff ^ ACC_PUBLIC ^ ACC_FINAL ^ ACC_SUPER ^ ACC_INTERFACE ^ ACC_ABSTRACT
-    
-    def initialize(data, pos)
-      @flags = data.u2(pos)
-      raise "inconsistent flags #{flags}" if abstract? && final?
-      raise "inconsistent flags #{flags}" if interface? && (!abstract? || final?)
-      raise "inconsistent flags #{flags}" if (@flags & ACC_OTHER) != 0
-    end
-    
-    # Return +true+ if the class is public.
-    def public?
-     (@flags & ACC_PUBLIC) != 0
-    end
-    alias accessible? public?   
-    
-    def final?
-     (@flags & ACC_FINAL) != 0
-    end
-    
-    def abstract?
-     (@flags & ACC_ABSTRACT) != 0
-    end
-    
-    def interface?
-     (@flags & ACC_INTERFACE) != 0
-    end
-    
-  end
-  
-end

data/lib/javaclass/class_magic.rb

@@ -1,27 +0,0 @@
-module JavaClass
-  
-  # The +CAFEBABE+ magic of a class file.
-  # Author::   Peter Kofler
-  class ClassMagic
-    
-    CAFE_BABE = "\xCA\xFE\xBA\xBE"
-    
-    # Check the class magic in the _data_ beginning at position _start_ (which is usually 0).
-    def initialize(data, start=0)
-      # "parsing"
-      @bytes = data[start..start+3]
-    end
-    
-    # Return +true+ if the data was valid, i.e. if the class started with +CAFEBABE+.
-    def valid?
-      @bytes == CAFE_BABE
-    end
-    
-    # Return the value of the magic in this class.
-    def bytes
-      @bytes.dup
-    end
-    
-  end
-  
-end

data/lib/javaclass/class_version.rb

@@ -1,65 +0,0 @@
-require 'javaclass/string_ux'
-
-module JavaClass
-  
-  # Version of a class file.
-  # Author::   Peter Kofler
-  # See::      http://java.sun.com/docs/books/jvms/second_edition/html/ClassFile.doc.html#75883
-  class ClassVersion
-    
-    attr_reader :minor
-    attr_reader :major
-    
-    # Extract the class version from the bytes _data_ starting at position _start_ (which is usually 4).
-    def initialize(data, start=4)
-      # parsing
-      @minor = data.u2(start)
-      @major = data.u2(start+2)
-    end
-    
-    # Return the class file version as +major+.+minor+ string like 48.0 (Java 1.4) or 50.0 (Java 6).
-    def to_s
-      "#{@major}.#{@minor}"
-    end
-    
-    # Return the version as +major+.+minor+ float.
-    def to_f
-      if @minor <= 0
-        denom = 1.0
-      else
-        denom = 1.0 * 10**(Math.log10(@minor).floor + 1)
-      end
-
-      @major + @minor/denom
-    end
-    
-    # Return a debug output of this version.
-    def dump
-      ["  minor version: #{@minor}", "  major version: #{@major}"] 
-    end
-    
-    # Return the JDK version corresponding to this version like "1.6" or "unknown" if none matched.
-    def jdk_version
-      v = to_f
-      if v >= 45.0 && v <= 45.3 # 1.0.2 supports class file format versions 45.0 through 45.3 inclusive.
-        '1.0'
-      elsif v > 45.3 && v <= 45.65535 # 1.1.X can support class file formats of versions in the range 45.0 through 45.65535 inclusive
-        '1.1'
-      elsif v == 46.0 # JDK 1.2=46
-        '1.2'
-      elsif v == 47.0 # JDK 1.3=47
-        '1.3'
-      elsif v == 48.0 # JDK 1.4=48
-        '1.4'
-      elsif v == 49.0 # J2SE 5.0=49
-        '1.5'
-      elsif v == 50.0 # J2SE 6.0=50
-        '1.6'
-      else
-        'unknown'
-      end
-    end
-    
-  end
-  
-end

data/lib/javaclass/constant_pool.rb

@@ -1,85 +0,0 @@
-require 'javaclass/string_ux'
-require 'javaclass/constants/value'
-require 'javaclass/constants/single_reference'
-require 'javaclass/constants/double_reference'
-
-module JavaClass
-  
-  # Container of the constant pool's constants.
-  # Author::   Peter Kofler
-  class ConstantPool
-    
-    # Types of constants by their +tag+.
-    CONSTANT_TYPE_TAGS = {
-      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,
-    }
-    
-    # Size of the whole constant pool in bytes.
-    attr_reader :size
-    
-    # Parse the constant pool from the bytes _data_ beginning at position _start_ (which is usually 8).
-    def initialize(data, start=8)
-      @pool = {} # cnt (fixnum) => constant
-      
-      # parsing
-      @item_count = data.u2(start)
-      pos = start + 2
-      cnt = 1
-      while cnt <= @item_count-1
-        
-        type = CONSTANT_TYPE_TAGS[data.u1(pos)]
-        unless type
-          #puts dump.join("\n") 
-          raise "const ##{cnt} = unknown constant pool tag #{data[pos]} at pos #{pos} in class"
-        end
-        
-        constant = type.new(@pool, data, pos)
-        @pool[cnt] = constant
-        pos += constant.size
-        cnt += constant.slots
-        
-      end
-      
-      @size = pos - start
-    end
-    
-    # Return the number of pool items. This number might be larger than +items+ available, 
-    # because +long+ and +double+ constants take two slots.
-    def item_count
-      @item_count-1
-    end
-    
-    # Return the _index_'th pool item. _index_ is the real index in the pool which may skip numbers. 
-    def[](index)
-      @pool[index]
-    end
-    
-    # Return an array of the ordered list of constants.
-    def items
-      @pool.keys.sort.collect { |k| self[k] }
-    end
-    
-    # Return an array of all constants of the given _tags_ types.
-    def find(*tags)
-      items.find_all { |item| tags.include? item.tag }
-    end
-    
-    # Return a debug output of the whole pool.
-    def dump
-      ["  Constant pool:"] + @pool.keys.sort.collect { |k| "const ##{k} = #{self[k].dump}"}
-    end
-    
-  end
-  
-end
-

data/lib/javaclass/constants/base.rb

@@ -1,31 +0,0 @@
-require 'javaclass/string_ux'
-
-module JavaClass 
-  module Constants # :nodoc:
-    
-    # Superclass of constant values in the constant pool. Every constant has a +name+, a +tag+ and a +size+ in bytes.
-    # Author::   Peter Kofler
-    class Base
-      
-      attr_reader :name
-      attr_reader :tag
-      attr_reader :size
-      attr_reader :slots
-      
-      # Set default constants.
-      def initialize(name=nil)
-        @name = self.class.to_s[/::[^:]+$/][10..-1] # skip modules (::) and "Constant"
-        @name = name if name
-        @size = 3
-        @slots = 1
-      end
-      
-      # Return part of debug output.
-      def dump
-        "#{@name}\t" # #{@tag} 
-      end
-      
-    end
-    
-  end
-end

data/lib/javaclass/constants/double_reference.rb

@@ -1,81 +0,0 @@
-require 'javaclass/constants/single_reference'
-
-module JavaClass 
-  module Constants # :nodoc:
-    
-    # Superclass of double reference constants like +ConstantField+ (+FieldRef+) in the constant pool. 
-    # Author::   Peter Kofler
-    class DoubleReference < SingleReference
-      
-      attr_reader :second_index
-      
-      # Define a double reference into _pool_ from _data_ beginning at _start_
-      def initialize(pool, data, start, name=nil)
-        super(pool, data, start, name)
-        @size = 5
-        
-        @second_index = data.u2(start+3)
-      end
-      
-      # Return the second value, which is the referenced value from the pool.
-      def second_value
-        get(@second_index)
-      end
-      
-      # Return the value, which are both referenced values from the pool.
-      def to_s
-        "#{super}.#{second_value}"
-      end
-      
-      # Return part of debug output.
-      def dump
-        "#{@name}\t##{@first_index}.##{@second_index};\t//  #{to_s}"
-      end
-      
-    end
-    
-    class ConstantField < DoubleReference
-      alias class_index first_index 
-      alias name_and_type_index second_index 
-      def initialize(pool, data, start) 
-        super(pool, data, start)
-      end
-      alias class_name first_value
-    end
-    
-    class ConstantMethod < DoubleReference
-      alias class_index first_index 
-      alias name_and_type_index second_index 
-      def initialize(pool, data, start) 
-        super(pool, data, start)
-      end  
-      alias class_name first_value
-    end
-    
-    class ConstantInterfaceMethod < DoubleReference
-      alias class_index first_index 
-      alias name_and_type_index second_index 
-      def initialize(pool, data, start) 
-        super(pool, data, start)
-      end  
-      alias class_name first_value
-    end
-    
-    class ConstantNameAndType < DoubleReference
-      alias name_index first_index 
-      alias descriptor_index second_index 
-      def initialize(pool, data, start)
-        super(pool, data, start)
-      end
-      
-      def to_s
-        "#{get(name_index)}:#{get(descriptor_index)}"
-      end
-      
-      def dump
-        "#{@name}\t##{name_index}:##{descriptor_index};//  #{to_s}"
-      end
-    end
-    
-  end
-end