software.amazon.awscdk.core

Class ConstructNode

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.ConstructNode

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/0.14.3 (build 1b1062d)",
           date="2019-08-14T08:10:20.276Z")
 @Stability(value=Stable)
public class ConstructNode
extends software.amazon.jsii.JsiiObject

Represents the construct node in the scope tree.

Nested Class Summary

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

software.amazon.jsii.JsiiObject.InitializationMode

Field Summary

Fields

Modifier and Type	Field and Description
static String	PATH_SEP Separator used to delimit construct path components.

Constructor Summary

Constructors

Modifier	Constructor and Description
	ConstructNode(Construct host, IConstruct scope, String id)
protected	ConstructNode(software.amazon.jsii.JsiiObject.InitializationMode mode)

Method Summary

Modifier and Type	Method and Description
void	addDependency(IDependable... dependencies) Add an ordering dependency on another Construct.
void	addError(String message) Adds an { error: } metadata entry to this construct.
void	addInfo(String message) Adds a { "aws:cdk:info": } metadata entry to this construct.
void	addMetadata(String type, Object data) Adds a metadata entry to this construct.
void	addMetadata(String type, Object data, Object from) Adds a metadata entry to this construct.
void	addReference(IResolvable... refs) Record a reference originating from this construct node.
void	addWarning(String message) Adds a { warning: } metadata entry to this construct.
void	applyAspect(IAspect aspect) Applies the aspect to this Constructs node.
List<IConstruct>	findAll() Return this construct and all of its children in the given order.
List<IConstruct>	findAll(ConstructOrder order) Return this construct and all of its children in the given order.
IConstruct	findChild(String id) Return a direct child by id.
List<IConstruct>	getChildren() All direct children of this construct.
IConstruct	getDefaultChild() Returns the child construct that has the id `Default` or `Resource"` Override the defaultChild property.
List<Dependency>	getDependencies() Return all dependencies registered on this node or any of its children.
String	getId() The id of this construct within the current scope.
Boolean	getLocked() Returns true if this construct or the scopes in which it is defined are locked.
List<software.amazon.awscdk.cxapi.MetadataEntry>	getMetadata() An immutable array of metadata objects associated with this construct.
String	getPath() The full, absolute path of this construct in the tree.
List<OutgoingReference>	getReferences() Return all references originating from this node or any of its children.
IConstruct	getRoot()
IConstruct	getScope() Returns the scope in which this construct is defined.
List<IConstruct>	getScopes() All parent scopes of this construct.
String	getUniqueId() A tree-global unique alphanumeric identifier for this construct.
static void	prepare(ConstructNode node) Invokes "prepare" on all constructs (depth-first, post-order) in the tree under `node`.
void	setContext(String key, Object value) This can be used to set contextual values.
void	setDefaultChild(IConstruct value) Returns the child construct that has the id `Default` or `Resource"` Override the defaultChild property.
static software.amazon.awscdk.cxapi.CloudAssembly	synth(ConstructNode root) Synthesizes a CloudAssembly from a construct tree.
static software.amazon.awscdk.cxapi.CloudAssembly	synth(ConstructNode root, SynthesisOptions options) Synthesizes a CloudAssembly from a construct tree.
IConstruct	tryFindChild(String id) Return a direct child by id, or undefined.
Object	tryGetContext(String key) Retrieves a value from tree context.
static List<ValidationError>	validate(ConstructNode node) Invokes "validate" on all constructs in the tree (depth-first, pre-order) and returns the list of all errors.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiCall, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticGet, 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

Field Detail

PATH_SEP

@Stability(value=Stable)
public static final String PATH_SEP

Separator used to delimit construct path components.

Constructor Detail

ConstructNode

protected ConstructNode(software.amazon.jsii.JsiiObject.InitializationMode mode)

ConstructNode

@Stability(value=Stable)
public ConstructNode(Construct host,
                                              IConstruct scope,
                                              String id)

Method Detail

prepare

@Stability(value=Stable)
public static void prepare(ConstructNode node)

Invokes "prepare" on all constructs (depth-first, post-order) in the tree under `node`.

Parameters:

node - The root node.

synth

@Stability(value=Stable)
public static software.amazon.awscdk.cxapi.CloudAssembly synth(ConstructNode root,
                                                                                        @Nullable
                                                                                        SynthesisOptions options)

Synthesizes a CloudAssembly from a construct tree.

Parameters:

root - The root of the construct tree.

options - Synthesis options.

synth

@Stability(value=Stable)
public static software.amazon.awscdk.cxapi.CloudAssembly synth(ConstructNode root)

Synthesizes a CloudAssembly from a construct tree.

Parameters:

root - The root of the construct tree.

validate

@Stability(value=Stable)
public static List<ValidationError> validate(ConstructNode node)

Invokes "validate" on all constructs in the tree (depth-first, pre-order) and returns the list of all errors. An empty list indicates that there are no errors.

Parameters:

node - The root node.

addDependency

@Stability(value=Stable)
public void addDependency(IDependable... dependencies)

Add an ordering dependency on another Construct. All constructs in the dependency's scope will be deployed before any construct in this construct's scope.

addError

@Stability(value=Stable)
public void addError(String message)

Adds an { error: } metadata entry to this construct. The toolkit will fail synthesis when errors are reported.

Parameters:

message - The error message.

addInfo

@Stability(value=Stable)
public void addInfo(String message)

Adds a { "aws:cdk:info": } metadata entry to this construct. The toolkit will display the info message when apps are synthesized.

Parameters:

message - The info message.

addMetadata

@Stability(value=Stable)
public void addMetadata(String type,
                                                 @Nullable
                                                 Object data,
                                                 @Nullable
                                                 Object from)

Adds a metadata entry to this construct. Entries are arbitrary values and will also include a stack trace to allow tracing back to the code location for when the entry was added. It can be used, for example, to include source mapping in CloudFormation templates to improve diagnostics.

Parameters:

type - a string denoting the type of metadata.

data - the value of the metadata (can be a Token).

from - a function under which to restrict the metadata entry's stack trace (defaults to this.addMetadata).

addMetadata

@Stability(value=Stable)
public void addMetadata(String type,
                                                 @Nullable
                                                 Object data)

Adds a metadata entry to this construct. Entries are arbitrary values and will also include a stack trace to allow tracing back to the code location for when the entry was added. It can be used, for example, to include source mapping in CloudFormation templates to improve diagnostics.

Parameters:

type - a string denoting the type of metadata.

data - the value of the metadata (can be a Token).

addReference

@Stability(value=Stable)
public void addReference(IResolvable... refs)

Record a reference originating from this construct node.

addWarning

@Stability(value=Stable)
public void addWarning(String message)

Adds a { warning: } metadata entry to this construct. The toolkit will display the warning when an app is synthesized, or fail if run in --strict mode.

Parameters:

message - The warning message.

applyAspect

@Stability(value=Stable)
public void applyAspect(IAspect aspect)

Applies the aspect to this Constructs node.

findAll

@Stability(value=Stable)
public List<IConstruct> findAll(@Nullable
                                                         ConstructOrder order)

Return this construct and all of its children in the given order.

findAll

@Stability(value=Stable)
public List<IConstruct> findAll()

Return this construct and all of its children in the given order.

findChild

@Stability(value=Stable)
public IConstruct findChild(String id)

Return a direct child by id. Throws an error if the child is not found.

Parameters:

id - Identifier of direct child.

Returns:

Child with the given id.

setContext

@Stability(value=Stable)
public void setContext(String key,
                                                @Nullable
                                                Object value)

This can be used to set contextual values. Context must be set before any children are added, since children may consult context info during construction. If the key already exists, it will be overridden.

Parameters:

key - The context key.

value - The context value.

tryFindChild

@Stability(value=Stable)
 @Nullable
public IConstruct tryFindChild(String id)

Return a direct child by id, or undefined.

Parameters:

id - Identifier of direct child.

Returns:

the child if found, or undefined

tryGetContext

@Stability(value=Stable)
 @Nullable
public Object tryGetContext(String key)

Retrieves a value from tree context. Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:

key - The context key.

Returns:

The context value or `undefined` if there is no context value for thie key.

getChildren

@Stability(value=Stable)
public List<IConstruct> getChildren()

All direct children of this construct.

getDependencies

@Stability(value=Stable)
public List<Dependency> getDependencies()

Return all dependencies registered on this node or any of its children.

getId

@Stability(value=Stable)
public String getId()

The id of this construct within the current scope. This is a a scope-unique id. To obtain an app-unique id for this construct, use `uniqueId`.

getLocked

@Stability(value=Stable)
public Boolean getLocked()

Returns true if this construct or the scopes in which it is defined are locked.

getMetadata

@Stability(value=Stable)
public List<software.amazon.awscdk.cxapi.MetadataEntry> getMetadata()

An immutable array of metadata objects associated with this construct. This can be used, for example, to implement support for deprecation notices, source mapping, etc.

getPath

@Stability(value=Stable)
public String getPath()

The full, absolute path of this construct in the tree. Components are separated by '/'.

getReferences

@Stability(value=Stable)
public List<OutgoingReference> getReferences()

Return all references originating from this node or any of its children.

getRoot

@Stability(value=Stable)
public IConstruct getRoot()

Returns:

The root of the construct tree.

getScopes

@Stability(value=Stable)
public List<IConstruct> getScopes()

All parent scopes of this construct.

Returns:

a list of parent scopes. The last element in the list will always be the current construct and the first element will be the root of the tree.

getUniqueId

@Stability(value=Stable)
public String getUniqueId()

A tree-global unique alphanumeric identifier for this construct. Includes all components of the tree.

getScope

@Stability(value=Stable)
 @Nullable
public IConstruct getScope()

Returns the scope in which this construct is defined. The value is `undefined` at the root of the construct scope tree.

getDefaultChild

@Stability(value=Stable)
 @Nullable
public IConstruct getDefaultChild()

Returns the child construct that has the id `Default` or `Resource"` Override the defaultChild property. This should only be used in the cases where the correct default child is not named 'Resource' or 'Default' as it should be. If you set this to undefined, the default behavior of finding the child named 'Resource' or 'Default' will be used.

Returns:

a construct or undefined if there is no default child

setDefaultChild

@Stability(value=Stable)
public void setDefaultChild(@Nullable
                                                     IConstruct value)

Returns the child construct that has the id `Default` or `Resource"` Override the defaultChild property. This should only be used in the cases where the correct default child is not named 'Resource' or 'Default' as it should be. If you set this to undefined, the default behavior of finding the child named 'Resource' or 'Default' will be used.