goliath 0.9.4 → 1.0.0.beta.1

data/.gitignore

@@ -1,9 +1,12 @@
 Gemfile.lock
 
+bin/
 .bundle/
 doc/
+.idea/
 pkg/
 _site
+vendor/
 
 .yardoc
 .livereload

data/Guardfile

@@ -0,0 +1,8 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/goliath/(.+)\.rb$})     { |m| "spec/unit/#{m[1]}_spec.rb" }
+end
+

data/HISTORY.md

@@ -1,5 +1,15 @@
 # HISTORY
 
+## v1.0.0 (May 2x, 2012)
+
+  - removed router DSL for 1.0 release
+  - removed restriction on environments
+  - refactored validation handler logic
+  - refactored params coercion logic
+  - users can customize log formats
+  - cleanup of spec helpers
+  - many small bugfixes
+
 ## v0.9.3 (Oct 16, 2011)
 
   - new router DSL - much improved, see examples

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2011 PostRank Inc.
+Copyright (c) 2011-2012 PostRank Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to

data/README.md

@@ -1,22 +1,28 @@
 # Goliath
 
-Goliath is an open source version of the non-blocking (asynchronous) Ruby web server framework powering PostRank. It is a lightweight framework designed to meet the following goals: bare metal performance, Rack API and middleware support, simple configuration, fully asynchronous processing, and readable and maintainable code (read: no callbacks).
+[<img src="https://secure.travis-ci.org/postrank-labs/goliath.png?travis"/>](http://travis-ci.org/postrank-labs/goliath) [<img src="https://gemnasium.com/postrank-labs/goliath.png?travis"/>](https://gemnasium.com/postrank-labs/goliath)
 
-The framework is powered by an EventMachine reactor, a high-performance HTTP parser and Ruby 1.9 runtime. The one major advantage Goliath has over other asynchronous frameworks is the fact that by leveraging Ruby fibers introduced in Ruby 1.9+, it can untangle the complicated callback-based code into a format we are all familiar and comfortable with: linear execution, which leads to more maintainable and  readable code.
+Goliath is an open source version of the non-blocking (asynchronous) Ruby web server framework. It is a lightweight framework designed to meet the following goals: bare metal performance, Rack API and middleware support, simple configuration, fully asynchronous processing, and readable and maintainable code (read: no callbacks).
 
-Each HTTP request within Goliath is executed in its own Ruby fiber and all asynchronous I/O operations can transparently suspend and later resume the processing without requiring the developer to write any additional code. Both request processing and response processing can be done in fully asynchronous fashion: streaming uploads, firehose API's, request/response, and so on.
+The framework is powered by an EventMachine reactor, a high-performance HTTP parser and Ruby 1.9+ runtime. The one major advantage Goliath has over other asynchronous frameworks is the fact that by leveraging Ruby fibers introduced in Ruby 1.9+, it can untangle the complicated callback-based code into a format we are all familiar and comfortable with: linear execution, which leads to more maintainable and readable code.
+
+Each HTTP request within Goliath is executed within its own Ruby fiber and all asynchronous I/O operations can transparently suspend and later resume the processing without requiring the developer to write any additional code. Both request processing and response processing can be done in fully asynchronous fashion: streaming uploads, firehose API's, request/response, websockets, and so on.
 
 ## Installation & Prerequisites
 
 * Install Ruby 1.9 (via RVM or natively)
 
-        $> gem install rvm
-        $> rvm install 1.9.2
-        $> rvm use 1.9.2
+```bash
+$> gem install rvm
+$> rvm install 1.9.3
+$> rvm use 1.9.3
+```
 
 * Install Goliath:
 
-        $> gem install goliath
+```bash
+$> gem install goliath
+```
 
 ## Getting Started: Hello World
 
@@ -33,20 +39,13 @@ end
 > [97570:INFO] 2011-02-15 00:33:51 :: Starting server on 0.0.0.0:9000 in development mode. Watch out for stones.
 ```
 
-See examples directory for more, hands-on examples of building Goliath powered web-services. Are you new to EventMachine, or want a detailed walk-through of building a Goliath powered API? You're in luck, we have two super-awesome peepcode screencasts which will teach you all you need to know:
-
-* [Meet EventMachine: Part 1](http://peepcode.com/products/eventmachine) - introduction to EM, Fibers, etc.
-* [Meet EventMachine: Part 2](http://peepcode.com/products/eventmachine-ii) - building an API with Goliath
+See examples directory for more hands-on examples of building Goliath powered web-services.
 
 ## Performance: MRI, JRuby, Rubinius
 
-Goliath is not tied to a single Ruby runtime - it is able to run on MRI Ruby, JRuby and Rubinius today. Depending on which platform you are working with, you will see different performance characteristics. At the moment, we recommend MRI Ruby 1.9.2 as the best performing VM: a roundtrip through the full Goliath stack on MRI 1.9.2p136 takes ~0.33ms (~3000 req/s).
-
-JRuby performance (with 1.9 mode enabled) is currently much worse than MRI Ruby 1.9.2, due to the fact that all JRuby fibers are mapped to native Java threads. However, there is [very promising](http://classparser.blogspot.com/2010/04/jruby-coroutines-really-fast.html), existing work that promises to make JRuby fibers even faster than those of MRI Ruby. Once this functionality is built into JRuby ([JRUBY-5461](http://jira.codehaus.org/browse/JRUBY-5461)), JRuby may well take the performance crown. At the moment, without the MLVM support, a request through the full Goliath stack takes ~6ms (166 req/s).
+Goliath is not tied to a single Ruby runtime - it is able to run on MRI Ruby, JRuby and Rubinius today. Depending on which platform you are working with, you will see different performance characteristics. At the moment, we recommend MRI Ruby 1.9.3+ as the best performing VM: a roundtrip through the full Goliath stack on MRI 1.9.3 takes ~0.33ms (~3000 req/s).
 
-Rubinius + Goliath performance is tough to pin down - there is a lot of room for optimization within the Rubinius VM. Currently, requests can take as little as 0.2ms and later spike to 50ms+. Stay tuned!
-
-Goliath has been in production at PostRank for over a year, serving a sustained 500 requests/s for internal and external applications. Many of the Goliath processes have been running for months at a time (read: no memory leaks) and have served hundreds of gigabytes of data without restarts. To scale up and provide failover and redundancy, our individual Goliath servers at PostRank are usually deployed behind a reverse proxy (such as HAProxy).
+Goliath has been used in production environments for 2+ years, across many different companies: PostRank (now Google), [OMGPOP](OMGPOP) (now Zynga), [GameSpy](http://www.poweredbygamespy.com/2011/09/09/growing-pains-they-hurt-so-good/), and many others.
 
 ## FAQ
 
@@ -68,20 +67,21 @@ Goliath has been in production at PostRank for over a year, serving a sustained
 
 ### Hands-on applications:
 
-* [Peepcode](http://peepcode.com/products/eventmachine) [screencasts](http://peepcode.com/products/eventmachine-ii)
+If you are you new to EventMachine, or want a detailed walk-through of building a Goliath powered API? You're in luck, we have two super-awesome Peepcode screencasts which will teach you all you need to know:
+
+* [Meet EventMachine: Part 1](http://peepcode.com/products/eventmachine) - introduction to EM, Fibers, etc.
+* [Meet EventMachine: Part 2](http://peepcode.com/products/eventmachine-ii) - building an API with Goliath
+
+Additionally, you can also watch this presentation from GoGaRuCo 2011, which describes the design and motivation behind Goliath:
+
+* [0-60 with Goliath: Building high performance web services](http://confreaks.com/videos/653-gogaruco2011-0-60-with-goliath-building-high-performance-ruby-web-services)
+
+Other resources:
+
 * [Asynchronous HTTP, MySQL, etc](https://github.com/postrank-labs/goliath/wiki/Asynchronous-Processing)
 * [Response streaming with Goliath](https://github.com/postrank-labs/goliath/wiki/Streaming)
 * [Examples](https://github.com/postrank-labs/goliath/tree/master/examples)
 
-## Coverage
-
-* [Goliath: Non-blocking, Ruby 1.9 Web Server](http://www.igvita.com/2011/03/08/goliath-non-blocking-ruby-19-web-server)
-* [Stage left: Enter Goliath - HTTP Proxy + MongoDB](http://everburning.com/news/stage-left-enter-goliath/)
-* [InfoQ: Meet the Goliath of Ruby Application Servers](http://www.infoq.com/articles/meet-goliath)
-* [Node.jsはコールバック・スパゲティを招くか](http://el.jibun.atmarkit.co.jp/rails/2011/03/nodejs-d123.html)
-* [Goliath on LinuxFr.org (french)](http://linuxfr.org/news/en-vrac-spécial-ruby-jruby-sinatra-et-goliath)
-* [Goliath et ses amis (slides in french)](http://nono.github.com/Presentations/20110416_Goliath/)
-
 ## Discussion and Support
 
 * [Source](https://github.com/postrank-labs/goliath)
@@ -90,5 +90,4 @@ Goliath has been in production at PostRank for over a year, serving a sustained
 
 ## License & Acknowledgments
 
-Goliath is distributed under the MIT license, for full details please see the LICENSE file.
-Rock favicon CC-BY from [Douglas Feer](http://www.favicon.cc/?action=icon&file_id=375421)
+Goliath is distributed under the MIT license, for full details please see the LICENSE file.

data/Rakefile

@@ -3,9 +3,17 @@ Bundler::GemHelper.install_tasks
 
 require 'yard'
 require 'rspec/core/rake_task'
+require 'rake/testtask'
 
-task :default => [:spec]
-task :test => [:spec]
+task :default => [:test]
+task :test => [:spec, :unit]
+
+desc "run the unit test"
+Rake::TestTask.new(:unit) do |t|
+   t.libs << "test"
+   t.test_files = FileList['test/**/*_test.rb']
+   t.verbose = true
+end
 
 desc "run spec tests"
 RSpec::Core::RakeTask.new('spec') do |t|

data/examples/activerecord/config/srv.rb

@@ -4,4 +4,5 @@ ActiveRecord::Base.establish_connection(:adapter  => 'em_mysql2',
                                         :database => 'goliath_test',
                                         :username => 'goliath',
                                         :password => 'goliath',
-                                        :host     => 'localhost')
+                                        :host     => 'localhost',
+                                        :pool     => 5)

data/examples/activerecord/srv.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-# gem install activerecord
+# gem install em-synchrony
 # gem install mysql2
 
 # create database goliath_test
@@ -9,11 +9,21 @@
 # create table users (id int not null auto_increment primary key, name varchar(255), email varchar(255));
 # insert into users (name, email) values ('dan', 'dj2@everyburning.com'), ('Ilya', 'ilya@igvita.com');
 
+# To start server
+# ruby ./srv.rb
+#
+# Example output:
+# curl http://localhost:9000/?id=1
+#=> "{\"user\":{\"email\":\"dj2@everyburning.com\",\"id\":1,\"name\":\"dan\"}}"
+# curl http://localhost:9000/?id=2
+#=> "{\"user\":{\"email\":\"ilya@igvita.com\",\"id\":2,\"name\":\"Ilya\"}}"
+
 $: << "../../lib" << "./lib"
 
 require 'goliath'
-require 'active_record'
-require 'yajl'
+require 'em-synchrony/activerecord'
+
+require 'yajl' if RUBY_PLATFORM != 'java'
 
 class User < ActiveRecord::Base
 end
@@ -27,7 +37,6 @@ class Srv < Goliath::API
   use Goliath::Rack::Validation::NumericRange, {:key => 'id', :min => 1}
 
   def response(env)
-    User.find_by_sql("SELECT SLEEP(10)")
-    [200, {}, User.find(params['id'])]
+    [200, {}, User.find(params['id']).to_json]
   end
 end

data/examples/api_proxy.rb

@@ -4,8 +4,8 @@
 
 require 'goliath'
 require 'em-synchrony/em-http'
- 
-class TwilioResponse < Goliath::API
+
+class Twilio < Goliath::API
   use Goliath::Rack::Params
   use Goliath::Rack::JSONP
 
@@ -18,11 +18,7 @@ class TwilioResponse < Goliath::API
 
     http = EM::HttpRequest.new(url).get head: HEADERS
     logger.debug "Received #{http.response_header.status} from Twilio"
- 
+
     [200, {'X-Goliath' => 'Proxy','Content-Type' => 'application/javascript'}, http.response]
   end
 end
-
-class Twilio < Goliath::API
-  get %r{^/(Local|TollFree)}, TwilioResponse
-end

data/examples/around.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/env ruby
+$:<< '../lib' << 'lib'
+
+require 'goliath'
+
+class ApiValidationAroundware
+  include Goliath::Rack::SimpleAroundware
+  class InvalidApiKeyError < Goliath::Validation::BadRequestError; end
+  
+  def pre_process
+    validate_api_key!
+    env.logger.info "past api_key validation" #<-- this is output, then an empty response header & body as if it is just hanging...
+    Goliath::Connection::AsyncResponse
+  end 
+  
+  def post_process
+    [status, headers, body]
+  end
+  
+  def validate_api_key!
+    server_api_key = env['config']['server_api_key'].to_s
+    if api_key != server_api_key
+      raise InvalidApiKeyError
+    end
+  end
+
+  # retreive the client's api_key  
+  def api_key
+    env['HTTP_API_KEY'].to_s
+  end
+end
+
+class AwesomeApiWithLogging < Goliath::API
+  use Goliath::Rack::SimpleAroundwareFactory, ApiValidationAroundware
+  def response(env)
+    [200, {}, "Hello"]
+  end
+end

data/examples/async_aroundware_demo.rb

@@ -3,7 +3,7 @@ $: << File.dirname(__FILE__)+'/../lib'
 
 require 'goliath'
 require 'em-synchrony/em-http'
-require 'yajl/json_gem'
+require 'yajl/json_gem' if RUBY_PLATFORM != 'java'
 
 #
 # Here's a way to make an asynchronous request in the middleware, and only
@@ -45,7 +45,7 @@ BASE_URL     = 'http://localhost:9002/'
 class RemoteRequestBarrier
   include Goliath::Rack::BarrierAroundware
   attr_accessor :sleep_1
-  
+
   def pre_process
     # Request with delay_1 and drop_1 -- note: 'aget', because we want execution to continue
     req = EM::HttpRequest.new(BASE_URL).aget(:query => { :delay => env.params['delay_1'], :drop => env.params['drop_1'] })

data/examples/async_upload.rb

@@ -2,7 +2,7 @@
 $:<< '../lib' << 'lib'
 
 require 'goliath'
-require 'yajl'
+require 'yajl' if RUBY_PLATFORM != 'java'
 
 class AsyncUpload < Goliath::API
   use Goliath::Rack::Params             # parse & merge query and body parameters

data/examples/auth_and_rate_limit.rb

@@ -5,7 +5,7 @@ require 'em-mongo'
 require 'em-http'
 require 'em-synchrony/em-http'
 require 'em-synchrony/em-mongo'
-require 'yajl/json_gem'
+require 'yajl/json_gem' if RUBY_PLATFORM != 'java'
 
 require File.join(File.dirname(__FILE__), 'http_log') # Use the HttpLog as our actual endpoint, but include this in the middleware
 

data/examples/clone.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+$:<< '../lib' << 'lib'
+
+require 'goliath'
+
+class RandomAPI2 < Goliath::API
+  use Goliath::Rack::Params
+  use Goliath::Rack::Validation::Param, :key => 'user'
+
+  def response(env)
+    [200, {}, "Hello 2!"]
+  end
+end
+
+class Router < Goliath::API
+  map '/', RandomAPI2
+end
+
+# class PlainApi < Goliath::API
+#   use Goliath::Rack::Params
+#   use Goliath::Rack::Validation::Param, :key => 'user'
+
+#   def response(env)
+#     [200, {}, "Hello 2!"]
+#   end
+# end

data/examples/config/websocket.rb

@@ -0,0 +1 @@
+config['channel'] = EM::Channel.new

data/examples/custom_logs.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$:<< '../lib' << 'lib'
+
+require 'goliath'
+
+Goliath::Request.log_block = proc do |env, response, elapsed_time|
+  method = env[Goliath::Request::REQUEST_METHOD]
+  path = env[Goliath::Request::REQUEST_PATH]
+  
+  env[Goliath::Request::RACK_LOGGER].info("#{method} #{path} in #{'%.2f' % elapsed_time} ms")  
+end
+
+class SimpleAPI < Goliath::API
+  def response(env)
+    [200, {}, "It worked !"]
+  end
+end
+
+# [19843:INFO] 2012-02-12 18:03:44 :: GET /some/url/ in 4.35 ms
+# [19843:INFO] 2012-02-12 18:03:49 :: GET /another/url/ in 4.24 ms
+# [19843:INFO] 2012-02-12 18:04:01 :: PUT /another/url/ in 4.16 ms

data/examples/custom_server.rb

@@ -4,54 +4,16 @@ $:<< '../lib' << 'lib'
 require 'goliath/api'
 require 'goliath/runner'
 
-# Example demonstrating how to use a custom rack builder with the
-# Goliath server and mixing Goliath APIs with normal Rack end points.
+# Example demonstrating how to use a custom Goliath runner
 #
-# Note, that the same routing behavior is supported by Goliath, loost at
-# the rack_routes.rb example to see how to define custom routes.
 
-# Our custom Goliath API
-class HelloWorld < Goliath::API
+class Custom < Goliath::API
   def response(env)
-    [200, {}, "hello world!"]
-  end
-end
-
-# Another Goliath API
-class Bonjour < Goliath::API
-  def response(env)
-    [200, {}, "bonjour!"]
-  end
-end
-
-# Rack builder acting as a router
-router = Rack::Builder.new do
-  # Rack end point
-  map '/version' do
-    use ::Rack::ContentLength
-    run Proc.new {|env| [200, {"Content-Type" => "text/html"}, ["Version 0.1"]] }
-  end
-
-  # map the /hello_world uri to our Goliath API
-  map "/hello_world" do
-    use ::Rack::ContentLength
-    run HelloWorld.new
-  end
-
-  # map the /bonjour uri to our other Goliath API
-  map "/bonjour" do
-    use ::Rack::ContentLength
-    run Bonjour.new
-  end
-
-  # catch the root route and return a 404
-  map "/" do
-    use ::Rack::ContentLength
-    run Proc.new {|env| [404, {"Content-Type" => "text/html"}, ["Try /version /hello_world or /bonjour"]] }
+    [200, {}, "hello!"]
   end
 end
 
 runner = Goliath::Runner.new(ARGV, nil)
-runner.app = router
-runner.run
-
+runner.api = Custom.new
+runner.app = Goliath::Rack::Builder.build(Custom, runner.api)
+runner.run

data/examples/early_abort.rb

@@ -4,6 +4,7 @@ require 'goliath'
 
 class EarlyAbort < Goliath::API
   include Goliath::Validation
+
   MAX_SIZE = 10
   TEST_FILE = "/tmp/goliath-test-error.log"
 
@@ -12,7 +13,8 @@ class EarlyAbort < Goliath::API
     env['async-headers'] = headers
 
     if env['HTTP_X_CRASH'] && env['HTTP_X_CRASH'] == 'true'
-      raise Goliath::Validation::NotImplementedError.new("Can't handle requests with X-Crash: true.")
+      raise Goliath::Validation::NotImplementedError.new(
+          "Can't handle requests with X-Crash: true.")
     end
   end
 
@@ -22,7 +24,8 @@ class EarlyAbort < Goliath::API
     size = env['async-body'].size
 
     if size >= MAX_SIZE
-      raise Goliath::Validation::BadRequestError.new("Payload size can't exceed #{MAX_SIZE} bytes. Received #{size.inspect} bytes.")
+      raise Goliath::Validation::BadRequestError.new(
+          "Payload size can't exceed #{MAX_SIZE} bytes. Received #{size.inspect} bytes.")
     end
   end
 
@@ -31,7 +34,7 @@ class EarlyAbort < Goliath::API
   end
 
   def response(env)
-    File.open(TEST_FILE, "w+") { |f| f << "response that should not be here"}
+    File.open(TEST_FILE, "w+") { |f| f << "response that should not be here\n"}
     [200, {}, "OK"]
   end
 end

data/examples/echo.rb

@@ -6,7 +6,7 @@ require 'goliath/plugins/latency'
 
 # Goliath uses multi-json, so pick your favorite JSON serializer
 # require 'json'
-require 'yajl'
+require 'yajl' if RUBY_PLATFORM != 'java'
 
 class Echo < Goliath::API
   use Goliath::Rack::Tracer             # log trace statistics

data/examples/fiber_pool.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+$:<< '../lib' << 'lib'
+
+require 'goliath'
+gem('fiber_pool', '1.0.0')
+require 'fiber_pool'
+
+fiber_pool = FiberPool.new(2)
+
+Goliath::Request.execute_block = proc do |&block|
+  fiber_pool.spawn(&block)
+end
+
+
+class SimpleAPI < Goliath::API
+  def response(env)
+    start_time = Time.now.to_f
+    EM::Synchrony.sleep(1)
+    
+    fiber_id = '%#x' % Fiber.current.object_id
+    [200, {}, "Request handled by fiber #{fiber_id}"]
+  end
+end
+
+
+# ab -n 5 -c 5 http://127.0.0.1:9000/
+
+# [96681:INFO] 2012-01-14 11:35:43 :: Status: 200, Content-Length: 39, Response Time: 1015.46ms
+# [96681:INFO] 2012-01-14 11:35:43 :: Status: 200, Content-Length: 39, Response Time: 1005.62ms
+# 
+# [96681:INFO] 2012-01-14 11:35:44 :: Status: 200, Content-Length: 39, Response Time: 2001.74ms
+# [96681:INFO] 2012-01-14 11:35:44 :: Status: 200, Content-Length: 39, Response Time: 2008.55ms
+# 
+# [96681:INFO] 2012-01-14 11:35:45 :: Status: 200, Content-Length: 39, Response Time: 3005.45ms
+# 

data/examples/grape/config/apiserver.rb

@@ -0,0 +1,8 @@
+require 'mysql2'
+
+ActiveRecord::Base.establish_connection(:adapter  => 'em_mysql2',
+                                        :database => 'goliath_test',
+                                        :username => 'goliath',
+                                        :password => 'goliath',
+                                        :host     => 'localhost',
+                                        :pool     => 1)

data/examples/grape/server.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+
+# This example shows an ActiveRecord model being exposed as an API using Grape and then being served up using Goliath.
+
+# 1. Install these gems
+# gem install em-synchrony
+# gem install mysql2
+# gem install grape
+
+# 2. Create a database
+# create database goliath_test
+# create user 'goliath'@'localhost' identified by 'goliath'
+# grant all on goliath_test.* to 'goliath'@'localhost'
+# create table users (id int not null auto_increment primary key, name varchar(255), email varchar(255));
+# insert into users (name, email) values ('dan', 'dj2@everyburning.com'), ('Ilya', 'ilya@igvita.com');
+
+# 3. Start server
+# ruby ./server.rb
+
+# 4. Try Examples
+# curl http://localhost:9000/v1/users/2.json
+# => {"email":"ilya@igvita.com","id":2,"name":"Ilya"}
+
+# All users
+# curl http://localhost:9000/v1/users
+
+# Create a new user
+# curl -X POST -d '{"user":{"name":"David Jones","email":"david@example.com"}}' http://localhost:9000/v1/users/create
+
+$: << "../../lib" << "./lib"
+
+require 'goliath'
+require 'em-synchrony/activerecord'
+require 'yajl' if RUBY_PLATFORM != 'java'
+require 'grape'
+
+class User < ActiveRecord::Base
+end
+
+class MyAPI < Grape::API
+
+  version 'v1', :using => :path
+  format :json
+
+  resource 'users' do
+    get "/" do
+      User.all
+    end
+
+    get "/:id" do
+      User.find(params['id'])
+    end
+
+    post "/create" do
+      User.create(params['user'])
+    end
+  end
+
+end
+
+class APIServer < Goliath::API
+
+  def response(env)
+    MyAPI.call(env)
+  end
+
+end

data/examples/gziped.rb

@@ -15,7 +15,7 @@ $:<< '../lib' << 'lib'
 require 'rack/deflater'
 require 'rack/rewrite'
 require 'goliath'
-require 'yajl'
+require 'yajl' if RUBY_PLATFORM != 'java'
 
 class Gziped < Goliath::API
   # if client requested, compress the response

data/examples/params.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+$:<< '../lib' << 'lib'
+
+require 'goliath'
+require 'multi_json'
+
+class CustomJSON
+  def coerce(value, opts={})
+    begin
+      MultiJson.load(value)
+    rescue
+      return opts[:default] if opts[:default]
+      raise Goliath::Rack::Validation::FailedCoerce.new([400, {}, "Invalid JSON"])
+    end
+  end
+end
+
+class ParamsCoerce < Goliath::API
+  include Goliath::Rack::Types
+  use Goliath::Rack::Params
+  use Goliath::Rack::Validation::Param, :key => 'user_id', :as => Integer, :default => "admin"
+  use Goliath::Rack::Validation::Param, :key => 'flag', :as => Boolean, :message => "Flag needs to be a boolean"
+  use Goliath::Rack::Validation::Param, :key => 'amount', :as => Float
+  use Goliath::Rack::Validation::Param, :key => "json", :as => CustomJSON
+  use Goliath::Rack::Validation::Param, :key => "json_default", :as => CustomJSON,
+                                              :default => "nojson", :optional => true
+
+  use Goliath::Rack::Validation::Param, :key => 'name', :type => "Big Name", :message => "cant be found"
+
+  def response(env)
+    [200, {}, params.to_s]
+  end
+end
+
+# Example request: http://localhost:9000/?user_id=3d&flag=1&amount=3.0&json=[1,2,3]&name=mike
+