IMPORTANTE: Esta documentação foi descontinuada. Leia a documentação Transformer - Visão geral das operations atualizada no nosso novo portal de documentação.
Este artigo apresenta exemplos de alguns "operations" no jolt.
BASICS OF JOLT:
operation (string): shift, sort, cardinality, modify-overwrite-beta, or remove.
shift: Para alterar a forma do JSON valores ou partes da árvore de entrada e inclua-os em locais especificados na saída. A estrutura se resume em navegar até a variável ou objeto Json que deseja alterar a estrutura, colocar : (dois pontos) e entre "" aspas, informar o destino para o objeto.
Referenciar "todos os elementos" dentro de um objeto, é possível utilizar * (asterisco).
Copiar o nome da variável para o destino, utilize &
Criar níveis no Json de destino, utilize "." (ponto)
Exemplo:
Input:
{
"body": {
"cep": "05350-000",
"logradouro": "Avenida Escola Politécnica",
"bairro": "Rio Pequeno",
"localidade": "São Paulo",
"uf": "SP"
},
"cliente": {
"codigo": 2,
"name": "RODRIGO LARA",
"email": "[email protected]",
"due_date": "2019-03-27"
}
}
Spec:
[
{
"operation": "shift",
"spec": {
"cliente": {
"codigo": "customer.id",
"name": "customer.&",
"email": "customer.email"
},
"body": {
"*": "customer.address.&"
}
}
}
]
Output:
{
"customer" : {
"id" : 2,
"name" : "RODRIGO LARA",
"email" : "[email protected]",
"address" : {
"cep" : "05350-000",
"logradouro" : "Avenida Escola Politécnica",
"bairro" : "Rio Pequeno",
"localidade" : "São Paulo",
"uf" : "SP"
}
}
}
default: Para adicionar novos campos e valores no JSON de saída.
Exemplo:
Input:
{
"counterTop": {
"loaf1": {
"type": "white"
},
"loaf2": {
"type": "wheat"
},
"jar1": {
"contents": "peanut butter"
},
"jar2": {
"contents": "jelly"
}
}
Spec:
[
{
"operation": "default",
"spec": {
"counterTop": {
"loaf1": {
"slices": [
"slice1",
"slice2",
"slice3",
"slice4
]
}
}
}
}
]
}
Output:
{
"counterTop" : {
"loaf1" : {
"type" : "white",
"slices" : [ "slice1", "slice2", "slice3", "slice4" ]
},
"loaf2" : {
"type" : "wheat"
},
"jar1" : {
"contents" : "peanut butter"
},
"jar2" : {
"contents" : "jelly"
}
}
}
cardinality: Transforma elementos no JSON de entrada em valores únicos (objeto) ou em listas (array) na saída.
Exemplo:
Input:
{
"counterTop": {
"loaf1": {
"type": "white",
"slices": [
"slice1",
"slice2",
"slice3",
"slice4"
]
},
"loaf2": {
"type": "wheat"
},
"jar1": {
"contents": "peanut butter"
},
"jar2": {
"contents": "jelly"
}
}
}
Spec:
[
{
"operation": "cardinality",
"spec": {
"counterTop": {
"loaf1": {
"slices": "ONE"
}
}
}
}
]
Obs: a instrução "ONE" altera sua lista para um objeto com o primeiro elemento da lista e a instrução "MANY" altera um objeto no json para uma lista.
Output:
{
"counterTop" : {
"loaf1" : {
"type" : "white",
"slices" : "slice1"
},
"loaf2" : {
"type" : "wheat"
},
"jar1" : {
"contents" : "peanut butter"
},
"jar2" : {
"contents" : "jelly"
}
}
}
Remove: Utilizado para remover campos do JSON de entrada
Exemplo:
Input:
{
"counterTop": {
"loaf1": {
"type": "white",
"slices": "slice1"
},
"loaf2": {
"type": "wheat"
},
"jar1": {
"contents": "peanut butter"
},
"jar2": {
"contents": "jelly"
}
}
}
Spec:
[
{
"operation": "remove",
"spec": {
"counterTop": {
"loaf2": "",
"jar1": ""
}
}
}
]
Output:
{
"counterTop" : {
"loaf1" : {
"type" : "white",
"slices" : "slice1"
},
"jar2" : {
"contents" : "jelly"
}
}
}
modify-overwrite-beta: Permite a ultilização de funções predefinidas no 'jolt' para alterar valores e até mesmo tipo dos elementos.
As funções incluem operações básicas de string e matemática (toLower, toUpper, concat, min / max / abs, toInteger, toDouble, toInt e podem ser aplicadas aos valores JSON de origem.
Exemplo:
Input:
{
"counterTop": {
"loaf1": {
"type": "white",
"slices": "slice1"
},
"jar2": {
"contents": "jelly"
}
}
}
Spec:
[
{
"operation": "modify-overwrite-beta",
"spec": {
"counterTop": {
"jar2": {
//acessando o Elemento contents e alterando seu valor para upper
"contents": "=toUpper"
}
}
}
}
]
Output:
{
"counterTop" : {
"loaf1" : {
"type" : "white",
"slices" : "slice1"
},
"jar2" : {
//a saída em UpperCase
"contents" : "JELLY"
}
}
}
sort: Ordena toda a entrada JSON na saída. A Ordenação não pode ser configurada, todo o json será afetado.
A Ordenação não olha para os valores das variáveis, apenas para seu nome mantendo.
A Saída será ordenada em ordem alfabética. (Obs.: Seguindo o convenção de estrutura JSON, a ordem as variáveis não altera sua entrutura/comportamento)
Exemplo:
Input:
{
"counterTop": {
"loaf1": {
"type": "white",
"slices": "slice1"
},
"jar2": {
"contents": "JELLY"
}
}
}
Spec:
[
{
"operation": "sort"
}
]
Output:
{
"counterTop" : {
"jar2" : {
"contents" : "JELLY"
},
"loaf1" : {
"slices" : "slice1",
"type" : "white"
}
}
}Remover todos os atributos cujo os valores sejam null's
{
"operation": "modify-overwrite-beta",
"spec": {
"*": "=recursivelySquashNulls"
}
}