Skip to content

Commit

Permalink
Improved README.
Browse files Browse the repository at this point in the history
  • Loading branch information
Don Werve committed Jul 3, 2010
1 parent b8c2117 commit 5fc2330
Show file tree
Hide file tree
Showing 16 changed files with 38 additions and 956 deletions.
11 changes: 6 additions & 5 deletions Manifest
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
Manifest
Rakefile
bin/jetty
lib/rack/handler/jetty.rb
lib/rack/servlet.rb
lib/java/cometd-api-1.0.0rc0.jar
lib/java/cometd-java-server-1.0.0rc0.jar
lib/java/cometd-api-1.1.0.jar
lib/java/cometd-java-server-1.1.0.jar
lib/java/jetty-continuation-7.0.2.v20100331.jar
lib/java/jetty-http-7.0.2.v20100331.jar
lib/java/jetty-io-7.0.2.v20100331.jar
Expand All @@ -15,3 +12,7 @@ lib/java/jetty-servlet-7.0.2.v20100331.jar
lib/java/jetty-servlets-7.0.2.v20100331.jar
lib/java/jetty-util-7.0.2.v20100331.jar
lib/java/servlet-api-2.5.jar
bin/mizuno
lib/rack/handler/mizuno/http_server.rb
lib/rack/handler/mizuno/rack_servlet.rb
lib/rack/handler/mizuno.rb
56 changes: 24 additions & 32 deletions README
Original file line number Diff line number Diff line change
@@ -1,41 +1,33 @@
is a high-performance Rack adapter for JRuby apps,
based on the latest version of the Jetty webserver
(http://jetty.codehaus.org/jetty/)
Mizuno is a set of Jetty-powered running shoes for JRuby/Rack.

To use rack-handler-jetty with your Rack app:
To use Mizuno with your Rack app:

gem install rack-handler-jetty
cd /path/to/my/app
jetty
gem install mizuno
cd /path/to/my/rack/app
mizuno

We get our performance by implementing a direct servlet-to-rack bridge
via JRuby's Java integration layer.
...and you're off and running. You don't need to set up a Java web
container for your Rack application to run under JRuby, because Mizuno
works just like Mongrel, WEBRick, Thin, or any other standard Rack
handler.

The numbers speak for themselves:
Mizuno is the fastest option for Rack applications on JRuby:

ruby 1.9.1p243
Mizuno: 6106.66 req/s (mean)
Jetty (via jruby-rack): 2011.67 req/s (mean)
Mongrel: 1479.15 req/sec (mean)

Mongrel
Webrick
Thin
Mizuno also supports asynchronous request handling.

JRuby 1.5.0RC1 on Java SE Server VM 1.6.0_17-b04
All the speed comes from Jetty 7; Mizuno just ties it to Rack through
JRuby's Ruby/Java integration layer.

Mongrel
Webrick
rack-handler-jetty
Jetty+Warbler
Tomcat+Warbler
Note that Mizuno is NOT a direct replacement for jruby-rack or Warbler,
because it doesn't produce WAR files or make any attempt to package a
Rack application for installation in a Java web container.

rack-handler-jetty also provides access to the underlaying servlet
context, allowing for runtime additions of additional servlets and
filters. We plan on using this to tie in the cometd servlet
as a piece of Rack middleware, which will provide a simple way to
add Comet funtionality, via the Bayeux protocol, to any Rack
application.

Note that rack-handler-jetty is NOT a direct replacement for jruby-rack
or Warbler, as we don't produce WAR files or make any attempt to package
a Rack application for installation in a Java web container. Rather, we
just make it really easy to use Jetty as a webserver for your Rack
applications.
There's also a few features that I have yet to implement:
1. Integrate the cometd servlet to provide Comet/Bayeux.
2. Route Jetty's logs into Rack::Logger.
3. Add hooks for realtime monitoring of server performance.
4. Add the ability to run multiple Rack apps in a single JVM.
4 changes: 2 additions & 2 deletions Rakefile
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@ require 'rubygems'
require 'rake'
require 'echoe'

Echoe.new('rack-handler-jetty', '0.3.4') do |p|
Echoe.new('mizuno', '0.3.6') do |p|
p.description = "Jetty handler for Rackup"
p.summary = "Implements Rack::Handler::Jetty"
p.summary = "Implements Rack::Handler::Mizuno"
p.url = "http://github.com/madwombat/rack-handler-jetty"
p.author = "Don Werve"
p.email = "don@madwombat.com"
Expand Down
12 changes: 0 additions & 12 deletions bin/jetty

This file was deleted.

Binary file removed lib/java/cometd-api-1.0.0rc0.jar
Binary file not shown.
Binary file removed lib/java/cometd-java-server-1.0.0rc0.jar
Binary file not shown.
1 change: 0 additions & 1 deletion lib/mizuno.rb

This file was deleted.

69 changes: 0 additions & 69 deletions lib/mizuno/handler.rb

This file was deleted.

Loading

0 comments on commit 5fc2330

Please sign in to comment.