Rack Servlet (Parent)

A JRuby servlet for Rack applications.

License	Apache 2.0
Categories	Square Business Logic Libraries Financial
GroupId	com.squareup.rack
ArtifactId	rack-servlet-parent
Last Version	1.8
Release Date	Mar 9, 2017
Type	pom
Description	Rack Servlet (Parent) A JRuby servlet for Rack applications.
Project URL	https://github.com/square/rack-servlet
Project Organization	Square, Inc.
Source Code Management	http://github.com/square/rack-servlet

Download rack-servlet-parent

Filename	Size
rack-servlet-parent-1.8.pom	6 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.squareup.rack/rack-servlet-parent/ -->
<dependency>
    <groupId>com.squareup.rack</groupId>
    <artifactId>rack-servlet-parent</artifactId>
    <version>1.8</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.squareup.rack/rack-servlet-parent/
implementation 'com.squareup.rack:rack-servlet-parent:1.8'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.squareup.rack/rack-servlet-parent/
implementation ("com.squareup.rack:rack-servlet-parent:1.8")

Apache Buildr

'com.squareup.rack:rack-servlet-parent:pom:1.8'

Apache Ivy

<dependency org="com.squareup.rack" name="rack-servlet-parent" rev="1.8">
  <artifact name="rack-servlet-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.squareup.rack', module='rack-servlet-parent', version='1.8')
)

Scala SBT

libraryDependencies += "com.squareup.rack" % "rack-servlet-parent" % "1.8"

Leiningen

[com.squareup.rack/rack-servlet-parent "1.8"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• core
• examples/dropwizard
• examples/guice-servlet
• examples/jetty
• integration

Rack Servlet

Embed JRuby Rack applications in your Java container.

Download

In a Maven project, add rack-servlet and jruby-complete to your pom.xml:

<dependencies>
  <dependency>
    <groupId>com.squareup.rack</groupId>
    <artifactId>rack-servlet</artifactId>
    <version>${rack.servlet.version}</version>
  </dependency>
  <dependency>
    <groupId>org.jruby</groupId>
    <artifactId>jruby-complete</artifactId>
    <version>${jruby.version}</version>
  </dependency>
</dependencies>

Quick Start

// Use JRuby to build your Rack application:
ScriptingContainer ruby = new ScriptingContainer();
IRubyObject application = ruby.parse("lambda { |env| [200, {}, ['Hello, World!']] }").run();

// Build a RackServlet with that Rack application:
Servlet servlet = new RackServlet(new JRubyRackApplication(application));

// Install that servlet in your container...
// (See our examples directory for concrete code.)

In Depth

• Gems: You can use the gem-maven-plugin to put gems in your pom.xml on your test classpath. For production deployments, you'll need to be a little more clever.
• Frameworks: We're successfully running Sinatra applications on Rack Servlet. We've not yet tried Rails. At any rate, you'll need to make separate arrangements for any database connections you may need.
• Logging: rack.logger and rack.errors use slf4j, so that you can choose your logging backend. Log messages are written to com.squareup.rack.RackLogger and com.squareup.rack.RackErrors, respectively.

Support

• Examples: Our examples directory has some good concrete code to get you started.
• Stack Overflow: Use the rack-servlet tag to ask any questions. We'll keep an eye on it.
• GitHub Issues: If you've found a bug, please file an issue.

Alternatives

Rack Servlet grew out of our desire to embed Rack applications in Square's Java service container, in order to take advantage of our sophisticated infrastructure.

There are other options in the "run Rack applications on the JVM" space, all of which are shaped somewhat differently:

• Kirk is a Rack server, like Mongrel or Unicorn.
• Warbler bundles your Rack application into a WAR file.
• jruby-rack is close in intent to Rack Servlet. It offers amazing support for instantiating and pooling your Rack application objects, though its custom embedding story is less clear.

Square

Versions

Version
1.8 Mar 9, 2017
1.7 Aug 12, 2016
1.6 Oct 2, 2015
1.5 May 9, 2014
1.4 Nov 8, 2013
1.3 Oct 5, 2013
1.2 Sep 3, 2013
1.1 Aug 28, 2013
1.0 Jul 11, 2013