ActsPresentably is a gem that makes it easy to emit different JSON representations for your models. Say you're building an API and you need different JSON structures of the same model for different API calls. The presenter pattern can really help you here. Presenters are the equivalent of views, but for your JSON representations. So, you can keep your models separate from the different ways you want to emit them.
Add this line to your application's Gemfile:
gem 'acts_presentably'
And then execute:
$ bundle
Or install it yourself as:
$ gem install acts_presentably
To create a presenter for your User class, first create a presenter in app/presenters. The easiest way to setup your presenter is to define its "fields" and any "associations".
class PostPresenter < ActsPresentably::Presenters::DefaultPresenter
fields :title, :text
associations :author
end
For maximum flexibility simply override as_json.
@object is the object you're creating the json for, and is available in all methods.
You can even specify a different presentation name for your attribute:
class AlternativePostPresenter < ActsPresentably::Presenters::DefaultPresenter
def as_json(options = {})
{
:name => @object.title
}
end
end
Now in your ActiveRecord model add the acts_presentably line.
class Post
acts_presentably
end
Now you can run...
@post = Post.new(:title => 'First Post', :text => 'Annoying first post')
@post.to_json
@post.to_json(:post_presenter => PostAlternativePresenter )
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request