jrjackson 0.3.9-java

data/.mvn/extensions.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extensions>
+  <extension>
+    <groupId>io.takari.polyglot</groupId>
+    <artifactId>polyglot-ruby</artifactId>
+    <version>0.1.15</version>
+  </extension>
+</extensions>

data/Gemfile

@@ -0,0 +1,10 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+group :development do
+  gem 'gson', '>= 0.6'
+  gem 'json', '~> 1.8'
+  gem 'benchmark-ips'
+end
+
+gemspec

data/Mavenfile

@@ -0,0 +1,32 @@
+#-*- mode: ruby -*-
+
+VERSION='1.2.18'
+gemspec :jar => "jrjackson/jars/jrjackson-#{VERSION}.jar"
+
+# overwrite groupId:artifacgtId:version from gem
+id "com.jrjackson.jruby:jrjackson:#{VERSION}"
+packaging :jar
+
+
+properties 'project.build.sourceEncoding' => 'UTF-8',
+           'netbeans.hint.jdkPlatform' => 'JDK_1.8',
+           # create a pom.xml from this here
+           'polyglot.dump.pom' => 'pom.xml'
+
+jar 'junit:junit', '4.11', :scope => :test
+
+jar 'org.jruby:jruby', '9.0.5.0', :scope => :provided
+
+plugin :compiler, '3.1', :source => '1.7', :target => '1.7',
+       :showDeprecateion => false,
+       :showWarnings => false,
+       :executable => '${JAVA_HOME}/bin/javac',
+       :fork => true
+
+plugin :surefire, '2.17', :skipTests => true
+
+# since bundle install does not vendor our jars we need to it manually
+plugin 'org.torquebox.mojo:jruby9-exec-maven-plugin', '0.3.1' do
+  execute_goal :exec, :id => 'vendor-jars', :phase => 'prepare-package',
+               :script => "require 'jars/installer';Jars::Installer.vendor_jars!"
+end

data/README.md

@@ -0,0 +1,150 @@
+
+
+LICENSE applicable to this library:
+
+Apache License 2.0 see http://www.apache.org/licenses/LICENSE-2.0
+
+### JrJackson:
+
+a jruby library wrapping the JAVA Jackson jars`
+
+__NOTE:__ Smile support has been temporarily dropped
+
+The code has been refactored to use almost all Java.
+
+There is now a MultiJson adapter added for JrJackson.
+
+This release is compatible with JRuby 9.0.0.0 and higher.
+
+***
+
+#### NEWS
+
+07 October 2015 - during serialisation, check and execute `to_json_data` method
+first.
+
+13th September 2015 - added support for a `to_json_data` method lookup.
+Use this if you want to provide a JSON native data structure that best
+represents your custom object.
+
+11th May 2014 - Added to_time method call for Ruby object serialization
+
+26th October 2013 - Added support to serialize arbitary (non JSON datatypes)
+ruby objects.  Normally the toJava internal method is called, but additionally
+to_h, to_hash, to_a and finally to_json are tried.  Be aware that the to_json
+method might invoke a new selialization session (i.e. it may use the JSON gem)
+and impact performance.
+
+***
+
+#### API
+
+```
+JrJackson::Json.load(string, options) -> hash like object
+      aliased as parse
+```
+By default the load method will return Ruby objects (Hashes have string 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 but not by much
+
++ :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
+
++ :use_smallint
+
+  Will return Integers objects instead of BigInteger
+
+```
+JrJackson::Json.dump(obj) -> json string
+      aliased as generate
+```
+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. __NOTE:__ All other objects should be converted to JSON data types before
+serialization. See the wiki for more on this.
+
+***
+
+#### Internals
+
+There are four Ruby sub modules of the JrJackson module
+
+```JrJackson::Json```, this is the general external facade used by MultiJson.
+
+```JrJackson::Raw```, this exists for backward compatibility, do not use this for new code.
+
+```JrJackson::Ruby```, this is used by the external facade, you should use this directly. It returns Ruby objects e.g. Hash, Array, Symbol, String, Integer, BigDecimal etc.
+
+```JrJackson::Java```, this is used by the external facade, you should use this directly. It returns Java objects e.g. ArrayList, HashMap, BigDecimal, BigInteger, Long, Float and String, JRuby wraps (mostly) them in a JavaProxy Ruby object.
+
+***
+
+#### Benchmarks
+
+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.8.3, Gson 0.6.1 and jackson 2.6.1 on jruby 1.7.22 and Oracle Java HotSpot(TM) 64-Bit Server VM 1.8.0_60-b27 +jit [linux-amd64]
+All the benchmarks were run separately. A 727.9KB string of random json data is read from a file and handled 250 times, thereby attempting to balance invocation and parsing benchmarking.
+
+```
+generation/serialize
+
+                                               user     system      total         real
+
+
+json java generate: 250                        6.780      0.620      7.400    (  6.599)
+gson generate: 250                             4.480      0.530      5.010    (  4.688)
+jackson generate: 250                          2.200      0.010      2.210    (  2.128)
+
+json mri parse: 250                            9.620      0.000      9.620    (  9.631)
+oj mri parse: 250                              9.190      0.000      9.190    (  9.199)
+json mri generate: 250                         8.400      0.010      8.410    (  8.419)
+oj mri generate: 250                           6.980      0.010      6.990    (  6.999)
+
+
+parsing/deserialize - after jrjackson parsing profiling
+
+                                               user     system      total         real
+json java parse: 250                           9.320      0.580      9.900    (  9.467)
+jackson parse string keys: 250                 3.600      0.520      4.120    (  3.823)
+jackson parse string + bigdecimal: 250         3.390      0.640      4.030    (  3.721)
+jackson parse ruby compat: 250                 3.700      0.030      3.730    (  3.516)
+jackson parse ruby ootb: 250                   3.490      0.120      3.610    (  3.420)
+jackson parse sj: 250                          3.290      0.030      3.320    (  3.065)
+jackson parse symbol keys: 250                 3.050      0.120      3.170    (  2.943)
+jackson parse symbol + bigdecimal: 250         2.770      0.020      2.790    (  2.669)
+jackson parse java + bigdecimal: 250           1.880      0.430      2.310    (  2.239)
+jackson parse java + bigdecimal direct: 250    1.950      0.440      2.390    (  2.290)
+jackson parse java ootb: 250                   1.990      0.030      2.020    (  1.925)
+jackson parse java sym bd: 250                 1.920      0.000      1.920    (  1.898)
+```
+
+I have done IPS style benchmarks too.
+
+Generation
+```
+jrjackson:   74539.4 i/s
+    gson:    58288.3 i/s - 1.28x slower
+    JSON:    54597.2 i/s - 1.37x slower
+```
+
+Parsing returning Ruby
+```
+symbol keys
+jrjackson:    95203.9 i/s
+     JSON:    40712.0 i/s - 2.34x slower
+
+```

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rspec/core/rake_task'
+require 'bundler'
+
+Bundler::GemHelper.install_tasks
+
+desc "Run benchmarks"
+task :benchmark do
+  load 'benchmarking/benchmark.rb'
+end
+

data/alt_bench.rb

@@ -0,0 +1,46 @@
+# coding: utf-8
+require 'benchmark/ips'
+require 'json'
+require File.expand_path('lib/jrjackson')
+
+obj = {
+  :name => "Fredrick Smith",
+  :quantity => 1_000_000,
+  :addresses => {
+    :address1 => "12 Heather Street, Parnell, Auckland, New Zealand",
+    :address2 => "1 Queen Street, CBD, Auckland, New Zealand"
+  }
+}
+
+json = JSON.dump(obj)
+
+puts "Decode ====================="
+
+puts 'Sleeping'
+sleep 45
+puts 'Working'
+
+# -JXrunhprof:cpu=samples,depth=30,file=jrjackson.hprof
+
+Benchmark.ips do |x|
+  x.config(time: 20, warmup: 20)
+
+  x.report("JrJackson new Ruby") { JrJackson::Ruby.parse(json, nil) }
+  # x.report("JrJackson Raw") { JrJackson::Java.parse(json, nil) }
+  # x.report("JSON") { JSON.load(json) }
+
+  # x.report("JrJackson") { JrJackson::Raw.parse_sym(json) }
+
+  # x.compare!
+end
+
+# puts "Encode ====================="
+# Benchmark.ips do |x|
+#   x.config(time: 5, warmup: 10)
+
+#   x.report("JrJackson Raw") { JrJackson::Base.generate(obj) }
+#   x.report("JrJackson") { JrJackson::Json.dump(obj) }
+#   x.report("JSON") { JSON.dump(obj) }
+
+#   x.compare!
+# end

data/changelog.md

@@ -0,0 +1,131 @@
+v0.3.9
+  Thanks to mkristian, now uses jar_dependencies
+    Upgrade to Jackson v2.7.1
+  fix for issue 51
+    dont create "new RubyJacksonModule()" when creating a Provider
+  fix for reports of symbol table overflow in Jackson when using JrJackson in very long running daemons (Logstash)
+    disable the FAIL_ON_SYMBOL_HASH_OVERFLOW setting
+
+v0.3.8
+  fix for issue 47
+    Update Jackson to v 2.6.3
+  Change error message to better report failure in issue 46
+
+v0.3.7
+  fix for issue 46
+    Add references to RubyAnySerializer so Jackson can
+    use it for Ruby objects nested in Java objects
+
+v0.3.6
+  fix for issue 45
+    use bytelist.begin instead of 0 generating from RubyString
+
+v0.3.5
+  give highest precedence to the to_json_data method
+
+v0.3.4
+  fix multi_json bug
+    not serializing non-string keys
+
+v0.3.3
+  fix bigdecimal bug
+    add require bigdecimal
+
+v0.3.2
+  update changelog
+
+v0.3.1
+  remove old jar
+
+v0.3.0
+  this is a major refactor.
+  parse and generate performance improvements.
+    see JrJackson::Ruby and JrJackson::Java modules
+  pretty generation support.
+  jruby 9.0.1.0 and 1.7.22
+  jackson 2.6.1
+
+v0.2.9
+  fix for issue 39
+    incorrect error when serializing BasicObject
+
+v0.2.8
+  fixes for issues-28,29,31
+    correction for Time#to_s
+    new options to control date serialization
+    optimizations suggested by @headius
+  jar compiled for jruby 1.7.17
+  jruby 1.7.17
+  jackson 2.4.4
+
+v0.2.7
+  fixes for issues-23,24
+    add to_time as option for serializing Time like objects
+  jar compiled for jruby 1.7.11
+
+v0.2.6
+  fix issue-20
+    allow jruby to convert Ruby StringIO into Java
+    by not type checking passed arg
+    this is because jruby 1.7.9 has changed the type of java object backing Ruby StringIO
+  jar compiled for jruby 1.7.8 (jruby 1.7.9 in the maven repo has an error in the pom.xml)
+  jruby 1.7.8, jruby 1.7.9 (tested)
+  jackson 2.3.0
+
+v0.2.5
+  fix issue-16
+    reduce the gem size by:
+      change pom.xml to only include relevant java jars
+      exclude benchmaking from the gemspec files
+  jruby 1.7.5
+  jackson 2.2.3
+
+v0.2.4
+  fix issue-15
+    return Ruby nil instead of Java null
+  fix issue-14
+    remove all usage of Ruby.getGlobalRuntime
+    pass the runtime from the calling Ruby ThreadContext into the deserializers and converters
+  jruby 1.7.5
+  jackson 2.2.3
+
+v0.2.3
+  fix issue-12
+    improve the serialization support for non Json Datatype Ruby objects
+    now has support for serializing via toJava, to_h, to_hash, to_a, to_json
+  fix for failing MultiJson unicode test
+  jruby 1.7.4
+  jackson 2.2.3
+
+v0.2.2
+  fix issue-13
+    compile Java for 1.6 compatibility
+  documentation tweaks
+  jruby 1.7.4
+  jackson 2.2.3
+
+v0.2.1
+  documentation tweaks
+  fix issue-7
+    add pluggable String and Symbol Converters for JSON values
+  jruby 1.7.4
+  jackson 2.2.3
+
+v0.2.0
+  extract all Java -> Ruby generation to reusable RubyUtils static class
+  support BigDecimal
+  remove JSON Api
+  fixes issues 5, 6, 8,
+
+  jruby 1.7.3
+  jackson 2.2.2
+
+v0.1.1
+  fix Time regex
+v0.1.0
+  MutiJson compatibility
+  switch to using almost all Java, i.e. define most of the ruby modules in Java
+  jruby 1.7.3
+  jackson 2.1.4
+v0.0.7
+  first release - minimal jruby wrapper around jackson 1.9.5 jars

data/jrjackson.gemspec

@@ -0,0 +1,32 @@
+#! /usr/bin/env jruby
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'jrjackson/build_info'
+
+Gem::Specification.new do |s|
+  s.name        = 'jrjackson'
+  s.version     = JrJackson::BuildInfo.version
+  s.date        = JrJackson::BuildInfo.release_date
+  # need java platform for jar-dependencies to work
+  s.platform    = 'java'
+  s.authors     = ['Guy Boertje']
+  s.email       = ['guyboertje@gmail.com']
+  s.homepage    = "http://github.com/guyboertje/jrjackson"
+  s.summary     = %q{A JRuby wrapper for the java jackson json processor jar}
+  s.description = %q{A mostly native JRuby wrapper for the java jackson json processor jar}
+  s.license     = 'Apache License 2.0'
+
+  s.add_development_dependency 'bundler', '~> 1.10'
+  s.add_development_dependency 'jar-dependencies', '< 2.0', '>= 0.3.2'
+  s.add_development_dependency 'ruby-maven', '~>3.3.10'
+
+  JACKSON_VERSION = '2.7.1'
+  s.requirements << "jar com.fasterxml.jackson.core:jackson-core, #{JACKSON_VERSION}"
+  s.requirements << "jar com.fasterxml.jackson.core:jackson-annotations, #{JACKSON_VERSION}"
+  s.requirements << "jar com.fasterxml.jackson.core:jackson-databind, #{JACKSON_VERSION}"
+  s.requirements << "jar com.fasterxml.jackson.module:jackson-module-afterburner, #{JACKSON_VERSION}"
+
+  s.files = JrJackson::BuildInfo.files
+
+end

data/lib/jrjackson.rb

@@ -0,0 +1,2 @@
+require "require_relative_patch" unless Kernel.respond_to?(:require_relative)
+require_relative "jrjackson/jrjackson"

data/lib/jrjackson/build_info.rb

@@ -0,0 +1,15 @@
+module JrJackson
+  module BuildInfo
+    def self.version
+      '0.3.9'
+    end
+
+    def self.release_date
+      '2016-04-09'
+    end
+
+    def self.files
+      `git ls-files`.split($/).select{|f| f !~ /\Abenchmarking/}
+    end
+  end
+end