org.springframework.boot.gradle.tasks.bundling.BootArchive Maven / Gradle / Ivy
/*
* Copyright 2012-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.boot.gradle.tasks.bundling;
import java.util.Set;
import org.gradle.api.Action;
import org.gradle.api.JavaVersion;
import org.gradle.api.Project;
import org.gradle.api.Task;
import org.gradle.api.artifacts.result.ResolvedArtifactResult;
import org.gradle.api.file.FileCollection;
import org.gradle.api.file.FileTreeElement;
import org.gradle.api.provider.Property;
import org.gradle.api.provider.Provider;
import org.gradle.api.specs.Spec;
import org.gradle.api.tasks.Classpath;
import org.gradle.api.tasks.Input;
import org.gradle.api.tasks.Nested;
import org.gradle.api.tasks.Optional;
import org.springframework.boot.loader.tools.LoaderImplementation;
/**
* A Spring Boot "fat" archive task.
*
* @author Andy Wilkinson
* @since 2.0.0
*/
public interface BootArchive extends Task {
/**
* Returns the fully-qualified name of the application's main class.
* @return the fully-qualified name of the application's main class
* @since 2.4.0
*/
@Input
Property getMainClass();
/**
* Adds Ant-style patterns that identify files that must be unpacked from the archive
* when it is launched.
* @param patterns the patterns
*/
void requiresUnpack(String... patterns);
/**
* Adds a spec that identifies files that must be unpacked from the archive when it is
* launched.
* @param spec the spec
*/
void requiresUnpack(Spec spec);
/**
* Returns the {@link LaunchScriptConfiguration} that will control the script that is
* prepended to the archive.
* @return the launch script configuration, or {@code null} if the launch script has
* not been configured.
*/
@Nested
@Optional
LaunchScriptConfiguration getLaunchScript();
/**
* Configures the archive to have a prepended launch script.
*/
void launchScript();
/**
* Configures the archive to have a prepended launch script, customizing its
* configuration using the given {@code action}.
* @param action the action to apply
*/
void launchScript(Action action);
/**
* Returns the classpath that will be included in the archive.
* @return the classpath
*/
@Optional
@Classpath
FileCollection getClasspath();
/**
* Adds files to the classpath to include in the archive. The given {@code classpath}
* is evaluated as per {@link Project#files(Object...)}.
* @param classpath the additions to the classpath
*/
void classpath(Object... classpath);
/**
* Sets the classpath to include in the archive. The given {@code classpath} is
* evaluated as per {@link Project#files(Object...)}.
* @param classpath the classpath
* @since 2.0.7
*/
void setClasspath(Object classpath);
/**
* Sets the classpath to include in the archive.
* @param classpath the classpath
* @since 2.0.7
*/
void setClasspath(FileCollection classpath);
/**
* Returns the target Java version of the project (e.g. as provided by the
* {@code targetCompatibility} build property).
* @return the target Java version
*/
@Input
@Optional
Property getTargetJavaVersion();
/**
* Registers the given lazily provided {@code resolvedArtifacts}. They are used to map
* from the files in the {@link #getClasspath classpath} to their dependency
* coordinates.
* @param resolvedArtifacts the lazily provided resolved artifacts
* @since 3.0.7
*/
void resolvedArtifacts(Provider> resolvedArtifacts);
/**
* The loader implementation that should be used with the archive.
* @return the loader implementation
* @since 3.2.0
*/
@Input
@Optional
Property getLoaderImplementation();
}