software.amazon.awscdk.core

Class Annotations

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.Annotations

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-02T20:25:24.263Z")
public class Annotations
extends software.amazon.jsii.JsiiObject

Includes API for attaching annotations such as warning messages to constructs.

Example:

 import software.amazon.awscdk.core.*;
 import software.constructs.Construct;
 import software.constructs.IConstruct;
 public class MyAspect implements IAspect {
     public void visit(IConstruct node) {
         if (node instanceof CfnResource && node.getCfnResourceType() == "Foo::Bar") {
             this.error(node, "we do not want a Foo::Bar resource");
         }
     }
     public void error(IConstruct node, String message) {
         Annotations.of(node).addError(message);
     }
 }
 public class MyStack extends Stack {
     public MyStack(Construct scope, String id) {
         super(scope, id);
         Stack stack = new Stack();
         CfnResource.Builder.create(stack, "Foo")
                 .type("Foo::Bar")
                 .properties(Map.of(
                         "Fred", "Thud"))
                 .build();
         Aspects.of(stack).add(new MyAspect());
     }
 }
 

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	addDeprecation(java.lang.String api, java.lang.String message) Adds a deprecation warning for a specific API.
void	addError(java.lang.String message) Adds an { "error": } metadata entry to this construct.
void	addInfo(java.lang.String message) Adds an info metadata entry to this construct.
void	addWarning(java.lang.String message) Adds a warning metadata entry to this construct.
static Annotations	of(software.constructs.IConstruct scope) Returns the annotations API for a construct scope.

Methods inherited from class java.lang.Object

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

Constructor Detail

Annotations

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

Annotations

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

Method Detail

of

public static Annotations of(software.constructs.IConstruct scope)

Returns the annotations API for a construct scope.

Parameters:

scope - The scope. This parameter is required.

addDeprecation

public void addDeprecation(java.lang.String api,
                           java.lang.String message)

Adds a deprecation warning for a specific API.

Deprecations will be added only once per construct as a warning and will be deduplicated based on the api.

If the environment variable CDK_BLOCK_DEPRECATIONS is set, this method will throw an error instead with the deprecation message.

Parameters:

api - The API being deprecated in the format `module.Class.property` (e.g. `@aws-cdk/core.Construct.node`). This parameter is required.

message - The deprecation message to display, with information about alternatives. This parameter is required.

addError

public void addError(java.lang.String message)

Adds an { "error": } metadata entry to this construct.

The toolkit will fail deployment of any stack that has errors reported against it.

Parameters:

message - The error message. This parameter is required.

addInfo

public void addInfo(java.lang.String message)

Adds an info metadata entry to this construct.

The CLI will display the info message when apps are synthesized.

Parameters:

message - The info message. This parameter is required.

addWarning

public void addWarning(java.lang.String message)

Adds a warning metadata entry to this construct.

The CLI will display the warning when an app is synthesized, or fail if run in --strict mode.

Parameters:

message - The warning message. This parameter is required.