software.amazon.awscdk.core

Class AssetStaging

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.AssetStaging

All Implemented Interfaces:

IDependable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.13.0 (build 385c325)",
           date="2020-10-19T20:38:02.092Z")
 @Stability(value=Stable)
public class AssetStaging
extends Construct

Stages a file or directory from a location on the file system into a staging directory.

This is controlled by the context key 'aws:cdk:asset-staging' and enabled by the CLI by default in order to ensure that when the CDK app exists, all assets are available for deployment. Otherwise, if an app references assets in temporary locations, those will not be available when it exists (see https://github.com/aws/aws-cdk/issues/1716).

The stagedPath property is a stringified token that represents the location of the file or directory after staging. It will be resolved only during the "prepare" stage and may be either the original path or the staged path depending on the context setting.

The file/directory are staged based on their content hash (fingerprint). This means that only if content was changed, copy will happen.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AssetStaging.Builder A fluent builder for AssetStaging.

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

IConstruct.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field and Description
static String	BUNDLING_INPUT_DIR (experimental) The directory inside the bundling container into which the asset sources will be mounted.
static String	BUNDLING_OUTPUT_DIR (experimental) The directory inside the bundling container into which the bundled output should be written.

Constructor Summary

Constructors

Modifier	Constructor and Description
	AssetStaging(software.constructs.Construct scope, String id, AssetStagingProps props)
protected	AssetStaging(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	AssetStaging(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static void	clearAssetHashCache() Clears the asset hash cache.
String	getAssetHash() A cryptographic hash of the asset.
String	getSourceHash() Deprecated. see `assetHash`.
String	getSourcePath() The path of the asset as it was referenced by the user.
String	getStagedPath() The path to the asset (stringinfied token).

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

toString

Methods inherited from class software.amazon.jsii.JsiiObject

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Detail

BUNDLING_INPUT_DIR

@Stability(value=Experimental)
public static final String BUNDLING_INPUT_DIR

(experimental) The directory inside the bundling container into which the asset sources will be mounted.

BUNDLING_OUTPUT_DIR

@Stability(value=Experimental)
public static final String BUNDLING_OUTPUT_DIR

(experimental) The directory inside the bundling container into which the bundled output should be written.

Constructor Detail

AssetStaging

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

AssetStaging

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

AssetStaging

@Stability(value=Stable)
public AssetStaging(@NotNull
                                             software.constructs.Construct scope,
                                             @NotNull
                                             String id,
                                             @NotNull
                                             AssetStagingProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

clearAssetHashCache

@Stability(value=Stable)
public static void clearAssetHashCache()

Clears the asset hash cache.

getAssetHash

@Stability(value=Stable)
 @NotNull
public String getAssetHash()

A cryptographic hash of the asset.

getSourceHash

@Stability(value=Deprecated)
 @Deprecated
 @NotNull
public String getSourceHash()

Deprecated. see `assetHash`.

(deprecated) A cryptographic hash of the asset.

getSourcePath

@Stability(value=Stable)
 @NotNull
public String getSourcePath()

The path of the asset as it was referenced by the user.

getStagedPath

@Stability(value=Stable)
 @NotNull
public String getStagedPath()

The path to the asset (stringinfied token).

If asset staging is disabled, this will just be the original path. If asset staging is enabled it will be the staged path.