nolman-jetty-rails 0.9.6-jruby

data/History.txt

@@ -0,0 +1,49 @@
+== 0.8.1
+* updating jruby-rack to be compatible with Rails 2.3.x
+* better build system, upgrading to newer version of newgem
+
+== 0.8
+* reading config/web.xml file (not yet supporting config/web.xml.erb)
+* supporting /public/WEB-INF dir for custom web resources (config files and taglibs)
+
+== 0.7
+* Merb 1.0 support!
+* jruby-rack updated to the latest release (0.9.3)
+* jetty server update to 6.1.14
+* adding known issue with jruby-1.1.4 to the docs
+* JSP and JSP Expression Language support
+* some minor bugs
+
+== 0.6
+* load all java classes inside classes/ by default
+* command line args to customize lib/ and classes/ directories
+* -v showing jetty_rails version
+* each web application context has its own classloader (isolated classpaths)
+* upgraded to jruby-rack-0.9.2 (no more views being cached in development time)
+* minor changes and refactorings
+* improved docs for multi-server support
+
+== 0.5
+* load all jars inside lib/ by default
+* using GEM_PATH environment variable, if exists
+* fix signal handling (ctrl + c) for jetty_merb
+
+== 0.4
+* Merb support! jruby -S jetty_merb
+* Changed default ports to 3000 (rails) and 4000 (merb)
+* More specs
+
+== 0.3
+
+* Improved Documentation: rdoc and site.
+
+== 0.2
+
+* Running any rails applications with no extra classpath.
+* Command line options for jett_rails binary executable.
+  See: <tt>jruby -S jetty_rails --help</tt> for details.
+
+== 0.1
+
+* Initial release.
+* Running default rails applications inside Jetty.

data/Licenses.txt

@@ -0,0 +1,37 @@
+= Jetty Rails
+
+Jetty Rails is distributed under the terms of the MIT License.
+
+Copyright (c) 2008 Fabio Kung
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+= Additional Bundled Software
+
+JRuby-Rack (jruby-rack-*.jar) is distributed under the terms of the 
+MIT license. See http://svn.codehaus.org/jruby-contrib/trunk/rack/LICENSE.txt
+for details.
+
+Jetty (jetty-*.jar) is distributed under the terms of the Apache 2.0 License. 
+See http://jetty.mortbay.org/jetty-6/LICENSE.txt for details.
+
+Servlet API 2.5, a.k.a JSR-154, (servlet-api-2.5-*.jar) is distributed 
+under the terms of the Berkeley License. See http://developers.sun.com/license/berkeley_license.html 
+for details.

data/Manifest.txt

@@ -0,0 +1,51 @@
+History.txt
+Licenses.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+TODO.txt
+bin/jetty_merb
+bin/jetty_rails
+jetty-libs/core-3.1.1.jar
+jetty-libs/jetty-6.1.14.jar
+jetty-libs/jetty-plus-6.1.14.jar
+jetty-libs/jetty-util-6.1.14.jar
+jetty-libs/jsp-2.1.jar
+jetty-libs/jsp-api-2.1.jar
+jetty-libs/servlet-api-2.5-6.1.14.jar
+lib/jetty_rails.rb
+lib/jetty_rails/adapters/abstract_adapter.rb
+lib/jetty_rails/adapters/merb_adapter.rb
+lib/jetty_rails/adapters/rails_adapter.rb
+lib/jetty_rails/adapters/rails_jms_adapter.rb
+lib/jetty_rails/config/command_line_reader.rb
+lib/jetty_rails/config/rdoc_fix.rb
+lib/jetty_rails/handler/delegate_on_errors_handler.rb
+lib/jetty_rails/handler/public_directory_handler.rb
+lib/jetty_rails/handler/web_app_handler.rb
+lib/jetty_rails/jars.rb
+lib/jetty_rails/runner.rb
+lib/jetty_rails/server.rb
+lib/jetty_rails/warbler_reader.rb
+lib/jruby-rack-0.9.5-SNAPSHOT.jar
+script/console
+script/destroy
+script/generate
+script/txt2html
+spec/config.yml
+spec/jetty_merb_spec.rb
+spec/jetty_rails/config_file_spec.rb
+spec/jetty_rails/handler/delegate_on_errors_handler_spec.rb
+spec/jetty_rails/runner_spec.rb
+spec/jetty_rails_sample_1.yml
+spec/jetty_rails_sample_2.yml
+spec/jetty_rails_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/jruby.rake
+tasks/rspec.rake
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.html.erb

data/PostInstall.txt

@@ -0,0 +1,2 @@
+
+For more information on jetty-rails, see http://jetty-rails.rubyforge.org

data/README.rdoc

@@ -0,0 +1,130 @@
+= jetty-rails
+
+http://jetty-rails.rubyforge.net
+
+== DESCRIPTION:
+
+Jetty Rails aims to run Ruby on Rails and Merb applications with the Jetty Container, leveraging the power of JRuby and jruby-rack.
+
+{Jetty}[http://jetty.mortbay.com/jetty/] is an excellent Java Web Server, being and at the same time extremely lightweight. This makes jetty-rails a good alternative for JRuby on Rails or Merb development and deployment.
+
+The project has born from my own needs ({read more}[http://fabiokung.com/2008/05/14/jetty-rails-gem-simple-jruby-on-rails-development-with-servlet-containers/]). I needed to run {JForum}[http://jforum.net] in the same context of my JRuby on Rails application. I had also to integrate HttpSessions (avoiding single sign on) and use ServletContext in-memory cache store.
+
+== FEATURES:
+
+* Uses {JRuby Rack}[http://wiki.jruby.org/wiki/JRuby_Rack].
+* Loads all jars inside your application lib/ dir, by default.
+* Loads all classes inside your application classes/ dir, by default.
+* Supports rails and merb applications out of the box.
+
+== KNOWN ISSUES
+
+* Doesn't work with gems inside $HOME/.gem, because jruby-rack overwrites custom gem paths. Please install jruby in writable places, or install your gems with sudo <tt>jruby -S gem install NAME</tt>.
+
+* Doesn't work with JRuby 1.1.4: http://jira.codehaus.org/browse/JRUBY-2959
+
+* To generate coverage report with jruby (>= 1.1) follow instructions from http://www.ruby-forum.com/topic/146252 and run (inside jetty-rails root dir):
+jruby -S rake rcov
+
+* Hoe in jruby has an issue reading the ~/.hoerc file. Just remove it.
+
+== USAGE:
+
+=== Rails:
+
+  cd myrailsapp
+  jruby -S jetty_rails
+  
+help option shows usage details:
+  
+  jruby -S jetty_rails --help
+  
+=== Merb:
+
+  cd mymerbapp
+  jruby -S jetty_merb
+
+help option shows usage details:
+
+  jruby -S jetty_merb --help
+
+== REQUIREMENTS:
+
+jetty-rails requires jruby (>=1.1). Please make sure you already have 
+it properly installed and inserted in your PATH environment variable.
+
+{Installing JRuby Instructions}[http://wiki.jruby.org/wiki/Getting_Started]
+
+== INSTALL:
+
+  jruby -S gem install jetty-rails
+  
+== BUGS AND NEW FEATURES
+
+Using Lighthouse: http://fabiokung.lighthouseapp.com/projects/12666-jetty-rails
+
+
+== MULTIPLE SERVERS:
+
+You can specify a configuration yaml file rather than command line switches. 
+The file also allows specifying multiple servers and / or application contexts for single jetty container.
+
+For example, you could set a context_path of /testA on port 8888 which is rails, /testB also that port which is merb.
+Or, you could have /testA on port 8888 and /testB on port 9999.
+
+ jruby -S jetty_rails -c path/to/config.yml
+
+The configuration options are inherited, so if you specify the environment to be "production" at the top level, 
+then any servers and application context will be "production" unless the choose to override the value.
+
+- server settings:
+  <tt>:port</tt>, <tt>:jruby_min_runtimes</tt>, <tt>:jruby_max_runtimes</tt>, <tt>:thread_pool_max</tt>, <tt>:thread_pool_min</tt>, <tt>:acceptor_size</tt>
+
+- application context settings:
+  <tt>:context_path</tt>, <tt>:base</tt>, <tt>:adapter</tt>, <tt>:environment</tt>, <tt>:lib_dir</tt>, <tt>:gem_path</tt>
+
+As part of the configuration you have some control over jruby & jetty.
+
+See spec/config.yml, spec/jetty_rails_sample_1.yml, and spec/jetty_rails_sample_2.yml for more examples.
+
+=== Rails:
+
+If -c is not specified, by default jetty_rails will look for a config/jetty_rails.yml relative to where it is started.
+
+Don't forget to add this into your config/environment.rb
+ActionController::AbstractRequest.relative_url_root = "/testA"
+
+
+=== JRuby Configuration
+
+You can tweak the JRuby runtimes per application context:
+
+  jruby_min_runtimes: 1
+  jruby_max_runtimes: 2
+
+
+=== Jetty Configuration
+
+You can also modify the jetty per server configurations:
+
+Thread pool will define the thread pool available to the jetty server using a QueuedThreadPool.
+
+  thread_pool_max: 40
+  thread_pool_min: 1
+
+
+The acceptor size is the number of acceptor threads available for that server's channel connector.
+
+  acceptor_size: 20
+
+See the jetty documentation for more information.
+
+
+== LICENSE:
+
+Jetty Rails is distributed under the terms of The MIT License.
+Copyright (c) 2008 Fabio Kung <fabio.kung@gmail.com>
+  
+Read more details in the bundled +Licenses.txt+ file. There are other 
+pieces of software bundled with jetty-rails. Before using jetty-rails, 
+make sure you agree with all of them.

data/Rakefile

@@ -0,0 +1,27 @@
+require 'rubygems' unless ENV['NO_RUBYGEMS']
+%w[rake rake/clean fileutils newgem rubigen hoe].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/jetty_rails'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('jetty-rails', JettyRails::VERSION) do |p|
+  p.developer('Fabio Kung', 'fabio.kung@gmail.com')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  p.rubyforge_name       = p.name # TODO this is default value
+  p.extra_deps         = [
+    ['activesupport','>= 2.0.2'],
+  ]
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  #p.spec_extras['platform'] = 'java' # JRuby gem created, e.g. jetty-rails-X.Y.Z-jruby.gem
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log **/.*.sw? *.gem .config]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+# task :default => :spec

data/TODO.txt

@@ -0,0 +1,11 @@
+== TODO never ends...
+
+* Improve RDocs
+* integration test for lib_dir jars loading
+* read configuration from warble.rb
+* install custom resources from warbler configuration
+* add custom classes from warble.rb to the context classpath
+* add custom jars from warble.rb to the context classpath
+* support config/web.xml.erb
+* read any custom jetty.xml
+* support jetty-plus features (i.e.: jndi)

data/bin/jetty_merb

@@ -0,0 +1,41 @@
+#!/usr/bin/env jruby
+
+# == Synopsis
+#
+# jetty_merb: jetty server for merb applications
+#
+# == Usage
+#
+# jetty_merb [OPTION] ... BASEDIR
+#
+# -h, --help::
+#    show help
+#
+# --context-path PATH, -u PATH::
+#    change the application context path (default: '/')
+#
+# --port PORT, -p PORT::
+#    change server port (default: 4000)
+#
+# --environment ENV, -e ENV::
+#    change rails environment (default: development)
+#
+# --classes CLASSES_DIR::
+#    directory containing java classes used by the application (default: 'classes/')
+#
+# --lib LIB_DIR, --jars LIB_DIR::
+#    directory containing jars used by the application (default: 'lib/')
+#
+# --config FILE, -c FILE:: (optional)
+#	config file to use instead of command line switches (allows for multiple servers)
+#
+# BASEDIR (optional): directory to be run (default: current).
+
+require "java"
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../lib"
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../jetty-libs"
+require "jetty_rails"
+
+options = CommandLineReader.new.read(:merb)
+runner = JettyRails::Runner.new(options)
+runner.start

data/bin/jetty_rails

@@ -0,0 +1,41 @@
+#!/usr/bin/env jruby
+
+# == Synopsis
+#
+# jetty_rails: jetty server for rails applications
+#
+# == Usage
+#
+# jetty_rails [OPTION] ... BASEDIR
+#
+# -h, --help::
+#    show help
+#
+# --context-path PATH, -u PATH::
+#    change the application context path (default: '/')
+#
+# --port PORT, -p PORT::
+#    change server port (default: 3000)
+#
+# --environment ENV, -e ENV::
+#    change rails environment (default: development)
+#
+# --classes CLASSES_DIR::
+#    directory containing java classes used by the application (default: 'classes/')
+#
+# --lib LIB_DIR, --jars LIB_DIR::
+#    directory containing jars used by the application (default: 'lib/')
+#
+# --config FILE, -c FILE:: (optional)
+#	config file to use instead of command line switches (allows for multiple servers)
+#
+# BASEDIR (optional): directory to be run (default: current).
+
+require "java"
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../lib"
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../jetty-libs"
+require "jetty_rails"
+
+options = CommandLineReader.new.read(:rails)
+runner = JettyRails::Runner.new(options)
+runner.start

data/lib/jetty_rails.rb

@@ -0,0 +1,26 @@
+jetty_libs_dir = "#{File.dirname(__FILE__)}/../jetty-libs"
+$:.unshift(File.expand_path(jetty_libs_dir)) unless
+  $:.include?(jetty_libs_dir) || $:.include?(File.expand_path(jetty_libs_dir))
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "java"
+require "rubygems"
+require "activesupport"
+require "jetty_rails/jars"
+require "jetty_rails/adapters/abstract_adapter"
+require "jetty_rails/adapters/rails_adapter"
+require "jetty_rails/adapters/rails_jms_adapter"
+require "jetty_rails/adapters/merb_adapter"
+require "jetty_rails/runner"
+require "jetty_rails/server"
+require "jetty_rails/handler/delegate_on_errors_handler"
+require "jetty_rails/handler/public_directory_handler"
+require "jetty_rails/handler/web_app_handler"
+require "jetty_rails/config/command_line_reader"
+
+module JettyRails
+  VERSION = '0.8.1'
+  JETTY_RAILS_HOME = File.dirname(__FILE__) + "/.." unless defined?(JETTY_RAILS_HOME)
+end

data/lib/jetty_rails/adapters/abstract_adapter.rb

@@ -0,0 +1,25 @@
+module JettyRails
+  module Adapters
+    class AbstractAdapter
+      attr_reader :config
+      
+      def initialize(config)
+        @config = config
+      end
+      
+      def base_init_params()
+        @base_init_params ||= { 
+          'public.root' => '/public',
+          'gem.path' => config[:gem_path] || ENV['GEM_PATH'] || 'tmp/war/WEB-INF/gems',
+          'jruby.initial.runtimes' => "#{config[:jruby_min_runtimes]}",
+          'jruby.min.runtimes' => "#{config[:jruby_min_runtimes]}",
+          'jruby.max.runtimes' => "#{config[:jruby_max_runtimes]}"
+        }
+      end
+      
+      def event_listeners
+        []
+      end
+    end
+  end
+end