DataWeave Deep Dive

How to extract the keys from an Object in DataWeave using keysOf, namesOf, or pluck

In this tutorial, we’ll learn different ways to get, extract, or retrieve an Array with all the keys from an Object. We’ll use thekeysOf,namesOf, andpluck functions to demonstrate the differences between the type of Array that is returned from each function. For these examples, we’ll be working with JSON Objects specifically, although these functions work for other data types as well.

You can try all of these examples with theDataWeave Playground. To learn more about it, check outthis tutorial.

Prerequisites

While not required to follow this tutorial, a good understanding of the basic DataWeave concepts would be preferred. You can check out these other tutorials if you feel a bit lost with some concepts:

• What is DataWeave? Part 1 - To understand MIME types, the script anatomy, and data types.
• What is DataWeave? Part 2 - To understand how to use the selectors to retrieve data.
• What is DataWeave? Part 3 - To understand variables, boolean operators, flow control, and named functions (prefix and infix notations).
• What is DataWeave? Part 4 - To understand what are lambdas (anonymous functions), higher-order functions, infix notation, and the dollar-sign syntax.
• What is DataWeave? Part 5 - To understand what is the syntax of the type parameters (or generics).

keysOf

You can use thekeysOf function to get an Array of all the Keys from the Object. Note that this will return an Array of Keys and not an Array of Strings. In this example, we create an Object with two fields: one containing the type of the first item in the Array and the second one containing the actual Array. Since this is anArray<Key>, we will need to do some additional steps when we try to compare the Keys to a String. We’ll see how to do that later in the tutorial.

Open in Playground

namesOf

You can use thenamesOf function to get an Array of all the Keys from the Object in a String form. In this example, we create an Object with two fields: one containing the type of the first item in the Array and the second one containing the actual Array. Since this is anArray<String>, we won’t need to do additional steps to compare the Keys to a String.

Open in Playground

pluck

You can use thepluck function to get an Array of all the Keys from the Object. Note that this will return an Array of Keys and not an Array of Strings. In this example, we create an Object with two fields: one containing the type of the first item in the Array and the second one containing the actual Array. Since this is anArray<Key>, we will need to do some additional steps when we try to compare the Keys to a String. We’ll see how to do that later in the tutorial.

Open in Playground

Compare Keys to Strings with~=

When you try to use an equality operator like “equals to” (==) to compare a Key and a String, the result will always befalse. An easy way to avoid this is to use the “similar to” operator (~=) to compare Keys and Strings. This operator coerces one of the types into the other one to be able to compare different types.

In the next example, we use thefilter function to demonstrate this functionality after retrieving our Array of Keys using thekeysOf function. We won’t cover the complete use offilter right now, but you can check outthis tutorial to learn more about it.

Open in Playground

If you’re not familiar with the dollar-sign syntax, you can check out thePrerequisites section at the top of this tutorial to get familiar with it. If you prefer to see the explicit lambda, it would look like this:
keysOf(payload) filter ((key) -> key ~= "firstName")

As you can see, we were able to extract the Key that matched the StringfirstName. If we tried to do this with$ == "firstName" instead, the result would be an empty Array because no matches would be found, sinceKey == String is alwaysfalse. To understand this topic in detail and to learn other alternatives to compare different types, check outthis tutorial.

Next Steps

We learned different ways to extract an Array with all the keys from an Object using thekeysOf,namesOf, andpluck functions. We also learned how to compare Keys to Strings using the~= operator.

Continue your development journey with the rest of thetutorials to become a master in DataWeave.

Try Anypoint Platform for free

Start your 30-day free trial of the #1 platform for integration, APIs, and automation. No credit card required. No software to install.

Try for free

Questions?Ask an expert.