Michael Slater and Christopher Haupt <h2>Welcome to the Learning Rails Online Course</h2> If you’ve read this far, you probably already have an interest in building web applications with Ruby on Rails. But just in case you’re unsure if Rails is worth learning, in this lesson we explore the reasons for the success of Ruby on Rails and the benefits that can result from using it. The heart of the lesson is the audio; these notes are supplementary. So please listen to the audio, or read the transcript, before making use of these notes. To listen to the lesson, click the Play button on the left. You can also right-click on the download link to save the mp3 file, or you can subscribe in iTunes (just search for Learning Rails). To read a transcript of the lesson, click the Transcript link on the left. <h2>Web resources</h2> Keep in mind the distinction between Ruby and Ruby on Rails: <ul> <li>Ruby is a programming language</li> <li>Ruby on Rails (often called simply “Rails”) is a framework for building web applications with Ruby</li> </ul> The central web resources for Ruby and Rails, respectively, are: <ul> <li><a href="http://www.ruby-lang.org">Ruby Language</a></li> <li><a href="http://www.rubyonrails.com">Ruby on Rails</a></li> </ul> If you want to do some more preparation for your Ruby on Rails education, we highly recommend that you begin learning Ruby, the programming language, without regard to Rails (at first). You don’t need an extensive knowledge of Ruby, but you need to learn the basics. We’ll talk about Ruby a little more in later lessons, but you can get started now learning it on your own. If you have experience with another programming language, much of Ruby will seem very natural. If you don’t have any experience with object-oriented programming, you may want to read up on Ruby objects — in Ruby, everything is an object, and you’ll work with them constantly. Ruby uses one unusual construct, the code block, which is unfamiliar to most programmers and merits some study. Code blocks are used extensively in Rails. Ruby-lang.org has a <a href="http://www.ruby-lang.org/en/documentation/quickstart/">good introductory tutorial</a> and a <a href="http://www.ruby-doc.org/docs/ruby-doc-bundle/Tutorial/">longer introduction to Ruby</a>. <a href="http://www.techotopia.com/index.php/Ruby_Essentials">Ruby Essentials</a> is a short online ebook on ruby. And for those of you who are more graphically inclined, check out <a href="http://poignantguide.net/ruby/chapter-3.html">Why’s Poignant Guide to Ruby, Chapter 3</a>, it even has foxes! You can begin experimenting with Ruby right in your browser, without having to install anything. Just browse to <a href="http://tryruby.hobix.com/">tryruby.hobix.com</a>. <h2>Introductory books</h2> You need to learn about both Ruby and Rails, and you’ll want separate books for each of them. For beginning Ruby, these are both good introductory books: <ul> <li><a href="http://www.amazon.com/exec/obidos/ASIN/0596529864/buildicom-20">Learning Ruby</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/1590597664/buildicom-20">Beginning Ruby</a></li> </ul> There are several other valuable references and advanced guides for Ruby, which you’ll want to pick up if you get serious about your Ruby programming; see <a href="/books/list?category=6">our Ruby bookstore</a> for an extensive list. For learning Ruby on Rails, the current selection of books is a little problematic. Two years ago, there were only a few books; now there are dozens, which makes it more confusing to pick one. And alas, most of them are written for Rails 1.2.6, and the ones that are the most up-to-date are not well suited for beginners. Although it is not the most accessible book for a novice programmer, and is written for Rails 1.2.x, <a href="http://www.amazon.com/exec/obidos/ASIN/0977616630/buildicom-20">Agile Web Development with Rails</a> remains the classic Rails book. But if you’re using Rails 2, which we recommend you do, parts of this book will be confusing due to changes in the framework. The most up-to-date and in-depth book on Ruby on Rails is <a href="http://www.amazon.com/exec/obidos/ASIN/0321445619/buildicom-20">The Rails Way</a>. It isn’t written as an introductory book, so while we highly recommend it as a reference, you’ll probably want to start with another book to get your bearings first. The Agile book mentioned above is a good place to start, especially if you have a programming background. If you’re looking for a gentler introduction, some of the available books include: <ul> <li><a href="http://www.amazon.com/exec/obidos/ASIN/1590597524/buildicom-20">Rails Solutions: Ruby on Rails Made Easy</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/0975841955/buildicom-20">Build Your Own Ruby on Rails Web Applications</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/1590596862/buildicom-20">Beginning Rails</a></li> </ul> Other books provide a lot of example code that provide useful guides for how to implement various features. Books of this type include: <ul> <li><a href="http://www.amazon.com/exec/obidos/ASIN/1590598415/buildicom-20">Practical Rails Social Networking Sites</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/0321480791/buildicom-20">RailsSpace: Building a Social Networking Website with Ruby on Rails</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/1590597362/buildicom-20">Beginning Ruby on Rails E-Commerce</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/0596527314/buildicom-20">Rails Cookbook</a></li> <li><a href="http://www.amazon.com/exec/obidos/ASIN/0977616606/buildicom-20">Rails Recipes</a></li> </ul> See our <a href="/books/list?category=5">complete list of Ruby and Ruby on Rails Books</a> for more. Ruby on Rails is one of the fastest-growing web development platforms. In this inaugural Learning Rails podcast, we explain what Ruby and Rails are, the huge "sweet spot" for Rails applications, and why it is worth investing your time to learn the platform. 2008-07-24T01:00:49-07:00

6514

5027

Why You Should Learn Ruby on Rails

2007-11-25T16:00:00-08:00

0 1

2009-03-19T11:32:05-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-1.mp3

6554

5027

Anatomy of a Web Application

2007-12-09T16:00:00-08:00

0 2

2009-03-19T11:32:05-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-2.mp3

Michael Slater and Christopher Haupt To listen to the lesson, click the Play button on the left. You can also right-click on the download link to save the mp3 file, or you can subscribe in iTunes (just search for Learning Rails). To read a transcript of the lesson, click the Transcript link on the left. The heart of the lesson is the audio; these notes are supplementary. So please listen to the audio, or read the transcript, before making use of these notes. <h2>Code Examples</h2> In this podcast, we mention several bits of code that are hard to visualize in audio, so we’ve included them here. Refer to the <a href="/podcasts/4/transcript">transcript</a> to see these examples in context. For links to additional resources, scroll down past the code examples. <h3>Embedded Ruby</h3> Ruby code in a view template is preceded by <code><%</code> and followed by <code>%></code>. The enclosed text is what is called “embedded Ruby,” or ERb. If the Ruby code is preceded by just <code><%</code>, then the code is executed, but its output is not inserted into the HTML stream. For example, you might have Ruby code that says something like “if podcast title is not blank”. In real code, this would be: <pre> <% if !podcast.title.blank? %> </pre> For example, if we had a variable named title and we wanted its value to be inserted into the HTML, we’d write <pre> <%= title %> </pre> Last episode, we gave as an example a page listing all the episodes of this podcast. In this example, the variable that would be passed to the view would be an array of podcast objects. The code to do so looks like this: <pre> <% for podcast in podcasts %> <h2><%= podcast.title %></h2> <%= podcast.description %> <% end %> </pre> <h3>Partials</h3> A partial is just a small view template that is meant to be included in another template, or in a layout. The statement that goes in the controller is: <pre> render :partial => 'partial_name' </pre> You can also use a partial when you want to repeatedly insert the same bit of markup, but using data from a series of objects. For example, consider our listing of podcast episodes. We can use a partial that displays the information for a single podcast. You could simply put that partial in a loop that executes it once for each podcast object, like this: <pre> <% for podcast in podcasts %> <%= render :partial => 'podcast' %> <% end %> </pre> (For simplicity, we’re ignoring here some details about how the podcast variable is passed to the partial.) But Rails gives us a shortcut that makes this even simpler; in the “render partial” statement, we can refer to the array of podcast objects (which the controller provided), and the partial will automatically be repeated for each podcast in the array. Here’s the code: <pre> <%= render :partial => 'podcast', :collection => podcasts %> </pre> <h3>Rails Helpers</h3> Instead of writing: <pre> <a href = 'some_URL'>Text to be linked</a> </pre> you can use the Rails link_to helper, like this: <pre> <%= link_to 'Text to be linked', 'some_URL' %> </pre> The link_to helper is more interesting when you use it to help you generate the URL, instead of specifying it explicitly. For example, you can specify the controller and action you want the link to invoke, and any parameters that you want to pass to it, and let link_to generate the URL. Dynamic generation of links is really preferable when it comes to flexibility and maintenance of your code. For example, you could write: <pre> <%= link_to 'View Transcript', :controller => 'podcast', :action => 'view_transcript', :id => podcast %> </pre> Another common helper is image_tag. Instead of the usual <pre> <img src = '/images/filename'> </pre> you can write Ruby code that reads <pre> <%= image_tag 'filename' %> </pre> Rails assumes, by default, that all images are in a directory called images, so you don’t need to include the directory as part of the filename. You can also add additional parameters, such as alt text and image dimensions, using Ruby instead of HTML code, such as: <pre> <%= image_tag 'filename', :alt => 'Alt text goes here', :height => 50, :width => 125 %> </pre> <h3>DHTML with Rails</h3> Here’s a simplified version of the code to observe the shipping adddress checkbox and call as JavaScript function when it is checked: <pre> <%= observe_field 'shipping_address', :function => 'show_shipping_address();' %> </pre> (We haven’t shown here the code that defines the JavaScript function show_shipping_address(), which you could write in conventional JavaScript.) With RJS (Ruby JavaScript), you can write something like: <pre> <%= observe_field 'shipping_address', :function => update_page {|page| page[:shipping_address].show} %> </pre> There’s a bit of Ruby syntax there that we haven’t explained, but hopefully you get the idea. We’ve also ignored, for simplicity, the need to hide the shipping address if the box is unchecked. <h3>Ajax with Rails</h3> Here’s the observe_field statement that makes an Ajax call to the server to get the address: <pre> <%= observe_field 'address_chooser', :update => 'shipping_address', :url => {:controller => 'user', :action => 'get_address'}, :with => 'address_chooser' %> </pre> <h2>Resources for Further Learning</h2> See the <a href="/learningrails/1">Lesson Page for lesson 1</a> for links to Ruby and Rails books and other resources. If you want to get deep into the Ajax aspects of Rails, there’s one book devoted to that subject: <a href="http://www.amazon.com/gp/product/0596527446?ie=UTF8&tag=buildicom-20&linkCode=as2&camp=1789&creative=9325&creativeASIN=0596529864">Ajax on Rails</a> To learn more about the JavaScript frameworks included in Rails, visit their sites: <ul> <li><a href="http://prototypejs.org">Prototype</a></li> <li><a href="http://script.aculo.us/">Scriptaculous</a></li> </ul> Rails creates web pages through a combination of layouts, templates, and partials. We'll explore how they work together to create a powerful mechanism for laying out web pages. We'll also touch on the Ajax support that is built in to Rails. 2008-07-24T01:00:50-07:00

6568

5027

Rails Views -- How Rails Renders Pages

2007-12-23T16:00:00-08:00

0 3

2009-03-19T11:32:05-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-3.mp3

Michael Slater and Christopher Haupt To listen to the lesson, click the Play button on the left. You can also right-click on the download link to save the mp3 file, or you can subscribe in iTunes (just search for Learning Rails). To read a transcript of the lesson, click the Transcript link on the left. The heart of the lesson is the audio; these notes are supplementary. So please listen to the audio, or read the transcript, before making use of these notes. <h2>Resources for Further Study</h2> Any Ruby on Rails book will explain how migrations, models, and associations work. The classic Agile Web Development with Rails does a good job explaining them. Note that Rails 2.0 provides a slightly simpler syntax for migrations, which we’ve used in our examples, so in most books you’ll see the Rails 1.2 style. The <a href="http://wiki.rubyonrails.org/rails/pages/UnderstandingMigrations">Rails wiki</a> has an explanation of migrations, but as of this writing it has not been updated for Rails 2.0. The <a href="http://api.rubyonrails.org/classes/ActiveRecord/Migration.html">API document</a> provides a less readable but more complete and up-to-date description. There’s a <a href="http://www.netbeans.org/kb/60/ruby/model.html">hand-on tutorial using NetBeans 6.0</a> that shows how to create migrations and models using the NetBeans IDE. <h2>Code Examples</h2> The user requirements for the example we discuss in this podcast are: <ol> <li>A visitor to the site sees a list of podcasts with their title, description, and a link to an MP3 file</li> <li>If there is an associated show note for that podcast, a link appears that goes to a page displaying it.</li> <li>Each podcast is tagged with one or more topic categories which the visitor can see next to the podcast’s other information</li> </ol> Here’s a schematic drawing of the required objects: <img src="/LR_episode_4.jpg" alt="" /> The migration that creates the podcast database table reads something like this: <pre> create_table "podcasts" do |t| t.string "title" t.string "description" t.string "filename" end </pre> The create_table line begins a code block that defines the table. This line provides the shortcut name t, which is referenced in the lines that define the table. To create a new podcast object, you use a very simple Podcast class and simply type: <pre> episode = Podcast.new </pre> And now you have an instance of the Podcast class, which you’ve named episode. Now, to set its attributes, you can simply write: <pre> episode.title = "Learning Ruby on Rails" episode.filename = "learningrails-1.mp3" episode.description = "This episode covers..." </pre> When this code is executed, you’ve created the episode object and filled it with data. Now it takes one more line of code, <code>episode.save</code>, to write the data to the database. To find an episode by name, you can simply write: <pre> episode = Podcast.find_by_title('Learning Ruby on Rails') </pre> and you’ll get back a podcast object, called episode, with all the information about that podcast. What about the show notes? We need another migration to define that table, the core of which is simply: <pre> t.text "body" t.integer "podcast_id" </pre> The body field is where we store the text of the show notes. (The column type of “text” instead of “string” tells the database to allow a potentially large amount of text.) The podcast_id field is how Rails knows what podcast a particular show_notes object is associated with. To set up the association, you add one line of code to each of the associated models’ classes. The podcast class gets a line that reads: <pre> has_one :show_notes </pre> and the show_notes model gets a line that reads: <pre> belongs_to :podcast </pre> With these two simple additions, you can now write episode.show_notes to access the show notes for a particular episode. To associate podcasts with categories, we need a join table, whose field definitions are: <pre> t.integer podcast_id t.integer category_id </pre> With the join table created and the HABTM declarations in the two model files, you can simply write <pre> episode.categories </pre> and you’ll get back an array of category objects, one for each category that is associated with that particular episode. Rails provides an elegant set of tools for creating your database and accessing it. Migrations are simple Ruby files that let you create your database tables without SQL. You access the database through the model objects you create, which inherit a rich set of capabilities from Active Record. You can define associations between models that enable you to easily access related data that is spread across multiple tables. 2008-07-24T01:00:50-07:00

6588

5027

Rails Models

2008-01-06T00:00:00-08:00

0 4

2009-09-05T18:30:56-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-4.mp3

6601

5027

Rails Form Processing

2008-01-20T16:00:00-08:00

0 5

2009-03-19T11:32:05-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-5.mp3

6606

5027

Tools for Rails Developers

2008-02-03T16:00:00-08:00

0 6

2009-03-19T11:32:05-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-6.mp3

6609

5027

Testing Rails Code

2008-02-17T16:00:00-08:00

0 7

2009-03-19T11:32:06-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-7.mp3

6611

5027

Setting Up Your Development Environment

2008-03-25T17:00:00-07:00

0 8

2009-03-19T11:32:06-07:00

http://www.buildingwebapps.com/account_assets/bwa/assets/learningrails-8.mp3