开发你的第一个spring boot应用

让我们在Java中开发一个简单的“Hello World！”Web应用程序，突出一些Spring Boot的主要特性。 我们将使用Maven来构建这个项目，因为大多数IDE支持它。

spring.io网站包含许多使用Spring Boot的“入门”指南。 如果你想解决一个特定的问题; 请先检查。 您可以通过转到start.spring.io并从依赖关系搜索器中选择Web启动器来快速执行以下步骤。 这将自动生成一个新的项目结构，以便您可以开始编码的方式。 有关更多详细信息，请参阅文档。

在开始之前,请先检查是否安装了java喝maven得有效版本

    $ java -version
    java version "1.7.0_51"
    Java(TM) SE Runtime Environment (build 1.7.0_51-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 24.51-b03, mixed mode)

    $ mvn -v
    Apache Maven 3.2.3 (33f8c3e1027c3ddde99d3cdebad2656a31e8fdf4; 2014-08-11T13:58:10-07:00)
    Maven home: /Users/user/tools/apache-maven-3.1.1
    Java version: 1.7.0_51, vendor: Oracle Corporation

此示例需要在其自己的文件夹中创建。 后续说明假定您已创建了一个合适的文件夹，并且它是您的“当前目录”。

创建pom.xml文件

我们需要从创建一个Maven pom.xml文件开始。 pom.xml是将用于构建项目的配方。 打开你喜欢的文本编辑器并添加以下内容：

    <?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>

        <groupId>com.example</groupId>
        <artifactId>myproject</artifactId>
        <version>0.0.1-SNAPSHOT</version>

        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.0.0.BUILD-SNAPSHOT</version>
        </parent>

        <!-- 在此处添加其他行... -->

        <!-- (如果你需要.RELEASE版本,你不需要添加下面的内容) -->
        <repositories>
            <repository>
                <id>spring-snapshots</id>
                <url>http://repo.spring.io/snapshot</url>
                <snapshots><enabled>true</enabled></snapshots>
            </repository>
            <repository>
                <id>spring-milestones</id>
                <url>http://repo.spring.io/milestone</url>
            </repository>
        </repositories>
        <pluginRepositories>
            <pluginRepository>
                <id>spring-snapshots</id>
                <url>http://repo.spring.io/snapshot</url>
            </pluginRepository>
            <pluginRepository>
                <id>spring-milestones</id>
                <url>http://repo.spring.io/milestone</url>
            </pluginRepository>
        </pluginRepositories>
    </project>

这应该给你一个工作的构建，你可以通过运行mvn package（可以忽略“jar will be empty - no content was marked for inclusion!”警告）测试它。

此时，您可以将项目导入到IDE中（最新的Java IDE包括对Maven的内置支持）。 为了简单起见，我们将继续为此示例使用纯文本编辑器。

添加classpath依赖

Spring Boot提供了许多"Starters"，使得容易将jar添加到classpath.我们的示例应用程序已经在pom的扶文件中使用spring-boot-starter-parent.spring-boot-starter-parent是一个特殊的启动器,提供了有用的Maven默认值.它还提供了依赖管理管理部分,以便你可以省略"blessed"依赖关系的版本标签

其他“Starters”只是提供了在开发特定类型的应用程序时可能需要的依赖关系。由于我们正在开发一个Web应用程序，我们将添加一个spring-boot-starter-web依赖关系 - 但在此之前，让我们看看我们目前有什么。

    $ mvn dependency:tree

    [INFO] com.example:myproject:jar:0.0.1-SNAPSHOT

mvn dependency：tree可以命令打印项目依赖关系树。你可以看到,spring-boot-starter-parent本身不提供依赖关系.让我妈编辑我们的pom.xml，并在parent部分的下面添加spring-boot-starter-web依赖关系:

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

再次运行mvn dependency：tree，将看到现在还有许多其他依赖项，包括Tomcat Web服务器和Spring Boot本身。

编码

为了完成我们的应用程序，我们需要创建一个单一的Java文件。 Maven将默认从src/main/java编译源代码，所以你需要创建该文件夹结构，然后添加一个名为src/main/java/Example.java的文件：

    import org.springframework.boot.*;
    import org.springframework.boot.autoconfigure.*;
    import org.springframework.stereotype.*;
    import org.springframework.web.bind.annotation.*;

    @RestController
    @EnableAutoConfiguration
    public class Example {

        @RequestMapping("/")
        String home() {
            return "Hello World!";
        }

        public static void main(String[] args) throws Exception {
            SpringApplication.run(Example.class, args);
        }

    }

@RestController和 @RequestMapping注解

我们的Example类的第一个注解是@RestController。这被称为构造型注解。 它为阅读代码的人提供了提示，对于Spring，该类扮演了一个特定的角色。 在这种情况下，我们的类是一个web @Controller，因此Spring会在处理传入的Web请求时处理它。

@RequestMapping注解提供了“路由”信息。 它告诉Spring任何带有路径“/”的HTTP请求应该映射到home方法。 @RestController注解告诉Spring将生成的字符串直接呈现给调用者。

@EnableAutoConfiguration注解

第二个类级别注释是@EnableAutoConfiguration。这个注解告诉Spring Boot“猜测”你会基于你添加的jar依赖如何配置Spring。由于spring-boot-starter-web添加了tomcat和spring mvc，因此自动配置将假定你正在开发一个web应用程序并相应地配置Spring.

starter和Auto-Configuration

自动配置旨在与“Starters(启动器)”配合使用，但这两个概念并不直接绑定。 你可以自由选择和选择启动器以外的jar依赖，Spring Boot仍将尽力自动配置您的应用程序。

main方法

这只是一个遵循Java约定的应用程序入口点的标准方法。我们的main方法通过调用run来委托Spring Boot的SpringApplication类.SpringApplication将引导我们的应用程序启动Spring,从而启动自动配置的tomca web服务器.我们需要传递Example.class作为run方法的参数来告诉SpringApplication是主要的Spring组件.args数组也被传递以暴露任何命令行参数.

运行例子

由于我们使用了spring-boot-starter-parent POM，因此我们有一个有用的运行目标，可以用来启动应用程序。 输入mvn spring-boot：run从项目根目录运行以启动应用程序：

    $ mvn spring-boot:run

      .   ____          _            __ _ _
     /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
    ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
     \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
      '  |____| .__|_| |_|_| |_\__, | / / / /
     =========|_|==============|___/=/_/_/_/
     :: Spring Boot ::  (v2.0.0.BUILD-SNAPSHOT)
    ....... . . .
    ....... . . . (log output here)
    ....... . . .
    ........ Started Example in 2.222 seconds (JVM running for 6.514)

如果打开Web浏览器到localhost：8080，您应该会看到以下输出：

    Hello World!

要正常退出应用程序，请按ctrl-c。

创建可执行jar

让我们完成我们的例子，创建一个完全自包含的可执行jar文件，我们可以在生产中运行。 可执行jar（有时称为“fat jar”）是包含您编译的类以及代码需要运行的所有jar依赖性的存档。

可执行jar和Java Java不提供任何标准方法来加载嵌套的jar文件（即自己包含在jar中的jar文件）。 如果你想分发一个自包含的应用程序，这可能是有问题的。为了解决这个问题，许多开发人员使用“uber”jar。uber jar简单的将所有类从所有的jar中归一到一个单一的地方。这种方法的问题是,很难看到你实际上的应用程序中使用哪些库.如果在多个jar钟使用相同的文件名(但是具有不同的内容),它也可能是有问题的 Spring Boot采用不同的方法，并允许您直接嵌套JAR。

要创建可执行的jar，我们需要将spring-boot-maven-plugin添加到我们的pom.xml中。 在dependencies部分下面插入以下行：

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

spring-boot-starter-parent POM包括配置以绑定repackage目标。 如果您不使用父POM，您将需要自己声明此配置。 有关详细信息，请参阅插件文档。

保存pom.xml文件并运行mvn package

    $ mvn package

    [INFO] Scanning for projects...
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building myproject 0.0.1-SNAPSHOT
    [INFO] ------------------------------------------------------------------------
    [INFO] .... ..
    [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
    [INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
    [INFO]
    [INFO] --- spring-boot-maven-plugin:2.0.0.BUILD-SNAPSHOT:repackage (default) @ myproject ---
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------

如果你在目标目录中，你应该看到myproject-0.0.1-SNAPSHOT.jar。 文件大小应为10 Mb。 如果你想看里面，可以使用jar tvf：

    $ jar tvf target/myproject-0.0.1-SNAPSHOT.jar

您还应该在目标目录中看到一个名为myproject-0.0.1-SNAPSHOT.jar.original的文件。 这是Maven在Spring Boot重新打包之前创建的原始jar文件。

要运行该应用程序，请使用java -jar命令：

    $ java -jar target/myproject-0.0.1-SNAPSHOT.jar

      .   ____          _            __ _ _
     /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
    ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
     \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
      '  |____| .__|_| |_|_| |_\__, | / / / /
     =========|_|==============|___/=/_/_/_/
     :: Spring Boot ::  (v2.0.0.BUILD-SNAPSHOT)
    ....... . . .
    ....... . . . (log output here)
    ....... . . .
    ........ Started Example in 2.536 seconds (JVM running for 2.864)

和以前一样，要正常退出应用程序，点击ctrl-c。