Need help with restfulie?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

caelum
400 Stars 43 Forks Other 1.9K Commits 17 Opened issues

Description

CRUD through HTTP is a good step forward to using resources and becoming RESTful. Another step further into it is to make use of hypermedia-based services and the Restfulie gem allows you to do it very quickly.

Services available

!
?

Need anything else?

Contributors list

h1. Status

Restfulie Ruby is not being actively maintained. Restfulie C# and Java (through VRaptor) support can be found on the mailing list.

h1. Web site

"Restfulie's site":http://restfulie.caelumobjects.com has a lot of information on Restfulie itself

h1. Quit pretending

CRUD through HTTP and web services (aka Rest) in Rails is a good step forward to using resources and becoming RESTful, another step further into it is to make use of hypermedia and semantic meaningful media types: this gem allows you to do it really fast. Go go go!

h2. Bite me!

One liners for your pleasure. First, how to let restfulie know which media types you can handle:

class ItemsController < ...
  respond_to :atom, :html, :xml, :commerce, :opensearch
end

Now let's handle them all:

def index
  respond_with @orders = Order.all
end

And what is the first difference between simple web services with Rails and a REST architecture? Let's add hypermedia to the game:

memeber(@order) do |order|
  order.link "payment", payment_url(order)
end

There you go, hypermedia, on the fly. You can also throw in link headers and much more fun for your life when maintaining your services. Lets grab it and navigate!

response = Restfulie.at('http://localhost:3030/orders').get
puts response.code

orders = response.resource
response = orders.link(payment).follow.post {creditcard => 4444}

That was it for your first hypermedia introduction with Restfulie. Now its time for the real deal.

Download it, install it, use it, ask questions in the mailing list and read the documentation on Restfulie's website!

h2. Installing

Execute:

gem install restfulie

For use in Rails 2.3, make sure to require the responders_backport gem in addition to the restfulie gem, either in environment.rb or in the Gemfile.

h2. Building the project

If you want to build the project and run its tests, remember to install all (client and server) required gem. "Bundler":http://gembundler.com/ is required to easily manage dependencies

bundle install
rake test:spec test:integration

h2. Contributions

Restfulie was created and is maintained by "Caelum":http://caelumobjects.com, and has received enormous contributions from all those developers:

Project Leader Guilherme Silveira, "Caelum":http://www.caelum.com.br

Caue Guerra, caelum George Guimaraes, abril and plataforma Fabio Akita Diego Carrion Leandro Silva Gavin-John Noonan Antonio Marques Luis Cipriani, abril Everton Ribeiro, abril Paulo Ahagon, abril Elomar França Thomas Stefano "David Paniz":http://www.caelum.com.br "Caike Souza":http://www.caikesouza.com/blog

h2. Rails 2

If you want to use Restfulie with Rails2, please use any release up to 0.9.2 and its minor releases.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.