What is Jolt
Jolt is a Java based “JSON to JSON” transformation library. However, the fact that it is Java based is irrelevant to us as transformations aren’t done in Java, but rather in Jolt’s own transformation definition format. This is the main purpose of Jolt: To be able to transform JSON without being bound to a language other than JSON. Although if Jolt’s built-in transformation operations aren’t enough for your purposes, it’s easy to extend them using the Java library. [source]
Jolt Specification
A Jolt Specification is a JSON structure that contains two root elements: operation (string): shift, sort, cardinality, modify-default-beta, modify-overwrite-beta, modify-define-beta, or remove. spec (JSON): A set of key/value pairs of the form {“input-side search”: “output-side transformation”}. [source]
Awal mula
Singkat cerita saya sedang mencoba API Gateway Gravitee. Pada menu Design terdapat JSON to JSON Transformation Gravitee Policy yang mana merupakan sebuah fungsi untuk merubah (override) konten JSON dari suatu request atau response ke bentuk JSON yang lain (diinginkan).
Nah. Untuk merubah bentuk JSON ke bentuk JSON yang lain, fungsi tersebut di atas menggunakan JOLT specification.
Contoh implementasi
Untuk memudahkan dalam mencoba atau bereksperimen dengan JOLT specification ini silahkan buka https://jolt-demo.appspot.com/.
Misalkan berikut ini adalah response JSON yang saya dapat dari suatu API (anggap ini sebagai JSON Input):
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"message": "Data Submitted",
"code": 0,
"params": {
"data": [
{
"produk": "Kopi Liong",
"harga": 1500
}
]
}
}
}Tapi saya menginginkan (JSON Output) format JSON yang lebih sederhana, misalkan sebagai berikut:
{
"produk": "Kopi Liong",
"harga": 1500
}Maka JSON specification-nya adalah sebagai berikut:
[
{
"operation": "shift",
"spec": {
"result": {
"params": {
"data": {
"*": {
"*": "&"
}
}
}
}
}
}
]
Kemudian, misalkan dari response JSON yang saya dapat dari suatu API di atas berubah bentuk menjadi:
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"message": "Data Not Found!",
"code": 404
}
}Maka dengan JOLT specification di atas apa output yang dihasilkan? Outputnya adalah null.
Tapi bagaimana jika saya ingin (misalkan) mendapatkan pesan error-nya? Apakah bisa? Jawabnnya adalah: bisa! Gunakan JOLT specification berikut:
[
{
"operation": "shift",
"spec": {
"result": {
"params": {
"data": {
"*": {
"*": "&"
}
}
}
},
"error": {
"message": "error"
}
}
}
]
Source: