software.amazon.awscdk.assertions

Class Capture

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.assertions.Matcher

software.amazon.awscdk.assertions.Capture

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.46.0 (build cd08c55)",
           date="2021-11-25T20:11:04.683Z")
 @Stability(value=Experimental)
public class Capture
extends Matcher

(experimental) Capture values while matching templates.

Using an instance of this class within a Matcher will capture the matching value. The as*() APIs on the instance can be used to get the captured value.

Example:

 // Given a template -
 // {
 //   "Resources": {
 //     "MyBar": {
 //       "Type": "Foo::Bar",
 //       "Properties": {
 //         "Fred": ["Flob", "Cat"],
 //         "Waldo": ["Qix", "Qux"],
 //       }
 //     }
 //   }
 // }
 Capture fredCapture = new Capture();
 Capture waldoCapture = new Capture();
 Map<String, Object> expected = Map.of(
         "Fred", fredCapture,
         "Waldo", List.of("Qix", waldoCapture));
 template.hasResourceProperties("Foo::Bar", expected);
 fredCapture.asArray(); // returns ["Flob", "Cat"]
 waldoCapture.asString();
 

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
	Capture()
protected	Capture(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Capture(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
List<Object>	asArray() (experimental) Retrieve the captured value as an array.
Boolean	asBoolean() (experimental) Retrieve the captured value as a boolean.
Number	asNumber() (experimental) Retrieve the captured value as a number.
Map<String,Object>	asObject() (experimental) Retrieve the captured value as a JSON object.
String	asString() (experimental) Retrieve the captured value as a string.
String	getName() (experimental) A name for the matcher.
MatchResult	test(Object actual) (experimental) Test whether a target matches the provided pattern.

Methods inherited from class software.amazon.awscdk.assertions.Matcher

isMatcher

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

Capture

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

Capture

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

Capture

@Stability(value=Experimental)
public Capture()

Method Detail

asArray

@Stability(value=Experimental)
 @NotNull
public List<Object> asArray()

(experimental) Retrieve the captured value as an array.

An error is generated if no value is captured or if the value is not an array.

asBoolean

@Stability(value=Experimental)
 @NotNull
public Boolean asBoolean()

(experimental) Retrieve the captured value as a boolean.

An error is generated if no value is captured or if the value is not a boolean.

asNumber

@Stability(value=Experimental)
 @NotNull
public Number asNumber()

(experimental) Retrieve the captured value as a number.

An error is generated if no value is captured or if the value is not a number.

asObject

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

(experimental) Retrieve the captured value as a JSON object.

An error is generated if no value is captured or if the value is not an object.

asString

@Stability(value=Experimental)
 @NotNull
public String asString()

(experimental) Retrieve the captured value as a string.

An error is generated if no value is captured or if the value is not a string.

test

@Stability(value=Experimental)
 @NotNull
public MatchResult test(@NotNull
                                                                 Object actual)

(experimental) Test whether a target matches the provided pattern.

Every Matcher must implement this method. This method will be invoked by the assertions framework. Do not call this method directly.

Specified by:

test in class Matcher

Parameters:

actual - This parameter is required.

Returns:

the list of match failures. An empty array denotes a successful match.

getName

@Stability(value=Experimental)
 @NotNull
public String getName()

(experimental) A name for the matcher.

This is collected as part of the result and may be presented to the user.

Specified by:

getName in class Matcher