= rjack-jetty

* http://rjack.gravitext.com/jetty
* http://rjack.gravitext.com
* https://github.com/dekellum/rjack

== Description

A gem packaging of the {Jetty Web Server}[http://www.eclipse.org/jetty/]
for JRuby:

* Provides all common jetty server jars and some optional jars like,
  -util, -rewrite, -continuation
* jetty-client (via <tt>require rjack-jetty/client</tt>)
* javax.servlet 3.0.0
* A Jetty::ServerFactory for simple programmatic server setup in ruby
* A set of Jetty::TestServlets containing a SnoopServlet and
  PerfTestServlet (implemented in Java)
* A jetty-service bin script for easy testing from the command line

Note that JSP support is provided separately in the companion
jetty-jsp[http://rjack.gravitext.com/jetty-jsp/] gem.

== Synopsis

  % rjack-jetty-service -v
  Usage: rjack-jetty-service [options]
      -p, --port N           Port to listen on (default: auto)
      -t, --threads N        Maximum pool threads (default: 20)
      -w, --webapp PATH      Load PATH as root context webapp
                             (default: gem test.war)
      -j, --jsp              Enable JSP support by loading jetty-jsp gem
      -d, --debug            Enable debug logging
      -v, --version          Show version and exit

or

  require 'rjack-jetty'
  require 'rjack-jetty/test-servlets'

  factory = RJack::Jetty::ServerFactory.new
  factory.port = 8080

  factory.set_context_servlets( '/', '/*' => Jetty::TestServlets::SnoopServlet.new )
  server = factory.create
  server.start
  server.join

== Requirements

* See the
  {Jetty Versions}[http://www.eclipse.org/jetty/documentation/current/what-jetty-version.html]
  table for details on minimum Java version requirements. Note however
  that as of 9.3.0.RC1, and despite the current state of this document,
  Java SE 8 is required.
* To load webapps with JSPs, the
  rjack-jetty-jsp[http://rjack.gravitext.com/jetty-jsp/] gem
  must be loaded.
* Jetty will log to SLF4J[http://rjack.gravitext.com/slf4j] if
  loaded. The jetty-service script will attempt to load
  rjack-logback[http://rjack.gravitext.com/logback], and thus
  rjack-slf4j, if available.

== License

=== rjack-jetty gem

Copyright (c) 2008-2017 David Kellum

Licensed under the Apache License, Version 2.0 (the "License"); you
may not use this file except in compliance with the License.  You
may obtain a copy of the License at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.  See the License for the specific language governing
permissions and limitations under the License.

=== Jetty Web Container (Java)

Copyright (c) 1995-2012 Mort Bay Consulting Pty Ltd

The Jetty Web Container is Copyright Mort Bay Consulting Pty Ltd
unless otherwise noted. It is dual licensed under the apache 2.0
license and eclipse 1.0 license. Jetty may be distributed under
either license.

The javax.servlet package used was sourced from the Apache
Software Foundation and is distributed under the apache 2.0
license.

The UnixCrypt.java code implements the one way cryptography used by
Unix systems for simple password protection.  Copyright 1996 Aki Yoshida,
modified April 2001  by Iris Van den Broeke, Daniel Deville.
Permission to use, copy, modify and distribute UnixCrypt
for non-commercial or commercial purposes and without fee is
granted provided that the copyright notice appears in all copies.