javaobs 0.3 → 0.3.1

data/lib/CVS/Entries

@@ -1,2 +1,2 @@
-/javaobs.rb/1.2/Sun Apr 16 22:41:16 2006//
+/javaobs.rb/1.4/Mon Apr 17 04:47:58 2006//
 D

data/lib/javaobs.rb

@@ -237,6 +237,8 @@ module Java
     def readUID; @str.read(8); end
     def readLong; @str.read(8).unpack("Q").first; end
   
+    # Read the block data beginning tag and return the size. We can have a long or 
+    # short block of data.
     def readBlockStart
       byte = readByte
       size = nil
@@ -253,6 +255,7 @@ module Java
       size
     end
     
+    # Read the block end tag. Validate it is correct or raise a SerializationError.
     def readBlockEnd
       byte = readByte
       raise SerializationError, "Unexpected byte #{byte}" unless byte == TC_ENDBLOCKDATA
@@ -420,7 +423,10 @@ module Java
       end
     end
     
-    # Read class data and recursively read parent classes.
+    # Read class data and recursively read parent classes. If the class
+    # is externalizable then we call the _readJavaData method to '
+    # perform the custom serialization. See Java::Util::Hash and 
+    # Java::Util::Date for an example.
     def readClassData(klass, object = nil)
       if object == nil
         object = klass.rubyClass.new()
@@ -528,6 +534,7 @@ module Java
       end
     end
     
+    # Write the beginning of a block tag with the size of the block.
     def writeBlockStart(size)
       if (size <= 255)
         writeByte(TC_BLOCKDATA)
@@ -538,6 +545,7 @@ module Java
       end
     end
     
+    # Write the block end tag.
     def writeBlockEnd
       writeByte(TC_ENDBLOCKDATA)
     end
@@ -603,10 +611,12 @@ module Java
       writeObject(klass.superClass)
     end
     
+    # Ruby version of the default write object method.
     def defaultWriteObject(object)
       writeObjectFields(object.class.javaClass, object)
     end
     
+    # Internal method to write meta fields to stream.
     def writeObjectFields(klass, object)
       klass.fields.each do |f|
         v = object.send(f.name.intern)

data/rakefile

@@ -6,9 +6,8 @@ require 'rake/packagetask'
 require 'rake/gempackagetask'
 require 'rake/contrib/rubyforgepublisher'
 
-PKG_BUILD     = '3'
 PKG_NAME      = 'javaobs'
-PKG_VERSION   = '0.3'
+PKG_VERSION   = '0.3.1'
 PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
 
 RELEASE_NAME  = "REL #{PKG_VERSION}"

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: javaobs
 version: !ruby/object:Gem::Version 
-  version: "0.3"
-date: 2006-04-16 00:00:00 -07:00
+  version: 0.3.1
+date: 2006-04-17 00:00:00 -07:00
 summary: Decode Java Serialized Objects to Ruby Objects.
 require_paths: 
 - lib