org.springframework.boot.gradle.tasks.bundling

Class BootWar

java.lang.Object

org.gradle.api.internal.AbstractTask

org.gradle.api.DefaultTask

org.gradle.api.internal.ConventionTask

org.gradle.api.tasks.AbstractCopyTask

org.gradle.api.tasks.bundling.AbstractArchiveTask

org.gradle.api.tasks.bundling.Zip

org.gradle.jvm.tasks.Jar

org.gradle.api.tasks.bundling.Jar

org.gradle.api.tasks.bundling.War

org.springframework.boot.gradle.tasks.bundling.BootWar

All Implemented Interfaces:

java.lang.Comparable<org.gradle.api.Task>, org.gradle.api.file.ContentFilterable, org.gradle.api.file.CopyProcessingSpec, org.gradle.api.file.CopySourceSpec, org.gradle.api.file.CopySpec, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.file.copy.CopySpecSource, org.gradle.api.internal.IConventionAware, org.gradle.api.internal.TaskInternal, org.gradle.api.plugins.ExtensionAware, org.gradle.api.Task, org.gradle.api.tasks.util.PatternFilterable, org.gradle.util.Configurable<org.gradle.api.Task>, BootArchive

public class BootWar
extends org.gradle.api.tasks.bundling.War
implements BootArchive

A custom War task that produces a Spring Boot executable war.

Since:

2.0.0

Author:

Andy Wilkinson, Phillip Webb

Nested Class Summary

Nested classes/interfaces inherited from interface org.gradle.api.Task

org.gradle.api.Task.Namer

Field Summary

Fields inherited from class org.gradle.api.tasks.bundling.War

WAR_EXTENSION

Fields inherited from class org.gradle.jvm.tasks.Jar

DEFAULT_EXTENSION

Fields inherited from class org.gradle.api.tasks.bundling.Zip

ZIP_EXTENSION

Fields inherited from interface org.gradle.api.Task

TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE

Constructor Summary

Constructors

Constructor and Description
BootWar() Creates a new BootWar task.

Method Summary

Modifier and Type	Method and Description
void	copy()
protected org.gradle.api.internal.file.copy.CopyAction	createCopyAction()
LaunchScriptConfiguration	getLaunchScript() Returns the LaunchScriptConfiguration that will control the script that is prepended to the archive.
java.lang.String	getMainClassName() Returns the name of the main class of the application.
org.gradle.api.file.FileCollection	getProvidedClasspath() Returns the provided classpath, the contents of which will be included in the WEB-INF/lib-provided directory of the war.
boolean	isExcludeDevtools() Returns true if the Devtools jar should be excluded, otherwise false.
protected boolean	isLibrary(org.gradle.api.file.FileCopyDetails details) Return if the FileCopyDetails are for a library.
void	launchScript() Configures the archive to have a prepended launch script.
void	launchScript(org.gradle.api.Action<LaunchScriptConfiguration> action) Configures the archive to have a prepended launch script, customizing its configuration using the given action.
void	providedClasspath(java.lang.Object... classpath) Adds files to the provided classpath to include in the WEB-INF/lib-provided directory of the war.
void	requiresUnpack(org.gradle.api.specs.Spec<org.gradle.api.file.FileTreeElement> spec) Adds a spec that identifies files that must be unpacked from the archive when it is launched.
void	requiresUnpack(java.lang.String... patterns) Adds Ant-style patterns that identify files that must be unpacked from the archive when it is launched.
protected ZipCompression	resolveZipCompression(org.gradle.api.file.FileCopyDetails details) Return the ZipCompression that should be used when adding the file represented by the given details to the jar.
void	setExcludeDevtools(boolean excludeDevtools) Sets whether or not the Devtools jar should be excluded.
void	setMainClassName(java.lang.String mainClass) Sets the name of the main class of the application.
void	setProvidedClasspath(org.gradle.api.file.FileCollection classpath) Sets the provided classpath to include in the WEB-INF/lib-provided directory of the war.
void	setProvidedClasspath(java.lang.Object classpath) Sets the provided classpath to include in the WEB-INF/lib-provided directory of the war.

Methods inherited from class org.gradle.api.tasks.bundling.War

classpath, getClasspath, getWebInf, getWebXml, setClasspath, setClasspath, setWebXml, webInf, webInf

Methods inherited from class org.gradle.api.tasks.bundling.Jar

manifest

Methods inherited from class org.gradle.jvm.tasks.Jar

getManifest, getManifestContentCharset, getMetadataCharset, getMetaInf, manifest, metaInf, metaInf, setManifest, setManifestContentCharset, setMetadataCharset

Methods inherited from class org.gradle.api.tasks.bundling.Zip

getCompressor, getEntryCompression, isZip64, setEntryCompression, setZip64

Methods inherited from class org.gradle.api.tasks.bundling.AbstractArchiveTask

createCopyActionExecuter, getAppendix, getArchiveAppendix, getArchiveBaseName, getArchiveClassifier, getArchiveExtension, getArchiveFile, getArchiveFileName, getArchiveName, getArchivePath, getArchiveVersion, getBaseName, getClassifier, getDestinationDir, getDestinationDirectory, getExtension, getVersion, into, into, into, isPreserveFileTimestamps, isReproducibleFileOrder, setAppendix, setArchiveName, setBaseName, setClassifier, setDestinationDir, setExtension, setPreserveFileTimestamps, setReproducibleFileOrder, setVersion

Methods inherited from class org.gradle.api.tasks.AbstractCopyTask

createRootSpec, eachFile, eachFile, exclude, exclude, exclude, exclude, expand, filesMatching, filesMatching, filesNotMatching, filesNotMatching, filter, filter, filter, filter, from, from, from, getDirectoryFileTreeFactory, getDirMode, getDuplicatesStrategy, getExcludes, getFileLookup, getFileMode, getFileResolver, getFileSystem, getFilteringCharset, getIncludeEmptyDirs, getIncludes, getInstantiator, getMainSpec, getRootSpec, getSource, include, include, include, include, isCaseSensitive, rename, rename, rename, rename, setCaseSensitive, setDirMode, setDuplicatesStrategy, setExcludes, setFileMode, setFilteringCharset, setIncludeEmptyDirs, setIncludes, with

Methods inherited from class org.gradle.api.internal.ConventionTask

conventionMapping, conventionMapping, getConventionMapping

Methods inherited from class org.gradle.api.internal.AbstractTask

appendParallelSafeAction, compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getAsDynamicObject, getConvention, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getIdentityPath, getImpliesSubProjects, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOnlyIf, getOutputs, getPath, getProject, getRequiredServices, getServices, getSharedResources, getShouldRunAfter, getStandardOutputCapture, getState, getTaskActions, getTaskDependencies, getTaskIdentity, getTemporaryDir, getTemporaryDirFactory, getTimeout, hasProperty, hasTaskActions, injectIntoNewInstance, isEnabled, isHasCustomActions, mustRunAfter, onlyIf, onlyIf, prependParallelSafeAction, property, replaceLogger, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setImpliesSubProjects, setMustRunAfter, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.boot.gradle.tasks.bundling.BootArchive

classpath, getClasspath, setClasspath, setClasspath

Methods inherited from interface org.gradle.api.Task

configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getConvention, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.gradle.api.plugins.ExtensionAware

getExtensions

Constructor Detail

BootWar

public BootWar()

Creates a new BootWar task.

Method Detail

copy

public void copy()

Overrides:

copy in class org.gradle.api.tasks.AbstractCopyTask

createCopyAction

protected org.gradle.api.internal.file.copy.CopyAction createCopyAction()

Overrides:

createCopyAction in class org.gradle.api.tasks.bundling.Zip

getMainClassName

public java.lang.String getMainClassName()

Description copied from interface: BootArchive

Returns the name of the main class of the application.

Specified by:

getMainClassName in interface BootArchive

Returns:

the main class name

setMainClassName

public void setMainClassName(java.lang.String mainClass)

Description copied from interface: BootArchive

Sets the name of the main class of the application.

Specified by:

setMainClassName in interface BootArchive

Parameters:

mainClass - the name of the main class of the application

requiresUnpack

public void requiresUnpack(java.lang.String... patterns)

Description copied from interface: BootArchive

Adds Ant-style patterns that identify files that must be unpacked from the archive when it is launched.

Specified by:

requiresUnpack in interface BootArchive

Parameters:

patterns - the patterns

requiresUnpack

public void requiresUnpack(org.gradle.api.specs.Spec<org.gradle.api.file.FileTreeElement> spec)

Description copied from interface: BootArchive

Adds a spec that identifies files that must be unpacked from the archive when it is launched.

Specified by:

requiresUnpack in interface BootArchive

Parameters:

spec - the spec

getLaunchScript

public LaunchScriptConfiguration getLaunchScript()

Description copied from interface: BootArchive

Returns the LaunchScriptConfiguration that will control the script that is prepended to the archive.

Specified by:

getLaunchScript in interface BootArchive

Returns:

the launch script configuration, or null if the launch script has not been configured.

launchScript

public void launchScript()

Description copied from interface: BootArchive

Configures the archive to have a prepended launch script.

Specified by:

launchScript in interface BootArchive

launchScript

public void launchScript(org.gradle.api.Action<LaunchScriptConfiguration> action)

Description copied from interface: BootArchive

Configures the archive to have a prepended launch script, customizing its configuration using the given action.

Specified by:

launchScript in interface BootArchive

Parameters:

action - the action to apply

getProvidedClasspath

@Optional
 @Classpath
public org.gradle.api.file.FileCollection getProvidedClasspath()

Returns the provided classpath, the contents of which will be included in the WEB-INF/lib-provided directory of the war.

Returns:

the provided classpath

providedClasspath

public void providedClasspath(java.lang.Object... classpath)

Adds files to the provided classpath to include in the WEB-INF/lib-provided directory of the war. The given classpath is evaluated as per Project.files(Object...).

Parameters:

classpath - the additions to the classpath

setProvidedClasspath

public void setProvidedClasspath(org.gradle.api.file.FileCollection classpath)

Sets the provided classpath to include in the WEB-INF/lib-provided directory of the war.

Parameters:

classpath - the classpath

Since:

2.0.7

setProvidedClasspath

public void setProvidedClasspath(java.lang.Object classpath)

Sets the provided classpath to include in the WEB-INF/lib-provided directory of the war. The given classpath is evaluated as per Project.files(Object...).

Parameters:

classpath - the classpath

Since:

2.0.7

isExcludeDevtools

public boolean isExcludeDevtools()

Description copied from interface: BootArchive

Returns true if the Devtools jar should be excluded, otherwise false.

Specified by:

isExcludeDevtools in interface BootArchive

Returns:

true if the Devtools jar should be excluded, or false if not

setExcludeDevtools

public void setExcludeDevtools(boolean excludeDevtools)

Description copied from interface: BootArchive

Sets whether or not the Devtools jar should be excluded.

Specified by:

setExcludeDevtools in interface BootArchive

Parameters:

excludeDevtools - true if the Devtools jar should be excluded, or false if not

resolveZipCompression

protected ZipCompression resolveZipCompression(org.gradle.api.file.FileCopyDetails details)

Return the ZipCompression that should be used when adding the file represented by the given details to the jar. By default, any library is stored and all other files are deflated.

Parameters:

details - the file copy details

Returns:

the compression to use

isLibrary

protected boolean isLibrary(org.gradle.api.file.FileCopyDetails details)

Return if the FileCopyDetails are for a library. By default any file in WEB-INF/lib or WEB-INF/lib-provided is considered to be a library.

Parameters:

details - the file copy details

Returns:

true if the details are for a library