The document discusses TorqueBox, an application server for Ruby that is built on JBoss Application Server 7 and uses JRuby. It allows Ruby applications to take advantage of features typically found in Java application servers like clustering, caching, messaging, and more. Key features highlighted include support for Ruby web frameworks like Rails and Sinatra, background processing using Resque or DelayedJob, messaging using JMS, long running services, and resource injection. Web sockets support is provided using STOMP and the Stilts framework. The document outlines goals of TorqueBox and provides examples of configuration and usage.

1. A True Application Server for Ruby
Lance Ball
Ruby Hoedown
Creative Commons BY-SA 3.0
August 2011

2. Lance Ball
• TorqueBox Core Developer
• Red Hat Senior Engineer
• Perl -> C++ -> Java -> Ruby
• @lanceball

3. project:odd

4. What is TorqueBox?
Ruby Application Server
Built on JBoss & JRuby
The Power of JBoss with the
Expressiveness of Ruby

5. JBoss AS7
TorqueBox is tightly
integrated with JBoss.
Extends JBoss AS7 to
enable a JRuby runtime.

6. JRuby
•Very fast runtime
•Real threads
•Java libraries
•Java tools
•Healthy community

7. Ruby App
Sinatra Rails
Rack
Passenger/Thin
Apache/Nginx

8. Ruby App
Sinatra Rails
Rack
Tasks Passenger/Thin
Resque/
DelayedJob Apache/Nginx

9. Ruby App
Sinatra Rails
Rack
Tasks Passenger/Thin Jobs
Resque/
DelayedJob Apache/Nginx crond

10. Ruby App
Sinatra Rails
Rack
Tasks Passenger/Thin Jobs
Resque/
DelayedJob Apache/Nginx crond
Daemons
god/monit

12. Goals

13. Goals
No XML, No Java
(unless you're into that sort of thing)

14. Goals
•Support Ruby web frameworks
•Rails
•Sinatra
•Rack

15. Goals
The Obvious & Necessary
• Rails
• Sinatra
• Rack
But do more!
• Messaging
• Jobs
• Services
• Plus Even More!

16. TorqueBox AS
Sinatra Rails
Rack Tasks Procs Jobs Daemons
Web Messaging Scheduling Services
JBoss AS
Clustering Load Balancing HA

18. Web
Ruby web apps in JBoss
Rack, Rails, Sinatra

19. Web
config/torquebox.yml
application:
root: /path/to/myapp
env: production
web:
context: /
host: www.myapp.com
environment:
MAIL_HOST: mail.myapp.com

20. Live Editing
Live updates for Rails apps
models, views, controllers...

22. What Else?

23. Clustering
Ruby apps participate in AS
clustering with mod_cluster

24. Clustering: mod_cluster
A reverse proxy implemented as
an Apache module with JBoss
awareness.
Constantly gathers load statistics
and deployment availability for
intelligent request distribution.

25. Caching
Infinispan
A distributed, replicated
object store.

26. Transparent Infinispan
Used for all implicit
caching in Rails.
Replaces in-memory or
memcached caches.

27. Caching
config/application.rb
module YourApp
class Application < Rails::Application
config.cache_store = :torque_box_store
end
end

28. Caching
my_app.rb
require 'sinatra'
require 'torquebox'
class MyApp < Sinatra::Base
use TorqueBox::Session::ServletStore
get '/' do
session[:message] = 'Hello World!'
haml :index
end
end

29. Opaque Infinispan
some_file.rb
include ActiveSupport::Cache
myCache = TorqueBoxStore.new(:name => 'MyCache',
:mode => :replicated)

31. Jobs
app/jobs/newsletter_sender.rb
class NewsletterSender
def run()
subscriptions = Subscription.find(:all)
subscriptions.each do |e|
send_newsletter(e)
end
end
end

32. Jobs
config/torquebox.yml
jobs:
monthly_newsletter:
description: first of month
job: NewsletterSender
cron: ‘0 0 0 1 * ?’
process_tps_reports:
job: TPSReportProcessor
cron: ‘0 0 0 0 MON ?’
singleton: true

34. Regular Class
class User
def send_welcome_email
# do something that takes a while
end
end

35. Blocking invocations
user = User.new
user.send_welcome_email

36. Backgroundable
class User
include TorqueBox::Messaging::Backgroundable
def send_welcome_email
# do something that takes a while
end
end

37. Explicitly Non-blocking
user = User.new
user.background.send_welcome_email

38. Choices
class User
include TorqueBox::Messaging::Backgroundable
always_background :send_welcome_email
def send_welcome_email
# do something that takes a while
end
end

39. Implicitly Non-blocking
user = User.new
user.send_welcome_email

40. See The Future
user = User.new
future = user.send_welcome_email

41. See The Future
future.started?
future.complete?
future.error?
future.result

42. See The Future
class User
def send_welcome_email
while( !@finished )
...
count += 1
future.status = count
...
end
end
end

43. See The Future
# on the 'client' side
future.status_changed?
future.status # => 42

45. Messaging
•JMS behind the scenes
•implementation
HornetQ is the JBoss JMS

46. Destinations
config/torquebox.yml
queues:
/queues/questions:
/queues/answers:
durable: false

47. Queues
contrived example
questions = Queue.new('/queues/questions')
answers = Queue.new('/queues/answers')
Thread.new do
questions.publish( "What time is it?" )
puts answers.receive( :timeout => 1000 )
end
puts questions.receive
answers.publish( Time.now )

48. Queues
contrived example
questions = Queue.new('/queues/questions')
answers = Queue.new('/queues/answers')
Thread.new do
questions.publish( "What time is it?" )
puts answers.receive( :timeout => 1000 )
end
puts questions.receive
answers.publish( Time.now )

49. Queues
contrived example
questions = Queue.new('/queues/questions')
answers = Queue.new('/queues/answers')
Thread.new do
questions.publish( "What time is it?" )
puts answers.receive( :timeout => 1000 )
end
puts questions.receive
answers.publish( Time.now )

50. Queues
contrived example
questions = Queue.new('/queues/questions')
answers = Queue.new('/queues/answers')
Thread.new do
questions.publish( "What time is it?" )
puts answers.receive( :timeout => 1000 )
end
puts questions.receive
answers.publish( Time.now )

51. Queues
“on the fly”
include TorqueBox::Messaging
queue = Queue.new('/queues/foo')
queue.create
# ...
queue.destroy

52. Processors
config/torquebox.yml
messaging:
/queues/receipts:
PrintHandler:
concurrency: 5
config:
printer: the_little_one

53. Processors
app/models/print_handler.rb
include TorqueBox::Messaging
class PrintHandler < MessageProcessor
def initialize(opts)
@printer = opts['printer'] || default
end
def on_message(body)
puts "Processing #{body} of #{message}"
end
end

54. Topics
•interface is different, but
behavior
is the same.
•each message, of a only one
all subscribers
but
topic see
subscriber will see any message
from a queue
• use TorqueBox::Messaging::Topic

56. Services
Long-running, non-web
“daemons” that share
the runtime environment
and deployment lifecycle
of your app.

57. Services
•methods, which shouldstop()
A class with start() and
each
return quickly. Optionally
provide initialize(Hash).
•running loop startthread and
Typically will
in a
a long-
respond to external events.

58. Services
config/torquebox.yml
services:
TimeMachine:
queue: /queue/morris_day
IrcBot:
server: freenode.net
channel: #torquebox
publish: /topics/irc
singleton: true

59. Services
app/services/time_machine.rb
class TimeMachine
def initialize(opts)
@queue = Queue.new(opts['queue'])
end
def start
Thread.new { run }
end
def stop
@done = true
end
def run
# ...
end
end

60. Services
app/services/time_machine.rb
class TimeMachine
def initialize(opts)
@queue = Queue.new(opts['queue'])
end
def start
Thread.new { run }
end
def stop
@done = true
end
def run
# ...
end
end

61. Services
app/services/time_machine.rb
class TimeMachine
def initialize(opts)
@queue = Queue.new(opts['queue'])
end
def start
Thread.new { run }
end
def stop
@done = true
end
def run
# ...
end
end

62. Services
app/services/time_machine.rb
class TimeMachine
def initialize(opts)
@queue = Queue.new(opts['queue'])
end
def start
Thread.new { run }
end
def stop
@done = true
end
def run
# ...
end
end

63. Services
app/services/time_machine.rb
class TimeMachine
def initialize(opts)
@queue = Queue.new(opts['queue'])
end
def start
Thread.new { run }
end
def stop
@done = true
end
def run
until @done
@queue.publish(Time.now)
sleep(1)
end
end
end

65. Resource Injection
Letting the container
figure out how to help
you wire up complex
component models.

66. aka
Inversion of Control

67. CDI Resources
class MyService
include TorqueBox::Injectors
def initialize opts={}
@thing = inject(com.mycorp.Something)
end
end

68. But you can inject lots
of things - not just CDI
objects.

69. Destination Injection
class MyService
include TorqueBox::Injectors
def initialize( opts={} )
@inbound = inject("/queues/questions")
@outbound = inject("/queues/answers")
end
end

70. JNDI Injection
class MyService
include TorqueBox::Injectors
def initialize opts={}
@factory = inject("java:comp/env/jdbc/myDS")
end
end

71. JBossMC Injection
class MyService
include TorqueBox::Injectors
def initialize opts={}
@pinto = inject("SomeMCBean")
end
end

72. Why MC Beans?
All internal plumbing of
JBoss AS is stitched
together using MC beans.
Grab the WebServer, the
CacheManager, whatevs.

74. Web Sockets
•Uses STOMP (protocol)
•And Stilts(framework)
•Provides Stomplet “Controllers”
•Simple JMS Bridging

75. Stomplet API
configure( config )
on_subscribe( subscriber )
on_unsubscribe( subscriber )
on_message( message, session )

76. Web Sockets
app/stomplets/broadcast_stomplet.rb
require 'torquebox-stomp'
class BroadcastStomplet
def on_subscribe(subscriber)
@subscribers << subscriber
end
def on_unsubscribe(subscriber)
@subscribers.delete( subscriber )
end
def on_message(stomp_message, session)
@subscribers.each do |subscriber|
subscriber.send( stomp_message )
end
end
end

77. Web Sockets
app/stomplets/broadcast_stomplet.rb
require 'torquebox-stomp'
class BroadcastStomplet
def on_subscribe(subscriber)
@subscribers << subscriber
end
def on_unsubscribe(subscriber)
@subscribers.delete( subscriber )
end
def on_message(stomp_message, session)
@subscribers.each do |subscriber|
subscriber.send( stomp_message )
end
end
end

78. Web Sockets
app/stomplets/broadcast_stomplet.rb
require 'torquebox-stomp'
class BroadcastStomplet
def on_subscribe(subscriber)
@subscribers << subscriber
end
def on_unsubscribe(subscriber)
@subscribers.delete( subscriber )
end
def on_message(stomp_message, session)
@subscribers.each do |subscriber|
subscriber.send( stomp_message )
end
end
end

79. Web Sockets
app/stomplets/broadcast_stomplet.rb
require 'torquebox-stomp'
class BroadcastStomplet
def on_subscribe(subscriber)
@subscribers << subscriber
end
def on_unsubscribe(subscriber)
@subscribers.delete( subscriber )
end
def on_message(stomp_message, session)
@subscribers.each do |subscriber|
subscriber.send( stomp_message )
end
end
end

80. JmsStomplet API
subscribe_to( subscriber, destination )
send_to( destination, message, headers )

81. JMS Stomplet
app/stomplets/irc_stomplet.rb
class IrcStomplet < TorqueBox::Stomp::JmsStomplet
include TorqueBox::Messaging
def configure(config)
@destination = Queue.new( config['destination'] )
end
def on_subscribe(subscriber)
# subscribe the client to a JMS message queue
subscribe_to( subscriber, @destination )
# send a message to the queue
send_to( @destination, "TorqueBoxBot in da house",
:sender => :system, :timestamp => Time.now.ctime )
end
end

82. IRC Bot Service
app/services/irc_bot_service.rb
class IrcBotService
include TorqueBox::Messaging
def start
@bot = configure_bot
@bot_thread = Thread.new { @bot.connect }
end
def configure_bot
# ...
# Log all channel messages to the queue
bot.on :channel do |event_data|
@destination.publish( event_data[:message],
:properties =>
{:sender=>event_data[:nick], :timestamp=>Time.now.ctime} )
end
bot
end
end

83. Web Sockets
config/torquebox.yml
stomp:
stomplets:
broadcast.stomplet:
route: '/sockets/broadcast'
class: BroadcastStomplet
jms.stomplet:
route: '/sockets/irc'
class: IrcStomplet
config:
destination: /queues/irc

84. Web Sockets
javascripts/application.js
$( function() {
client = Stomp.client( "ws://localhost:8675/" )
client.connect( null, null, function() {
$(window).unload(function() { client.disconnect() });
client.subscribe( '/sockets/bridge', function( message ) {
$("#messages").append("<li>" + message.body + "</li>")
})
})
})

86. BENchmarks
Real-world Rail application:
Redmine
Comparisons:
TorqueBox, Trinidad, Glassfish,
Passenger, Unicorn, Thin
Runtimes:
JRuby, MRI, RubyEE

90. BackStage
Dashboard to inspect
and control Ruby
components.
And a RESTful API.

92. StompBox
Easy Heroku-esque
git-based deployments.

94. dm-infinispan-adapter
•DataMapper on Infinispan
•Replicated NoSQL store

95. Installation & Deployment
$ gem install torquebox-server --pre
--source http://torquebox.org/2x/builds/LATEST/gem-repo/
$ torquebox
Tasks:
torquebox deploy ROOT # Deploy an application to TorqueBox
torquebox undeploy ROOT # Undeploy an application from TorqueBox
torquebox run # Run TorqueBox
torquebox cli # Run the JBoss AS7 CLI
torquebox help [TASK] # Describe available tasks or one specific task

96. Oh yeah...
It works on Windows.

97. Roadmap
1.1.1 Stable
2.0 In Development
??? - you tell us

99. Resources
• http://torquebox.org/
• http://github.com/
torquebox
• #torquebox on FreeNode
• @torquebox

100. Thanks!
Questions?
Image attributions:
Soccer Youth Goal Keeper by Torsten Bolten http://en.wikipedia.org/wiki/File:Soccer_Youth_Goal_Keeper.jpg
Series of tubes by ritingon http://www.flickr.com/photos/ritingonthewall/2579076693/
Yawning is danger! by dj badly http://www.flickr.com/photos/djbadly/2052098189/
EuroFoo Schedule by silent-penguin http://www.flickr.com/photos/silent-penguin/232394/
Sink. by _Fidelio_ http://www.flickr.com/photos/photogaby/4129740673/ CC BY 2.0
Telegraph Practice Set from Popular Science, Feb 1947 http://books.google.com/books?id=uyUDAAAAMBAJ&lpg=PA65&pg=PT83#v=onepage&q&f=false
Service as a Strategy Celebration at NCVS 2011 by Be The Change, Inc http://www.flickr.com/photos/bethechangeinc/5816393052/ CC BY-NC 2.0
Cash by ROSS HONG KONG http://www.flickr.com/photos/rossap/2716531616/ CC BY-NC-SA 2.0
Injection by Dr Case http://www.flickr.com/photos/justin_case/3252846177/ CC BY-NC 2.0
IMG_1478 by akshaydavis http://www.flickr.com/photos/akshaydavis/166391476/ CC BY-NC-SA 2.0
Rainforest by Chris.Gray http://www.flickr.com/photos/chriscgray/3946304802/ CC BY-NC-SA 2.0
Community by niallkennedy http://www.flickr.com/photos/niallkennedy/40727794/ CC BY-NC 2.0