plumber (version 1.0.0)

register_serializer: Register a Serializer

Description

A serializer is responsible for translating a generated R value into output that a remote user can understand. For instance, the serializer_json serializes R objects into JSON before returning them to the user. The list of available serializers in plumber is global.

Usage

register_serializer(name, serializer, verbose = TRUE)

registered_serializers()

Arguments

name

The name of the serializer (character string)

serializer

The serializer function to be added. This function should accept arguments that can be supplied when plumb()ing a file. This function should return a function that accepts four arguments: value, req, res, and errorHandler. See print(serializer_json) for an example.

verbose

Logical value which determines if a message should be printed when overwriting serializers

Functions

  • register_serializer: Register a serializer with a name

  • registered_serializers: Return a list of all registered serializers

Details

There are three main building-block serializers:

  • serializer_headers: the base building-block serializer that is required to have as_attachment() work

  • serializer_content_type(): for setting the content type. (Calls serializer_headers())

  • serializer_device(): add endpoint hooks to turn a graphics device on and off in addition to setting the content type. (Uses serializer_content_type())

Examples

Run this code
# NOT RUN {
# `serializer_json()` calls `serializer_content_type()` and supplies a serialization function
print(serializer_json)
# serializer_content_type() calls `serializer_headers()` and supplies a serialization function
print(serializer_content_type)
# }

Run the code above in your browser using DataCamp Workspace