What’s New in DataWeave

DataWeave 2.4 is bundled with Mule 4.4. The 2.4 version of DataWeave introduces the following features:

Ability to read larger-than-memory strings automatically. When you are using the indexed reader strategy and processing a String with a size larger than 1.5 MB, DataWeave automatically splits the value in chunks to avoid out-of-memory issues. Related reader properties are com.mulesoft.dw.max_memory_allocation and com.mulesoft.dw.buffered_char_sequence.enabled. Refer to Indexed Readers in DataWeave.
New reader and writer properties for working with data formats. For example, the XML writer now enables you to define namespaces at the root level.
Many new modules, functions, types, annotations, and variables. Some are experimental and subject to change in future releases.
A number of functions are overloaded to introduce new helper functions for handling null values.

Changes to the documentation include more detailed function signatures and organization of the functions by their module names, such as dw::Core, dw::core::Strings, and dw::util::Math.

DataWeave 2.4 is bundled with Mule 4.4. For information about the Mule 4.4 release, refer to What’s New in Mule 4.4.

New Properties for Data Formats

DataWeave introduces the following reader and writer properties:

DataWeave (dw) reader property: privileges enables you to provide a comma-separated list of privileges to use in the format, such as 'Resources,Properties'.
Excel (XLSX) reader property: tableLimit enables you to set position of the last column in each row.
YAML writer property: writeDeclaration enables you to write the header declaration.
XML writer properties: defaultNamespace specifies the default namespaces of the output XML , and writeDeclaredNamespaces marks the namespaces to declare in the root element of the XML.

New DataWeave Function Modules and Features

New DataWeave modules and features:

dw::Core introduces new functions and annotations:
- indexOf
- lastIndexOf
- onNull
- then
- Core Annotations introduces a number of new annotations.
dw::core::Dates is a new module with functions and types to create and manipulate Date types, for example, the function today.
dw::core::Strings introduces new functions:
- collapse
- countCharactersBy
- countMatches
- everyCharacter
- first
- hammingDistance
- last
- levenshteinDistance
- lines
- mapString
- remove
- replaceAll
- reverse
- someCharacter
- substring
- substringBy
- substringEvery
- words
dw::util::Coercions is a new DataWeave module with functions and types to simplify data type transformations, for example, the function toString.
dw::util::Math is a new DataWeave module with functions and variables that provides mathematical functions, for example, the function sin.
dw::util::Periods is a new DataWeave module with functions and types to simplify the creation of Periods, for example, the function days.
dw::util::Tree introduces new functions:
dw::util::Values provides a new type UpdaterValueProvider.