Red Hat JBoss Web Framework Kit 2.1 TorqueBox Quickstart Guide
Contents
1. Node js is an official trademark of Joyent Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node js open source or commercial project The OpenStack Word Mark and OpenStack Logo are either registered trademarks service marks or trademarks service marks of the OpenStack Foundation in the United States and other countries and are used with the OpenStack Foundation s permission We are not affiliated with endorsed or sponsored by the OpenStack Foundation or the OpenStack community All other trademarks are the property of their respective owners Abstract TorqueBox provides an enterprise grade environment that not only provides complete Ruby on Rails and Rack compatibility but also goes beyond the functionality offered in traditional Rails Rack environments Table of Contents P Efa CO lt tc re tet ia ek A paths t RPE a cal tk Saat AA Se eh Ae aed 1 Document Conventions 1 1 Typographic Conventions 1 2 Pull quote Conventions 1 3 Notes and Warnings 2 Getting Help and Giving Feedback 2 1 Do You Need Help 2 2 Give us Feedback Chapter 1 First Steps cneccasgeed eo oad optet ages Pees eign dents 1 1 First Steps on Mac Linux 1 1 1 Your First Rails Application 1 1 2 Subsequent Applications 1 2 First Steps on Windows 1 2 1 Your First Rails Application 1 2 2 Subsequent Applications 1 3 First Steps with RVM 1 3 1 Your First Rails Application 1 3 2 Subsequent A2. Users someone torquebox_examples rack_example rvmrc y Les n o v iew c ancel gt y rvm gemset list gemsets for jruby version jruby found in Users someone rvm gems jruby version jruby global gt tb_rack_example tb_rails_example gem install rack Fetching rack 1 4 1 gem 100 Successfully installed rack 1 4 1 1 gem installed Now create a config ru for our example rack application Example 1 4 torquebox_examples rack_example config ru app lambda env 200 Content Type gt text html Hello from Rack n run app Deploy the Rack application at a context path of rack since we already have the Rails application deployed at the root context torquebox deploy context path rack Deployed rack_example knob ym1l into Users someone rvm gems jruby version jruby global gems torquebox server project version java jboss standalone deployments Now that two applications are deployed to T orqueBox each with separate RVM gemsets we hit an issue that trips up most users of RVM and TorqueBox TorqueBox runs as a single process but RVM is really iy F gi Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide designed to have a separate process per project for gemsets to work out of the box We can work around this by emulating the environment variables RVM sets when reading our rvmrc ina torquebox rb file for each application Example 1 5 torquebox_ex
3. LY redhat Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide for use with JBoss Enterprise Application Platform Edition 2 1 0 Red Hat Content Services Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide for use with JBoss Enterprise Application Platform Edition 2 1 0 Red Hat Content Services Legal Notice Copyright 2012 Red Hat This document is licensed by Red Hat under the Creative Commons Attribution ShareAlike 3 0 Unported License If you distribute this document or a modified version of it you must provide attribution to Red Hat Inc and provide a link to the original If the document is modified all Red Hat trademarks must be removed Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section 4d of CC BY SA to the fullest extent permitted by applicable law Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logo and RHCE are trademarks of Red Hat Inc registered in the United States and other countries Linux is the registered trademark of Linus Torvalds in the United States and other countries Java is a registered trademark of Oracle and or its affiliates XFS is a trademark of Silicon Graphics International Corp or its subsidiaries in the United States and or other countries MySQL is a registered trademark of MySQL AB in the United States the European Union and other countries
4. JBAS018559 Deployed rails _example knob yml 19 25 38 050 INFO org jboss as server DeploymentScanner threads 1 JBAS018559 Deployed rack_example knob ym1 applications are deployed and working Congratulations You now know all the basics to proceed with the rest of this getting started guide when using a Mac or Linux 1 2 First Steps on Windows 1 2 1 Your First Rails Application Ensure you have Java 6 or above installed then download T orqueBox using your web browser from When prompted for a folder to extract the files to choose your user s home directory ie c Users someone After TorqueBox is extracted we need to set a few environment variables Find the Advanced System Settings dialog in Windows 7 this is Control Panel gt System and Security gt System gt Advanced System Settings and click the Environment Variables button We want to add three new user environment variables Add TORQUEBOX_HOME with a value of HOME tor quebox project version Add JBOSS_HOME with a value of 4HOME tor quebox project version jboss Add JRUBY_HOME with a value of SHOME tor quebox project version jruby Also modify the Path environment variable by prepending JRUBY_HOME bin to the front of the current value Click the OK button to save and close the Environment Variables dialog Now let s open up a Command Prompt to install Rails and create a new Rails example application You can open a Command Prompt by click
5. Document URL Section Number and Name Describe the issue Suggestions for improvement Additional information Be sure to give us your name so that you can receive full credit for reporting the issue Chapter 1 First Steps Chapter 1 First Steps Choose the section below to follow based on your development environment Windows users should instructions and not the generic Mac Linux instructions 1 1 1 Your First Rails Application Ensure you have Java 6 or above installed then download and extract the TorqueBox binary distribution and set a few environment variables wget http torquebox org release org torquebox torquebox dist project version torquebox dist project version bin zip 2012 09 13 09 35 56 1 61 MB s torquebox dist project version bin zip saved 152039457 152039457 unzip torquebox dist project version bin zip d inflating torquebox 2 1 1 Rakefile export TORQUEBOX_HOME torquebox project version export JBOSS HOME TORQUEBOX_HOME jboss export JRUBY_HOME TORQUEBOX_HOME jruby export PATH JRUBY_HOME bin PATH PRAHA HH You ll likely want to place the exports somewhere that gets loaded automatically bashrc bash_profile or wherever your operating system suggests placing user specific environment variables Install Rails and create a new Rails example application mkdir p torquebox_examples rails_example cd torquebox_examples rails_example gem i
6. Search field and click Next The character you sought will be highlighted in the Character Table Double click this highlighted character to place it in the Text to copy field and then click the Copy button Now switch back to your document and choose Edit Paste from the gedit menu bar The above text includes application names system wide menu names and items application specific menu names and buttons and text found within a GUI interface all presented in proportional bold and all distinguishable by context Mono spaced Bold Italic or Proportional Bold Italic Whether mono spaced bold or proportional bold the addition of italics indicates replaceable or variable text Italics denotes text you do not input literally or displayed text that changes depending on circumstance For example To connect to a remote machine using ssh type ssh username domain name at a shell prompt If the remote machine is example com and your username on that machine is john type ssh john example com The mount o remount file system command remounts the named file system For example to remount the home file system the command is mount o remount home To see the version of a currently installed package use the rpm q package command It will return a result as follows package version release Note the words in bold italics above username domain name file system package version and release Each word is a placeholder either for text you e
7. for our example rack application Example 1 2 4HOME torquebox_examples rack_example config ru app lambda env 200 Content Type gt text html Hello from Rack n run app Deploy the Rack application at a context path of rack since we already have the Rails application deployed at the root context gt torquebox deploy context path rack Deployed rack_example knob ym1 into C Users someone torquebox project version jboss standalone deployments Now you should be able to run TorqueBox and see both applications deployed gt echo Y jruby S torquebox run 19 25 38 049 INFO org jboss as server DeploymentScanner threads 1 JBAS018559 Deployed rails _example knob ym1 19 25 38 050 INFO org jboss as server DeploymentScanner threads 1 JBAS018559 Deployed rack_example knob ym1 applications are deployed and working Congratulations You now know all the basics to proceed with the rest of this getting started guide when using Windows The filesystem paths and command prompts shown in future chapters won t be Windows specific so be sure to translate any paths to the appropriate format before executing the example commands 11 Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide 1 3 First Steps with RVM 1 3 1 Your First Rails Application Ensure you have a recent JRuby installed then install the torquebox server gem into the global gemset rvm install jruby versi
8. individual key by the plus sign that connects each part of a key combination For example Press Enter to execute the command Press Ctr1 Al1t F2 to switch to a virtual terminal The first example highlights a particular key to press The second example highlights a key combination a set of three keys pressed simultaneously If source code is discussed class names methods functions variable names and returned values mentioned within a paragraph will be presented as above in mono spaced bold For example File related classes include filesystem for file systems file for files and dir for directories Each class has its own associated set of permissions Proportional Bold This denotes words or phrases encountered on a system including application names dialog box text labeled buttons check box and radio button labels menu titles and submenu titles For example Choose System Preferences Mouse from the main menu bar to launch Mouse Preferences In the Buttons tab select the Left handed mouse check box and click Close to switch the primary mouse button from the left to the right making the mouse suitable for use in the left hand To insert a special character into a gedit file choose Applications Accessories Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Character Map from the main menu bar Next choose Search Find from the Character Map menu bar type the name of the character in the
9. monitor a resource for changes and take some action or many other things As an example we ll create a service that pretends to connect to a social network and submit post ideas to a queue for later processing Example 2 5 torquebox_examples rails_ example app services post_idea_grabb er rb class PostIdeaGrabber def initialize options queue TorqueBox Messaging Queue new options queue_name end def start puts Starting PostIdeaGrabber Thread new do until done queue publish Random idea rand 100 sleep 2 end end end def stop done true end end Just like with our scheduled job we need to tell TorqueBox about this new service and the message queue it uses 19 Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Example 2 6 torquebox_examples rails_ example app config torquebox ym1l This is the TorqueBox configuration file Refer to the TorqueBox documentation at http torquebox org documentation current for all configuration options web context jobs post_counter job PostCounter cron 7 10 Mu services post_idea_grabber service PostIdeaGrabber config queue_name queue post_ideas queues queue post_ideas durable false Restart TorqueBox and you should see the service starting in the logs 10 43 56 316 INFO org torquebox core runtime MSC service thread 1 7 Created ruby runtime ruby_version RUBY1_8 compile_mo
10. 11 19 746 INFO stdout http localhost 127 0 0 1 8080 1 Publishing Chunky Bacon Fever to our favorite social network 09 11 24 747 INFO stdout http localhost 127 0 0 1 8080 1 Post published As you can see it took 5 seconds to publish the post and during that five seconds the browser was waiting on a response from the server There s no reason the browser needs to wait until the post is published so let s see how easy it is to convert the publish_to_social_ network method to run in the background 17 Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Example 2 2 torquebox_examples rails_ example app models post rb class Post lt ActiveRecord Base attr_accessible body title after_create publish_to_social_network always_background publish_to_social_network def publish_to_social_network puts Publishing title to our favorite social network sleep 5 puts Post published end end Create a new post and you ll see that the browser returns immediately and in the TorqueBox console the messaging runtime will spin up Since TorqueBox Backgroundable uses messaging and the first message we send starts the messaging runtime pool and publish the post to our favorite social network in the background 2 3 Scheduled Jobs TorqueBox also has built in support for scheduled jobs like Cron or Windows Scheduler but in a cross platform way To see how scheduled jobs work let s create a job that logs the num
11. amples rack_example torquebox rb TorqueBox configure do environment do GEM_HOME ENV rvm_path gems jruby version jruby tb_rack_example GEM_PATH ENV rvm_path gems jruby version jruby tb_rack_example ENV rvm_path gems jruby version jruby global end end Example 1 6 torquebox_examples rails_ example config torquebox rb TorqueBox configure do environment do GEM_HOME ENV rvm_path gems jruby version jruby tb_rails_ example GEM_PATH ENV rvm_path gems jruby version jruby tb_rails_example ENV rvm_path gems jruby version jruby global end end Now you should be able to run TorqueBox and see both applications deployed torquebox run 19 25 38 049 INFO org jboss as server DeploymentScanner threads 1 JBAS018559 Deployed rails_example knob ym1 19 25 38 050 INFO org jboss as server DeploymentScanner threads 1 JBAS018559 Deployed rack_example knob ym1 applications are deployed and working Congratulations You now know all the basics to proceed with the rest of this getting started guide when using RVM The most important thing to remember is to add the torquebox rb that sets the GEM_HOME and GEM_PATH environment variables for each application that uses a project specific gemset 16 Chapter 2 Adding TorqueBox Features Chapter 2 Adding TorqueBox Features to take advantage of T orqueBox features 2 1 TorqueBox Rails Template TorqueBox shi
12. ber of posts in our database every 10 seconds To do this create a PostCounter class in the app jobs directory created for us by the TorqueBox Rails template earlier Example 2 3 torquebox_examples rails_example app jobs post_counter rb class PostCounter def run puts Post count posts in the database end end We also have to tell TorqueBox about this new job and when to run it To do that edit the config torquebox ym1 created for us by the TorqueBox Rails template to have the contents below Example 2 4 torquebox_examples rails_ example app config torquebox yml This is the TorqueBox configuration file Refer to the TorqueBox documentation at http torquebox org documentation current for all configuration options web context jobs post_counter job PostCounter cron 710 eu 18 Chapter 2 Adding TorqueBox Features Since we had to make a change to config torquebox ym1 we need to restart TorqueBox for the job to start running After restarting TorqueBox you should see output like below every 10 seconds 09 45 30 029 INFO stdout JobScheduler rails_example knob yml_Worker 2 2 posts in the database 2 4 Long Running Services TorqueBox supports the notion of long running services that get started when the application is deployed and stopped when the application is undeployed This could be useful to connect a client toa streaming API service like that provided by some social networks
13. by S torquebox run 15 59 28 053 INFO org jboss as server DeploymentScanner threads 2 JBASO 15555 Dezloyec ails_s lt ample knob ym1 When stopping T orqueBox via CT RL C the Windows Command Prompt will ask you if you want to Terminate batch job Y N Piping echo Y into the command just prevents you from having to answer this prompt We prefix the command with jruby S because if we just used echo Y torquebox run there s currently a bug where T orqueBox would get stuck in an infinite restart loop upon stopping 10 Chapter 1 First Steps Now edit HOME torquebox_examples rails_example app views posts index html erb then refresh the posts page in your browser and see your changes Changes to your Rails application show up immediately in the browser as expected When you re done press CTRL C in the terminal to stop TorqueBox before continuing with the next steps 1 2 2 Subsequent Applications Deploying multiple applications to TorqueBox is straightforward but let s walk through the required steps We ll create a Rack application to go with our Rails example application created earlier If TorqueBox is still running stop it with CTRL C in its terminal window before following the steps below gt mkdir HOME torquebox_examples rack_example gt cd HOME torquebox_examples rack_example gt gem install rack Fetching rack 1 4 1 gem 100 Successfully installed rack 1 4 1 1 gem installed Now create a config ru
14. de JIT app rails_example context services in 17 73s 10 43 56 325 INFO stdout MSC service thread 1 5 Starting PostIdeaGrabber 2 5 Message Processors We have a long running service placing messages on a queue but now we need something to consume those messages and do something with them T orqueBox has a feature designed specifically for this purpose message processors We ll create a message processor to randomly choose some of the ideas and create new posts from them Example 2 7 torquebox_examples rails_ example app processors post_idea_pro cessor rb class PostIdeaProcessor lt TorqueBox Messaging MessageProcessor def on message message if rand 10 gt 8 puts Creating new post from idea message Post create title gt message body gt Random post created from an idea end end end As usual we need to edit config torquebox yml so TorqueBox knows how to wire up this new message processor 20 Chapter 2 Adding TorqueBox Features Example 2 8 torquebox_examples rails_ example app config torquebox yml This is the TorqueBox configuration file Refer to the TorqueBox documentation at http torquebox org documentation current for all configuration options web context jobs post_counter job PostCounter cron 710 DU services post_idea_grabber service PostIdeaGrabber config queue_name queue post_ideas queues queue post_ideas du
15. he posts page in your browser and see your changes Changes to your Rails application show up immediately in the browser as expected When you re done press CTRL C in the terminal to stop TorqueBox before continuing with the next steps 1 1 2 Subsequent Applications Deploying multiple applications to TorqueBox is straightforward but let s walk through the required steps We ll create a Rack application to go with our Rails example application created earlier If TorqueBox is still running stop it with CTRL C in its terminal window before following the steps below mkdir p torquebox_examples rack_example cd torquebox_examples rack_example gem install rack Fetching rack 1 4 1 gem 100 Successfully installed rack 1 4 1 1 gem installed Now create a config ru for our example rack application Chapter 1 First Steps Example 1 1 torquebox_examples rack_example config ru app lambda env 200 Content Type gt text html Hello from Rack n J run app Deploy the Rack application at a context path of rack since we already have the Rails application deployed at the root context torquebox deploy context path rack Deployed rack_example knob yml into Users someone torquebox project version jboss standalone deployments Now you should be able to run TorqueBox and see both applications deployed torquebox run 19 25 38 049 INFO org jboss as server DeploymentScanner threads 1
16. ing the Windows button in the bottom left and typing cmd in the Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide search box gt mkdir HOME torquebox_examples rails_example gt cd HOME torquebox_examples rails_ example gt gem install rails Successfully installed rails 3 2 8 27 gems installed gt rails new Using rails 3 2 8 Installing sass 3 2 1 Installing sass rails 3 2 5 Installing therubyrhino_jar 1 7 4 Installing therubyrhino 2 0 1 Installing uglifier 1 3 0 Your bundle is complete Use bundle show gemname to see where a bundled gem is installed Bundler and jruby openssl Some versions of JRuby Bundler and jruby openssl don t play well together so if you get an error when Rails tries to run bundle install regarding jruby openssl edit the Gemfile to change the source line from https to http and manually run bundle install afterwards Add a simple scaffolded resource deploy it to TorqueBox and run T orqueBox gt rails g scaffold post title body text create app assets stylesheets posts css scss invoke scss create app assets stylesheets scaffolds css scss gt rake db migrate lt CreatePosts migrating zenenan create_table posts gt 0060s gt O0 rows CreatePosts migrated 0 0080s SS gt torquebox deploy Deployed rails_example knob ym1l into C Users someone tor quebox project version jboss standalone deployments gt echo Y jru
17. le is complete Use bundle show gemname to see where a bundled gem is installed rails g scaffold post title body text create app assets stylesheets posts css scss invoke scss create app assets stylesheets scaffolds css scss rake db migrate CreatePosts migrating SS SS a a a aaa create_table posts gt 0 0060s gt 0 rows CreatePosts migrated 0 0080s Sse torquebox deploy Deployed rails_example knob yml into Users someone rvm gems jruby version jruby global gems torquebox server project version java jboss standalone deployments torquebox run 15 59 28 053 INFO org jboss as server DeploymentScanner threads 2 JBAS018559 Deployed rails_example knob ym1 Now edit torquebox_examples rails_example app views posts index html erb then refresh the posts page in your browser and see your changes Changes to your Rails application show up immediately in the browser as expected When you re done press CTRL C in the terminal to stop TorqueBox before continuing with the next steps When you want to take advantage of TorqueBox specific features like we ll do in subsequent chapters you ll need the torquebox gem in your application s Gemfile However since we re using torquebox server under RVM to install TorqueBox you ll want to ensure this gem is in the Gemfile for every application as well If it s not you ll receive errors trying to use the torquebox because bundler will be unable to fi
18. n changes that only apply to the current session or services that need restarting before an update will apply Ignoring a box labeled Important will not cause data loss but may cause irritation and frustration Warnings should not be ignored Ignoring warnings will most likely cause data loss 2 Getting Help and Giving Feedback 2 1 Do You Need Help If you experience difficulty with a procedure described in this documentation visit the Red Hat Customer gt search or browse through a knowledgebase of technical support articles about Red Hat products submit a support case to Red Hat Global Support Services GSS access other product documentation Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and Click on the name of any mailing list to subscribe to that list or to access the list archives 2 2 Give us Feedback If you find a typographical error or know how this guide can be improved we would love to hear from you Submit a report in Bugzilla against the product JBoss Enterprise WFK Platform and the component doc TorqueBox_Quickstar t_Guide The following link will take you to a pre filled bug report for this product Bugzilla_URL Fill out the following template in Bugzilla s Description field Be as specific as possible when describing the issue this will help ensure that we can fix it quickly
19. nd the torquebox server gem 13 Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Example 1 3 torquebox_examples rails_example Gemfile source https rubygems org gem rails 3 2 8 gem activerecord jdbcsqlite3 adapter gem jruby openss1 gem json group assets do gem sass rails Ves gem coffee rails gt 3 gem therubyrhino gem uglifier gt 1 0 3 end gem jquery rails gem torquebox gt project version gem torquebox server gt project version 1 3 2 Subsequent Applications Deploying multiple applications to TorqueBox when using RVM and project specific gemsets requires a small amount of extra work To walk through the required steps let s create a second Rack application to go with our Rails example application created earlier If TorqueBox is still running stop it with CTRL C in its terminal window before following the steps below 14 mkdir p torquebox_examples rack_example cd torquebox_examples rack_example rvm rvmre create jruby version jruby tb_rack_example cd torquebox_examples rack_example RVM has encountered a new or modified rvmrc file in the current directory This is a shell script and therefore may contain any shell commands Examine the contents of this file carefully to be sure the contents are safe before trusting it Choose v iew below to view the contents Do you wish to trust this rvmrc file
20. nstall rails Successfully installed rails 3 2 8 27 gems installed rails new Using rails 3 2 8 Installing sass 3 2 1 Installing sass rails 3 2 5 Installing therubyrhino_jar 1 7 4 Installing therubyrhino 2 0 1 Installing uglifier 1 3 0 Your bundle is complete Use bundle show gemname to see where a bundled gem is installed Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Bundler and jruby openssl Some versions of JRuby Bundler and jruby openssl don t play well together so if you get an error when Rails tries to run bundle install regarding jruby openssl edit the Gemfile to change the source line from https to http and manually run bundle install afterwards Add a simple scaffolded resource deploy it to TorqueBox and run TorqueBox rails g scaffold post title body text create app assets stylesheets posts css scss invoke scss create app assets stylesheets scaffolds css scss rake db migrate gt CreatePosts migrating create_table posts gt 0 0060s gt 0 rows CreatePosts migrated 0 0080s SSS eS ee ee torquebox deploy Deployed rails_example knob ym1l into Users someone torquebox project version jboss standalone deployments torquebox run 15 59 28 053 INFO org jboss as server DeploymentScanner threads 2 JBAS018559 Deployed rails_example knob ym1 Now edit torquebox_examples rails_ example app views posts index html erb then refresh t
21. nter when issuing a command or for text displayed by the system Aside from standard usage for presenting the title of a work italics denotes the first use of a new and important term For example Publican is a DocBook publishing system 1 2 Pull quote Conventions Terminal output and source code listings are set off visually from the surrounding text Output sent to a terminal is set in mono spaced roman and presented thus books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs Source code listings are also set in mono spaced roman but add syntax highlighting as follows Preface package org jboss book jca ex1 import javax naming InitialContext public class ExClient public static void main String args throws Exception InitialContext iniCtx new InitialContext Object ref iniCtx lookup EchoBean EchoHome home EchoHome ref Echo echo home create System out println Created Echo System out println Echo echo Hello echo echo Hello 1 3 Notes and Warnings Finally we use three visual styles to draw attention to information that might otherwise be overlooked Notes are tips shortcuts or alternative approaches to the task at hand Ignoring a note should have no negative consequences but you might miss out on a trick that makes your life easier Important boxes detail things that are easily missed configuratio
22. on jruby rvm use jruby version jruby global gem install torquebox server Create a directory and project specific gemset for our example application mkdir p torquebox_examples rails_example cd torquebox_examples rails_example rvm rvmre create jruby version jruby tb_rails_example Change to the Rails example directory trust the generated rvmrc file when prompted and install Rails cd torquebox_examples rails_example RVM has encountered a new or modified rvmrc file in the current directory This is a shell script and therefore may contain any shell commands Examine the contents of this file carefully to be sure the contents are safe before trusting it Choose v iew below to view the contents Do you wish to trust this rvmrc file Users someone torquebox_examples rails_example rvmrc y es n o v iew c ancel gt y rvm gemset list gemsets for jruby version jruby found in Users someone rvm gems jruby version jruby global gt tb_rails_example gem install rails Successfully installed rails 3 2 8 27 gems installed Create a new Rails application add a simple scaffolded resource deploy it to TorqueBox and run 12 Chapter 1 First Steps T orqueBox rails new Using rails 3 2 8 Installing sass 3 2 1 Installing sass rails 3 2 5 Installing therubyrhino_jar 1 7 4 Installing therubyrhino 2 0 1 Installing uglifier 1 3 0 Your bund
23. pplications Chapter 2 Adding TorqueBox Features 02 0 eee eeee 2 1 TorqueBox Rails Template 2 2 Running Tasks in the Background 2 3 Scheduled Jobs 2 4 Long Running Services 2 5 Message Processors Table of Contents Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Preface Preface 1 Document Conventions This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information Liberation Fonts set is also used in HTML editions if the set is installed on your system If not alternative but equivalent typefaces are displayed Note Red Hat Enterprise Linux 5 and later include the Liberation Fonts set by default 1 1 Typographic Conventions Four typographic conventions are used to call attention to specific words and phrases These conventions and the circumstances they apply to are as follows Mono spaced Bold Used to highlight system input including shell commands file names and paths Also used to highlight keys and key combinations For example To see the contents of the file my_next_bestselling_novel in your current working directory enter the cat my_next_bestselling_novel command at the shell prompt and press Enter to execute the command The above includes a file name a shell command and a key all presented in mono spaced bold and all distinguishable thanks to context Key combinations can be distinguished from an
24. ps with a Rails template that we can use to automatically add torquebox to the Gemfile convert the session store to the optional TorqueBox clustered session storage setup all ActiveRecord objects to have TorqueBox Backgroundable methods available and add some T orqueBox specific Rake tasks cd torquebox_examples rails_example torquebox rails apply Users someone torquebox project version share rails template rb gemfile torquebox project version remove config initializers session_store rb initializer session_store rb initializer active_record_backgroundable rb rakefile torquebox rake 2 2 Running Tasks in the Background To illustrate how TorqueBox makes it effortless to run long running tasks in the background let s first add a long running task to our Post model After each Post is created lets publish a message to our favorite social network linking to that post For simplicitly we ll just log a message and sleep for a few seconds to simulate the publish Example 2 1 torquebox_examples rails_ example app models post rb class Post lt ActiveRecord Base attr_accessible body title after_create publish_to_social_network def publish_to_social_network puts Publishing title to our favorite social network sleep 5 puts Post published end end Start TorqueBox if it isn t already running via torquebox run Windows users remember to use echo observe the output from the T orqueBox console 09
25. rable false messaging queue post_ideas PostIdeaProcessor Restart TorqueBox and you should see new posts being created from the random ideas 11 10 31 891 INFO stdout Thread 2 HornetQ client global threads 9512807 Creating new post from idea Random idea 66 Congratulations You now have an application that uses many of the features of TorqueBox For detailed documentation on TorqueBox look for the User Manual in the same location you found this Getting Started Guide 21 Red Hat JBoss Web Framework Kit 2 1 TorqueBox Quickstart Guide Revision History Revision 1 1 405 Tue Dec 17 2013 Rudiger Landmann Rebuild with Publican 4 0 0 Revision 1 1 Fri Sep 28 2012 Isaac Rooskov Initial creation of book Index feedback help 22
Download Pdf Manuals
Related Search