Payload translator
Using a yaml configuration you can transform a payload to another payload. Example:
# config.yaml
payload:
id:
$field: _id
$formatter: to_integer
user_name:
$field: name
login_type:
$field: login_provider
$map:
google: GOOGLE
twitter: TWITTER
auth0: APP
country:
$fnc: get_countryInput:
// internal_payload.json
{
"_id": 1,
"name": "Jhon Doe",
"login_provider": "auth0"
}translator = PayloadTranslator::Service.new(config)
external_payload = translator.translate(internal_payload)Return:
// external_payload.json
{
"id": "1",
"user_name": "Jhon Doe",
"login_type": "APP"
}Configure handlers
Resolve the field output with a custom function.
PayloadTranslator.configure do |config|
config.handlers = {
get_country: ->(payload) { payload['name'] },
}
endOr per service
PayloadTranslator::Service(config, handlers: get_country: ->(payload) { payload['name'] })Configure formatters
Apply different formatters to the output.
PayloadTranslator.configure do |config|
config.formatters = {
uppercase: ->(value) { value.upcase },
to_integer: ->(value) { value.to_i },
}
endOr formatter per service
PayloadTranslator::Service(config, formatters: to_integer: ->(value) { value.to_i })Configure adapters configuration
Store adapter configuration
PayloadTranslator.configure do |config|
config.adapters_configurations = {
internal_to_external: {
"payload" => {
"id" => { "$field" => "_id" }
}
}
}
endtranslator = PayloadTranslator::Service.new(:internal_to_external)Multiple translator
translator = PayloadTranslator::ServiceMultiple.new([:internal_to_external, :external_to_internal])
translated_response = translator.translate({"user_id" => 4 }) do |translated_payload|
response = Net::HTTP.post_form(
URI("https://jsonplaceholder.typicode.com/todos"),
translated_payload
).body
JSON.parse(response)
endComplex adapters
Translate all array items, use $field_for_all_items special propery of the first elemtn of the array to apply the same translation from the same field
Config:
payload:
countries:
- $field_for_all_items: countries
name:
$field: 'name'Input:
{
"countries": [
{
"name": "US",
"code": "US_CODE"
},
{
"name": "AU",
"code": "AU_CODE"
}
]
}Result:
{
"countries": [
{
"name": "US"
},
{
"name": "AU"
}
]
}
