This is the first article on Dataweave series, we will explore below concepts in this article
- Dataweave Introduction
- Dataweave code Structure
- Basic example of Dataweave XML to JSON
The Dataweave Language is a powerful template engine that allows you to transform data to and from any kind of format (XML, CSV, JSON, Pojos, Maps, etc).
In Anypoint Studio, this language can be used in:
a) The Transform Message Component,
b) Any Mule component that accepts Mule Expression Language, through MEL DataWeave Functions
Dataweave code Structure:
DataWeave files are divided into two main sections:
1. The Header, which defines directives (optional)
2. The Body, which describes the output structure
The two sections are delimited by a separator, which is not required if no header is present. The separator consists of three dashes: "---"
The DataWeave header contains the directives, which define high level information about your transformation. The structure of the Header is a sequence of lines, each with its own Directives. The Header is terminated with '---'.
Through directives you can define:
- DataWeave version
- Input types and sources
- Output type
- Namespaces to import into your transform
- Constants that can be referenced throughout the body
- Functions that can be called throughout the body
All directives are declared on the header section of your DataWeave document and act upon the entire scope of it.
Directives are a mechanism to declare variables and constants and namespace aliases which need to be referenced in the Document.
They are also needed to declare the type of the output of your transform.
In Anypoint Studio, you can optionally use them to declare additional inputs. You rarely need them for this as any data arriving in the incoming Mule Message is already implicitly recognized as an input.
Basic example of Dataweave XML to JSON:
"title": "Java 8 in Action",
"author": "Mario Fusco",
details: "By $(payload.author) ($(payload.year))"
<?xml version='1.0' encoding='UTF-8'?>
<title>Java 8 in Action</title>
<details>By Mario Fusco (2014)</details>