《Spring Boot实战》之二:开发第一个应用程序

本章使用Spring Boot实现一个简单的例子,主要包括两个知识点:

使用Spring Boot的起步依赖
使用Spring Boot自动进行Spring的配置
2.1 运用Spring Boot

下面将使用Spring Boot创建一个简单的阅读列表程序,用户可以输入想读的 图书信息,查看列表,删除已经读过的书。

首先,使用Spring Boot初始化项目,从技术角度来看,我们要用Spring MVC来处理Web请求,用Thymeleaf来定义Web视图,用Spring Data JPA来把阅读列表持久化到数据库里,这里先用嵌入式的H2数据库。我们使用Initializr的Web界面进行初始化,在添加依赖的地方添加Web、Thymeleaf和JPA。还要添加H2,以在开发应用程序时使用内嵌式数据库。

《Spring Boot实战》之二:开发第一个应用程序

《Spring Boot实战》之二:开发第一个应用程序

初始化后的文件结构:

《Spring Boot实战》之二:开发第一个应用程序

2.1.1 ReadListApplication.java

首先看ReadListApplication.java,ReadListApplication在Spring Boot应用程序里有两个作用:配置和启动引导。首先, 这是主要的Spring配置类。虽然Spring Boot的自动配置免除了很多Spring配置,但你还需要进行 少量配置来启用自动配置。@SpringBootApplication开启了Spring的组件扫描和Spring Boot的自动配置功能。实际 上,@SpringBootApplication将三个有用的注解组合在了一起。

Spring的@Configuration:标明该类使用Spring基于Java的配置。
Spring的@ComponentScan:启用组件扫描,这样你写的Web控制器类和其他组件才能被 自动发现并注册为Spring应用程序上下文里的Bean。本章稍后会写一个简单的Spring MVC 控制器,使用@Controller进行注解,这样组件扫描才能找到它。
Spring Boot 的 @EnableAutoConfiguration :这个注解也可以称为 @Abracadabra,就是这一行配置开启了Spring Boot自动配置的魔力,让你不用再写成篇的配置了。

如前所述,ReadListApplication还有一个作用是启动引导,运行Spring Boot应用程序有两种方式:一是通过传统的WAR包形式;二是通过可执行jar包的方式。这里向SpringApplication.run()传递了一个ReadingListApplication类的引用,还有命令行参数,通过这些东西启动应用程序。

package com.yuan.readlist;

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

@SpringBootApplication //开启组件扫描和自动配置
public class ReadlistApplication {

public static void main(String[] args) {
SpringApplication.run(ReadlistApplication.class, args); //负责启动引导应用程序
}
}

2.1.2 ReadlistApplicationTests.java

ReadingListApplicationTests不仅提供了一个用于测试Spring Boot项目的框架,它还是一个例子,告诉你如何为Spring Boot应用程序编写测试。

contextLoads()这个空方法足以证明应用程序上下文的加载没有问题,如果ReadingListApplication里定义的配置是好的,就能通过测试。如果有问题,测试就会失败。

当然,现在这只是一个新的应用程序,你还会添加自己的测试。但contextLoads()方法是个良好的开端,此刻可以验证应用程序提供的各种功能。第4章会更详细地讨论如何测试Spring Boot应用程序。

package com.yuan.readlist;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)
@SpringBootTest
public class ReadlistApplicationTests {

@Test
public void contextLoads() {
}
}

2.1.3 application.properties

Initializr为你生成的application.properties文件是一个空文件,该文件可以用来调整Spring Boot的自动配置。

要注意的是,你完全不用告诉Spring Boot为你加载application.properties,只要它存在就会被加载,Spring和应用程序代码都能获取其中的属性,当然如果它不存在也完全没有问题,Spring Boot会使用其默认配置。

2.1.4 运行项目

构建一个Spring Boot应用程序和构建其他Java应用程序的过程类似,可以选择Gradle或Maven作为构建工具。描述构建说明文件的方法和描述非Spring Boot应用程序的方法也相似。Spring Boot为Gradle和Maven提供了构建插件,以便辅助构建Spring Boot项目。

将项目导入到MyEclipse中,执行ReadlistApplication的main方法,即可运行项目,然后浏览器访问127.0.0.1:8080,由于还没有写控制器类,会打开一个404的错误页面。

《Spring Boot实战》之二:开发第一个应用程序

《Spring Boot实战》之二:开发第一个应用程序

2.2 使用起步依赖

指定基于功能的依赖

通过使用Spring Boot的起步依赖,可以使我们不用指定具体的版本号,甚至不需要指定具体使用的依赖。比如我们前面在引入依赖时,我们只是在Initializr里添加了Web、Thymeleaf、JPA和H2,而通过传递依赖,它们声明的依赖也会被传递依赖进来,添加这四个依赖就等价于将相关的库都添加了进来。在《Spring Boot实战》附录B罗列出了全部起步依赖,并简要描述了一下它们向项目构建引入了什么。

覆盖起步依赖引入的传递依赖

起步依赖和你项目里的其他依赖没什么区别。也就是说,你可以通过构建工具中的功能,选择性地覆盖它们引入的传递依赖的版本号,排除传递依赖,当然还可以为那些Spring Boot起步依赖没有涵盖的库指定依赖。在Maven里,可以用元素来排除传递依赖。

Maven总是会用最近的依赖,也就是说,如果你在项目里想要覆盖Spring Boot引入的传递依赖,可以直接在在项目的构建说明文件里增加的这个依赖。

(关于起步依赖更多详细内容,参考《Spring Boot实战》2.2节使用起步依赖。)

2.3 使用自动配置

简每当应用程序启动的时候,Spring Boot检测ClassPath中包含的包,并对包含的包做一个基本的配置。比如Spring Security是不是在Classpath里?如果是,则进行一个非常基本的Web安全设置。

每当应用程序启动的时候,Spring Boot的自动配置都要做将近200个这样的决定,涵盖安全、 集成、持久化、Web开发等诸多方面。所有这些自动配置就是为了尽量不让你自己写配置,从而更多的专注于程序的功能。

下面我们继续ReadList的功能实现:

定义领域模型

读者阅读列表上的书是本例的核心领域概念,我们定义一个实体类Book来表示这个概念。

@Entity注解表明它是一个JPA实体,id属性加了@Id和@GeneratedValue注解,说明这个字段是实体的唯一标识,并且这个字段的值是自动生成的。

package com.yuan.readlist;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class Book {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private String reader;
private String isbn;
private String title;
private String author;
private String description;
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getReader() {
return reader;
}
public void setReader(String reader) {
this.reader = reader;
}
public String getIsbn() {
return isbn;
}
public void setIsbn(String isbn) {
this.isbn = isbn;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getAuthor() {
return author;
}
public void setAuthor(String author) {
this.author = author;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
}

定义仓库接口

用于把Book对象持久化到数据库的仓库了。因为用了Spring Data JPA,所以我们要做的就是简单地定义一个接口,扩展一下Spring Data JPA的JpaRepository接口:

package com.yuan.readlist;

import java.util.List;
import org.springframework.data.jpa.repository.JpaRepository;

public interface ReadingListRepository extends JpaRepository<Book, Long> {
List<Book> findByReader(String reader);
}

通过扩展JpaRepository,ReadingListRepository直接继承了18个执行常用持久化操作的方法。JpaRepository是个泛型接口,有两个参数:仓库操作的领域对象类型,及其ID属性的类型。此外,我还增加了一个findByReader()方法,可以根据读者的用户名来查找阅读列表。 如果你好奇谁来实现这个ReadingListRepository及其继承的18个方法,请不用担心,Spring Data提供了很神奇的魔法,只需定义仓库接口,在应用程序启动后,该接口在运行时会自动实现。

创建控制器

我们创建Spring MVC控制器来处理HTTP请求。ReadingListController使用了@Controller注解,这样组件扫描会自动将其注册为 Spring应用程序上下文里的一个Bean。它还用了@RequestMapping注解,将其中所有的处理器 方法都映射到了“/”这个URL路径上。

package com.yuan.readlist;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import java.util.List;
@Controller
@RequestMapping("/")
public class ReadingListController {
private ReadingListRepository readingListRepository;
@Autowired
public ReadingListController(ReadingListRepository readingListRepository) {
this.readingListRepository = readingListRepository;
}
@RequestMapping(value = "/{reader}", method = RequestMethod.GET)
public String readersBooks(@PathVariable("reader") String reader,
Model model) {
List<Book> readingList = readingListRepository.findByReader(reader);
if (readingList != null) {
model.addAttribute("books", readingList);
}
return "readingList";
}
@RequestMapping(value = "/{reader}", method = RequestMethod.POST)
public String addToReadingList(@PathVariable("reader") String reader,
Book book) {
book.setReader(reader);
readingListRepository.save(book);
return "redirect:/{reader}";
}
}

该控制器有两个方法。

readersBooks():处理/{reader}上的HTTP GET请求,根据路径里指定的读者,从(通过控制器的构造器注入的)仓库获取Book列表。随后将这个列表塞入模型,用的键是books,最后返回readingList作为呈现模型的视图逻辑名称。

addToReadingList():处理/{reader}上的HTTP POST请求,将请求正文里的数据绑定到一个Book对象上。该方法把Book对象的reader属性设置为读者的姓名,随后通过仓库的save()方法保存修改后的Book对象,最后重定向到/{reader}(控制器中的另一个方法会处理该请求)。

创建WEB界面

readersBooks()方法最后返回readingList作为逻辑视图名,为此必须创建该视图。因为在项目开始之初就决定要用Thymeleaf来定义应用程序的视图,所以接下来就在src/main/resources/templates里创建一个名为readingList.html的文件:

<html>
<head>
<title>Reading List</title>
<link rel="stylesheet" th:href="@{/style.css}"></link>
</head>
<body
<h2>Your Reading List</h2>
<div th:unless="${#lists.isEmpty(books)}">
<dl th:each="book : ${books}">
<dt class="bookHeadline">
<span th:text="${book.title}">Title</span> by <span
th:text="${book.author}">Author</span> (ISBN: <span
th:text="${book.isbn}">ISBN</span>)
</dt>
<dd class="bookDescription">
<span th:if="${book.description}" th:text="${book.description}">Description</span>
<span th:if="${book.description eq null}"> No description
available</span>
</dd>
</dl>
</div>
<div th:if="${#lists.isEmpty(books)}">
<p>You have no books in your book list</p>
</div>
<hr />
<h3>Add a book</h3>
<form method="POST">
<label for="title">Title:</label> <input type="text" name="title"
size="50"></input><br /> <label for="author">Author:</label> <input
type="text" name="author" size="50"></input><br /> <label for="isbn">ISBN:</label>
<input type="text" name="isbn" size="15"></input><br /> <label
for="description">Description:</label><br />
<textarea name="description" cols="80" rows="5">
</textarea>
<br /> <input type="submit"></input>
</form>
</body>
</html>

添加名为style.css的样式文件,该文件位于src/main/resources/static目录:

body {
background-color: #cccccc;
font-family: arial,helvetica,sans-serif;
}
.bookHeadline {
font-size: 12pt;
font-weight: bold;
}
.bookDescription {
font-size: 10pt;
}
label {
font-weight: bold;
}

运行程序

到目前为止,我们就已经完成了一个完整的Spring WEB程序,可见我们并没有进行什么配置,所有的配置都是Spring Boot自动完成的。

下面我们来运行这个WEB程序,在MyEclipse中右键,Run as Java Application,然后浏览器访问127.0.0.1:8080/name即可打开网页,可提交查询表单。

《Spring Boot实战》之二:开发第一个应用程序

关于Spring Boot自动配置更多内容,及其如何实现自动配置功能,参见《Spring Boot实战》2.3.3节内容。

2.4 总结

通过Spring Boot的起步依赖和自动配置,你可以更加快速、便捷地开发Spring应用程序。在下一章,我们将会看到如何覆盖Spring Boot自动配置,借此达成应用程序的一些特殊要求,还有如何运用类似的技术来配置自己的应用程序组件。

原创:https://www.panoramacn.com
源码网提供WordPress源码,帝国CMS源码discuz源码,微信小程序,小说源码,杰奇源码,thinkphp源码,ecshop模板源码,微擎模板源码,dede源码,织梦源码等。

专业搭建小说网站,小说程序,杰奇系列,微信小说系列,app系列小说

《Spring Boot实战》之二:开发第一个应用程序

免责声明,若由于商用引起版权纠纷,一切责任均由使用者承担。

您必须遵守我们的协议,如果您下载了该资源行为将被视为对《免责声明》全部内容的认可-> 联系客服 投诉资源
www.panoramacn.com资源全部来自互联网收集,仅供用于学习和交流,请勿用于商业用途。如有侵权、不妥之处,请联系站长并出示版权证明以便删除。 敬请谅解! 侵权删帖/违法举报/投稿等事物联系邮箱:2640602276@qq.com
未经允许不得转载:书荒源码源码网每日更新网站源码模板! » 《Spring Boot实战》之二:开发第一个应用程序
关注我们小说电影免费看
关注我们,获取更多的全网素材资源,有趣有料!
120000+人已关注
分享到:
赞(0) 打赏

评论抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

您的打赏就是我分享的动力!

支付宝扫一扫打赏

微信扫一扫打赏