专业编程基础技术教程

网站首页 > 基础教程 正文

写给新手看的 Spring Boot 入门学习指南

ccvgpt 2024-07-17 15:57:12 基础教程 10 ℃

什么是 Spring Boot ?

解释一下:Spring Boot 可以构建一切。Spring Boot 设计之初就是为了最少的配置,最快的速度来启动和运行 Spring 项目。Spring Boot 使用特定的配置来构建生产就绪型的项目。

写给新手看的 Spring Boot 入门学习指南

Spring Boot 的特性:

  • 使用 Spring 项目引导页面可以在几秒构建一个项目

  • 方便对外输出各种形式的服务,如 REST API、WebSocket、Web、Streaming、Tasks

  • 非常简洁的安全策略集成

  • 支持关系数据库和非关系数据库

  • 支持运行期内嵌容器,如 Tomcat、Jetty

  • 强大的开发包,支持热启动

  • 自动管理依赖

  • 自带应用监控

  • 支持各种 IED,如 IntelliJ IDEA、NetBeans

Spring Boot 快速入门

构建项目:

(1)访问 http://start.spring.io/。

(2)选择构建工具 Maven Project、Spring Boot 版本 1.5.8 及一些工程基本信息,可参考下图:

(3)单击 Generate Project 按钮并下载项目压缩包。

(4)解压后,单击 Eclipse,Import | Existing Maven Projects | Next | 选择解压后的文件夹 | Finsh 命令,OK Done!

(5)如果使用的是 Idea,单击 File | New | Model from Existing Source.. | 选择解压后的文件夹 | OK 命令, 选择 Maven ,一路 Next,OK Done!

如果读者使用的是 Idea 工具,也可以这样:

(1)单击 File | New | Project… 命令,弹出新建项目框。

(2)选择 Spring Initializr 选项,单击 Next 按钮,也会出现上述类似的配置界面,Idea 帮我们做了集成。

(3)填写相关内容后,单击 Next 按钮,选择依赖的包再单击 Next 按钮,最后确定信息无误单击 Finish 按钮。

对上面的配置做一个解释:

  • 第一个选择框选择创建以 Maven 构建项目,还是以 Gradle 构建项目,这是两种不同的构建方式,其中 Gradel 配置内容更简洁一些,并且包含了 Maven 的使用,不过日常使用 Maven 居多。


  • 第二个选择框选择编程语言,现在支持 Java、Kotlin 和 Groovy。


  • 第三个选择框选择 Spring Boot 版本,可以看出 Spring Boot 2.0 已经到了第五个里程碑了。在实际使用中,我们会优先使用稳定版本,1.0 的最新稳定版本是 1.5.8,也是我们演示使用的版本。

下面就是项目的配置信息了。

  • Group:一般填写公司域名,比如百度公司填 com.baidu,演示使用 com.neo。

  • Artifact:可以理解为项目的名称,可以根据实际情况来填,本次演示填写 helloWorld。

  • Dependencies:在这块添加我们项目所依赖的 Spring Boot 组件,可以多选。本次选择 Web、devtools 两个模块。

项目结构介绍

如上图所示,Spring Boot 的基础结构共三个文件:

  • src/main/java:程序开发以及主程序入口

  • src/main/resources:配置文件

  • src/test/java:测试程序

另外,Sping Boot 建议的目录结果如下:

root package 结构:com.example.myproject

com.example.myproject 目录下:

  • Application.java:建议放到根目录下面,是项目的启动类,Spring Boot 项目只能有一个 main 方法。

  • comm:目录建议放置公共的类,如全局的配置文件、工具类等。

  • domain:目录主要用于实体(Entity)与数据访问层(Repository)。

  • repository:数据库访问层代码。

  • service:该层主要是业务类代码。

  • web:该层负责页面访问控制。

resources 目录下:

  • static:目录存放 Web 访问的静态资源,如 JS、CSS、图片等。

  • templates:目录存放页面模板。

  • application.properties:项目的配置信息。

test 目录存放单元测试的代码;pom.xml 用于配置项目依赖包,以及其他配置。

采用默认配置可以省去很多设置,当然也可以根据自己的喜好来进行更改。最后,启动 Application main 方法,至此一个 Java 项目搭建好了!

简单 Web 开发

(1)可以在 Spring Initializr 上面添加,也可以手动在 pom.xml 中添加:

pom.xml 文件中默认有两个模块:

  • spring-boot-starter:核心模块,包括自动配置支持、日志和 YAML;

  • spring-boot-starter-test:测试模块,包括 JUnit、Hamcrest、Mockito。

(2)编写 controller 内容:

@RestControllerpublic class HelloWorldController

{ @RequestMapping("/hello")
public String hello
{
return "Hello World"; }}

@RestController的意思就是 controller 里面的方法都以 json 格式输出,不用再配置什么 jackjson 的了!

如果配置为@Controller就代表着输出为页面内容。

(3)启动主程序,打开浏览器访问 http://localhost:8080/hello,就可以看到以下内容,是不是很简单!

Hello World

(4)如果我们想传入参数怎么办?

@RestControllerpublic class HelloWorldController
{ @RequestMapping("/hello")
public String index(String name)
{
return "Hello World, " +name; }}

重新启动项目,访问 http://localhost:8080/hello?name=neo,返回内容如下:

Hello World,neo

经过上一个测试发现,修改 controller 内相关代码,就需要重新启动项目才能生效,这样做很麻烦是不是,别着急。Spring Boot 提供了另外一个组件来解决。

热部署

热启动就需要用到我们在一开始引入的另外一个组件:devtools。它是 Spring Boot 提供的一组开发工具包,其中就包含我们需要的热部署功能。但是在使用这个功能之前还需要再做一些配置。

(1)在 dependency 中添加 optional 属性,并设置为 true:

(2)在 plugin 中配置另外一个属性 fork,并且配置为 true:

OK,以上两步配置完成,如果读者使用的是 Eclipse,那么恭喜你大功告成了。

如果读者使用的是 Idea 还需要做以下配置。

(3)配置 Idea

选择 File-Settings-Compiler 勾选 Build project automatically,低版本 Idea 勾选make project automatically

使用快捷键:CTRL + SHIFT + A输入Registry找到选项compile.automake.allow.when.app.running勾选

全部配置完成后,Idea 就支持热部署了,大家可以试着去改动一下代码就会发现 Spring Boot 会自动重新加载,再也不需要我们手动点击重新部署了。

为什么 Idea 需要多配置后面这一步呢,因为 Idea 默认不是自动编译的,需要我们手动去配置后才会自动编译,而热部署依赖于项目的自动编译功能。

该模块在完整的打包环境下运行的时候会被禁用。如果使用 java -jar 启动应用或者用一个特定的 classloader 启动,它会认为这是一个“生产环境”。

单元测试

单元测试在日常开发中是必不可少的,一个牛逼的程序员,单元测试写得也是杠杠的。下面来看下 Spring Boot 对单元测试又做了哪些支持?

如果我们只想运行一个 hello World,只需要一个注解就可以。在 src/test 目录下新建一个 HelloTests 类,代码如下:

public class HelloTest
{ @Test public void hello
{ System.out.println("hello world"); }}

单击右键“运行”按钮,会发现控制台输出:hello world。仅仅只需要了一个注解。但是如果我们需要测试 web 层的请求呢?Spring Boot 也给出了支持。

以往我们在测试 web 请求的时候,需要手动输入相关参数在页面测试查看效果,或者自己写 post 请求。在 Spring Boot 中,Spring 给出了一个简单的解决方案;使用 mockmvc 进行 web 测试,mockmvc 内置了很多工具类和方法,可以模拟 post、get 请求,并且判断返回的结果是否正确等,也可以利用print打印执行结果。

@SpringBootTest
public class HelloTest
{
private MockMvc mockMvc;
@Before
public void setUp t
hrows Exception
{ mockMvc = MockMvcBuilders.standaloneSetup(new HelloWorldController).build; }
@Test public void getHello
throws Exception
{ mockMvc.perform(MockMvcRequestBuilders.post("/hello?name=小明").accept(MediaType.APPLICATION_JSON_UTF8)).andDo(print); }}

在类的上面添加@SpringBootTest,系统会自动加载 Spring Boot 容器。在日常测试中,我们就可以注入 bean 来做一些局部业务的测试。MockMvcRequestBuilders可以 post、get 请求,使用print方法会将请求和相应的过程都打印出来,如下:

MockHttpServletRequest: HTTP Method = POST Request URI = /hello Parameters = {name=[neo]} Headers = {}Handler: Type = com.neo.helloWorld.web.HelloWorldController Method = public java.lang.String com.neo.helloWorld.web.HelloWorldController.hello(java.lang.String)...MockHttpServletResponse: Status = 200
Error message =
Headers = {Content-Type=[text/plain;charset=ISO-8859-1], Content-Length=[16]} Content type = text/plain;
charset=ISO-8859-1
Body = Hello World ,neo Forwarded URL =
Redirected URL =
Cookies =

从返回的Body = Hello World ,neo可以看出请求成功。

总结

使用 Spring Boot 可以非常方便、快速搭建项目,而不用关心框架之间的兼容性、适用版本等各种问题,我们想使用任何东西,仅仅添加一个配置就可以,所以使用 Sping Boot 非常适合构建微服务。

建议大家使用 Idea 开发 Spring Boot 项目,Eclipse 对 Spring Boot 项目支持并不好,并且使用 Eclipse 偶尔会出现一些诡异的问题,影响初学者的学习。

关于完整的学习 Spring Boot 路径,我写了结构更加清晰,知识点更加系统的课程。

Tags:

最近发表
标签列表