BuildRequest (Spring Boot 2.6.12 API)

java.lang.Object
- org.springframework.boot.buildpack.platform.build.BuildRequest

```
public class BuildRequest
extends Object
```
A build request to be handled by the Builder.

Since:

2.3.0

Author:

Phillip Webb, Scott Frederick, Andrey Shlykov, Jeroen Meijer, Rafael Ceccone, Julian Liebig

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static BuildRequest`	`forJarFile(File jarFile)` Factory method to create a new `BuildRequest` from a JAR file.
`static BuildRequest`	`forJarFile(ImageReference name, File jarFile)` Factory method to create a new `BuildRequest` from a JAR file.
`TarArchive`	`getApplicationContent(Owner owner)` Return a `TarArchive` containing the application content that the buildpack should package.
`List<Binding>`	`getBindings()` Return the collection of bindings to mount to the build container.
`Cache`	`getBuildCache()` Return the custom build cache that should be used by the lifecycle.
`ImageReference`	`getBuilder()` Return the builder that should be used.
`List<BuildpackReference>`	`getBuildpacks()` Return the collection of buildpacks to use when building the image, if provided.
`Creator`	`getCreator()` Return the `Creator` the builder should use.
`Map<String,String>`	`getEnv()` Return any env variable that should be passed to the builder.
`Cache`	`getLaunchCache()` Return the custom launch cache that should be used by the lifecycle.
`ImageReference`	`getName()` Return the name of the image that should be created.
`String`	`getNetwork()` Return the network the build container will connect to.
`PullPolicy`	`getPullPolicy()` Return the image `PullPolicy` that the builder should use.
`ImageReference`	`getRunImage()` Return the run image that should be used, if provided.
`List<ImageReference>`	`getTags()` Return the collection of tags that should be created.
`boolean`	`isCleanCache()` Return if caches should be cleaned before packaging.
`boolean`	`isPublish()` Return if the built image should be pushed to a registry.
`boolean`	`isVerboseLogging()` Return if verbose logging output should be used.
`static BuildRequest`	`of(ImageReference name, Function<Owner,TarArchive> applicationContent)` Factory method to create a new `BuildRequest` with specific content.
`BuildRequest`	`withBindings(Binding... bindings)` Return a new `BuildRequest` with updated bindings.
`BuildRequest`	`withBindings(List<Binding> bindings)` Return a new `BuildRequest` with updated bindings.
`BuildRequest`	`withBuildCache(Cache buildCache)` Return a new `BuildRequest` with an updated build cache.
`BuildRequest`	`withBuilder(ImageReference builder)` Return a new `BuildRequest` with an updated builder.
`BuildRequest`	`withBuildpacks(BuildpackReference... buildpacks)` Return a new `BuildRequest` with an updated buildpacks setting.
`BuildRequest`	`withBuildpacks(List<BuildpackReference> buildpacks)` Return a new `BuildRequest` with an updated buildpacks setting.
`BuildRequest`	`withCleanCache(boolean cleanCache)` Return a new `BuildRequest` with an updated clean cache setting.
`BuildRequest`	`withCreator(Creator creator)` Return a new `BuildRequest` with an updated creator.
`BuildRequest`	`withEnv(Map<String,String> env)` Return a new `BuildRequest` with additional env variables.
`BuildRequest`	`withEnv(String name, String value)` Return a new `BuildRequest` with an additional env variable.
`BuildRequest`	`withLaunchCache(Cache launchCache)` Return a new `BuildRequest` with an updated launch cache.
`BuildRequest`	`withNetwork(String network)` Return a new `BuildRequest` with an updated network setting.
`BuildRequest`	`withPublish(boolean publish)` Return a new `BuildRequest` with an updated publish setting.
`BuildRequest`	`withPullPolicy(PullPolicy pullPolicy)` Return a new `BuildRequest` with the updated image pull policy.
`BuildRequest`	`withRunImage(ImageReference runImageName)` Return a new `BuildRequest` with an updated run image.
`BuildRequest`	`withTags(ImageReference... tags)` Return a new `BuildRequest` with updated tags.
`BuildRequest`	`withTags(List<ImageReference> tags)` Return a new `BuildRequest` with updated tags.
`BuildRequest`	`withVerboseLogging(boolean verboseLogging)` Return a new `BuildRequest` with an updated verbose logging setting.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - withBuilder
```
public BuildRequest withBuilder(ImageReference builder)
```
    Return a new BuildRequest with an updated builder.
    
    Parameters:
    
    builder - the new builder to use
    
    Returns:
    
    an updated build request
  - withRunImage
```
public BuildRequest withRunImage(ImageReference runImageName)
```
    Return a new BuildRequest with an updated run image.
    
    Parameters:
    
    runImageName - the run image to use
    
    Returns:
    
    an updated build request
  - withCreator
```
public BuildRequest withCreator(Creator creator)
```
    Return a new BuildRequest with an updated creator.
    
    Parameters:
    
    creator - the new Creator to use
    
    Returns:
    
    an updated build request
  - withEnv
```
public BuildRequest withEnv(String name,
                            String value)
```
    Return a new BuildRequest with an additional env variable.
    
    Parameters:
    
    name - the variable name
    
    value - the variable value
    
    Returns:
    
    an updated build request
  - withEnv
```
public BuildRequest withEnv(Map<String,String> env)
```
    Return a new BuildRequest with additional env variables.
    
    Parameters:
    
    env - the additional variables
    
    Returns:
    
    an updated build request
  - withCleanCache
```
public BuildRequest withCleanCache(boolean cleanCache)
```
    Return a new BuildRequest with an updated clean cache setting.
    
    Parameters:
    
    cleanCache - if the cache should be cleaned
    
    Returns:
    
    an updated build request
  - withVerboseLogging
```
public BuildRequest withVerboseLogging(boolean verboseLogging)
```
    Return a new BuildRequest with an updated verbose logging setting.
    
    Parameters:
    
    verboseLogging - if verbose logging should be used
    
    Returns:
    
    an updated build request
  - withPullPolicy
```
public BuildRequest withPullPolicy(PullPolicy pullPolicy)
```
    Return a new BuildRequest with the updated image pull policy.
    
    Parameters:
    
    pullPolicy - image pull policy PullPolicy
    
    Returns:
    
    an updated build request
  - withPublish
```
public BuildRequest withPublish(boolean publish)
```
    Return a new BuildRequest with an updated publish setting.
    
    Parameters:
    
    publish - if the built image should be pushed to a registry
    
    Returns:
    
    an updated build request
  - withBuildpacks
```
public BuildRequest withBuildpacks(BuildpackReference... buildpacks)
```
    Return a new BuildRequest with an updated buildpacks setting.
    
    Parameters:
    
    buildpacks - a collection of buildpacks to use when building the image
    
    Returns:
    
    an updated build request
    
    Since:
    
    2.5.0
  - withBuildpacks
```
public BuildRequest withBuildpacks(List<BuildpackReference> buildpacks)
```
    Return a new BuildRequest with an updated buildpacks setting.
    
    Parameters:
    
    buildpacks - a collection of buildpacks to use when building the image
    
    Returns:
    
    an updated build request
    
    Since:
    
    2.5.0
  - withBindings
```
public BuildRequest withBindings(Binding... bindings)
```
    Return a new BuildRequest with updated bindings.
    
    Parameters:
    
    bindings - a collection of bindings to mount to the build container
    
    Returns:
    
    an updated build request
    
    Since:
    
    2.5.0
  - withBindings
```
public BuildRequest withBindings(List<Binding> bindings)
```
    Return a new BuildRequest with updated bindings.
    
    Parameters:
    
    bindings - a collection of bindings to mount to the build container
    
    Returns:
    
    an updated build request
    
    Since:
    
    2.5.0
  - withNetwork
```
public BuildRequest withNetwork(String network)
```
    Return a new BuildRequest with an updated network setting.
    
    Parameters:
    
    network - the network the build container will connect to
    
    Returns:
    
    an updated build request
    
    Since:
    
    2.6.0
  - withTags
```
public BuildRequest withTags(ImageReference... tags)
```
    Return a new BuildRequest with updated tags.
    
    Parameters:
    
    tags - a collection of tags to be created for the built image
    
    Returns:
    
    an updated build request
  - withTags
```
public BuildRequest withTags(List<ImageReference> tags)
```
    Return a new BuildRequest with updated tags.
    
    Parameters:
    
    tags - a collection of tags to be created for the built image
    
    Returns:
    
    an updated build request
  - withBuildCache
```
public BuildRequest withBuildCache(Cache buildCache)
```
    Return a new BuildRequest with an updated build cache.
    
    Parameters:
    
    buildCache - the build cache
    
    Returns:
    
    an updated build request
  - withLaunchCache
```
public BuildRequest withLaunchCache(Cache launchCache)
```
    Return a new BuildRequest with an updated launch cache.
    
    Parameters:
    
    launchCache - the cache
    
    Returns:
    
    an updated build request
  - getName
```
public ImageReference getName()
```
    Return the name of the image that should be created.
    
    Returns:
    
    the name of the image
  - getApplicationContent
```
public TarArchive getApplicationContent(Owner owner)
```
    Return a TarArchive containing the application content that the buildpack should package. This is typically the contents of the Jar.
    
    Parameters:
    
    owner - the owner of the tar entries
    
    Returns:
    
    the application content
    
    See Also:
    
    TarArchive.fromZip(File, Owner)
  - getBuilder
```
public ImageReference getBuilder()
```
    Return the builder that should be used.
    
    Returns:
    
    the builder to use
  - getRunImage
```
public ImageReference getRunImage()
```
    Return the run image that should be used, if provided.
    
    Returns:
    
    the run image
  - getCreator
```
public Creator getCreator()
```
    Return the Creator the builder should use.
    
    Returns:
    
    the Creator
  - getEnv
```
public Map<String,String> getEnv()
```
    Return any env variable that should be passed to the builder.
    
    Returns:
    
    the builder env
  - isCleanCache
```
public boolean isCleanCache()
```
    Return if caches should be cleaned before packaging.
    
    Returns:
    
    if caches should be cleaned
  - isVerboseLogging
```
public boolean isVerboseLogging()
```
    Return if verbose logging output should be used.
    
    Returns:
    
    if verbose logging should be used
  - isPublish
```
public boolean isPublish()
```
    Return if the built image should be pushed to a registry.
    
    Returns:
    
    if the built image should be pushed to a registry
  - getPullPolicy
```
public PullPolicy getPullPolicy()
```
    Return the image PullPolicy that the builder should use.
    
    Returns:
    
    image pull policy
  - getBuildpacks
```
public List<BuildpackReference> getBuildpacks()
```
    Return the collection of buildpacks to use when building the image, if provided.
    
    Returns:
    
    the buildpacks
  - getBindings
```
public List<Binding> getBindings()
```
    Return the collection of bindings to mount to the build container.
    
    Returns:
    
    the bindings
    
    Since:
    
    2.5.0
  - getNetwork
```
public String getNetwork()
```
    Return the network the build container will connect to.
    
    Returns:
    
    the network
    
    Since:
    
    2.6.0
  - getTags
```
public List<ImageReference> getTags()
```
    Return the collection of tags that should be created.
    
    Returns:
    
    the tags
  - getBuildCache
```
public Cache getBuildCache()
```
    Return the custom build cache that should be used by the lifecycle.
    
    Returns:
    
    the build cache
  - getLaunchCache
```
public Cache getLaunchCache()
```
    Return the custom launch cache that should be used by the lifecycle.
    
    Returns:
    
    the launch cache
  - forJarFile
```
public static BuildRequest forJarFile(File jarFile)
```
    Factory method to create a new BuildRequest from a JAR file.
    
    Parameters:
    
    jarFile - the source jar file
    
    Returns:
    
    a new build request instance
  - forJarFile
```
public static BuildRequest forJarFile(ImageReference name,
                                      File jarFile)
```
    Factory method to create a new BuildRequest from a JAR file.
    
    Parameters:
    
    name - the name of the image that should be created
    
    jarFile - the source jar file
    
    Returns:
    
    a new build request instance
  - of
```
public static BuildRequest of(ImageReference name,
                              Function<Owner,TarArchive> applicationContent)
```
    Factory method to create a new BuildRequest with specific content.
    
    Parameters:
    
    name - the name of the image that should be created
    
    applicationContent - function to provide the application content
    
    Returns:
    
    a new build request instance

Class BuildRequest

Method Summary

Methods inherited from class java.lang.Object

Method Detail

withBuilder

withRunImage

withCreator

withEnv

withEnv

withCleanCache

withVerboseLogging

withPullPolicy

withPublish

withBuildpacks

withBuildpacks

withBindings

withBindings

withNetwork

withTags

withTags

withBuildCache

withLaunchCache

getName

getApplicationContent

getBuilder

getRunImage

getCreator

getEnv

isCleanCache

isVerboseLogging

isPublish

getPullPolicy

getBuildpacks

getBindings

getNetwork

getTags

getBuildCache

getLaunchCache

forJarFile

forJarFile

of