javaclass 0.0.3 → 0.0.4

data/lib/javaclass/resources/iso_3166_countries.txt

@@ -0,0 +1,240 @@
+ax
+af
+al
+dz
+as
+ad
+ao
+ai
+aq
+ag
+ar
+am
+aw
+au
+at
+az
+bs
+bh
+bd
+bb
+by
+be
+bz
+bj
+bm
+bt
+bo
+ba
+bw
+bv
+br
+io
+bn
+bg
+bf
+bi
+kh
+cm
+ca
+cv
+ky
+cf
+td
+cl
+cn
+cx
+cc
+co
+km
+cd
+cg
+ck
+cr
+ci
+hr
+cu
+cy
+cz
+dk
+dj
+dm
+do
+ec
+eg
+sv
+gq
+er
+ee
+et
+fk
+fo
+fj
+fi
+fr
+gf
+pf
+tf
+ga
+gm
+ge
+de
+gh
+gi
+gr
+gl
+gd
+gp
+gu
+gt
+gn
+gw
+gy
+ht
+hm
+hn
+hk
+hu
+is
+in
+id
+ir
+iq
+ie
+il
+it
+jm
+jp
+jo
+kz
+ke
+ki
+kp
+kr
+kw
+kg
+la
+lv
+lb
+ls
+lr
+ly
+li
+lt
+lu
+mo
+mk
+mg
+mw
+my
+mv
+ml
+mt
+mh
+mq
+mr
+mu
+yt
+mx
+fm
+md
+mc
+mn
+ms
+ma
+mz
+mm
+na
+nr
+np
+nl
+an
+nc
+nz
+ni
+ne
+ng
+nu
+nf
+mp
+no
+om
+pk
+pw
+ps
+pa
+pg
+py
+pe
+ph
+pn
+pl
+pt
+pr
+qa
+re
+ro
+ru
+rw
+sh
+kn
+lc
+pm
+vc
+ws
+sm
+st
+sa
+sn
+cs
+sc
+sl
+sg
+sk
+si
+sb
+so
+za
+gs
+es
+lk
+sd
+sr
+sj
+sz
+se
+ch
+sy
+tw
+tj
+tz
+th
+tl
+tg
+tk
+to
+tt
+tn
+tr
+tm
+tc
+tv
+ug
+ua
+ae
+gb
+us
+um
+uy
+uz
+vu
+va
+ve
+vn
+vg
+vi
+wf
+eh
+ye
+zm
+zw

data/lib/javaclass/resources/jdk0_packages.txt

@@ -0,0 +1,6 @@
+java.lang
+java.applet
+java.awt
+java.io
+java.net
+java.util

data/lib/javaclass/resources/jdk1_packages.txt

@@ -0,0 +1,6 @@
+java.beans
+java.math
+java.rmi
+java.security
+java.sql
+java.text

data/lib/javaclass/resources/jdk2_packages.txt

@@ -0,0 +1,4 @@
+javax.accessibility
+javax.swing
+org.omg.CORBA
+org.omg.CosNaming

data/lib/javaclass/resources/jdk3_packages.txt

@@ -0,0 +1,6 @@
+javax.naming
+javax.rmi
+javax.sound
+javax.transaction
+org.omg.CORBA_2_3
+org.omg.SendingContext

data/lib/javaclass/resources/jdk4_packages.txt

@@ -0,0 +1,22 @@
+java.nio
+javax.crypto
+javax.imageio
+javax.net
+javax.print
+javax.security
+javax.sql
+javax.xml.parsers
+javax.xml.transform
+org.apache.crimson
+org.apache.xalan
+org.apache.xml
+org.apache.xpath
+org.ietf.jgss
+org.omg.Dynamic
+org.omg.DynamicAny
+org.omg.IOP
+org.omg.Messaging
+org.omg.PortableInterceptor
+org.omg.PortableServer
+org.w3c.dom
+org.xml.sax

data/lib/javaclass/resources/jdk5_packages.txt

@@ -0,0 +1,5 @@
+javax.activity
+javax.jnlp
+javax.management
+javax.security.sasl
+javax.xml

data/lib/javaclass/resources/jdk6_packages.txt

@@ -0,0 +1,7 @@
+javax.activation
+javax.annotation
+javax.jws
+javax.lang.model
+javax.script
+javax.smartcardio
+javax.tools

data/lib/javaclass/resources/jdk_packages.txt

@@ -0,0 +1,53 @@
+java.applet
+java.awt
+java.beans
+java.io
+java.lang
+java.math
+java.net
+java.nio
+java.rmi
+java.security
+java.sql
+java.text
+java.util
+javax.accessibility
+javax.activation
+javax.activity
+javax.annotation
+javax.crypto
+javax.imageio
+javax.jnlp
+javax.jws
+javax.lang.model
+javax.management
+javax.naming
+javax.net
+javax.print
+javax.rmi
+javax.script
+javax.security
+javax.smartcardio
+javax.sound
+javax.sql
+javax.swing
+javax.tools
+javax.transaction
+javax.xml
+org.apache.crimson
+org.apache.xalan
+org.apache.xml
+org.apache.xpath
+org.ietf.jgss
+org.omg.CORBA
+org.omg.CORBA_2_3
+org.omg.CosNaming
+org.omg.Dynamic
+org.omg.DynamicAny
+org.omg.IOP
+org.omg.Messaging
+org.omg.PortableInterceptor
+org.omg.PortableServer
+org.omg.SendingContext
+org.w3c.dom
+org.xml.sax

data/lib/javaclass/resources/reserved_words.txt

@@ -0,0 +1,50 @@
+abstract
+assert
+boolean
+break
+byte
+case
+catch
+char
+class
+const
+continue
+default
+do
+double
+else
+enum
+extends
+final
+finally
+float
+for
+goto
+if
+implements
+import
+instanceof
+int
+interface
+long
+native
+new
+package
+private
+protected
+public
+return
+short
+static
+strictfp
+super
+switch
+synchronized
+this
+throw
+throws
+transient
+try
+void
+volatile
+while

data/lib/javaclass/string_hexdump.rb

@@ -0,0 +1,76 @@
+# Add some +hexdump+ helper method to dump the data contained in this String.
+# Author::          Peter Kofler
+class String
+
+  # Return the hex dump of this String with _columns_ columns of hexadecimal numbers per line.
+  def hexdump(columns=16)
+    return StringLineHexdumper.empty(columns).format if size == 0
+
+    input = [0, []]
+    output = scan(/[\x00-\xff]{1,#{columns}}/).inject(input) { |result, part|
+      offset, previous_lines = *result
+
+      line = StringLineHexdumper.new(offset, columns, part).format
+      
+      [ offset + columns, previous_lines + [line] ]
+    }
+    offset, lines = *output
+    lines.join
+  end
+
+end
+
+# Dump a line of text as hex dump.
+# Author::          Peter Kofler
+class StringLineHexdumper 
+
+  # Each displayed number is 2 nibbles, i.e. it's a byte.
+  NIBBLE_SIZE = 2
+  NIBBLE_FORMAT_STR = "%#{NIBBLE_SIZE}.#{NIBBLE_SIZE}X "
+  NIBBLE_WHITE_SPACE = ' ' * (NIBBLE_SIZE + 1)
+
+  # Factory method to create a formatter for an empty line with _columns_ length.
+  def self.empty(columns)
+    StringLineHexdumper.new(0, columns, '')
+  end
+  
+  def initialize(address, columns, data)
+    @address = address
+    @maxlen = columns
+    @data = data
+  end
+
+  def format
+    address = format_address
+    hexbytes = format_bytes
+    space = add_whitespace
+    display = strip_non_printable
+    
+    "#{address}: #{hexbytes.join}#{space}; #{display}\n"
+  end
+
+  private
+  
+  # Format the address to a 8 digit hex number.
+  def format_address
+    sprintf('%8.8Xh', @address)
+  end
+
+  def format_bytes
+    @data.unpack('C' * @data.size).collect{ |c| format_byte(c) }
+  end
+
+  # Format the _bytes_ value to a +NIBBLE_SIZE+ digit hex number.
+  def format_byte(byte)
+    sprintf(NIBBLE_FORMAT_STR, byte)
+  end
+
+  def add_whitespace
+    NIBBLE_WHITE_SPACE * (@maxlen - @data.size)
+  end
+
+  def strip_non_printable
+    @data.gsub(/[^ -\x7f]/, '.')
+  end
+  
+end

data/lib/javaclass/string_ux.rb

@@ -1,39 +1,50 @@
-
-# Add some +unpack+ helper methods for HI-LO byte order (network byte order) contained in this string.
+# Add some +unpack+ helper methods for HI-LO byte order (network byte order) contained in this String.
 # Author::          Peter Kofler
 class String
+
+  RUBY19 = ''.respond_to? :codepoints 
   
   # Return the _index_'th element as byte.
   def u1(index=0)
-    self[index]
+    if RUBY19
+      self[index..index].unpack('C')[0]
+    else
+      self[index]
+    end
   end
-  
+
   # Return the _index_'th and the next element as unsigned word.
   def u2(index=0)
     self[index..index+1].unpack('n')[0]
-    # same as self[index]*256 + self[index+1] 
+    # self[index]*256 + self[index+1]
   end
-  
+
+  # Return the _index_'th and the next element as unsigned word, repeat it for _count_
+  # words in total and return an array of these words.
+  def u2rep(count=1, index=0)
+    self[index...index+count*2].unpack('n'*count)
+  end
+
   # Return the _index_'th and the next 3 elements as unsigned dword.
   def u4(index=0)
     self[index..index+3].unpack('N')[0]
   end
-  
+
   # Return the _index_'th and the next 7 elements as unsigned qword.
   def u8(index=0)
     u4(index) * 256**4 + u4(index+4)
   end
-  
+
   # Return the _index_'th and the next 3 elements as single precision float.
   # See::           http://steve.hollasch.net/cgindex/coding/ieeefloat.html
   # See::           http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/196633
   def single(index=0)
     self[index..index+3].unpack('g')[0]
   end
-  
+
   # Return the _index_'th and the next 7 elements as double precision float.
   def double(index=0)
     self[index..index+7].unpack('G')[0]
   end
-  
+
 end

data/lib/javaclass.rb

@@ -1,47 +1,22 @@
-require 'javaclass/classfile/java_class_header'
-require 'javaclass/classpath/java_home_classpath'
-require 'javaclass/classpath/composite_classpath'
+require 'javaclass/classpath/factory'
+require 'javaclass/dsl/loader'
+require 'javaclass/classscanner/scanners'
 
-# Main entry point for class file parsing.
+# Main namespace of JavaClass gem. The module also provides all basic methods 
+# for class file parsing as class methods. For its usage see
+# {Basic Usage}[link:/files/lib/generated/examples/simple_usage_txt.html]. 
+# For alternative usage see JavaClass::Dsl::Mixin.
 # Author::          Peter Kofler
+# Copyright::       Copyright (c) 2009, Peter Kofler.
+# License::         {BSD License}[link:/files/license_txt.html]
 module JavaClass
+  extend Classpath::Factory
+  extend Dsl::Loader
+  extend ClassScanner::Scanners
 
-    # Read and disassemble the given class from _filename_ (full file name).
-    def self.load_fs(filename)
-      disassemble(File.open(filename, 'rb') { |io| io.read } )
-    end
-    
-    def self.parse(filename)
-      warn 'Deprecated method JavaClass::parse will be removed in next release. Use method load_fs instead.'
-      load_fs(filename)
-    end
-
-    # Read and disassemble the given class _classname_ from _classpath_ .
-    def self.load_cp(classname, classpath)
-      disassemble(classpath.load_binary(classname))
-    end
-
-    # Read and disassemble the given class inside _data_ (byte data).
-    def self.disassemble(data)
-      ClassFile::JavaClassHeader.new(data)
-    end
-
-    # Parse the given path variable _path_ and return a chain of class path elements.
-    def self.classpath(path)
-      full_classpath(nil, path)
-    end
-    
-    # Parse and scan the system classpath. Needs +JAVA_HOME+ set. Uses environment +CLASSPATH+ if set.
-    def self.environment_classpath
-      full_classpath(ENV['JAVA_HOME'], ENV['CLASSPATH'])
-    end
-
-    # Parse the given path variable _path_ and return a chain of class path elements together with _javahome_ if any.
-    def self.full_classpath(javahome, path='')
-      cp = Classpath::CompositeClasspath.new
-      cp.add_element(Classpath::JavaHomeClasspath.new(javahome)) if javahome
-      path.split(File::PATH_SEPARATOR).each { |cpe| cp.add_file_name(cpe) } if path
-      cp
-    end
+  def self.parse(filename)
+    warn 'Deprecated method JavaClass::parse will be removed in next release. Use method load_fs instead.'
+    load_fs(filename)
+  end
 
 end

data/license.txt

@@ -0,0 +1,28 @@
+=== BSD License
+
+Copyright (c) 2009, Peter Kofler.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, 
+  this list of conditions and the following disclaimer.
+  
+* Redistributions in binary form must reproduce the above copyright notice, 
+  this list of conditions and the following disclaimer in the documentation 
+  and/or other materials provided with the distribution.
+
+<b>
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR APARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANYDIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCHDAMAGE.
+</b>

data/planned.txt

@@ -0,0 +1,13 @@
+=== Planned
+
+* add collecting of incoming references (mark my interfaces, mark my referenced classes)
+  * can calculate stability
+  * find interfaces with only 1 implementation (smell?)
+
+* implement byte code awareness
+  * add the byte code sequences to the methods so it can be analysed later (see JVM spec) 
+  * scanning of byte code for numbers, which methods loaded, which fields loaded
+
+* test with a large set of classes
+  * use all classes of all JDKs against javap (compileTheWorld)
+  * use the Quality Corpus

data/test/data/access_flags/AccessFlagsTestAnnotation.java

@@ -0,0 +1,3 @@
+package packagename;
+
+public @interface AccessFlagsTestAnnotation { }

data/test/data/access_flags/AccessFlagsTestEnum.java

@@ -0,0 +1,6 @@
+package packagename;
+
+public enum AccessFlagsTestEnum { 
+   Value, 
+   Inner { } 
+}

data/test/data/access_flags/AccessFlagsTestInner.java

@@ -0,0 +1,13 @@
+package packagename;
+
+public class AccessFlagsTestInner {
+
+   private Runnable anonymous = new Runnable() { 
+      public void run() { }
+   };
+   
+   private static Runnable staticAnonymous = new Runnable() { 
+      public void run() { }
+   };
+   
+}