spring-boot:run

Full name:

org.springframework.boot:spring-boot-maven-plugin:1.1.0.M1:run

Description:

Run an executable archive application.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Since version: 1.1.
  • Binds by default to the lifecycle phase: validate.
  • Invokes the execution of the lifecycle phase test-compile prior to executing itself.

Required Parameters

Name Type Since Description
classesDirectory File 1.0 Directory containing the classes and resource files that should be packaged into the archive.
Default value is: ${project.build.outputDirectory}.

Optional Parameters

Name Type Since Description
addResources boolean 1.0 Add maven resources to the classpath directly, this allows live in-place editing or resources. Since resources will be added directly, and via the target/classes folder they will appear twice if ClassLoader.getResources() is called. In practice, however, most applications call ClassLoader.getResource() which will always return the first resource.
Default value is: true.
User property is: run.addResources.
agent File[] 1.0 Path to agent jar.
User property is: run.agent.
arguments String[] 1.0 Arguments that should be passed to the application. On command line use commas to separate multiple arguments.
User property is: run.arguments.
excludeArtifactIds String 1.1 Comma separated list of artifact names to exclude.
User property is: excludeArtifactIds.
excludeGroupIds String 1.1 Comma separated list of groupId names to exclude.
User property is: excludeGroupIds.
excludes List 1.1 Collection of artifact definitions to exclude. The Exclude element defines a groupId and artifactId mandatory properties and an optional classifier property.
folders String[] 1.0 Additional folders besides the classes directory that should be added to the classpath.
mainClass String 1.0 The name of the main class. If not specified the first compiled class found that contains a 'main' method will be used.
noverify Boolean 1.0 Flag to say that the agent requires -noverify.
User property is: run.noverify.

Parameter Details

addResources:

Add maven resources to the classpath directly, this allows live in-place editing or resources. Since resources will be added directly, and via the target/classes folder they will appear twice if ClassLoader.getResources() is called. In practice, however, most applications call ClassLoader.getResource() which will always return the first resource.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • User Property: run.addResources
  • Default: true

agent:

Path to agent jar.
  • Type: java.io.File[]
  • Since: 1.0
  • Required: No
  • User Property: run.agent

arguments:

Arguments that should be passed to the application. On command line use commas to separate multiple arguments.
  • Type: java.lang.String[]
  • Since: 1.0
  • Required: No
  • User Property: run.arguments

classesDirectory:

Directory containing the classes and resource files that should be packaged into the archive.
  • Type: java.io.File
  • Since: 1.0
  • Required: Yes
  • Default: ${project.build.outputDirectory}

excludeArtifactIds:

Comma separated list of artifact names to exclude.
  • Type: java.lang.String
  • Since: 1.1
  • Required: No
  • User Property: excludeArtifactIds

excludeGroupIds:

Comma separated list of groupId names to exclude.
  • Type: java.lang.String
  • Since: 1.1
  • Required: No
  • User Property: excludeGroupIds

excludes:

Collection of artifact definitions to exclude. The Exclude element defines a groupId and artifactId mandatory properties and an optional classifier property.
  • Type: java.util.List
  • Since: 1.1
  • Required: No

folders:

Additional folders besides the classes directory that should be added to the classpath.
  • Type: java.lang.String[]
  • Since: 1.0
  • Required: No

mainClass:

The name of the main class. If not specified the first compiled class found that contains a 'main' method will be used.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No

noverify:

Flag to say that the agent requires -noverify.
  • Type: java.lang.Boolean
  • Since: 1.0
  • Required: No
  • User Property: run.noverify