SpringBoot_0 学习过程 最简springboot入门

入坑说明:前情提要

进入spring boot官网并使用360浏览器翻译插件翻译后,(所有斜体字都是自动翻译或者根据官网英语推测的)首先看到的就是标题Spring Boot参考指南,随后就是一堆作者和版权,作者名字很多,可惜一个都不认识,看下面的版权说明

本文件的副本可供您自己使用和分发给他人,前提是您不对此类副本收取任何费用,并且每份副本均包含本版权声明,无论是以印刷版还是电子版分发。

所以只要我不收费就可以随意查看和分享这份参考指南,真是太棒了!接下来是目录,第一部分主要讲解的是springboot的概述,没兴趣,直接第二部分,也就是getting started(翻译过来是入门)。

首先是介绍Spring Boot,翻译后的内容有些不通顺,所以修改了一下:

介绍Spring Boot

Spring Boot可以轻松的创建可独立运行的生产级的基于Spring的应用程序。我们对Spring平台和第三方库进行了一种通用的配置,这样您就可以轻松上手了。大多数Spring Boot应用程序只需要很少的Spring配置。

您可以使用Spring Boot创建Java应用程序 ,它可以使用java -jar或更传统的war包来部署启动。我们还提供了一个运行“spring scripts”的命令行工具。

我们的主要目标是:

为所有Spring开发提供从根本上更快且可广泛访问的入门方案。

开箱即用,随着需求开始而迅速摆脱困境。

提供大型项目(例如嵌入式服务器,安全性,度量标准,运行状况检查和外部化配置)通用的一系列非功能性特性。

绝对没有代码生成,也不需要XML配置。

好,我就信了你的鞋,只要看到xml配置的地方全部跳过。

系统要求

Spring Boot 2.1.6.RELEASE需要Java 8,并且与Java 11兼容(包括在内)。 还需要Spring Framework 5.1.8.RELEASE或更高版本。以下构建工具提供了显式构建支持:

Build ToolVersion

Maven3.3+

Gradle4.4+

Servlet容器   Spring Boot支持以下嵌入式servlet容器:

NameServlet Version

Tomcat 9.04.0

Jetty 9.43.1

Undertow 2.04.0

您还可以将Spring Boot应用程序部署到任何Servlet 3.1+兼容容器。

通常用到的是maven加Tomcat,这两个要好好学。

安装Spring Boot

Spring Boot可以与“通用”Java开发工具一起使用,也可以作为命令行工具安装。无论哪种方式,您都需要Java SDK v1.8或更高版本。在开始之前,您应该使用以下命令检查当前的Java安装:

$ java -version

如果您不熟悉Java开发,或者想要尝试Spring Boot,则可能需要先尝试Spring Boot CLI(命令行界面)。否则,请继续阅读“通用”安装说明。

这里必须说明一下,本次学习涉及范围不大,也不想拓宽其他知识,所以只使用通用的maven来说明如何安装,其他方式的安装也有介绍,包括最原始的方法直接导入jar包,也包括使用新的构建工具Gradle来安装,使用Spring Boot CLI命令行安装,SDKMAN安装,OSX Homebrew安装(Mac),MacPorts安装(Mac),Windows Scoop安装,以及如何从早期版本的Spring Boot升级到最新的版本里面都有一定的介绍,这些普通公司用的不多,初学者没时间也没精力去探险。

Maven安装

Spring Boot与Apache Maven 3.3或更高版本兼容。如果您还没有安装Maven,可以按照maven.apache.org上的说明进行操作。

在许多操作系统上,Maven可以与软件包管理器一起安装。如果您使用OSX Homebrew,请尝试brew install maven。Ubuntu用户可以运行sudo apt-get install maven。使用Chocolatey的 Windows用户可以使用命令choco install maven运行安装。

Spring Boot依赖项使用org.springframework.boot groupId。通常,您的Maven POM文件继承自spring-boot-starter-parent项目并声明对一个或多个“Starters”的依赖关系。Spring Boot还提供了一个可选的 Maven插件来创建可执行jar。

以下清单显示了一个典型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 https://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>

    <!-- 从springboot父模块中继承默认启动配置 -->

    <parent>

        <groupId>org.springframework.boot</groupId>

        <artifactId>spring-boot-starter-parent</artifactId>

        <version>2.1.6.RELEASE</version>

    </parent>

    <!-- 为网络程序添加基本依赖 -->

    <dependencies>

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

    </dependencies>

    <!-- 打包为可执行jar包 -->

    <build>

        <plugins>

            <plugin>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-maven-plugin</artifactId>

            </plugin>

        </plugins>

    </build>

</project>

这里导入的spring-boot-starter-parent父模块是使用Spring Boot的好方法,但它可能并不适合所有情况。有时您可能需要从不同的父POM继承,或者您可能不喜欢我们的默认设置。在这些情况下,请参见 第13.2.2节“使用没有父POM的Spring Boot”来获得使用import 范围的替代解决方案。

这里开始使用maven构建项目,如果不明白不要问,自己百度maven简单示例。

开发您的第一个Spring Boot应用程序

本节介绍如何开发一个简单的“Hello World!”Web应用程序,该应用程序突出了Spring Boot的一些主要功能。我们使用Maven来构建这个项目,因为大多数IDE都支持它。

在开始之前,打开终端并运行以下命令以确保安装了有效的Java和Maven版本:

$ java -version

java version "1.8.0_102"

Java(TM) SE Runtime Environment (build 1.8.0_102-b14)

Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)

$ mvn -v

Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-17T14:33:14-04:00)

Maven home: /usr/local/Cellar/maven/3.3.9/libexec

Java version: 1.8.0_102, vendor: Oracle Corporation

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

创建POM文件

我们需要从创建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 https://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.1.6.RELEASE</version>

    </parent>

    <!-- 当有其他pom内容需要添加时放到这里... -->

</project>

上面的内容应该为您提供有效的构建。您可以通过运行来测试它mvn package(现在,您可以忽略“jar将为空”的相关警告)。

此时,您可以将项目导入IDE(大多数现代Java IDE(eclipse,idea较常用)包括对Maven的内置支持)。为简单起见,我们继续为此示例使用纯文本编辑器。

添加类路径依赖关系

Spring Boot提供了许多“Starters”,可以将jar添加到类路径中。我们的示例应用程序已经spring-boot-starter-parent在parent POM部分中使用过。spring-boot-starter-parent是一个特殊的启动器,提供有用的Maven默认值。它还提供了一个依赖部分,以便您可以省略版本号的说明。

其他“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文件,并在spring-boot-starter-web该parent部分下方添加依赖项,示例:

<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.web.bind.annotation.*;

@RestController

@EnableAutoConfiguration

public class Example {

    @RequestMapping("/")

    String home() {

        return "Hello World!";

    }

    public static void main(String[] args) {

        SpringApplication.run(Example.class, args);

    }

}

虽然这里的代码不多,但还是有很多代码。我们将在接下来的几节中逐步介绍重要部分。

@RestController和@RequestMapping Annotations 注解说明

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

该@RequestMapping注释提供“路由”的信息。它告诉Spring,任何带/路径的HTTP请求都应该映射到该home方法。该 @RestController注解告诉Spring使得到的字符串直接返回给调用者。

在@RestController与@RequestMapping注解是Spring MVC的注解。(它们不是Spring Boot特有的。)有关更多详细信息,请参阅Spring参考文档中的MVC部分。

这段话的意思是要想会用web还要学Spring MVC里面的知识

@EnableAutoConfiguration注解

第二个类级注解是@EnableAutoConfiguration。这个注解告诉Spring Boot根据你添加的jar依赖关系“猜测”你想要如何配置Spring。自从spring-boot-starter-web添加了Tomcat和Spring MVC 以来,自动配置假定您正在开发Web应用程序并相应地设置Spring。

启动器和自动配置

自动配置旨在与“启动器”配合使用,但这两个概念并不直接相关。您可以自由选择并在starter依赖之外的jar依赖项。同时Spring Boot仍然尽力自动配置您的应用程序。

“主”方法

我们的应用程序的最后一部分是main方法。这只是遵循应用程序入口点的Java约定的标准方法。我们的main方法SpringApplication通过调用委托给Spring Boot的类run。 SpringApplication引导我们的应用程序,启动Spring,然后启动自动配置的Tomcat Web服务器。我们需要Example.class作为参数传递给run方法,以告诉SpringApplication哪个是主要的Spring组件。该 args数组也被传递以公开任何命令行参数。

运行示例

此时,您的应用程序应该工作。由于您使用了 spring-boot-starter-parent POM,run因此您可以使用一个有用的目标来启动应用程序。mvn spring-boot:run从根项目目录中键入以启动应用程序。您应该看到类似于以下内容的输出:

$ mvn spring-boot:run

运行图

如果您打开Web浏览器访问 localhost:8080,您应该看到以下输出:

Hello World!

要正常退出应用程序,请按组合按键 ctrl-c。

创建一个可执行的Jar

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

可执行的jar和Java

Java没有提供加载嵌套jar文件的标准方法(jar文件本身包含在jar中)。如果您要分发自包含的应用程序,这可能会有问题。

为了解决这个问题,许多开发人员使用“超级”罐子。uber 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包括<executions>配置以结合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.1.6.RELEASE:repackage (default) @ myproject ---

[INFO] ------------------------------------------------------------------------

[INFO] BUILD SUCCESS

[INFO] ------------------------------------------------------------------------

如果你查看target目录,你应该看到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的文件小得多target。这是Maven在Spring Boot重新打包之前创建的原始jar文件。

要运行该应用程序,请使用以下java -jar命令:

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

运行图

和以前一样,要退出应用程序,请按ctrl-c。

返回主页

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335