CSC/ECE 517 Fall 2007/wiki1b 2 Method Missing

"There are plenty of examples of method_missing on the Web. Unfortunately, I find most of them rather difficult to understand. One needs to look at quite a bit of source code and figure out what it does. Fix this by giving a plain-English description of several uses of method_missing not covered in our class, with Web links to the pages where you found them."

"Method Missing for Dummies" Example!

-> http://rubylearning.com/satishtalim/ruby_method_missing.html

Provide Extensive APIs with Method Missing!

This section covers how we can use Method Missing to provide a very comprehensive list of API methods in a class, with a little amount of code.

Lets assume that we are creating a flickr search API class. What could be the interface of this class? Well basically, the purpose of this class would be to provide a variety of methods using which developers can search photos in flickr database. For example, assume that our photo database has attributes like keywords, tags, user, content_type, free_photos and date for each photo. And we want to define the following methods in the Flickr Search API:

flickr.search_by_keywords("Wolfpack")
flickr.search_by_tags("Sports")
flickr.search_by_user("Vinay")
flickr.search_by_content_type("paintings")
flickr.search_by_free_photos("Million dollar Art")
flickr.search_by_date_added_on("10/1/2007")

A normal approach to this would be to define 6 different methods in our code and let the sub classes use these 6 methods to access the search API. Now, lets see the downside of this approach. Suppose after a year, we decide to introduce new features to flickr API like tagging each photo by its location. To achieve this, a new attribute called "location" can be added to our database which would tell where that particular photo was taken. Now, to provide the functionality of "search by location" we will have to modify our Search API class, so that sub classes can use this new search method. This means time and $$$...

Now, lets do it in a Ruby way! This can be easily achieved by Method Missing. Have a look at the following code and the inlined comments:

def method_missing(method_id, *arguments)
  # Enter only if method called is of the type "search_by"
  if match = /search_(by)_([_a-zA-Z]w*)/.match(method_id.to_s)
  
    # Extract the attribute names, for ex. tags, keywords etc
    attribute_names = extract_attribute_names_from_match(match)

    # Check if the attributes exist in the database, else call Method_missing method of Superclass
    super unless all_attributes_exists?(attribute_names)

    # Construct conditions from the attribute names and arguments
    # For different pair of attribute and argument, different conditions can be constructed.
    # For example, take a pair (keywords,Wolfpack), for which conditions like "keywords = 'Wolfpack'" or
    # "keywords LIKE '%Wolfpack%'" can be created.
    conditions = construct_conditions_from_arguments(attribute_names, arguments)
    
    # Create an array of conditions so that it can be passed around methods
    options = { :conditions => conditions }
    
    # Execute the database query here and return the results
  else
    # If the called method is not of the type "search_by", call the method_missing of Parent Class
    super
  end
end

The above code works in a simple way. Method_missing will be called whenever the called method instance is not found anywhere. The code extracts the attribute name and the arguments and then create an options array containing the database query conditions. This condition array is then use to create database queries.

Now you can easily understand why Ruby implementation is far better! Now, if we plan to provide the functionality to search the photos by location, we just have to add a new attribute to our database, and thats all! No need to even touch the code!

Note: The above example was made simple purposefully to highlight method_missing feature of Ruby. Further reading can be done at @ http://ajax.stealthsettings.com/rubyisms-in-rails/metaprogramming/ which is the original source of this idea.

Build your own Domain Specific Language (DSL) with Ruby!

Another powerful application of Method Missing is that it can be used to create a DSL. You can define your own language as a class and the inheriting classes can use this DSL to code specific tasks faster!

Lets look at an example to understand this concept:

Lets define a DSL to create a recipe. For example to create a breakfast recipe you would only have to write

"italian breakfast".consists_of
                               .caffe(1 , :macchiato )
                               .cornetto(1, :cioccolato)

Above statement would create a recipe having items cafee and cornetto of the type macchiato and cioccolato. To display the list of recipe items, the following statement can be used:

recipe? "italian breakfast"    

and following will be the output :

    to make italian breakfast you should buy:
     * 1 cioccolato cornetto
     * 1 macchiato caffe

Now lets try to do this. Consider the following statement

"italian breakfast".consists_of.
                        caffe(1 , :macchiato ).
                        cornetto(1, :cioccolato)

Here a method "consist_of" is being called as a string method. Therefore, we need to define this method in String class (which can be done in Ruby!).So, we include the following code:

class String
  #Recipe conjuction
  def consists_of
    Recipe .new self
  end
end

The above method creates a new instance of class recipe and returns a reference to the created instance. Since, the reference is returned, we can use it to call methods in Class Recipe.

Now, its time to define class recipe:

 class Recipe
    # Class variable to store all the recipes
    Public:
    @@recipes = {}

  def initialize recipe_name
    @name = recipe_name
    @ingredients = {}
    @@recipies[@name] = self
  end

  # Method missing will take the ingredients provided and put it in a hash table 
  def method_missing method, *args
    @ingredients[method .to_s] = args

    # Returning self(reference to the class instance) will enable chaining of multiple ingredients.
    # Now we can add ingredients by <class_instance>.<ingredient1>.<ingredient2>.<ingredient3> ...
    return self
  end

Now, using the above code we can create any recipe. And next is to write the code which would print the following output on calling the method recipe? "italian breakfast"

to make italian breakfast you should buy:
  * 1 cioccolato cornetto
  * 1 macchiato caffe

class Recipe
  …
  def report
    puts "to make #{@name} you should buy:" 
    @ingredients.each_pair do
      |ingredient,description|
      puts " * #{Array(description).join ' '} #{ingredient}"
    end
  end
  … 
end

Now we need a method to link recipe? to report method of class Recipe.

def recipe? name
  Recipe.recipes[name].report
end

and its done!

You can now do:
    "italian breakfast".consists_of.
                        caffe(1 , :macchiato ).
                        cornetto(1, :cioccolato)

    recipe? "italian breakfast"    

and get:
    to make italian breakfast you should buy:
     * 1 cioccolato cornetto
     * 1 macchiato caffe

Note: The above example was taken from the original source http://liquiddevelopment.blogspot.com/2006/04/twisting-and-shaping-dsls-using-ruby.html.

References

http://rubylearning.com/satishtalim/ruby_method_missing.html
http://ajax.stealthsettings.com/rubyisms-in-rails/metaprogramming/
http://liquiddevelopment.blogspot.com/2006/04/twisting-and-shaping-dsls-using-ruby.html
http://riffraff.blogsome.com/2006/05/02/metaprogramming-breakfast/

Other Cool Links to Ruby Lovers!

http://poignantguide.net/ruby/ -> A Funny way to Learn Ruby
http://redhanded.hobix.com/ -> Interesting hacks and code snippets
http://www.rubyinside.com/ -> Stay tuned with whats new in Ruby
http://www.rubyonrails.org/ -> The Best Ruby Framework!