1 SpringBoot HelloWorld

功能:浏览器发送sayHello请求,服务器接受请求并处理,响应Hello

1.1 创建一个maven工程

1
2
3
<groupId>com.seagetech</groupId>
<artifactId>springboot-helloworld</artifactId>
<version>1.0.0</version>

1.2 下载官方参考文档

​ 在官网找到相应的下载地址(官网地址:https://spring.io/projects)或者直接使用如下地址下载:https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/reference/pdf/spring-boot-reference.pdf。文档名称《spring-boot-reference.pdf》,版本2.10.RELEASE

1.3 使用官方参考文档

​ Part II. Getting Started(第二部分)—>11. Developing Your First Spring Boot Application(开发你的第一个SpringBoot应用)

1.3.1 Creating the POM (创建POM)

1
2
3
4
5
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.0.RELEASE</version>
</parent>

1.3.2 Adding Classpath Dependencies(添加依赖)

1
2
3
4
5
6
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>

1.3.3 Writing the Code(编写代码)

​ 创建一个主程序类,类名随便取,因为我们是做一个HelloWorld的项目,所有我们创建一个HelloWorldApplication类:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
/**
* @auther wangzb
* @date 2018/11/9 21:32
*/
@Controller
@EnableAutoConfiguration
public class HelloWorldApplication {

@RequestMapping(value = "/sayHello")
@ResponseBody
public String sayHello(String name){
return "Hello," + name;
}

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

1.3.4 Running the Example(运行例子)

启动main方法后,查看SpringBoot启动日志

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.1.0.RELEASE)

....... . . .
....... . . . (log output here)
....... . . .  

... Tomcat started on port(s): 8080 (http) with context path ''
... Started HelloWorldApplication in 3.577 seconds (JVM running for 4.446)

​ 可以看到Tomcat的启动日志:

Tomcat started on port(s): 8080 (http) with context path ‘’

​ 即,Tomcat默认启动端口为8080,项目根路径为””,所以在浏览器或者Postman中输入地址:http://localhost:8080/sayHello?name=wangzb,浏览器或Postman响应:

Hello,wangzb

1.3.5 Creating an Executable Jar (创建一个可执行的Jar)

​ 要创建一个可执行jar,我们需要将spring-boot-maven-plugin添加到我们的pom.xml中。来
这样做,在dependencies部分下面插入以下几行:

1
2
3
4
5
6
7
8
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>

​ 接下来就可以打包,在idea中点击package,执行打包命令,之后我们在项目的target包下就可以看到刚打包好的springboot-helloworld-1.0.0.jar包。在包的路径下,打开CMD命令行,执行如下命令:

1
2
3
4
5
6
7
8
9
10
11
12
$ java -jar springboot-helloworld-1.0.0.jar
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.0.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)

​ 要退出应用程序,请按ctrl+c或者直接关闭命令窗口,再次在浏览器中访问上面地址,发现链接已不能再访问,如果实在Linux系统中,且要后台长期运行,可以在命令后加&符号,即:

1
java -jar springboot-helloworld-1.0.0.jar &

2 HelloWorld探究

2.1 使用IntelliJ IDEA快速创建SpringBoot项目

(1) New Project(新建项目)

图片

(2) 左边菜单选择Spring Initializr,右边菜单选择jdk版本,然后点击Next

图片

(3) 填写Maven坐标GroupId/ArtifactId、打包形式(本例使用Jar的方式,war包形式请看后续文章)、项目名称/版本等基本信息,然后点击Next。

图片

(4) 选择SpringBoot的版本,以及需要依赖的包,这里我们选择最新版2.1.0,导入Web模块依赖包,点击Next。

图片)

(5) 修改项目名称以及项目存放路径,默认即可,点击Finish。

图片

2.2 SpringBoot项目结构分析

​ 通过2.1的讲解,我们熟悉了如果快速创建SpringBoot项目,接下来就是分析下SpringBoot的项目结构,上节中创建好的SpringBoot项目结构如下:

图片

2.2.1 pom.xml文件

2.2.1.1 父项目

1
2
3
4
5
6
7
8
9
10
11
12
13
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.0.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
按住Ctrl,点击spring-boot-starter-parent进入spring-boot-starter-parent项目,他的父项目是:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.1.0.RELEASE</version>
<relativePath>../../spring-boot-dependencies</relativePath>
</parent>

​ 如上,看到spring-boot-dependencies,它是真正管理SpringBoot项目里的所有依赖版本,是Spring Boot的版本仲裁中心,以后我们导入依赖默认是不需要写版本(没有在dependencies里面管理的依赖自然需要声明版本号)。

2.2.1.2 启动器(Starter)

1
2
3
4
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>

​ spring-boot-starter:spring-boot场景启动器;帮我们导入了web模块正常运行所依赖的组件;Spring Boot将所有的功能场景都抽取出来,做成一个个的starters(启动器),只需要在项目里面引入这些starter,相关场景的所有依赖都会导入进来。要用什么功能就导入什么场景的启动器。
(1) 以下列举SpringBoot官方提供的starter pom。更多请参考《spring-boot-reference.pdf》2.1.0.RELEASE版,第13.5节Starters

名称 描述
spring-boot-starter SpringBoot核心starter,包含自动配置、日志、yaml配置文件的支持
spring-boot-starter-aop 使用spring-aop和AspectJ支持面向切面编程
spring-boot-starter-cache 对Spring Cache的抽象支持
spring-boot-starter-jpa 对JPA的支持,包含spring-data-jpa、spring-orm和Hibernate
spring-boot-starter-solr 通过spring-data-solr对Apache Solr数据检索平台的支持
spring-boot-starter-jdbc 对JDBC数据库的支持
spring-boot-starter-redis 对键值对内存数据库Redis的支持,包含spring-redis
spring-boot-starter-security 对spring-security的支持
spring-boot-starter-test 对常用测试框架JUint、Hamcrest和Mockito的支持,包含spring-test模块
spring-boot-starter-thymeleaf 对Thymeleaf模板引擎的支持,包含与Spring整合的配置
spring-boot-starter-web 对web项目开发的支持,包含Tomcat和spring-webmvc
spring-boot-starter-Tomcat SpringBoot默认的Servlet容器Tomcat
spring-boot-starter-Jetty 使用Jetty作为Servlet容器替换Tomcat
spring-boot-starter-logging SpringBoot默认的日志框架Logback
spring-boot-starter-log4j 支持使用Log4J日志框架
spring-boot-starter-websocket 对WebSocket开发的支持

(2)除了官方的starter pom外,还有第三方为SpringBoot所写的starter pom,如下表所示。

名称 使用方法
Mybatis
org.mybatis.spring.boot
mybatis-spring-boot-starter
3.3.0
Actitivi
 org.activiti 
activiti-spring-boot-starter-basic
6.0.0

2.2.2 resources文件目录结构

(1)static:保存所有的静态资源,如js、css、images等。
(2)templates:保存所有的模板文件,SpringBoot默认jar使用嵌入式的Tomcat,默认不支持JSP页面,可以使用模板引擎(thymeleaf、freemarker )。
(3)application.properties:SpringBoot应用配置文件,可以修改一些默认的配置,如修改Tomcat的端口,项目根路径等。

2.2.3 主程序类

打开2.1节创建的springboot-demo项目,找到SpringBootDemoApplication类:

1
2
3
4
5
6
7
8
9
10
11
12
package com.seagetech.springbootdemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringbootDemoApplication {

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

​ 基本和1.3.3节创建的主程序类一样,main方法加注解的形式,不同的是,Idea创建的主程序类使用的是@SpringBootApplication注解,它是SpringBoot的核心注解,也是一个组合注解,打开这个注解,源码如下:

1
2
3
4
5
6
7
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan

@SpringBootApplication注解的核心功能其实是:@SpringBootConfiguration、@EnableAutoConfigration、@ComponentScan三个注解提供

× 请我吃糖~
打赏二维码