[chore] Tidy and document examples

Author: chadlwilson

README.md

@@ -127,7 +127,7 @@ can embed it directly in the `web.xml` as follows (using Sinatra as an example):
 </context-param>
 ```
 
-Be sure to escape angle-brackets for XML !
+Be sure to escape angle-brackets for XML!
 
 
 ## Servlet Filter
@@ -306,6 +306,9 @@ logging system, configure `jruby.rack.logging` as follows:
 For those loggers that require a specific named logger, set it with the
 `jruby.rack.logging.name` option, by default "jruby.rack" name will be used.
 
+## Examples
+
+Some example demo applications are available at [./examples](./examples).
 
 ## Building
 

examples/Kirkfile

@@ -0,0 +1,42 @@
+## JRuby-Rack Examples
+
+This directory includes samples using JRuby-Rack to build Rack web applications for deployment
+into Java app servers.
+
+- All use [Warbler](https://github.com/jruby/warbler) to do so for easy of packaging.
+- Require JRuby `9.4` and a compatible JVM (Java `8` -> `25`).
+
+### Building/running
+
+For deployment into a separate webserver:
+
+1. ```bash
+    bundle
+    bundle exec warble war
+    ```
+2. Drop the war into a relevant Java app server running a compatible JVM version
+
+As an executable jar within Jetty:
+
+1. ```bash
+    bundle
+    bundle exec warble executable war
+    ```
+2. ```shell
+    java -jar *.war
+    ```
+
+## Demo routes
+
+| Example | Component                     | Embedded Route                    | Deployed War Route                       |
+|---------|-------------------------------|-----------------------------------|------------------------------------------|
+| Rails 7 | Status Page                   | http://localhost:8080/up          | http://localhost:8080/rails7/up          |
+| Rails 7 | Snoop Dump                    | http://localhost:8080/snoop       | http://localhost:8080/rails7/snoop       |
+| Rails 7 | Embedded JSP (non-functional) | http://localhost:8080/jsp/        | http://localhost:8080/rails7/jsp/        |
+| Rails 7 | Simple Form submission        | http://localhost:8080/simple_form | http://localhost:8080/rails7/simple_form |
+| Rails 7 | Body Posts                    | http://localhost:8080/body        | http://localhost:8080/rails7/body        |
+| Sinatra | Demo Index                    | http://localhost:8080/            | http://localhost:8080/sinatra            |
+| Sinatra | Info                          | http://localhost:8080/info        | http://localhost:8080/sinatra/info       |
+| Sinatra | Snoop Dump                    | http://localhost:8080/env         | http://localhost:8080/sinatra/env        |
+| Camping | Demo Index                    | http://localhost:8080/            | http://localhost:8080/camping            |
+| Camping | Snoop Dump                    | http://localhost:8080/snoop       | http://localhost:8080/camping/snoop      |

examples/README.md

@@ -7,7 +7,5 @@ gem 'rackup'
 gem 'camping', '< 3'
 gem 'markaby'
 
-group :development do
-  gem 'warbler', '~> 2.1'
-  gem 'jruby-jars', '< 10'
-end
+gem 'warbler', '~> 2.1'
+gem 'jruby-jars', '< 10'

examples/camping/Gemfile

@@ -6,7 +6,5 @@ gem 'rails', '~> 7.2.2', '>= 7.2.2.2'
 gem 'rack', '~> 2.2.20'
 gem "sprockets-rails"
 
-group :development do
-  gem 'warbler', '~> 2.1'
-  gem 'jruby-jars', '< 10'
-end
+gem 'warbler', '~> 2.1'
+gem 'jruby-jars', '< 10'

examples/rails7/Gemfile

@@ -222,7 +222,7 @@ GEM
     zeitwerk (2.6.18)
 
 PLATFORMS
-  universal-java-21
+  java
   x86_64-linux
 
 DEPENDENCIES

examples/rails7/Gemfile.lock

@@ -47,9 +47,9 @@
   # config.ssl_options = { redirect: { exclude: ->(request) { request.path == "/up" } } }
 
   # Log to STDOUT by default
-  # config.logger = ActiveSupport::Logger.new(STDOUT)
-  #  .tap  { |logger| logger.formatter = ::Logger::Formatter.new }
-  #  .then { |logger| ActiveSupport::TaggedLogging.new(logger) }
+  config.logger = ActiveSupport::Logger.new(STDOUT)
+   .tap  { |logger| logger.formatter = ::Logger::Formatter.new }
+   .then { |logger| ActiveSupport::TaggedLogging.new(logger) }
 
   # Prepend all log lines with the following tags.
   config.log_tags = [ :request_id ]

examples/rails7/config/environments/production.rb

@@ -6,7 +6,5 @@ gem 'sinatra'
 gem 'webrick'
 gem 'rack', '~> 2.2.20'
 
-group :development do
-  gem 'warbler', '~> 2.1'
-  gem 'jruby-jars', '< 10'
-end
+gem 'warbler', '~> 2.1'
+gem 'jruby-jars', '< 10'