io.github.cdklabs.projen.awscdk

Class AwsCdkJavaApp.Builder

java.lang.Object

io.github.cdklabs.projen.awscdk.AwsCdkJavaApp.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<AwsCdkJavaApp>

Enclosing class:

AwsCdkJavaApp

@Stability(value=Experimental)
public static final class AwsCdkJavaApp.Builder
extends Object
implements software.amazon.jsii.Builder<AwsCdkJavaApp>

(experimental) A fluent builder for AwsCdkJavaApp.

Method Summary

Modifier and Type	Method and Description
AwsCdkJavaApp.Builder	artifactId(String artifactId) (experimental) The artifactId is generally the name that the project is known by.
AwsCdkJavaApp.Builder	autoApproveOptions(AutoApproveOptions autoApproveOptions) (experimental) Enable and configure the 'auto approve' workflow.
AwsCdkJavaApp.Builder	autoMergeOptions(AutoMergeOptions autoMergeOptions) (experimental) Configure options for automatic merging on GitHub.
AwsCdkJavaApp	build()
AwsCdkJavaApp.Builder	buildCommand(String buildCommand) (experimental) A command to execute before synthesis.
AwsCdkJavaApp.Builder	cdkDependencies(List<String> cdkDependencies) (experimental) Which AWS CDK modules this app uses.
AwsCdkJavaApp.Builder	cdkout(String cdkout) (experimental) cdk.out directory.
AwsCdkJavaApp.Builder	cdkVersion(String cdkVersion) (experimental) AWS CDK version to use (you can use semantic versioning).
AwsCdkJavaApp.Builder	clobber(Boolean clobber) (experimental) Add a `clobber` task which resets the repo to origin.
AwsCdkJavaApp.Builder	compileOptions(MavenCompileOptions compileOptions) (experimental) Compile options.
AwsCdkJavaApp.Builder	context(Map<String,String> context) (experimental) Additional context to include in `cdk.json`.
static AwsCdkJavaApp.Builder	create()
AwsCdkJavaApp.Builder	deps(List<String> deps) (experimental) List of runtime dependencies for this project.
AwsCdkJavaApp.Builder	description(String description) (experimental) Description of a project is always good.
AwsCdkJavaApp.Builder	devContainer(Boolean devContainer) (experimental) Add a VSCode development environment (used for GitHub Codespaces).
AwsCdkJavaApp.Builder	distdir(String distdir) (experimental) Final artifact output directory.
AwsCdkJavaApp.Builder	featureFlags(Boolean featureFlags) (experimental) Include all feature flags in cdk.json.
AwsCdkJavaApp.Builder	github(Boolean github) (experimental) Enable GitHub integration.
AwsCdkJavaApp.Builder	githubOptions(GitHubOptions githubOptions) (experimental) Options for GitHub integration.
AwsCdkJavaApp.Builder	gitpod(Boolean gitpod) (experimental) Add a Gitpod development environment.
AwsCdkJavaApp.Builder	groupId(String groupId) (experimental) This is generally unique amongst an organization or a project.
AwsCdkJavaApp.Builder	junit(Boolean junit) (experimental) Include junit tests.
AwsCdkJavaApp.Builder	junitOptions(JunitOptions junitOptions) (experimental) junit options.
AwsCdkJavaApp.Builder	logging(LoggerOptions logging) (experimental) Configure logging options such as verbosity.
AwsCdkJavaApp.Builder	mainClass(String mainClass) (experimental) The name of the Java class with the static `main()` method.
AwsCdkJavaApp.Builder	mergify(Boolean mergify) Deprecated. use `githubOptions.mergify` instead
AwsCdkJavaApp.Builder	mergifyOptions(MergifyOptions mergifyOptions) Deprecated. use `githubOptions.mergifyOptions` instead
AwsCdkJavaApp.Builder	name(String name) (experimental) This is the name of your project.
AwsCdkJavaApp.Builder	outdir(String outdir) (experimental) The root directory of the project.
AwsCdkJavaApp.Builder	packaging(String packaging) (experimental) Project packaging format.
AwsCdkJavaApp.Builder	packagingOptions(MavenPackagingOptions packagingOptions) (experimental) Packaging options.
AwsCdkJavaApp.Builder	parent(Project parent) (experimental) The parent project, if this project is part of a bigger project.
AwsCdkJavaApp.Builder	projectType(ProjectType projectType) Deprecated. no longer supported at the base project level
AwsCdkJavaApp.Builder	projenCommand(String projenCommand) (experimental) The shell command to use in order to run the projen CLI.
AwsCdkJavaApp.Builder	projenrcJava(Boolean projenrcJava) (experimental) Use projenrc in java.
AwsCdkJavaApp.Builder	projenrcJavaOptions(ProjenrcOptions projenrcJavaOptions) (experimental) Options related to projenrc in java.
AwsCdkJavaApp.Builder	projenrcJson(Boolean projenrcJson) (experimental) Generate (once) .projenrc.json (in JSON).
AwsCdkJavaApp.Builder	projenrcJsonOptions(ProjenrcOptions projenrcJsonOptions) (experimental) Options for .projenrc.json.
AwsCdkJavaApp.Builder	readme(SampleReadmeProps readme) (experimental) The README setup.
AwsCdkJavaApp.Builder	requireApproval(ApprovalLevel requireApproval) (experimental) To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
AwsCdkJavaApp.Builder	sample(Boolean sample) (experimental) Include sample code and test if the relevant directories don't exist.
AwsCdkJavaApp.Builder	sampleJavaPackage(String sampleJavaPackage) (experimental) The java package to use for the code sample.
AwsCdkJavaApp.Builder	stale(Boolean stale) (experimental) Auto-close of stale issues and pull request.
AwsCdkJavaApp.Builder	staleOptions(StaleOptions staleOptions) (experimental) Auto-close stale issues and pull requests.
AwsCdkJavaApp.Builder	testDeps(List<String> testDeps) (experimental) List of test dependencies for this project.
AwsCdkJavaApp.Builder	url(String url) (experimental) The URL, like the name, is not required.
AwsCdkJavaApp.Builder	version(String version) (experimental) This is the last piece of the naming puzzle.
AwsCdkJavaApp.Builder	vscode(Boolean vscode) (experimental) Enable VSCode integration.
AwsCdkJavaApp.Builder	watchExcludes(List<String> watchExcludes) (experimental) Glob patterns to exclude from `cdk watch`.
AwsCdkJavaApp.Builder	watchIncludes(List<String> watchIncludes) (experimental) Glob patterns to include in `cdk watch`.

Methods inherited from class java.lang.Object

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

Method Detail

create

@Stability(value=Experimental)
public static AwsCdkJavaApp.Builder create()

Returns:

a new instance of AwsCdkJavaApp.Builder.

name

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder name(String name)

(experimental) This is the name of your project.

Default: $BASEDIR

Parameters:

name - This is the name of your project. This parameter is required.

Returns:

this

logging

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder logging(LoggerOptions logging)

(experimental) Configure logging options such as verbosity.

Default: {}

Parameters:

logging - Configure logging options such as verbosity. This parameter is required.

Returns:

this

outdir

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder outdir(String outdir)

(experimental) The root directory of the project.

Relative to this directory, all files are synthesized.

If this project has a parent, this directory is relative to the parent directory and it cannot be the same as the parent or any of it's other sub-projects.

Default: "."

Parameters:

outdir - The root directory of the project. This parameter is required.

Returns:

this

parent

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder parent(Project parent)

(experimental) The parent project, if this project is part of a bigger project.

Parameters:

parent - The parent project, if this project is part of a bigger project. This parameter is required.

Returns:

this

projenCommand

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder projenCommand(String projenCommand)

(experimental) The shell command to use in order to run the projen CLI.

Can be used to customize in special environments.

Default: "npx projen"

Parameters:

projenCommand - The shell command to use in order to run the projen CLI. This parameter is required.

Returns:

this

projenrcJson

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder projenrcJson(Boolean projenrcJson)

(experimental) Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation.

Default: false

Parameters:

projenrcJson - Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation. This parameter is required.

Returns:

this

projenrcJsonOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder projenrcJsonOptions(ProjenrcOptions projenrcJsonOptions)

(experimental) Options for .projenrc.json.

Default: - default options

Parameters:

projenrcJsonOptions - Options for .projenrc.json. This parameter is required.

Returns:

this

autoApproveOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder autoApproveOptions(AutoApproveOptions autoApproveOptions)

(experimental) Enable and configure the 'auto approve' workflow.

Default: - auto approve is disabled

Parameters:

autoApproveOptions - Enable and configure the 'auto approve' workflow. This parameter is required.

Returns:

this

autoMergeOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder autoMergeOptions(AutoMergeOptions autoMergeOptions)

(experimental) Configure options for automatic merging on GitHub.

Has no effect if github.mergify is set to false.

Default: - see defaults in `AutoMergeOptions`

Parameters:

autoMergeOptions - Configure options for automatic merging on GitHub. This parameter is required.

Returns:

this

clobber

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder clobber(Boolean clobber)

(experimental) Add a `clobber` task which resets the repo to origin.

Default: true

Parameters:

clobber - Add a `clobber` task which resets the repo to origin. This parameter is required.

Returns:

this

devContainer

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder devContainer(Boolean devContainer)

(experimental) Add a VSCode development environment (used for GitHub Codespaces).

Default: false

Parameters:

devContainer - Add a VSCode development environment (used for GitHub Codespaces). This parameter is required.

Returns:

this

github

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder github(Boolean github)

(experimental) Enable GitHub integration.

Enabled by default for root projects. Disabled for non-root projects.

Default: true

Parameters:

github - Enable GitHub integration. This parameter is required.

Returns:

this

githubOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder githubOptions(GitHubOptions githubOptions)

(experimental) Options for GitHub integration.

Default: - see GitHubOptions

Parameters:

githubOptions - Options for GitHub integration. This parameter is required.

Returns:

this

gitpod

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder gitpod(Boolean gitpod)

(experimental) Add a Gitpod development environment.

Default: false

Parameters:

gitpod - Add a Gitpod development environment. This parameter is required.

Returns:

this

mergify

@Stability(value=Deprecated)
 @Deprecated
public AwsCdkJavaApp.Builder mergify(Boolean mergify)

Deprecated. use `githubOptions.mergify` instead

(deprecated) Whether mergify should be enabled on this repository or not.

Default: true

Parameters:

mergify - Whether mergify should be enabled on this repository or not. This parameter is required.

Returns:

this

mergifyOptions

@Stability(value=Deprecated)
 @Deprecated
public AwsCdkJavaApp.Builder mergifyOptions(MergifyOptions mergifyOptions)

Deprecated. use `githubOptions.mergifyOptions` instead

(deprecated) Options for mergify.

Default: - default options

Parameters:

mergifyOptions - Options for mergify. This parameter is required.

Returns:

this

projectType

@Stability(value=Deprecated)
 @Deprecated
public AwsCdkJavaApp.Builder projectType(ProjectType projectType)

Deprecated. no longer supported at the base project level

(deprecated) Which type of project this is (library/app).

Default: ProjectType.UNKNOWN

Parameters:

projectType - Which type of project this is (library/app). This parameter is required.

Returns:

this

readme

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder readme(SampleReadmeProps readme)

(experimental) The README setup.

Default: - { filename: 'README.md', contents: '# replace this' }

Example:

 // Example automatically generated from non-compiling source. May contain errors.
 "{ filename: 'readme.md', contents: '# title' }"
 

Parameters:

readme - The README setup. This parameter is required.

Returns:

this

stale

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder stale(Boolean stale)

(experimental) Auto-close of stale issues and pull request.

See staleOptions for options.

Default: true

Parameters:

stale - Auto-close of stale issues and pull request. This parameter is required.

Returns:

this

staleOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder staleOptions(StaleOptions staleOptions)

(experimental) Auto-close stale issues and pull requests.

To disable set stale to false.

Default: - see defaults in `StaleOptions`

Parameters:

staleOptions - Auto-close stale issues and pull requests. This parameter is required.

Returns:

this

vscode

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder vscode(Boolean vscode)

(experimental) Enable VSCode integration.

Enabled by default for root projects. Disabled for non-root projects.

Default: true

Parameters:

vscode - Enable VSCode integration. This parameter is required.

Returns:

this

artifactId

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder artifactId(String artifactId)

(experimental) The artifactId is generally the name that the project is known by.

Although the groupId is important, people within the group will rarely mention the groupId in discussion (they are often all be the same ID, such as the MojoHaus project groupId: org.codehaus.mojo). It, along with the groupId, creates a key that separates this project from every other project in the world (at least, it should :) ). Along with the groupId, the artifactId fully defines the artifact's living quarters within the repository. In the case of the above project, my-project lives in $M2_REPO/org/codehaus/mojo/my-project.

Default: "my-app"

Parameters:

artifactId - The artifactId is generally the name that the project is known by. This parameter is required.

Returns:

this

groupId

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder groupId(String groupId)

(experimental) This is generally unique amongst an organization or a project.

For example, all core Maven artifacts do (well, should) live under the groupId org.apache.maven. Group ID's do not necessarily use the dot notation, for example, the junit project. Note that the dot-notated groupId does not have to correspond to the package structure that the project contains. It is, however, a good practice to follow. When stored within a repository, the group acts much like the Java packaging structure does in an operating system. The dots are replaced by OS specific directory separators (such as '/' in Unix) which becomes a relative directory structure from the base repository. In the example given, the org.codehaus.mojo group lives within the directory $M2_REPO/org/codehaus/mojo.

Default: "org.acme"

Parameters:

groupId - This is generally unique amongst an organization or a project. This parameter is required.

Returns:

this

version

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder version(String version)

(experimental) This is the last piece of the naming puzzle.

groupId:artifactId denotes a single project but they cannot delineate which incarnation of that project we are talking about. Do we want the junit:junit of 2018 (version 4.12), or of 2007 (version 3.8.2)? In short: code changes, those changes should be versioned, and this element keeps those versions in line. It is also used within an artifact's repository to separate versions from each other. my-project version 1.0 files live in the directory structure $M2_REPO/org/codehaus/mojo/my-project/1.0.

Default: "0.1.0"

Parameters:

version - This is the last piece of the naming puzzle. This parameter is required.

Returns:

this

description

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder description(String description)

(experimental) Description of a project is always good.

Although this should not replace formal documentation, a quick comment to any readers of the POM is always helpful.

Default: undefined

Parameters:

description - Description of a project is always good. This parameter is required.

Returns:

this

packaging

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder packaging(String packaging)

(experimental) Project packaging format.

Default: "jar"

Parameters:

packaging - Project packaging format. This parameter is required.

Returns:

this

url

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder url(String url)

(experimental) The URL, like the name, is not required.

This is a nice gesture for projects users, however, so that they know where the project lives.

Default: undefined

Parameters:

url - The URL, like the name, is not required. This parameter is required.

Returns:

this

compileOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder compileOptions(MavenCompileOptions compileOptions)

(experimental) Compile options.

Default: - defaults

Parameters:

compileOptions - Compile options. This parameter is required.

Returns:

this

deps

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder deps(List<String> deps)

(experimental) List of runtime dependencies for this project.

Dependencies use the format: <groupId>/<artifactId>@<semver>

Additional dependencies can be added via project.addDependency().

Default: []

Parameters:

deps - List of runtime dependencies for this project. This parameter is required.

Returns:

this

distdir

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder distdir(String distdir)

(experimental) Final artifact output directory.

Default: "dist/java"

Parameters:

distdir - Final artifact output directory. This parameter is required.

Returns:

this

junit

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder junit(Boolean junit)

(experimental) Include junit tests.

Default: true

Parameters:

junit - Include junit tests. This parameter is required.

Returns:

this

junitOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder junitOptions(JunitOptions junitOptions)

(experimental) junit options.

Default: - defaults

Parameters:

junitOptions - junit options. This parameter is required.

Returns:

this

packagingOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder packagingOptions(MavenPackagingOptions packagingOptions)

(experimental) Packaging options.

Default: - defaults

Parameters:

packagingOptions - Packaging options. This parameter is required.

Returns:

this

projenrcJava

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder projenrcJava(Boolean projenrcJava)

(experimental) Use projenrc in java.

This will install projen as a java dependency and will add a synth task which will compile & execute main() from src/main/java/projenrc.java.

Default: true

Parameters:

projenrcJava - Use projenrc in java. This parameter is required.

Returns:

this

projenrcJavaOptions

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder projenrcJavaOptions(ProjenrcOptions projenrcJavaOptions)

(experimental) Options related to projenrc in java.

Default: - default options

Parameters:

projenrcJavaOptions - Options related to projenrc in java. This parameter is required.

Returns:

this

testDeps

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder testDeps(List<String> testDeps)

(experimental) List of test dependencies for this project.

Dependencies use the format: <groupId>/<artifactId>@<semver>

Additional dependencies can be added via project.addTestDependency().

Default: []

Parameters:

testDeps - List of test dependencies for this project. This parameter is required.

Returns:

this

sample

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder sample(Boolean sample)

(experimental) Include sample code and test if the relevant directories don't exist.

Parameters:

sample - Include sample code and test if the relevant directories don't exist. This parameter is required.

Returns:

this

sampleJavaPackage

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder sampleJavaPackage(String sampleJavaPackage)

(experimental) The java package to use for the code sample.

Default: "org.acme"

Parameters:

sampleJavaPackage - The java package to use for the code sample. This parameter is required.

Returns:

this

buildCommand

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder buildCommand(String buildCommand)

(experimental) A command to execute before synthesis.

This command will be called when running cdk synth or when cdk watch identifies a change in your source code before redeployment.

Default: - no build command

Parameters:

buildCommand - A command to execute before synthesis. This parameter is required.

Returns:

this

cdkout

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder cdkout(String cdkout)

(experimental) cdk.out directory.

Default: "cdk.out"

Parameters:

cdkout - cdk.out directory. This parameter is required.

Returns:

this

context

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder context(Map<String,String> context)

(experimental) Additional context to include in `cdk.json`.

Default: - no additional context

Parameters:

context - Additional context to include in `cdk.json`. This parameter is required.

Returns:

this

featureFlags

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder featureFlags(Boolean featureFlags)

(experimental) Include all feature flags in cdk.json.

Default: true

Parameters:

featureFlags - Include all feature flags in cdk.json. This parameter is required.

Returns:

this

requireApproval

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder requireApproval(ApprovalLevel requireApproval)

(experimental) To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.

Default: ApprovalLevel.BROADENING

Parameters:

requireApproval - To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. This parameter is required.

Returns:

this

watchExcludes

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder watchExcludes(List<String> watchExcludes)

(experimental) Glob patterns to exclude from `cdk watch`.

Default: []

Parameters:

watchExcludes - Glob patterns to exclude from `cdk watch`. This parameter is required.

Returns:

this

watchIncludes

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder watchIncludes(List<String> watchIncludes)

(experimental) Glob patterns to include in `cdk watch`.

Default: []

Parameters:

watchIncludes - Glob patterns to include in `cdk watch`. This parameter is required.

Returns:

this

cdkVersion

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder cdkVersion(String cdkVersion)

(experimental) AWS CDK version to use (you can use semantic versioning).

Default: "^1.130.0"

Parameters:

cdkVersion - AWS CDK version to use (you can use semantic versioning). This parameter is required.

Returns:

this

mainClass

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder mainClass(String mainClass)

(experimental) The name of the Java class with the static `main()` method.

This method should call app.synth() on the CDK app.

Default: "org.acme.App"

Parameters:

mainClass - The name of the Java class with the static `main()` method. This parameter is required.

Returns:

this

cdkDependencies

@Stability(value=Experimental)
public AwsCdkJavaApp.Builder cdkDependencies(List<String> cdkDependencies)

(experimental) Which AWS CDK modules this app uses.

The core module is included by default and you can add additional modules here by stating only the package name (e.g. aws-lambda).

Parameters:

cdkDependencies - Which AWS CDK modules this app uses. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public AwsCdkJavaApp build()

Specified by:

build in interface software.amazon.jsii.Builder<AwsCdkJavaApp>