This commit is contained in:
Stephane Nicoll
2016-01-12 14:54:22 +01:00
parent e720ac8e64
commit 9ea01d9424

View File

@@ -9,9 +9,7 @@ configure the project to generate and endpoints that you can use via plain HTTP.
Spring Initializr also exposes an endpoint that serves its Spring Initializr also exposes an endpoint that serves its
{wiki}/Metadata-format[meta-data] in a well-known format to allow third-party {wiki}/Metadata-format[meta-data] in a well-known format to allow third-party
clients to provide the necessary assistance. {boot-doc}/#cli-init[Spring Boot CLI] is clients to provide the necessary assistance.
using this mechanism to offer a command-line project generator; STS uses it in a similar
way to offer a project creation wizard.
Finally, Initializr offers a configuration structure to define all the aspects related Finally, Initializr offers a configuration structure to define all the aspects related
to the project to generate: list of dependencies, supported java and boot versions, etc. Check to the project to generate: list of dependencies, supported java and boot versions, etc. Check
@@ -21,14 +19,20 @@ configuration is {wiki}/Configuration-format[also described in details on the wi
NOTE: We use the continuous deployment technique to manage our instance; check the NOTE: We use the continuous deployment technique to manage our instance; check the
link:CHANGELOG.adoc[changelog] for an overview of changes link:CHANGELOG.adoc[changelog] for an overview of changes
== Generating a project == Supported interfaces
There are many ways you can use to generate a project using Spring Initializr. You can Spring Initializr can be used as follows:
obviously use the https://start.spring.io[embedded web UI] available from the root
context. Recent versions of STS provide a wizard to assist you in the creation * With your browser (i.e. link:https://start.spring.io[])
of your new project. As from Spring Boot 1.2, the CLI has an `init` command to create * In your IDE if you are using STS or IntelliJ IDEA
a new project from the command-line. Using the <<meta-data,meta-data>>, one can easily create * On the command-line with {boot-doc}/#cli-init[the Spring Boot CLI] or simply with [cURL] or [HTTPie]
its own client.
[TIP]
====
You can "curl" an instance to get a usage page with examples (try `curl start.spring.io`)
====
== Generating a project
If you click on "Generate Project" on the web ui of our instance, it will download a project If you click on "Generate Project" on the web ui of our instance, it will download a project
archive with a Maven-based project and the necessary infrastructure to start a basic Spring archive with a Maven-based project and the necessary infrastructure to start a basic Spring
@@ -41,7 +45,8 @@ You could achieve the same result with a simple `curl` command
$ curl https://start.spring.io/starter.zip -o demo.zip $ curl https://start.spring.io/starter.zip -o demo.zip
---- ----
The following request attributes are supported: The web ui exposes a bunch of options that you can configure. These are mapped to the following
request attributes:
* Basic information for the generated project: `groupId`, `artifactId`, `version`, `name`, * Basic information for the generated project: `groupId`, `artifactId`, `version`, `name`,
`description` and `packageName` `description` and `packageName`