> ## Documentation Index
> Fetch the complete documentation index at: https://cdktn.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Java: ListTerraformIterator
> CDKTN Core API Reference for ListTerraformIterator in Java.
## Initializers
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
new ListTerraformIterator(java.util.List|IResolvable|java.util.List|java.util.List list);
```
| **Name** | **Type** | **Description** |
| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| list | java.util.List\< java.lang.String >\|IResolvable\|java.util.List\< java.lang.Number >\|java.util.List\IResolvable> | *No description.* |
***
### `list`Required
* *Type:* java.util.List\< java.lang.String >|IResolvable|java.util.List\< java.lang.Number >|java.util.List\IResolvable>
***
## Methods
| **Name** | **Description** |
| ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| dynamic | Creates a dynamic expression that can be used to loop over this iterator in a dynamic block. |
| forExpressionForList | Creates a for expression that results in a list. |
| forExpressionForMap | Creates a for expression that results in a map. |
| getAny | *No description.* |
| getAnyMap | *No description.* |
| getBoolean | *No description.* |
| getBooleanMap | *No description.* |
| getList | *No description.* |
| getMap | *No description.* |
| getNumber | *No description.* |
| getNumberList | *No description.* |
| getNumberMap | *No description.* |
| getString | *No description.* |
| getStringMap | *No description.* |
| keys | Creates a for expression that maps the iterators to its keys. |
| pluckProperty | Creates a for expression that accesses the key on each element of the iterator. |
| values | Creates a for expression that maps the iterators to its value in case it is a map. |
***
### `dynamic`
```java theme={null}
public IResolvable dynamic(java.util.Map attributes)
```
Creates a dynamic expression that can be used to loop over this iterator in a dynamic block.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
See [https://cdktn.io/docs/concepts/iterators#using-iterators-for-list-attributes](https://cdktn.io/docs/concepts/iterators#using-iterators-for-list-attributes)
#### `attributes`Required
* *Type:* java.util.Map\< java.lang.String, java.lang.Object >
***
### `forExpressionForList`
```java theme={null}
public IResolvable forExpressionForList(java.lang.String|IResolvable expression)
```
Creates a for expression that results in a list.
This method allows you to create every possible for expression, but requires more knowledge about
Terraform's for expression syntax.
For the most common use cases you can use keys(), values(), and pluckProperty() instead.
You may write any valid Terraform for each expression, e.g.
`TerraformIterator.fromList(myIteratorSourceVar).forExpressionForList("val.foo if val.bar == true")`
will result in `[ for key, val in var.myIteratorSource: val.foo if val.bar == true ]`.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
#### `expression`Required
* *Type:* java.lang.String|IResolvable
The expression to use in the for mapping.
***
### `forExpressionForMap`
```java theme={null}
public IResolvable forExpressionForMap(java.lang.String|IResolvable keyExpression, java.lang.String|IResolvable valueExpression)
```
Creates a for expression that results in a map.
This method allows you to create every possible for expression, but requires more knowledge about
Terraforms for expression syntax.
For the most common use cases you can use keys(), values(), and pluckProperty instead.
You may write any valid Terraform for each expression, e.g.
`TerraformIterator.fromMap(myIteratorSourceVar).forExpressionForMap("key", "val.foo if val.bar == true")`
will result in `\{ for key, val in var.myIteratorSource: key => val.foo if val.bar == true }`.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
#### `keyExpression`Required
* *Type:* java.lang.String|IResolvable
The expression to use as key in the for mapping.
***
#### `valueExpression`Required
* *Type:* java.lang.String|IResolvable
The expression to use as value in the for mapping.
***
### `getAny`
```java theme={null}
public IResolvable getAny(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getAnyMap`
```java theme={null}
public java.util.Map getAnyMap(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getBoolean`
```java theme={null}
public IResolvable getBoolean(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getBooleanMap`
```java theme={null}
public java.util.Map getBooleanMap(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getList`
```java theme={null}
public java.util.List getList(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getMap`
```java theme={null}
public java.util.Map getMap(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getNumber`
```java theme={null}
public java.lang.Number getNumber(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getNumberList`
```java theme={null}
public java.util.List getNumberList(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getNumberMap`
```java theme={null}
public java.util.Map getNumberMap(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getString`
```java theme={null}
public java.lang.String getString(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `getStringMap`
```java theme={null}
public java.util.Map getStringMap(java.lang.String attribute)
```
#### `attribute`Required
* *Type:* java.lang.String
name of the property to retrieve.
***
### `keys`
```java theme={null}
public IResolvable keys()
```
Creates a for expression that maps the iterators to its keys.
For lists these would be the indices, for maps the keys.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
### `pluckProperty`
```java theme={null}
public IResolvable pluckProperty(java.lang.String property)
```
Creates a for expression that accesses the key on each element of the iterator.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
#### `property`Required
* *Type:* java.lang.String
The property of the iterators values to map to.
***
### `values`
```java theme={null}
public IResolvable values()
```
Creates a for expression that maps the iterators to its value in case it is a map.
For lists these would stay the same.
As this returns an IResolvable you might need to wrap the output in
a Token, e.g. `Token.asString`.
## Static Functions
| **Name** | **Description** |
| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| fromComplexList | Creates a new iterator from a complex list. |
| fromDataSources | Creates a new iterator from a data source that has been created with the `for_each` argument. |
| fromList | Creates a new iterator from a list. |
| fromMap | Creates a new iterator from a map. |
| fromResources | Creates a new iterator from a resource that has been created with the `for_each` argument. |
***
### `fromComplexList`
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
ListTerraformIterator.fromComplexList(IResolvable|ComplexList|StringMapList|NumberMapList|BooleanMapList|AnyMapList list, java.lang.String mapKeyAttributeName)
```
Creates a new iterator from a complex list.
One example for this would be a list of maps.
The list will be converted into a map with the mapKeyAttributeName as the key.
*Example*
```java theme={null}
// Example automatically generated from non-compiling source. May contain errors.
Object cert = AcmCertificate.Builder.create(this, "cert")
.domainName("example.com")
.validationMethod("DNS")
.build();
Object dvoIterator = TerraformIterator.fromComplexList(cert.getDomainValidationOptions(), "domain_name");
Route53Record.Builder.create(this, "record")
.allowOverwrite(true)
.name(dvoIterator.getString("name"))
.records(List.of(dvoIterator.getString("record")))
.ttl(60)
.type(dvoIterator.getString("type"))
.zoneId(Token.asString(dataAwsRoute53ZoneExample.getZoneId()))
.forEach(dvoIterator)
.build();
```
#### `list`Required
* *Type:* IResolvable|ComplexList|StringMapList|NumberMapList|BooleanMapList|AnyMapList
the list to iterate over.
***
#### `mapKeyAttributeName`Required
* *Type:* java.lang.String
the name of the attribute that should be used as the key in the map.
Visit [https://cdktn.io/docs/concepts/iterators#using-iterators-on-complex-lists](https://cdktn.io/docs/concepts/iterators#using-iterators-on-complex-lists) for more information.
***
### `fromDataSources`
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
ListTerraformIterator.fromDataSources(ITerraformResource resource)
```
Creates a new iterator from a data source that has been created with the `for_each` argument.
#### `resource`Required
* *Type:* ITerraformResource
***
### `fromList`
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
ListTerraformIterator.fromList(java.util.List|IResolvable|java.util.List|java.util.List list)
```
Creates a new iterator from a list.
#### `list`Required
* *Type:* java.util.List\< java.lang.String >|IResolvable|java.util.List\< java.lang.Number >|java.util.List\IResolvable>
***
### `fromMap`
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
ListTerraformIterator.fromMap(ComplexMap|java.util.Map|java.util.Map|java.util.Map|java.util.Map map)
```
Creates a new iterator from a map.
#### `map`Required
* *Type:* ComplexMap|java.util.Map\< java.lang.String, java.lang.Object >|java.util.Map\< java.lang.String, java.lang.String >|java.util.Map\< java.lang.String, java.lang.Number >|java.util.Map\< java.lang.String, java.lang.Boolean >
***
### `fromResources`
```java theme={null}
import io.cdktn.cdktn.ListTerraformIterator;
ListTerraformIterator.fromResources(ITerraformResource resource)
```
Creates a new iterator from a resource that has been created with the `for_each` argument.
#### `resource`Required
* *Type:* ITerraformResource
***
## Properties
| **Name** | **Type** | **Description** |
| ---------------------------------------------------------------------------- | ----------------------------- | --------------------------------------------------------------------------- |
| key | java.lang.Object | Returns the currently entry in the list or set that is being iterated over. |
| value | java.lang.Object | Returns the value of the current item iterated over. |
***
### `key`Required
```java theme={null}
public java.lang.Object getKey();
```
* *Type:* java.lang.Object
Returns the currently entry in the list or set that is being iterated over.
For lists this is the same as `iterator.value`. If you need the index,
use count via `TerraformCount`:
[https://cdktn.io/docs/concepts/iterators#using-count](https://cdktn.io/docs/concepts/iterators#using-count)
***
### `value`Required
```java theme={null}
public java.lang.Object getValue();
```
* *Type:* java.lang.Object
Returns the value of the current item iterated over.
***