spring boot 第一个应用程序——迹忆客-ag捕鱼王app官网

本节介绍如何开发一个小的可以突出 spring boot 的一些关键特性的 web 应用程序。 我们使用 maven 来构建这个项目，因为大多数 ide 都支持它。

在我们开始之前，打开一个终端并运行以下命令以确保安装了有效版本的 java 和 maven：

$ java -version
openjdk version "11.0.12" 2021-07-20
openjdk runtime environment homebrew (build 11.0.12 0)
openjdk 64-bit server vm homebrew (build 11.0.12 0, mixed mode)

$ mvn -v
apache maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)
maven home: /users/jiyik/apache-maven-3.8.4
java version: 11.0.12, vendor: homebrew, runtime: /usr/local/cellar/openjdk@11/11.0.12/libexec/openjdk.jdk/contents/home
default locale: en_cn, platform encoding: utf-8
os name: "mac os x", version: "10.14.5", arch: "x86_64", family: "mac"

注意 ：此示例需要在其自己的目录中创建。 后续说明假定已经创建了一个合适的目录并且它是我们的当前目录。

创建 pom

首先我们使用 idea 创建一个 maven 项目

填写 groupid 和 artifactid

然后进行下一步，最后点击完成。这样我们一个基本的 maven 项目就创建完成了。

下面是一个基本的 maven 项目结构

项目创建完成了，我们需要编辑 maven pom.xml 文件。 pom.xml 是用于构建项目的配置文件。打开 pom.xml 添加如下内容

    4.0.0
    com.spring
    springbootproject
    1.0-snapshot
    
        org.springframework.boot
        spring-boot-starter-parent
        2.6.6
    
        

上面的配置知识给我们一个工作构建。 可以通过运行 mvn package 来测试

spring boot 提供了许多“启动器”，可让我们将 jars 添加到 classpath 中。 我们的冒烟测试(smoke test)应用程序使用 pom parent 部分中的 spring-boot-starter-parent 。 spring-boot-starter-parent 是一个特殊的启动器，它提供有用的 maven 默认值。 它还提供了dependency-management ，以便我们可以省略“blessed”依赖项的 version 标签。

其他“启动器”为我们提供了在开发特定类型的应用程序时可能需要的依赖项。 由于我们正在开发 web 应用程序，因此我们添加了 spring-boot-starter-web 依赖项。 在此之前，我们可以通过运行以下命令查看我们当前拥有的内容：

$ mvn dependency:tree
com.spring:springbootproject:jar:1.0-snapshot

mvn dependency:tree 命令打印项目依赖项的树形结构。 我们可以看到 spring-boot-starter-parent 本身不提供任何依赖项。 要添加必要的依赖项，需要编辑 pom.xml 并在 parent 部分的正下方添加 spring-boot-starter-web 依赖项：

    
        org.springframework.boot
        spring-boot-starter-web
    

如果再次运行 mvn dependency:tree，我们会看到现在有许多附加依赖项，包括 tomcat web 服务器和 spring boot 本身。

编写代码

为了完成我们的应用程序，我们需要创建一个 java 文件。 默认情况下，maven 从 src/main/java 编译源代码，因此我们先在该目录下新建一个 com.study 包。然后新建 myapplication.java 文件并包含以下代码：

@restcontroller
@enableautoconfiguration
public class myapplication {
    @requestmapping("/")
    string home() {
        return "hello 迹忆客(jiyik.com)!";
    }
    public static void main(string[] args) {
        springapplication.run(myapplication.class, args);
    }
}

虽然这里没有太多代码，但有很多事情正在发生。 我们将在接下来的几节中逐步介绍重要部分。

@restcontroller 和 @requestmapping 注解

myapplication 类的第一个注解是 @restcontroller 。 这称为构造型注释。 它为阅读代码的人和 spring 提供了类扮演特定角色的提示。 在这种情况下，我们的类是一个 web @controller ，所以 spring 在处理传入的 web 请求时会考虑它。

@requestmapping 注解提供“路由”信息。 它告诉 spring 任何带有 / 路径的 http 请求都应该映射到 home 方法。 @restcontroller 注解告诉 spring 将结果字符串直接呈现给调用者。

提示 ：@restcontroller 和 @requestmapping 注解是 spring mvc 注解（它们并不特定于 spring boot）。 有关详细信息，请参阅 spring 参考文档中的 mvc 部分 。

@enableautoconfiguration 注解

第二个类级别的注解是 @enableautoconfiguration 。 这个注解告诉 spring boot 根据你添加的 jar 依赖来“猜测”你想如何配置 spring。 由于 spring-boot-starter-web 添加了 tomcat 和 spring mvc，因此自动配置假定我们正在开发 web 应用程序并相应地设置 spring。

启动器和自动配置 : 自动配置旨在与“启动器”很好地配合使用，但这两个概念没有直接联系。 我们可以自由选择启动器之外的 jar 依赖项。 spring boot 仍然尽力自动配置我们的应用程序。

main 方法

我们应用程序的最后一部分是 main 方法。 这是一种遵循应用程序入口点的 java 约定的标准方法。 我们的 main 方法通过调用 run 委托给 spring boot 的 springapplication 类。 springapplication 引导我们的应用程序，启动 spring，然后启动自动配置的 tomcat web 服务器。 我们需要将 myapplication.class 作为参数传递给 run 方法来告诉 springapplication 哪个是主要的 spring 组件。 args 数组也被传递以公开任何命令行参数。

运行应用程序

此时，我们的应用程序应该可以工作了。使用 idea 来运行程序，点击右上角的运行按钮，启动结果如下所示

出现上面结果说明应用程序启动成功了。

如果我们打开浏览器访问 localhost:8080 ，应该会看到以下输出：

或者我们也可以在项目根目录下运行下面的maven命令来运行程序

$ mvn spring-boot:run

创建 jar 包

我们通过创建一个可以在生产中运行的完全独立的可执行 jar 文件来完成我们的示例。 可执行 jars（有时称为“fat jars”）是包含已编译类以及代码需要运行的所有 jar 依赖项的存档。

java 不提供加载嵌套 jar 文件（本身包含在 jar 中的 jar 文件）的标准方法。 如果你希望分发一个独立的应用程序，这可能会出现问题。 为了解决这个问题，许多开发人员使用“uber” jars 。 一个 uber jar 将所有应用程序依赖项中的所有类打包到一个存档中。 这种方法的问题是很难看到应用程序中有哪些库。 如果在多个 jar 中使用相同的文件名（但内容不同），也可能会出现问题。 spring boot 采用了不同的方法，让你实际上可以直接嵌套 jar。

要创建一个可执行的 jar，我们需要将 spring-boot-maven-plugin 添加到我们的 pom.xml 中。 为此，请在依赖项部分下方插入以下行：

    
        
            org.springframework.boot
            spring-boot-maven-plugin
        
    

注意 ：spring-boot-starter-parent pom 包含 配置以绑定 repackage goal 。 如果不使用 parent pom，则需要自己声明此配置。

保存 pom.xml 并从命令行运行 mvn package，如下所示：

$ mvn package
[info] scanning for projects...
[info]
[info] --------------------< com.spring:springbootproject >--------------------
[info] building springbootproject 1.0-snapshot
[info] --------------------------------[ jar ]---------------------------------
[info]
[info] --- maven-resources-plugin:3.2.0:resources (default-resources) @ springbootproject ---
[info] using 'utf-8' encoding to copy filtered resources.
[info] using 'utf-8' encoding to copy filtered properties files.
[info] copying 0 resource
[info] copying 0 resource
[info]
[info] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ springbootproject ---
[info] nothing to compile - all classes are up to date
[info]
[info] --- maven-resources-plugin:3.2.0:testresources (default-testresources) @ springbootproject ---
[info] using 'utf-8' encoding to copy filtered resources.
[info] using 'utf-8' encoding to copy filtered properties files.
[info] skip non existing resourcedirectory /users/jiyik/workspace/java/springbootproject/src/test/resources
[info]
[info] --- maven-compiler-plugin:3.8.1:testcompile (default-testcompile) @ springbootproject ---
[info] nothing to compile - all classes are up to date
[info]
[info] --- maven-surefire-plugin:2.22.2:test (default-test) @ springbootproject ---
[info]
[info] --- maven-jar-plugin:3.2.2:jar (default-jar) @ springbootproject ---
[info] building jar: /users/jiyik/workspace/java/springbootproject/target/springbootproject-1.0-snapshot.jar
[info]
[info] --- spring-boot-maven-plugin:2.6.6:repackage (repackage) @ springbootproject ---
[info] replacing main artifact with repackaged archive
[info] ------------------------------------------------------------------------
[info] build success
[info] ------------------------------------------------------------------------
[info] total time:  2.180 s
[info] finished at: 2022-04-21t21:57:46 08:00
[info] ------------------------------------------------------------------------
[warning] the requested profile "test" could not be activated because it does not exist.

查看 target 目录，我们应该会看到 springbootproject-0.0.1-snapshot.jar 。 该文件的大小应约为 10 mb。 如果想看里面，可以使用jar tvf，如下：

$ jar tvf target/springbootproject-0.0.1-snapshot.jar

要运行该应用程序，需要使用 java -jar 命令，如下所示：

$ java -jar springbootproject-0.0.1-snapshot.jar
 .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: spring boot ::                (v2.6.6)
2022-04-21 22:02:05.235  info 5030 --- [           main] com.study.myapplication                  : starting myapplication v1.0-snapshot using java 11.0.12 on 迹忆客 with pid 503