software.amazon.awscdk.assertions

Class Template

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.assertions.Template

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.46.0 (build cd08c55)",
           date="2021-11-25T20:11:04.684Z")
 @Stability(value=Experimental)
public class Template
extends software.amazon.jsii.JsiiObject

(experimental) Suite of assertions that can be run on a CDK stack.

Typically used, as part of unit tests, to validate that the rendered CloudFormation template has expected resources and properties.

Example:

 import software.amazon.awscdk.Stack;
 import software.amazon.awscdk.assertions.Template;
 Stack stack = new Stack();
 // ...
 Template template = Template.fromStack(stack);
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Template(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Template(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
Map<String,Map<String,Object>>	findMappings(String logicalId) (experimental) Get the set of matching Mappings that match the given properties in the CloudFormation template.
Map<String,Map<String,Object>>	findMappings(String logicalId, Object props) (experimental) Get the set of matching Mappings that match the given properties in the CloudFormation template.
Map<String,Map<String,Object>>	findOutputs(String logicalId) (experimental) Get the set of matching Outputs that match the given properties in the CloudFormation template.
Map<String,Map<String,Object>>	findOutputs(String logicalId, Object props) (experimental) Get the set of matching Outputs that match the given properties in the CloudFormation template.
Map<String,Map<String,Object>>	findResources(String type) (experimental) Get the set of matching resources of a given type and properties in the CloudFormation template.
Map<String,Map<String,Object>>	findResources(String type, Object props) (experimental) Get the set of matching resources of a given type and properties in the CloudFormation template.
static Template	fromJSON(Map<String,? extends Object> template) (experimental) Base your assertions from an existing CloudFormation template formatted as an in-memory JSON object.
static Template	fromStack(Stack stack) (experimental) Base your assertions on the CloudFormation template synthesized by a CDK `Stack`.
static Template	fromString(String template) (experimental) Base your assertions from an existing CloudFormation template formatted as a JSON string.
void	hasMapping(String logicalId, Object props) (experimental) Assert that a Mapping with the given properties exists in the CloudFormation template.
void	hasOutput(String logicalId, Object props) (experimental) Assert that an Output with the given properties exists in the CloudFormation template.
void	hasResource(String type, Object props) (experimental) Assert that a resource of the given type and given definition exists in the CloudFormation template.
void	hasResourceProperties(String type, Object props) (experimental) Assert that a resource of the given type and properties exists in the CloudFormation template.
void	resourceCountIs(String type, Number count) (experimental) Assert that the given number of resources of the given type exist in the template.
void	templateMatches(Object expected) (experimental) Assert that the CloudFormation template matches the given value.
Map<String,Object>	toJSON() (experimental) The CloudFormation template deserialized into an object.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Template

protected Template(software.amazon.jsii.JsiiObjectRef objRef)

Template

protected Template(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Method Detail

fromJSON

@Stability(value=Experimental)
 @NotNull
public static Template fromJSON(@NotNull
                                                                         Map<String,? extends Object> template)

(experimental) Base your assertions from an existing CloudFormation template formatted as an in-memory JSON object.

Parameters:

template - the CloudFormation template formatted as a nested set of records. This parameter is required.

fromStack

@Stability(value=Experimental)
 @NotNull
public static Template fromStack(@NotNull
                                                                          Stack stack)

(experimental) Base your assertions on the CloudFormation template synthesized by a CDK `Stack`.

Parameters:

stack - the CDK Stack to run assertions on. This parameter is required.

fromString

@Stability(value=Experimental)
 @NotNull
public static Template fromString(@NotNull
                                                                           String template)

(experimental) Base your assertions from an existing CloudFormation template formatted as a JSON string.

Parameters:

template - the CloudFormation template in. This parameter is required.

findMappings

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findMappings(@NotNull
                                                                                            String logicalId,
                                                                                            @Nullable
                                                                                            Object props)

(experimental) Get the set of matching Mappings that match the given properties in the CloudFormation template.

Parameters:

logicalId - the name of the mapping. This parameter is required.

props - by default, matches all Mappings in the template.

findMappings

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findMappings(@NotNull
                                                                                            String logicalId)

(experimental) Get the set of matching Mappings that match the given properties in the CloudFormation template.

Parameters:

logicalId - the name of the mapping. This parameter is required.

findOutputs

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findOutputs(@NotNull
                                                                                           String logicalId,
                                                                                           @Nullable
                                                                                           Object props)

(experimental) Get the set of matching Outputs that match the given properties in the CloudFormation template.

Parameters:

logicalId - the name of the output. This parameter is required.

props - by default, matches all Outputs in the template.

findOutputs

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findOutputs(@NotNull
                                                                                           String logicalId)

(experimental) Get the set of matching Outputs that match the given properties in the CloudFormation template.

Parameters:

logicalId - the name of the output. This parameter is required.

findResources

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findResources(@NotNull
                                                                                             String type,
                                                                                             @Nullable
                                                                                             Object props)

(experimental) Get the set of matching resources of a given type and properties in the CloudFormation template.

Parameters:

type - the type to match in the CloudFormation template. This parameter is required.

props - by default, matches all resources with the given type.

findResources

@Stability(value=Experimental)
 @NotNull
public Map<String,Map<String,Object>> findResources(@NotNull
                                                                                             String type)

(experimental) Get the set of matching resources of a given type and properties in the CloudFormation template.

Parameters:

type - the type to match in the CloudFormation template. This parameter is required.

hasMapping

@Stability(value=Experimental)
public void hasMapping(@NotNull
                                                      String logicalId,
                                                      @NotNull
                                                      Object props)

(experimental) Assert that a Mapping with the given properties exists in the CloudFormation template.

By default, performs partial matching on the resource, via the Match.objectLike(). To configure different behavour, use other matchers in the Match class.

Parameters:

logicalId - the name of the mapping. This parameter is required.

props - the output as should be expected in the template. This parameter is required.

hasOutput

@Stability(value=Experimental)
public void hasOutput(@NotNull
                                                     String logicalId,
                                                     @NotNull
                                                     Object props)

(experimental) Assert that an Output with the given properties exists in the CloudFormation template.

By default, performs partial matching on the resource, via the Match.objectLike(). To configure different behavour, use other matchers in the Match class.

Parameters:

logicalId - the name of the output. This parameter is required.

props - the output as should be expected in the template. This parameter is required.

hasResource

@Stability(value=Experimental)
public void hasResource(@NotNull
                                                       String type,
                                                       @NotNull
                                                       Object props)

(experimental) Assert that a resource of the given type and given definition exists in the CloudFormation template.

By default, performs partial matching on the resource, via the Match.objectLike(). To configure different behavour, use other matchers in the Match class.

Parameters:

type - the resource type;. This parameter is required.

props - the entire defintion of the resource as should be expected in the template. This parameter is required.

hasResourceProperties

@Stability(value=Experimental)
public void hasResourceProperties(@NotNull
                                                                 String type,
                                                                 @NotNull
                                                                 Object props)

(experimental) Assert that a resource of the given type and properties exists in the CloudFormation template.

By default, performs partial matching on the Properties key of the resource, via the Match.objectLike(). To configure different behavour, use other matchers in the Match class.

Parameters:

type - the resource type;. This parameter is required.

props - the 'Properties' section of the resource as should be expected in the template. This parameter is required.

resourceCountIs

@Stability(value=Experimental)
public void resourceCountIs(@NotNull
                                                           String type,
                                                           @NotNull
                                                           Number count)

(experimental) Assert that the given number of resources of the given type exist in the template.

Parameters:

type - the resource type;. This parameter is required.

count - number of expected instances. This parameter is required.

templateMatches

@Stability(value=Experimental)
public void templateMatches(@NotNull
                                                           Object expected)

(experimental) Assert that the CloudFormation template matches the given value.

Parameters:

expected - the expected CloudFormation template as key-value pairs. This parameter is required.

toJSON

@Stability(value=Experimental)
 @NotNull
public Map<String,Object> toJSON()

(experimental) The CloudFormation template deserialized into an object.