javaclass 0.0.2 → 0.0.3

data/Rakefile

@@ -1,51 +1,236 @@
+#require 'FileUtils' # already required
+require 'net/http'
 require 'rubygems'
-
+require 'rubygems/gem_runner' # install and uninstall
 require 'rake'
+require 'rake/clean' # for clean/clobber
 require 'rake/testtask'
-require 'rake/packagetask'
 require 'rake/gempackagetask'
+require 'rake/packagetask'
 require 'rake/rdoctask'
 
-jcversion = '0.0.2'
+# Test, package and publish functions.
+# Author::          Peter Kofler
+# See: http://rake.rubyforge.org/files/doc/rakefile_rdoc.html
+GEM_NAME = 'javaclass'
+GOOGLE_PROJECT = "#{GEM_NAME}-rb"
+RDOC_DIR = 'html'
+RDOC_REPO = 'api'
 
 gemspec = Gem::Specification.new do |s|
-  s.name = 'javaclass'
-  s.version = jcversion
-  s.summary ='A parser and disassembler for Java class files'
-  s.files = FileList['Readme.txt', '{lib,test}/**/*.*', 'history.txt', 'Rakefile']
-  s.test_files = FileList["{test}/**/test_*.rb"]
-  s.require_path = 'lib'
-  s.has_rdoc = true
-  s.rubyforge_project = 'javaclass'
-  s.homepage = 'http://javaclass.rubyforge.org/'
+  s.version = '0.0.3'
+  s.name = GEM_NAME
+  s.rubyforge_project = 'javaclass' # old, just redirects
+  s.summary = 'A parser and disassembler for Java class files'
+  s.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.'
+  s.homepage = "http://code.google.com/p/#{GOOGLE_PROJECT}/"
   s.author = 'Peter Kofler'
-  s.email = 'bruno41 at rubyforge dot org'
-  # TODO use new cc email
+  s.email = 'peter dot kofler at code minus cop dot org'
+  
+  s.files = FileList['Readme.txt', '{lib,test,examples}/**/*.*', 'history.txt', 'Rakefile']
+  s.test_files = FileList['test/**/test_*.rb']
+  s.require_path = 'lib'
+  s.add_dependency('rubyzip', '>= 0.9.1')
+  s.required_ruby_version = '>= 1.8.6' 
   s.platform = Gem::Platform::RUBY
+  s.add_development_dependency('rake', '>= 0.8.4')
+  s.add_development_dependency('ZenTest', '>= 4.4.0')
+  
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['Readme.txt', 'history.txt']
+  s.rdoc_options << '--title' << "#{s.name}-#{s.version} Documentation" <<
+                    '--main' << 'Readme.txt' 
+end
+full_gem_name = "#{gemspec.name}-#{gemspec.version}"
+
+desc 'Validates the gemspec'
+task :validate_gem do 
+  gemspec.validate
+end
+
+desc 'Displays the current version'
+task :version do 
+  puts gemspec.version
+end
+
+# :test
+Rake::TestTask.new do |t| 
+  t.test_files = gemspec.test_files
+  t.warning = true
+  #t.verbose = false is default
+end
+
+desc 'Find missing test methods with ZenTest'
+task :zentest do
+  files = gemspec.files.find_all { |f| f =~ /^#{gemspec.require_path}.*\.rb$/ } + gemspec.test_files
+  output = `ruby -I#{gemspec.require_path} -e "require 'rubygems'; load(Gem.bin_path('ZenTest', 'zentest'))" #{files.join(' ')}`
+  puts output.gsub(/^#.*\n/, '') # skip all ZenTest comments
 end
 
-Rake::GemPackageTask.new(gemspec) do |pkg|
+# :gem
+Rake::GemPackageTask.new(gemspec) do |pkg| 
   pkg.need_zip = true
 end
 
-Rake::PackageTask.new(gemspec.name, gemspec.version) do |pkg|
+# :package, :clobber_package, :repackage
+Rake::PackageTask.new(gemspec.name, gemspec.version) do |pkg| 
   #pkg.need_tar = true - no compress in tar on unxutils in Windows
   #pkg.need_tar_gz = true - no compress in tar on unxutils in Windows
   pkg.need_zip = true
   pkg.package_files.include gemspec.files
 end
 
-Rake::TestTask.new do |t|
-  t.pattern = 'test/**/test_*.rb'
-  t.warning = true
-  t.verbose = false
+desc 'Install the gem locally'
+task :install_gem => :package do
+  Gem::GemRunner.new.run ['install', "pkg/#{full_gem_name}"]
+end
+
+desc 'Uninstall the gem'
+task :uninstall_gem do
+  Gem::GemRunner.new.run ['uninstall', gemspec.name]
+end
+
+# Helper method to execute Mercurial with the _params_ array.
+# The +hg+ executable must be in the path.
+def hg(params)
+  puts `hg #{params.join(' ')}`
+end
+
+desc 'Tag current version in Hg'
+task :tag do
+  hg ['tag', '-f', "-m \"Released gem version #{gemspec.version}\"", "#{full_gem_name}"]
+  puts 'Tag created. Don\'t forget to push'
+end
+
+# internal - desc 'Release the gem to Rubygems'
+task :release_rubygems => :package do
+  puts "Releasing #{full_gem_name} to Rubygems"
+  Gem::GemRunner.new.run ['push', "pkg/#{full_gem_name}.gem"]
+end
+
+# Read username and password from the <code>~/.hgrc</code> for _authname_ prefix.
+# <code>HOME</code> environment must be set.
+def user_pass_from_hgrc(authname)
+  lines = IO.readlines(File.expand_path('~/.hgrc'))
+  user = lines.find{ |l| l =~ /#{authname}.username/ }[/[^\s=]+$/] 
+  raise "could not find key #{authname}.username in ~/.hgrc" unless user
+  pass = lines.find{ |l| l =~ /#{authname}.password/ }[/[^\s=]+$/]
+  raise "could not find key #{authname}.password in ~/.hgrc" unless pass
+  [user, pass] 
+end
+
+# Download the <code>googlecode_upload.py</code> from Google Code repository and save it as _name_ .
+# See:: http://support.googlecode.com/svn/trunk/scripts/googlecode_upload.py
+def download_googlecode_upload_py(name)
+  Net::HTTP.start('support.googlecode.com', 80) do |http|
+    body = http.get("/svn/trunk/scripts/#{name}").body
+    File.open(name, 'w') { |f| f.print body }
+  end
+end
+
+# Helper method to execute Python with the _params_ array.
+# The +python+ executable must be in the path.
+def python(params)
+  puts `python #{params.join(' ')}`
+end
+
+# internal - desc 'Release the gem to Google Code'
+task :release_googlecode => :package do
+  puts "Releasing #{full_gem_name} to GoogleCode"
+  user, pass = user_pass_from_hgrc(gemspec.name)
+  # See:: http://code.google.com/p/support/wiki/ScriptedUploads
+  download_googlecode_upload_py 'googlecode_upload.py'
+  ['gem', 'zip'].each do |extension|
+    puts "uploading \"pkg/#{full_gem_name}.#{extension}\"..."
+    python ['googlecode_upload.py', "-s \"JavaClass #{gemspec.version} #{extension.capitalize}\"", "-p #{GOOGLE_PROJECT}", "-u #{user}", "-w #{pass}", "pkg/#{full_gem_name}.#{extension}"]
+  end
 end
 
+desc 'Package and upload gem to Rubygems and Google Code'
+task :publish_gem => [:clobber_package, :package, :release_rubygems, :release_googlecode] 
+
+# :rdoc, :clobber_rdoc, :rerdoc
 Rake::RDocTask.new do |rdoc|
-  # rdoc.rdoc_dir = 'html'
-  rdoc.title    = "JavaClass javaclass-#{jcversion} Documentation"
-  rdoc.main     = 'Readme.txt'
+  rdoc.rdoc_dir = RDOC_DIR # 'html' is default anyway
+  rdoc.title = "#{full_gem_name} Documentation"
+  rdoc.main = 'Readme.txt'
   rdoc.rdoc_files.include 'Readme.txt', 'lib/**/*.rb', 'history.txt'
 end
 
+# Helper method to add target="_parent" to all external links in _file_ html.
+def add_href_parent(file)
+  lines = IO.readlines(file).collect do |line|
+    if line =~ /(href=(?:'|")https?:\/\/)/
+      "#{$`}target=\"_parent\" #{$1}#{$'}"
+    else 
+      line
+    end
+  end
+  File.open(file, 'w') { |f| f.print lines.join }
+end
+
+desc 'Fix the RDoc hrefs in framesets'
+task :fix_rdoc => [:rdoc] do 
+  Dir["#{RDOC_DIR}/**/*.html"].each { |file| add_href_parent(file) } 
+end
+
+# Helper method to add the gem version _dir_ into index _file_ to frameset links.
+def add_frameset_version(file, dir)
+  lines = IO.readlines(file).collect do |line|
+    if line =~ /(frame src=")/
+      "#{$`}#{$1}#{dir}/#{$'}"
+    else 
+      line
+    end
+  end
+  File.open(file, 'w') { |f| f.print lines.join }
+end
+
+desc 'Publish the RDoc files to Google Code'
+task :publish_rdoc => [:clobber_rdoc, :rdoc, :fix_rdoc] do 
+  puts "Releasing #{full_gem_name} to API"
+
+  remote_repo = "https://#{RDOC_REPO}.#{GOOGLE_PROJECT}.googlecode.com/hg/"
+  remote_dir = "#{gemspec.version}"
+  
+  FileUtils.rm_r RDOC_REPO rescue nil
+  hg ['clone', remote_repo, RDOC_REPO]
+  
+  FileUtils.rm_r "#{RDOC_REPO}/#{remote_dir}" rescue nil
+  FileUtils.cp_r RDOC_DIR, "#{RDOC_REPO}/#{remote_dir}"
+  
+  # modify index, update redirect in frameset
+  file = "#{RDOC_REPO}/index.html"
+  FileUtils.cp "#{RDOC_REPO}/#{remote_dir}/index.html", file
+  add_frameset_version(file, remote_dir)
+  
+  hg ['addremove', '-q', "-R #{RDOC_REPO}"]
+  hg ['ci', "-m \"Update Rdoc for version #{gemspec.version}\"", "-R #{RDOC_REPO}"]
+  hg ['tag', '-f', "-m \"Released gem version #{gemspec.version}\"", "-R #{RDOC_REPO}", "#{full_gem_name}"]
+  hg ['push', "-R #{RDOC_REPO}"]
+end
+
+# :clean :clobber 
+CLOBBER.include(RDOC_REPO, 'googlecode_upload.py')
+
+# Helper method to grep all the sources for some _pattern_ words.
+def egrep(pattern)
+  Dir['**/*'].find_all { |fn| FileTest.file? fn }.each do |fn|
+    line_count = 0
+    open(fn) do |f|
+      while line = f.gets
+        line_count += 1
+        if line =~ pattern
+          puts "#{fn}:#{line_count}:#{line.strip}"
+        end
+      end
+    end
+  end
+end
+
+desc 'Look for TODO and FIXME tags'
+task :todo do
+  egrep(/#.*(FI[X]ME|TO[D]O|T[B]D|H[A]CK)/i) # use 'odd' brackets to not find myself (and not have Eclipse markers)
+end
+
 task :default => :test

data/Readme.txt

@@ -1,47 +1,84 @@
-JavaClass
-by {Peter Kofler}[http://kofler.dot.at/work/]
+javaclass-rb
+by {Peter 'Code Cop' Kofler}[http://www.code-cop.org/]
 
-* {Homepage}[http://javaclass.rubyforge.org/]
-* {Rubyforge Project}[http://rubyforge.org/projects/javaclass]
-* email bruno41 at rubyforge dot org 
+* {Homepage (Google Code)}[http://code.google.com/p/javaclass-rb/]
+* {Rubyforge Project (old)}[http://rubyforge.org/projects/javaclass]
+* email peter dot kofler at code minus cop dot org
 
 == Description
 
-JavaClass (Java Class File Parser) is a
-parser and disassembler for Java class files, similar to the javap command. 
-It 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.   
+javaclass-rb (Java Class File Parser for Ruby) is a
+parser and disassembler for Java class files, similar to the javap command.
+It 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.
 
 == Motivation
 
-I am still doing Java most of the time. I used to be quite enthusiatic about
-it, but after 9 years I can see the advantages of being a polyglot. So I use
-Ruby for all kind of stuff, just for fun. Recently I needed some Java class
-analysis and happened to write it with Ruby. As I am a puritan, I did not
+I am still doing Java most of the time. I used to be quite enthusiastic about
+it, but after 11 years I can see the advantages of being a polyglot. So I use
+Ruby for all kind of stuff, just for fun. When I needed some Java class
+analysis I wrote it with Ruby. As I am a puritan, I did not
 want to call javap from my script, so I started disassembling the class files,
-which might be the the base for some serious static code analysis tools. (I
-started adding methods to that end...) 
+which might be the base for some serious static code analysis tools. (I
+started adding methods to that end...)
 
 == Install
 
   sudo gem install javaclass
 
+* {Gem Hosting}[http://rubygems.org/gems/javaclass]
+* {Download of tarballs and gems}[http://code.google.com/p/javaclass-rb/downloads/list]
+
 == Usage
 
   require 'javaclass'
+
+  # load the class directly from the file system
+  clazz = JavaClass.load_fs('packagename/Public.class')
+  
+  # better lookup the class from some classpath
+  classpath = JavaClass.classpath('some/path')
+  clazz = JavaClass.load_cp('packagename.Public', classpath)
   
-  clazz = JavaClass.parse('packagename/Public.class')
   clazz.version                          # => 50.0
   clazz.constant_pool.items[1]           # => packagename/Public
   clazz.access_flags.public?             # => true
   clazz.this_class                       # => packagename/Public
+  clazz.this_class.to_java_file          # => packagename/Public.java
   clazz.super_class                      # => java/lang/Object
+  clazz.super_class.to_classname         # => java.lang.Object
   clazz.references.referenced_methods[0] # => java/lang/Object.<init>:()V
 
-== Requirements
+== Documentation
+
+Module +JavaClass+ is the entry point for most functions in the gem.
+The main class is JavaClass::ClassFile::JavaClassHeader which provides access to
+all information of a Java class file. There are also some examples in the examples
+folder of the gem.
+
+* {API RDoc}[http://api.javaclass-rb.googlecode.com/hg/index.html]
+
+== Support
 
-JavaClass does not depend on any other installed libraries or gems.
+The bug tracker is available at http://code.google.com/p/javaclass-rb/issues/list or just drop me an email.
+
+== Dependencies
+
+* Ruby 1.8.6
+* {rubyzip}[http://rubyzip.sourceforge.net/]
+
+== References
+
+* {JavaWorld: The Java class file lifestyle}[http://www.javaworld.com/javaworld/jw-07-1996/jw-07-classfile.html]
+* {VM Spec: The class File Format}[http://java.sun.com/docs/books/jvms/second_edition/html/ClassFile.doc.html]
+* {Similar Project by unageanu}[http://github.com/unageanu/javaclass]
 
 == License
 
-Same as Ruby.
+* {New BSD License}[http://www.opensource.org/licenses/bsd-license.php]
+
+== Disclaimer Note
+
+This software is provided "as is" and without any express or implied warranties,
+including, without limitation, the implied warranties of merchantability and
+fitness for a particular purpose.

data/examples/generate_class_lists.rb

@@ -0,0 +1,61 @@
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'javaclass/classlist/list'
+require 'javaclass/classlist/jar_searcher'
+
+# Generate the full class lists starting from a saved one.
+# Author::          Peter Kofler
+puts "create full class lists for JDKs (by search and open class)"
+
+# Struct to keep configuration what kind of JDK classes should be searched and added.
+JDK_CONFIG = Struct.new(:version, :label, :paths)
+# Define information about JDK to process one after another.
+JDKS = [
+  JDK_CONFIG.new(0, "1.0.2",    ['E:\Develop\Java\Compiler\jdk1.0.2\lib']),
+  JDK_CONFIG.new(1, "1.1.8-09", ['E:\Develop\Java\Compiler\jdk1.1.8\lib', 'E:\Develop\Java\JDK-1.1\Library\swing-1.1.1\lib']),
+  JDK_CONFIG.new(2, "1.2.2-13", ['C:\Programme\Java\jdk1.2.2_13\jre\lib', 'C:\Programme\Java\jdk1.2.2_13\lib\dt.jar']),
+  JDK_CONFIG.new(3, "1.3.1-08", ['C:\Programme\Java\jdk1.3.1_08\jre\lib', 'C:\Programme\Java\jdk1.3.1_08\lib\dt.jar']),
+  JDK_CONFIG.new(4, "1.4.2-03", ['C:\Programme\Java\jdk1.4.2_03\jre\lib', 'C:\Programme\Java\jdk1.4.2_03\lib\dt.jar']),
+  JDK_CONFIG.new(5, "1.5.0-07", ['C:\Programme\Java\jdk1.5.0_07\jre\lib', 'C:\Programme\Java\jdk1.5.0_07\lib\dt.jar']),
+  JDK_CONFIG.new(6, "1.6.0-11", ['C:\Programme\Java\jdk1.6.0_21\jre\lib', 'C:\Programme\Java\jdk1.6.0_21\lib\dt.jar']),
+  #JDK_CONFIG.new(7, "1.7.0-xx", ['C:\Programme\Java\jdk1.7.0_xx\jre\lib']),
+]
+
+BASE_NAME = 'fullClassList'
+
+# Create a new list
+@list = JavaClass::ClassList::List.new
+
+# load already good list if we do not start with JDK 1.0
+if JDKS[0].version > 0
+  old_version = JDKS[0].version-1
+  old_class_list_name = Dir["./#{BASE_NAME}?#{old_version}?.txt"].first
+  if FileTest.exist?(old_class_list_name)
+    puts "loading #{old_version}"
+    IO.readlines(old_class_list_name).each {|line| @list.parse_line(line, old_version) }
+  end
+end
+
+# init the searcher
+@searcher = JavaClass::ClassList::JarSearcher.new
+@searcher.filters = %w[sun/ sunw/ com/sun/ netscape/ COM/rsa/ quicktime/ com/apple/mrj/macos/carbon/ org/jcp/xml/dsig/internal/]
+# netscape ... applet js security [2]
+# COM/rsa/ ... jsafe [4]
+# quicktime ... quicktime [5]
+# org/jcp/xml/dsig/internal ... xml dsig [6]
+
+#Dir.mkdir './ClassLists' unless File.exist? './ClassLists'
+
+# Work on all lists defined in +JDK+ and yield the block with the jdk label and the class list.
+JDKS.each do |conf|
+  puts "processing #{conf.version}"
+  conf.paths.each { |p| @list = @searcher.compile_list(conf.version, p, @list) }
+  
+  #basename = "jdk#{conf.label.gsub(/\./, '')}"
+  #File.open("./ClassLists/#{basename}_new_package_classes.txt", "w") { |f| f.print @list.old_access_list.collect{|m| m.sub(/\s.*$/, '')} }
+  #File.open("./ClassLists/#{basename}_all_classes.txt", "w") { |f| f.print @list.plain_class_list }
+  #File.open("./ClassLists/#{basename}_all_public_classes.txt", "w") { |f| f.print @list.plain_class_list { |c| c.public? } }
+  #File.open("./ClassLists/#{basename}_new_public_classes.txt", "w") { |f| f.print @list.plain_class_list { |c| c.public? and c.version.first == conf.version } }
+  
+  baseversion = conf.label.gsub(/\.|-.+$/, '')
+  File.open("./#{BASE_NAME}#{baseversion}.txt", "w") { |f| f.print @list.full_class_list }
+end

data/history.txt

@@ -1,3 +1,14 @@
+=== 0.0.3 02/10/2010
+
+* integrated ClassList from another project as first analyser
+* add JavaName to all class names that are returned
+* fix links in RDoc, update documentation
+* move classes into submodules for classpath, classfile, etc.
+* migrated to Google Code and Mercurial repository
+* added access flag $1000
+* added references to used classes
+* added classpath abstraction
+
 === 0.0.2 08/04/2009
 
 * refactored code to smaller objects for version and constant pool
@@ -8,22 +19,5 @@
 === 0.0.1 01/03/2009
 	
 * initial version extracted from ClassList project
-  * reads the class version and package/public flag of a class
-  * understands the constant pool but does not use it
-
-=== Planned
-
-* continue function for fields and methods
-* implement
-  * dump to return the class same as javap
-  * isAnnotation (checks version>=5 & superclass)
-    * are Annotation extendable, if so how do they look? (javap)
-  * isEnum (checks version>=5 & superclass)
-    * are Enums extendable (yes), if so how do they look? (javap)
-* test
-  * test with all classes of all JDKs against javap from this version
-  * Java 1.0 - private protected fields.
-  * Java 1.0 - http://www.javaworld.com/javaworld/javaqa/1999-06/03-synchronized.html 
-* think about
-  * "metric" if all referencing classes of a class is another package, propose moving it there.
-  * add zip gem to load classes directly from the classpath (i.e. the jars), add gem dependency
+* reads the class version and package/public flag of a class
+* understands the constant pool but does not use it

data/lib/javaclass/classfile/access_flags.rb

@@ -0,0 +1,52 @@
+require 'javaclass/string_ux'
+
+module JavaClass
+  module ClassFile 
+    
+    # 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_INNER = 0x1000 # TODO unknown access flag, find in spec
+      ACC_OTHER = 0xffff ^ ACC_PUBLIC ^ ACC_FINAL ^ ACC_SUPER ^ ACC_INTERFACE ^ ACC_ABSTRACT ^ ACC_INNER
+      
+      def initialize(data, pos)
+        @flags = data.u2(pos)
+        raise "inconsistent flags #{@flags} (abstract and final)" if abstract? && final?
+        if interface? && !abstract?
+          # JDK 1.0 and 1.1 do have non abstract interfaces, fix it
+          @flags = @flags | ACC_ABSTRACT
+        end
+        raise "inconsistent flags #{@flags} (interface not abstract)" if interface? && !abstract?
+        raise "inconsistent flags #{@flags} (interface is final)" if interface? && final?
+        raise "inconsistent flags #{@flags} (other value #{@flags & ACC_OTHER})" 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
+end

data/lib/javaclass/classfile/class_magic.rb

@@ -0,0 +1,29 @@
+module JavaClass
+  module ClassFile 
+    
+    # The +CAFEBABE+ magic of a class file. This just checks if CAFEBABE is here.
+    # Author::   Peter Kofler
+    class ClassMagic # ZenTest SKIP
+      
+      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
+end

data/lib/javaclass/classfile/class_version.rb

@@ -0,0 +1,67 @@
+require 'javaclass/string_ux'
+
+module JavaClass
+  module ClassFile 
+    
+    # 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 # ZenTest FULL to find method to_s
+      
+      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
+end