org.springframework.boot.builder

Class SpringApplicationBuilder

java.lang.Object

org.springframework.boot.builder.SpringApplicationBuilder

public class SpringApplicationBuilder
extends Object

Builder for SpringApplication and ApplicationContext instances with convenient fluent API and context hierarchy support. Simple example of a context hierarchy:

 new SpringApplicationBuilder(ParentConfig.class).child(ChildConfig.class).run(args);
 

Another common use case is setting default arguments, e.g. active Spring profiles, to set up the environment for an application:

 new SpringApplicationBuilder(Application.class).profiles("server")
                .defaultArgs("--transport=local").run(args);
 

If your needs are simpler, consider using the static convenience methods in SpringApplication instead.

Author:

Dave Syer, Andy Wilkinson

Constructor Summary

Constructors

Constructor and Description
SpringApplicationBuilder(Object... sources)

Method Summary

Methods

Modifier and Type	Method and Description
SpringApplicationBuilder	addCommandLineProperties(boolean addCommandLineProperties) Flag to indicate that command line arguments should be added to the environment.
SpringApplication	application() Accessor for the current application.
SpringApplicationBuilder	banner(Banner banner) Sets the Banner instance which will be used to print the banner when no static banner file is provided.
SpringApplicationBuilder	beanNameGenerator(BeanNameGenerator beanNameGenerator) Bean name generator for automatically generated bean names in the application context.
SpringApplication	build() Returns a fully configured SpringApplication that is ready to run.
SpringApplicationBuilder	child(Object... sources) Create a child application with the provided sources.
ConfigurableApplicationContext	context() Accessor for the current application context.
SpringApplicationBuilder	contextClass(Class<? extends ConfigurableApplicationContext> cls) Explicitly set the context class to be used.
protected SpringApplication	createSpringApplication(Object... sources) Creates a new SpringApplication instances from the given sources.
SpringApplicationBuilder	environment(ConfigurableEnvironment environment) Environment for the application context.
SpringApplicationBuilder	headless(boolean headless) Sets if the application is headless and should not instantiate AWT.
SpringApplicationBuilder	initializers(ApplicationContextInitializer<?>... initializers) Add some initializers to the application (applied to the ApplicationContext before any bean definitions are loaded).
SpringApplicationBuilder	listeners(ApplicationListener<?>... listeners) Add some listeners to the application (listening for SpringApplication events as well as regular Spring events once the context is running).
SpringApplicationBuilder	logStartupInfo(boolean logStartupInfo) Flag to indicate the startup information should be logged.
SpringApplicationBuilder	main(Class<?> mainApplicationClass) Fixes the main application class that is used to anchor the startup messages.
SpringApplicationBuilder	parent(ConfigurableApplicationContext parent) Add an already running parent context to an existing application.
SpringApplicationBuilder	parent(Object... sources) Add a parent application with the provided sources.
SpringApplicationBuilder	profiles(String... profiles) Add to the active Spring profiles for this app (and its parent and children).
SpringApplicationBuilder	properties(Map<String,Object> defaults) Default properties for the environment.
SpringApplicationBuilder	properties(Properties defaultProperties) Default properties for the environment in the form key=value or key:value.
SpringApplicationBuilder	properties(String... defaultProperties) Default properties for the environment in the form key=value or key:value.
SpringApplicationBuilder	registerShutdownHook(boolean registerShutdownHook) Sets if the created ApplicationContext should have a shutdown hook registered.
SpringApplicationBuilder	resourceLoader(ResourceLoader resourceLoader) ResourceLoader for the application context.
ConfigurableApplicationContext	run(String... args) Create an application context (and its parent if specified) with the command line args provided.
SpringApplicationBuilder	showBanner(boolean showBanner) Flag to indicate the startup banner should be printed.
SpringApplicationBuilder	sibling(Object... sources) Create a sibling application (one with the same parent).
SpringApplicationBuilder	sibling(Object[] sources, String... args) Create a sibling application (one with the same parent).
SpringApplicationBuilder	sources(Class<?>... sources) Add more sources (configuration classes and components) to this application
SpringApplicationBuilder	sources(Object... sources) Add more sources to use in this application.
SpringApplicationBuilder	web(boolean webEnvironment) Flag to explicitly request a web or non-web environment (auto detected based on classpath if not set).

Methods inherited from class java.lang.Object

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

Constructor Detail

SpringApplicationBuilder

public SpringApplicationBuilder(Object... sources)

Method Detail

createSpringApplication

protected SpringApplication createSpringApplication(Object... sources)

Creates a new SpringApplication instances from the given sources. Subclasses may override in order to provide a custom subclass of SpringApplication

Parameters:

sources - The sources

Returns:

The SpringApplication instance

Since:

1.1.0

context

public ConfigurableApplicationContext context()

Accessor for the current application context.

Returns:

the current application context (or null if not yet running)

application

public SpringApplication application()

Accessor for the current application.

Returns:

the current application (never null)

run

public ConfigurableApplicationContext run(String... args)

Create an application context (and its parent if specified) with the command line args provided. The parent is run first with the same arguments if has not yet been started.

Parameters:

args - the command line arguments

Returns:

an application context created from the current state

build

public SpringApplication build()

Returns a fully configured SpringApplication that is ready to run.

Returns:

the fully configured SpringApplication.

child

public SpringApplicationBuilder child(Object... sources)

Create a child application with the provided sources. Default args and environment are copied down into the child, but everything else is a clean sheet.

Parameters:

sources - the sources for the application (Spring configuration)

Returns:

the child application builder

parent

public SpringApplicationBuilder parent(Object... sources)

Add a parent application with the provided sources. Default args and environment are copied up into the parent, but everything else is a clean sheet.

Parameters:

sources - the sources for the application (Spring configuration)

Returns:

the parent builder

parent

public SpringApplicationBuilder parent(ConfigurableApplicationContext parent)

Add an already running parent context to an existing application.

Parameters:

parent - the parent context

Returns:

the current builder (not the parent)

sibling

public SpringApplicationBuilder sibling(Object... sources)

Create a sibling application (one with the same parent). A side effect of calling this method is that the current application (and its parent) are started.

Parameters:

sources - the sources for the application (Spring configuration)

Returns:

the new sibling builder

sibling

public SpringApplicationBuilder sibling(Object[] sources,
                               String... args)

Create a sibling application (one with the same parent). A side effect of calling this method is that the current application (and its parent) are started if they are not already running.

Parameters:

sources - the sources for the application (Spring configuration)

args - the command line arguments to use when starting the current app and its parent

Returns:

the new sibling builder

contextClass

public SpringApplicationBuilder contextClass(Class<? extends ConfigurableApplicationContext> cls)

Explicitly set the context class to be used.

Parameters:

cls - the context class to use

Returns:

the current builder

sources

public SpringApplicationBuilder sources(Object... sources)

Add more sources to use in this application.

Parameters:

sources - the sources to add

Returns:

the current builder

sources

public SpringApplicationBuilder sources(Class<?>... sources)

Add more sources (configuration classes and components) to this application

Parameters:

sources - the sources to add

Returns:

the current builder

web

public SpringApplicationBuilder web(boolean webEnvironment)

Flag to explicitly request a web or non-web environment (auto detected based on classpath if not set).

Parameters:

webEnvironment - the flag to set

Returns:

the current builder

logStartupInfo

public SpringApplicationBuilder logStartupInfo(boolean logStartupInfo)

Flag to indicate the startup information should be logged.

Parameters:

logStartupInfo - the flag to set. Default true.

Returns:

the current builder

banner

public SpringApplicationBuilder banner(Banner banner)

Sets the Banner instance which will be used to print the banner when no static banner file is provided.

Parameters:

banner - The banner to use

Returns:

the current builder

showBanner

public SpringApplicationBuilder showBanner(boolean showBanner)

Flag to indicate the startup banner should be printed.

Parameters:

showBanner - the flag to set. Default true.

Returns:

the current builder

headless

public SpringApplicationBuilder headless(boolean headless)

Sets if the application is headless and should not instantiate AWT. Defaults to true to prevent java icons appearing.

Parameters:

headless - if the application is headless

Returns:

the current builder

registerShutdownHook

public SpringApplicationBuilder registerShutdownHook(boolean registerShutdownHook)

Sets if the created ApplicationContext should have a shutdown hook registered.

Parameters:

registerShutdownHook - if the shutdown hook should be registered

Returns:

the current builder

main

public SpringApplicationBuilder main(Class<?> mainApplicationClass)

Fixes the main application class that is used to anchor the startup messages.

Parameters:

mainApplicationClass - the class to use.

Returns:

the current builder

addCommandLineProperties

public SpringApplicationBuilder addCommandLineProperties(boolean addCommandLineProperties)

Flag to indicate that command line arguments should be added to the environment.

Parameters:

addCommandLineProperties - the flag to set. Default true.

Returns:

the current builder

properties

public SpringApplicationBuilder properties(String... defaultProperties)

Default properties for the environment in the form key=value or key:value.

Parameters:

defaultProperties - the properties to set.

Returns:

the current builder

properties

public SpringApplicationBuilder properties(Properties defaultProperties)

Default properties for the environment in the form key=value or key:value.

Parameters:

defaultProperties - the properties to set.

Returns:

the current builder

properties

public SpringApplicationBuilder properties(Map<String,Object> defaults)

Default properties for the environment. Multiple calls to this method are cumulative.

Parameters:

defaults - the default properties

Returns:

the current builder

See Also:

properties(String...)

profiles

public SpringApplicationBuilder profiles(String... profiles)

Add to the active Spring profiles for this app (and its parent and children).

Parameters:

profiles - the profiles to add.

Returns:

the current builder

beanNameGenerator

public SpringApplicationBuilder beanNameGenerator(BeanNameGenerator beanNameGenerator)

Bean name generator for automatically generated bean names in the application context.

Parameters:

beanNameGenerator - the generator to set.

Returns:

the current builder

environment

public SpringApplicationBuilder environment(ConfigurableEnvironment environment)

Environment for the application context.

Parameters:

environment - the environment to set.

Returns:

the current builder

resourceLoader

public SpringApplicationBuilder resourceLoader(ResourceLoader resourceLoader)

ResourceLoader for the application context. If a custom class loader is needed, this is where it would be added.

Parameters:

resourceLoader - the resource loader to set.

Returns:

the current builder

initializers

public SpringApplicationBuilder initializers(ApplicationContextInitializer<?>... initializers)

Add some initializers to the application (applied to the ApplicationContext before any bean definitions are loaded).

Parameters:

initializers - some initializers to add

Returns:

the current builder

listeners

public SpringApplicationBuilder listeners(ApplicationListener<?>... listeners)

Add some listeners to the application (listening for SpringApplication events as well as regular Spring events once the context is running). Any listeners that are also ApplicationContextInitializer will be added to the initializers automatically.

Parameters:

listeners - some listeners to add

Returns:

the current builder