mirror of
https://github.com/ditkrg/active_model_serializers.git
synced 2026-01-22 22:06:50 +00:00
6567989ad7
[DOC] `SerializableResource#serializer` vs. `SerializableResource#serializer_instance` [ci skip]
65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
[Back to Guides](../README.md)
|
|
|
|
## Using ActiveModelSerializers Outside Of A Controller
|
|
|
|
### Serializing a resource
|
|
|
|
In ActiveModelSerializers versions 0.10 or later, serializing resources outside of the controller context is fairly simple:
|
|
|
|
```ruby
|
|
# Create our resource
|
|
post = Post.create(title: "Sample post", body: "I love Active Model Serializers!")
|
|
|
|
# Optional options parameters
|
|
options = {}
|
|
|
|
# Create a serializable resource instance
|
|
serializable_resource = ActiveModelSerializers::SerializableResource.new(post, options)
|
|
|
|
# Convert your resource into json
|
|
model_json = serializable_resource.as_json
|
|
```
|
|
|
|
### Looking up the Serializer for a Resource
|
|
|
|
If you want to retrieve the serializer class for a specific resource, you can do the following:
|
|
|
|
```ruby
|
|
# Create our resource
|
|
post = Post.create(title: "Another Example", body: "So much fun.")
|
|
|
|
# Optional options parameters
|
|
options = {}
|
|
|
|
# Retrieve the default serializer for posts
|
|
serializer = ActiveModel::Serializer.serializer_for(post, options)
|
|
```
|
|
|
|
You could also retrieve the serializer via:
|
|
|
|
```ruby
|
|
ActiveModelSerializers::SerializableResource.new(post, options).serializer
|
|
```
|
|
|
|
Both approaches will return the serializer class that will be used for the resource.
|
|
|
|
Additionally, you could retrieve the serializer instance for the resource via:
|
|
|
|
```ruby
|
|
ActiveModelSerializers::SerializableResource.new(post, options).serializer_instance
|
|
```
|
|
|
|
## Serializing before controller render
|
|
|
|
At times, you might want to use a serializer without rendering it to the view. For those cases, you can create an instance of `ActiveModelSerializers::SerializableResource` with
|
|
the resource you want to be serialized and call `.as_json`.
|
|
|
|
```ruby
|
|
def create
|
|
message = current_user.messages.create!(message_params)
|
|
message_json = ActiveModelSerializers::SerializableResource.new(message).as_json
|
|
MessageCreationWorker.perform(message_json)
|
|
head 204
|
|
end
|
|
```
|