jrjackson 0.1.1 → 0.2.0

data/.jrubyrc

@@ -0,0 +1,433 @@
+################################################################################
+# compiler settings
+################################################################################
+
+# Set compilation mode. JIT = at runtime; FORCE = before execution.
+# Options: [JIT, FORCE, OFF, OFFIR], Default: JIT.
+# compile.mode=JIT
+compile.mode=FORCE
+
+# Dump to console all bytecode generated at runtime.
+# Options: [true, false], Default: false.
+compile.dump=false
+
+# (EXPERIMENTAL) Turn on compilation without polling for "unsafe" thread events.
+# Options: [true, false], Default: false.
+compile.threadless=false
+
+# Turn on fast operators for Fixnum and Float.
+# Options: [true, false], Default: true.
+compile.fastops=true
+
+# Set the number of lines at which compiled bodies are "chained".
+# Options: [Integer], Default: 500.
+compile.chainsize=500
+
+# Generate method bindings (handles) for compiled methods lazily.
+# Options: [true, false], Default: false.
+compile.lazyHandles=false
+
+# Enable or disable peephole optimizations.
+# Options: [true, false], Default: true.
+compile.peephole=true
+
+# Compile calls without guards, for experimentation.
+# Options: [true, false], Default: false.
+compile.noguards=false
+
+# Compile with all "mostly harmless" compiler optimizations.
+# Options: [true, false], Default: false.
+compile.fastest=false
+
+# Compile obj.__send__(<literal>, ...) as obj.<literal>(...).
+# Options: [true, false], Default: false.
+compile.fastsend=false
+
+# Return true from multiple assignment instead of a new array.
+# Options: [true, false], Default: false.
+compile.fastMasgn=false
+
+# Use invokedynamic for optimizing Ruby code
+# Options: [true, false], Default: false.
+# compile.invokedynamic=false
+compile.invokedynamic=true
+
+
+################################################################################
+# invokedynamic settings
+################################################################################
+
+# Maximum call site failures after which to inline cache.
+# Options: [Integer], Default: 1000.
+invokedynamic.maxfail=1000
+
+# Maximum polymorphism of PIC binding.
+# Options: [Integer], Default: 2.
+invokedynamic.maxpoly=2
+
+# Log binding of invokedynamic call sites.
+# Options: [true, false], Default: false.
+invokedynamic.log.binding=false
+
+# Log invokedynamic-based constant lookups.
+# Options: [true, false], Default: false.
+invokedynamic.log.constants=false
+
+# Enable all possible uses of invokedynamic.
+# Options: [true, false], Default: false.
+invokedynamic.all=false
+
+# Enable all safe (but maybe not fast) uses of invokedynamic.
+# Options: [true, false], Default: false.
+invokedynamic.safe=false
+
+# Enable invokedynamic for method invocations.
+# Options: [true, false], Default: true.
+invokedynamic.invocation=true
+
+# Use SwitchPoint for class modification guards on invocations.
+# Options: [true, false], Default: true.
+invokedynamic.invocation.switchpoint=true
+
+# Also bind indirect method invokers to invokedynamic.
+# Options: [true, false], Default: true.
+invokedynamic.invocation.indirect=true
+
+# Bind Ruby to Java invocations with invokedynamic.
+# Options: [true, false], Default: true.
+invokedynamic.invocation.java=true
+
+# Bind Ruby attribue invocations directly to invokedynamic.
+# Options: [true, false], Default: true.
+invokedynamic.invocation.attr=true
+
+# Bind Fixnum and Float math using optimized logic.
+# Options: [true, false], Default: true.
+invokedynamic.invocation.fastops=true
+
+# Use invokedynamic to load cached values like literals and constants.
+# Options: [true, false], Default: true.
+invokedynamic.cache=true
+
+# Use invokedynamic to load constants.
+# Options: [true, false], Default: true.
+invokedynamic.cache.constants=true
+
+# Use invokedynamic to load literals.
+# Options: [true, false], Default: true.
+invokedynamic.cache.literals=true
+
+# Use invokedynamic to get/set instance variables.
+# Options: [true, false], Default: true.
+invokedynamic.cache.ivars=true
+
+# Use ClassValue to store class-specific data.
+# Options: [true, false], Default: false.
+invokedynamic.class.values=false
+
+# ################################################################################
+# # jit settings
+# ################################################################################
+
+# # Set the JIT threshold to the specified method invocation count.
+# # Options: [Integer], Default: 50.
+jit.threshold=1
+
+# # Set the max count of active methods eligible for JIT-compilation.
+# # Options: [Integer], Default: 4096.
+jit.max=16384
+
+# # Set the maximum full-class byte size allowed for jitted methods.
+# # Options: [Integer], Default: 30000.
+# jit.maxsize=30000
+
+# # Enable JIT logging (reports successful compilation).
+# # Options: [true, false], Default: false.
+# jit.logging=false
+
+# # Enable verbose JIT logging (reports failed compilation).
+# # Options: [true, false], Default: false.
+# jit.logging.verbose=false
+
+# # Enable stdout dumping of JITed bytecode.
+# # Options: [true, false], Default: false.
+# jit.dumping=false
+
+# # Log a message every n methods JIT compiled.
+# # Options: [Integer], Default: 0.
+# jit.logEvery=0
+
+# # Exclude methods from JIT. Comma delimited.
+# # Options: [ClsOrMod, ClsOrMod::method_name, -::method_name], Default: none.
+# jit.exclude=none
+
+# # Cache jitted method in-memory bodies across runtimes and loads.
+# # Options: [true, false], Default: true.
+# jit.cache=true
+
+# # Save jitted methods to <dir> as they're compiled, for future runs.
+# # Options: [dir], Default: null.
+# jit.codeCache=null
+
+# # Log loading of JITed bytecode.
+# # Options: [true, false], Default: false.
+# jit.debug=false
+
+# # Run the JIT compiler in a background thread.
+# # Options: [true, false], Default: true.
+# jit.background=true
+
+
+# ################################################################################
+# # intermediate representation settings
+# ################################################################################
+
+# # Debug generation of JRuby IR.
+# # Options: [true, false], Default: false.
+# ir.debug=false
+
+# # [EXPT]: Profile IR code during interpretation.
+# # Options: [true, false], Default: false.
+# ir.profile=false
+
+# # Debug compilation of JRuby IR.
+# # Options: [true, false], Default: false.
+# ir.compiler.debug=false
+
+# # Specify comma delimeted list of passes to run.
+# # Options: [String], Default: null.
+# ir.passes=null
+
+# # Specify comma delimeted list of passes to run after inlining a method.
+# # Options: [String], Default: null.
+# ir.inline_passes=null
+
+
+# ################################################################################
+# # native settings
+# ################################################################################
+
+# # Enable/disable native code, including POSIX features and C exts.
+# # Options: [true, false], Default: true.
+# native.enabled=true
+
+# # Enable verbose logging of native extension loading.
+# # Options: [true, false], Default: false.
+# native.verbose=false
+
+# # Enable or disable C extension support.
+# # Options: [true, false], Default: false.
+# cext.enabled=false
+
+# # Dump bytecode-generated FFI stubs to console.
+# # Options: [true, false], Default: false.
+# ffi.compile.dump=false
+
+# # Number of FFI invocations before generating a bytecode stub.
+# # Options: [Integer], Default: 100.
+# ffi.compile.threshold=100
+
+# # Use invokedynamic to bind FFI invocations.
+# # Options: [true, false], Default: false.
+# ffi.compile.invokedynamic=false
+
+
+# ################################################################################
+# # thread pooling settings
+# ################################################################################
+
+# # Enable reuse of native threads via a thread pool.
+# # Options: [true, false], Default: false.
+# thread.pool.enabled=false
+
+# # The minimum number of threads to keep alive in the pool.
+# # Options: [Integer], Default: 0.
+# thread.pool.min=0
+
+# # The maximum number of threads to allow in the pool.
+# # Options: [Integer], Default: 2147483647.
+# thread.pool.max=2147483647
+
+# # The maximum number of seconds to keep alive an idle thread.
+# # Options: [Integer], Default: 60.
+# thread.pool.ttl=60
+
+
+################################################################################
+# miscellaneous settings
+################################################################################
+
+# Specify the major Ruby version to be compatible with.
+# Options: [1.8, 1.9, 2.0], Default: 1.9.
+compat.version=1.9
+
+# Enable or disable ObjectSpace.each_object.
+# Options: [true, false], Default: false.
+objectspace.enabled=false
+
+# Enable or disable SipHash for String hash function.
+# Options: [true, false], Default: false.
+siphash.enabled=false
+
+# Set in-process launching of e.g. system('ruby ...').
+# Options: [true, false], Default: false.
+launch.inproc=false
+
+# Specify the major Java bytecode version.
+# Options: [1.5, 1.6, 1.7], Default: 1.7.
+bytecode.version=1.7
+
+# Set whether JMX management is enabled.
+# Options: [true, false], Default: false.
+management.enabled=false
+
+# Make non-local flow jumps generate backtraces.
+# Options: [true, false], Default: false.
+jump.backtrace=false
+
+# Do not unwrap process streams (issue on some recent JVMs).
+# Options: [true, false], Default: false.
+process.noUnwrap=false
+
+# Before instantiation, stand up a real Java class for ever Ruby class.
+# Options: [true, false], Default: false.
+reify.classes=false
+
+# Log errors during reification (reify.classes=true).
+# Options: [true, false], Default: false.
+reify.logErrors=false
+
+# Use reflection for binding methods, not generated bytecode.
+# Options: [true, false], Default: false.
+reflected.handles=false
+
+# Enable colorized backtraces.
+# Options: [true, false], Default: false.
+backtrace.color=false
+
+# Set the style of exception backtraces.
+# Options: [normal, raw, full, mri], Default: normal.
+backtrace.style=normal
+
+# Mask .java lines in Ruby backtraces.
+# Options: [true, false], Default: false.
+backtrace.mask=false
+
+# Set the signal used for dumping thread stacks.
+# Options: [USR1, USR2, etc], Default: USR2.
+thread.dump.signal=USR2
+
+# Use native impls for parts of net/protocol.
+# Options: [true, false], Default: false.
+native.net.protocol=false
+
+# Use JVM coroutines for Fiber.
+# Options: [true, false], Default: false.
+fiber.coroutines=false
+
+# Use a single global lock for requires.
+# Options: [true, false], Default: false.
+global.require.lock=false
+
+# Do a true process-obliterating native exec for Kernel#exec.
+# Options: [true, false], Default: true.
+native.exec=true
+
+
+# ################################################################################
+# # debugging and logging settings
+# ################################################################################
+
+# # Log require/load file searches.
+# # Options: [true, false], Default: false.
+# debug.loadService=false
+
+# # Log require/load parse+evaluate times.
+# # Options: [true, false], Default: false.
+# debug.loadService.timing=false
+
+# # Log externally-launched processes.
+# # Options: [true, false], Default: false.
+# debug.launch=false
+
+# # Set whether full traces are enabled (c-call/c-return).
+# # Options: [true, false], Default: false.
+# debug.fullTrace=false
+
+# # Print which script is executed by '-S' flag.
+# # Options: [true, false], Default: false.
+# debug.scriptResolution=false
+
+# # disables JRuby impl script loads and prints parse exceptions
+# # Options: [true, false], Default: false.
+# debug.parser=false
+
+# # Generate backtraces for heavily-used Errno exceptions (EAGAIN).
+# # Options: [true, false], Default: false.
+# errno.backtrace=false
+
+# # Log every time an exception is constructed.
+# # Options: [true, false], Default: false.
+# log.exceptions=false
+
+# # Log every time an exception backtrace is generated.
+# # Options: [true, false], Default: false.
+# log.backtraces=false
+
+# # Log every time a Kernel#caller backtrace is generated.
+# # Options: [true, false], Default: false.
+# log.callers=false
+
+# # Log every time a built-in warning backtrace is generated.
+# # Options: [true, false], Default: false.
+# log.warnings=false
+
+# # Use specified class for logging.
+# # Options: [class name], Default: org.jruby.util.log.JavaUtilLoggingLogger.
+# logger.class=org.jruby.util.log.JavaUtilLoggingLogger
+
+
+# ################################################################################
+# # java integration settings
+# ################################################################################
+
+# # Try to set inaccessible Java methods to be accessible.
+# # Options: [true, false], Default: true.
+# ji.setAccessible=true
+
+# # Log whether setAccessible is working.
+# # Options: [true, false], Default: false.
+# ji.logCanSetAccessible=false
+
+# # Allow Capitalized Java pacakge names.
+# # Options: [true, false], Default: false.
+# ji.upper.case.package.name.allowed=false
+
+# # Use java.lang.reflect.Proxy for interface impl.
+# # Options: [true, false], Default: false.
+# interfaces.useProxy=false
+
+# # Use generated handles instead of reflection for calling Java.
+# # Options: [true, false], Default: false.
+# java.handles=false
+
+# # Extend Java classes without using a proxy object.
+# # Options: [true, false], Default: false.
+# ji.newStyleExtension=false
+
+# # Cache Java object wrappers between calls.
+# # Options: [true, false], Default: true.
+# ji.objectProxyCache=true
+
+# # Allow external envs to replace JI proxy class factory
+# # Options: [String], Default: null.
+# ji.proxyClassFactory=null
+
+
+# ################################################################################
+# # profiling settings
+# ################################################################################
+
+# # Maximum number of methods to consider for profiling.
+# # Options: [Integer], Default: 100000.
+# profile.max.methods=100000

data/Gemfile

@@ -3,7 +3,7 @@ source "https://rubygems.org"
 
 group :development do
   gem 'gson', '>= 0.6'
-  gem 'json', '~> 1.7'
+  gem 'json', '~> 1.8'
 end
 
 gemspec

data/README.md

@@ -4,56 +4,65 @@ Apache License 2.0 see http://www.apache.org/licenses/LICENSE-2.0
 
 Jrjackson:
 
-a jruby library wrapping the JAVA jackson jars
+a jruby library wrapping the JAVA Jackson jars
 
-Version: 0.0.9
+Version: 0.2.0
 
 NOTE: Smile support has been temporarily dropped
 
 The code has been refactored to use almost all Java.
 
-There is shortly to be a MultiJson adapter added for JrJackson
+There is now a MultiJson adapter added for JrJackson
 
-provides:
+JrJackson provides:
 
 ```
-JrJackson::Json.load(str, options) -> hash like object
+JrJackson::Json.load(string, options) -> hash like object
   aliased as parse
 JrJackson::Json.dump(obj) -> json string
   aliased as generate
 ```
 
 By default the load method will return Ruby objects (Hashes have string keys).
-The options hash respects two symbol keys
+The options hash respects three symbol keys
   :symbolize_keys
     Will return symbol keys in hashes
   :raw
     Will return JRuby wrapped java objects that quack like ruby objects
     This is the fastest option
+  :use_bigdecimal
+    Will return BigDecimal objects instead of Float
+    If used with the :raw option you will get Java::JavaMath::BigDecimal objects
+    otherwise they are Ruby BigDecimal
 
-Behind the scenes there are three Ruby sub modules of the JrJackson module
-```
-  JrJackson::Str
-  JrJackson::Sym
-  JrJackson::Raw
+Note: the dump method expects that the values of hashes or arrays are JSON data types,
+the only exception to this is Ruby Symbol as values, they are converted to java strings
+during serialization. All other objects should be converted to JSON data types before
+serialization.
 
-  These all have the same method signatures - they map to different java classes
-  that parse appropriately
-```
+There are two Ruby sub modules of the JrJackson module
+
+JrJackson::Json, this is the general external facade used by MultiJson, and is pure Ruby
+JrJackson::Raw, this is used by the Json module, it is defined in Java with annotations
+exposing it as a Ruby module with module methods.
+
+If you are using JrJackson directly and not via MultiJson then you can take advantage of
+optimised Java methods parse_raw, parse_sym and parse_str. Please look at the tests and
+benchmarks for examples. 
 
 Credit to Chuck Remes for the benchmark and initial
 investigation when the jruby, json gem and the jackson
 libraries were young.
 
-I compared Json (java) 1.7.7, Gson 0.6.1 and jackson 2.1.4 on jruby 1.7.3 and Java 7
+I compared Json (java) 1.8, Gson 0.6.1 and jackson 2.2.2 on jruby 1.7.4 and OpenJDK 64-Bit Server VM 1.7.0_21-b02
 ```
                                          user     system      total        real
-ruby parse:                         10.300000   0.020000  10.320000 ( 10.014000)
-gson parse:                         11.270000   0.010000  11.280000 ( 10.958000)
-jrjackson parse raw:                 4.840000   0.080000   4.920000 (  3.767000)
-jrjackson parse symbol keys:         5.130000   0.010000   5.140000 (  4.975000)
-jrjackson parse string keys:         7.370000   0.010000   7.380000 (  7.223000)
-ruby generate:                      13.590000   0.050000  13.640000 ( 12.815000)
-gson generate:                       5.080000   0.010000   5.090000 (  4.949000)
-jackson generate:                    4.640000   0.010000   4.650000 (  4.560000)
+json java parse:                    10.140000   0.020000  10.160000 (  9.867000)
+gson parse:                         11.510000   0.010000  11.520000 ( 11.164000)
+jackson parse raw:                   4.320000   0.020000   4.340000 (  3.552000)
+jackson parse symbol keys:           5.910000   0.010000   5.920000 (  5.770000)
+jackson parse string keys:           8.400000   0.010000   8.410000 (  8.232000)
+json java generate:                 14.730000   0.010000  14.740000 ( 13.864000)
+gson generate:                       5.060000   0.010000   5.070000 (  4.981000)
+jackson generate:                    4.540000   0.000000   4.540000 (  4.467000)
 ```