io.micronaut.runtime

Class Micronaut

java.lang.Object

io.micronaut.context.DefaultApplicationContextBuilder

io.micronaut.runtime.Micronaut

All Implemented Interfaces:

ApplicationContextBuilder, ApplicationContextConfiguration, BeanContextConfiguration

public class Micronaut
extends DefaultApplicationContextBuilder
implements ApplicationContextBuilder

Main entry point for running a Micronaut application.

Since:

1.0

Author:

Graeme Rocher

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Micronaut() The default constructor.

Method Summary

Modifier and Type	Method and Description
Micronaut	args(String... args) Set the command line arguments.
Micronaut	banner(boolean isEnabled) Whether the banner is enabled or not.
static Micronaut	build(String... args) Run the application for the given arguments.
Micronaut	classes(Class... classes) Add classes to be included in the initialization of the application.
Micronaut	classLoader(ClassLoader classLoader) The class loader to be used.
Micronaut	defaultEnvironments(String... environments) The environments to use if no other environments are specified.
Micronaut	environmentPropertySource(boolean environmentPropertySource) Set whether environment variables should contribute to configuration.
Micronaut	environments(String... environments) The environments to use.
Micronaut	environmentVariableExcludes(String... environmentVariables) Which environment variables should not contribute to configuration.
Micronaut	environmentVariableIncludes(String... environmentVariables) Which environment variables should contribute to configuration.
Micronaut	exclude(String... configurations) Allow customizing the configurations that will be loaded.
protected void	handleStartupException(Environment environment, Throwable exception) Default handling of startup exceptions.
Micronaut	include(String... configurations) Allow customizing the configurations that will be loaded.
Micronaut	mainClass(Class mainClass) The main class used by this application.
<T extends Throwable> Micronaut	mapError(Class<T> exception, Function<T,Integer> mapper) Maps an exception to the given error code.
Micronaut	packages(String... packages) The packages to include for package scanning.
Micronaut	properties(Map<String,Object> properties) Properties to override from the environment.
Micronaut	propertySources(PropertySource... propertySources) Additional property sources.
static ApplicationContext	run(Class[] classes, String... args) Run the application for the given arguments.
static ApplicationContext	run(Class cls, String... args) Run the application for the given arguments.
static ApplicationContext	run(String... args) Run the application for the given arguments.
Micronaut	singletons(Object... beans) Additional singletons to register prior to startup.
ApplicationContext	start() Starts the ApplicationContext.

Methods inherited from class io.micronaut.context.DefaultApplicationContextBuilder

allowEmptyProviders, bootstrapEnvironment, build, deduceEnvironment, eagerInitAnnotated, enableDefaultPropertySources, getClassLoader, getDeduceEnvironments, getDefaultEnvironments, getEagerInitAnnotated, getEnvironments, getEnvironmentVariableExcludes, getEnvironmentVariableIncludes, getOverrideConfigLocations, getResourceLoader, isAllowEmptyProviders, isBannerEnabled, isBootstrapEnvironmentEnabled, isEnableDefaultPropertySources, isEnvironmentPropertySource, newApplicationContext, overrideConfigLocations

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.context.ApplicationContextBuilder

allowEmptyProviders, bootstrapEnvironment, build, deduceEnvironment, eagerInitAnnotated, eagerInitConfiguration, eagerInitSingletons, enableDefaultPropertySources, overrideConfigLocations, run

Methods inherited from interface io.micronaut.context.ApplicationContextConfiguration

getConversionService

Methods inherited from interface io.micronaut.context.BeanContextConfiguration

isEagerInitConfiguration, isEagerInitSingletons

Constructor Detail

Micronaut

protected Micronaut()

The default constructor.

Method Detail

start

@NonNull
public ApplicationContext start()

Description copied from interface: ApplicationContextBuilder

Starts the ApplicationContext.

Specified by:

start in interface ApplicationContextBuilder

Returns:

Run this Micronaut

include

@NonNull
public Micronaut include(@Nullable
                                  String... configurations)

Description copied from class: DefaultApplicationContextBuilder

Allow customizing the configurations that will be loaded.

Specified by:

include in interface ApplicationContextBuilder

Overrides:

include in class DefaultApplicationContextBuilder

Parameters:

configurations - The configurations to include

Returns:

This application

exclude

@NonNull
public Micronaut exclude(@Nullable
                                  String... configurations)

Description copied from class: DefaultApplicationContextBuilder

Allow customizing the configurations that will be loaded.

Specified by:

exclude in interface ApplicationContextBuilder

Overrides:

exclude in class DefaultApplicationContextBuilder

Parameters:

configurations - The configurations to exclude

Returns:

This application

banner

@NonNull
public Micronaut banner(boolean isEnabled)

Description copied from interface: ApplicationContextBuilder

Whether the banner is enabled or not.

Specified by:

banner in interface ApplicationContextBuilder

Overrides:

banner in class DefaultApplicationContextBuilder

Parameters:

isEnabled - Whether the banner is enabled or not

Returns:

This application

classes

@NonNull
public Micronaut classes(@Nullable
                                  Class... classes)

Add classes to be included in the initialization of the application.

Parameters:

classes - The application

Returns:

The classes

properties

@NonNull
public Micronaut properties(@Nullable
                                     Map<String,Object> properties)

Description copied from interface: ApplicationContextBuilder

Properties to override from the environment.

Specified by:

properties in interface ApplicationContextBuilder

Overrides:

properties in class DefaultApplicationContextBuilder

Parameters:

properties - The properties

Returns:

This builder

singletons

@NonNull
public Micronaut singletons(Object... beans)

Description copied from interface: ApplicationContextBuilder

Additional singletons to register prior to startup.

Specified by:

singletons in interface ApplicationContextBuilder

Overrides:

singletons in class DefaultApplicationContextBuilder

Parameters:

beans - The beans

Returns:

This builder

propertySources

@NonNull
public Micronaut propertySources(@Nullable
                                          PropertySource... propertySources)

Description copied from interface: ApplicationContextBuilder

Additional property sources.

Specified by:

propertySources in interface ApplicationContextBuilder

Overrides:

propertySources in class DefaultApplicationContextBuilder

Parameters:

propertySources - The property sources to include

Returns:

This builder

environmentPropertySource

@NonNull
public Micronaut environmentPropertySource(boolean environmentPropertySource)

Description copied from interface: ApplicationContextBuilder

Set whether environment variables should contribute to configuration.

Specified by:

environmentPropertySource in interface ApplicationContextBuilder

Overrides:

environmentPropertySource in class DefaultApplicationContextBuilder

Parameters:

environmentPropertySource - The boolean

Returns:

This builder

environmentVariableIncludes

@NonNull
public Micronaut environmentVariableIncludes(@Nullable
                                                      String... environmentVariables)

Description copied from interface: ApplicationContextBuilder

Which environment variables should contribute to configuration.

Specified by:

environmentVariableIncludes in interface ApplicationContextBuilder

Overrides:

environmentVariableIncludes in class DefaultApplicationContextBuilder

Parameters:

environmentVariables - The environment variables

Returns:

This builder

environmentVariableExcludes

@NonNull
public Micronaut environmentVariableExcludes(@Nullable
                                                      String... environmentVariables)

Description copied from interface: ApplicationContextBuilder

Which environment variables should not contribute to configuration.

Specified by:

environmentVariableExcludes in interface ApplicationContextBuilder

Overrides:

environmentVariableExcludes in class DefaultApplicationContextBuilder

Parameters:

environmentVariables - The environment variables

Returns:

This builder

mainClass

@NonNull
public Micronaut mainClass(Class mainClass)

Description copied from interface: ApplicationContextBuilder

The main class used by this application.

Specified by:

mainClass in interface ApplicationContextBuilder

Overrides:

mainClass in class DefaultApplicationContextBuilder

Parameters:

mainClass - The main class

Returns:

This builder

classLoader

@NonNull
public Micronaut classLoader(ClassLoader classLoader)

Description copied from interface: ApplicationContextBuilder

The class loader to be used.

Specified by:

classLoader in interface ApplicationContextBuilder

Overrides:

classLoader in class DefaultApplicationContextBuilder

Parameters:

classLoader - The classloader

Returns:

This builder

args

@NonNull
public Micronaut args(@Nullable
                               String... args)

Description copied from interface: ApplicationContextBuilder

Set the command line arguments.

Specified by:

args in interface ApplicationContextBuilder

Overrides:

args in class DefaultApplicationContextBuilder

Parameters:

args - The arguments

Returns:

This application

environments

@NonNull
public Micronaut environments(@Nullable
                                       String... environments)

Description copied from interface: ApplicationContextBuilder

The environments to use.

Specified by:

environments in interface ApplicationContextBuilder

Overrides:

environments in class DefaultApplicationContextBuilder

Parameters:

environments - The environments

Returns:

This builder

defaultEnvironments

@NonNull
public Micronaut defaultEnvironments(@Nullable
                                              String... environments)

Description copied from interface: ApplicationContextBuilder

The environments to use if no other environments are specified.

Specified by:

defaultEnvironments in interface ApplicationContextBuilder

Overrides:

defaultEnvironments in class DefaultApplicationContextBuilder

Parameters:

environments - The environments

Returns:

This builder

packages

@NonNull
public Micronaut packages(@Nullable
                                   String... packages)

Description copied from interface: ApplicationContextBuilder

The packages to include for package scanning.

Specified by:

packages in interface ApplicationContextBuilder

Overrides:

packages in class DefaultApplicationContextBuilder

Parameters:

packages - The packages

Returns:

This builder

mapError

public <T extends Throwable> Micronaut mapError(Class<T> exception,
                                                Function<T,Integer> mapper)

Maps an exception to the given error code.

Type Parameters:

T - The exception type

Parameters:

exception - The exception

mapper - The mapper

Returns:

This application

build

public static Micronaut build(String... args)

Run the application for the given arguments. Classes for the application will be discovered automatically

Parameters:

args - The arguments

Returns:

The ApplicationContext

run

public static ApplicationContext run(String... args)

Run the application for the given arguments. Classes for the application will be discovered automatically

Parameters:

args - The arguments

Returns:

The ApplicationContext

run

public static ApplicationContext run(Class cls,
                                     String... args)

Run the application for the given arguments.

Parameters:

cls - The application class

args - The arguments

Returns:

The ApplicationContext

run

public static ApplicationContext run(Class[] classes,
                                     String... args)

Run the application for the given arguments.

Parameters:

classes - The application classes

args - The arguments

Returns:

The ApplicationContext

handleStartupException

protected void handleStartupException(Environment environment,
                                      Throwable exception)

Default handling of startup exceptions.

Parameters:

environment - The environment

exception - The exception

Throws:

ApplicationStartupException - If the server cannot be shutdown with an appropriate exist code