Spring-Boot:6分钟掌握SpringBoot开发

构建项目

从技术角度来看,我们要用Spring MVC来处理Web请求,用Thymeleaf来定义Web视图,用Spring Data JPA来把阅读列表持久化到数据库里,姑且先用嵌入式的H2数据库。

1、项目搭建

Spring IO 官网搭建

我们可以进入到Spring 的官网:http://start.spring.io/
进入官网后,可以快速的构建Spring boot 的基础项目,这里可以选择Maven 项目或者Gradle 项目,然后设置项目相关的配置。

在选择Generate Project 进行项目下载后,会生成对应的zip 文件。后续只需要将Zip 文件解压,添加到IDE 中即可。

IDEA 快速构建

除了在SpringIO 官网进行项目初始化外,还可以通过IDEA 进行项目的搭建。如下图所示,项目的搭建也是引用了 http://start.spring.io/

在后续的页面中,我们可以设置相关的配置信息,一些常用的依赖,也可以进行初始化。

Spring Boot CLI

除了以上常用的项目创建方法以外,我们还可以通过CLI 进行项目的创建:

spring init -dweb,data-jpa,h2,thymeleaf --build gradle readinglist

  

CLI的init命令是不能指定项目根包名和项目名的。包名默认是demo,项目名默认是Demo。

2、目录结构

不管我们采用哪种方式进行项目的创建,在将项目导入IDE之后,我们可以看到整个项目结构遵循传统Maven或Gradle项目的布局,即主要应用程序代码位于src/main/java目录里,资源都在src/main/resources目录里,测试代码则在src/test/java目录里。此刻还没有测试资源,但如果有的话,要放在src/test/resources里。

文件介绍:

  • SpringBootWebApplication: 应用程序的启动引导类(bootstrap class),也是主要的Spring 配置类。
  • appliction.properties:用于配置应用程序和Spring boot 的属性
  • SpringBootWebApplicationTests:一个基本的集成测试类。
  •  pom.xml:项目依赖文件

3、文件介绍

SpringBootWebApplication

Application 类在Spring boot应用程序中有两个作用:配置和启动引导。

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

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

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

我们在使用Spring boot 进行开发时,Application 类是我们启动服务的入口,起到关键作用的是 **@SpringBootApplication** 这一注解,实际上 @SpringBootApplication 包含了三个有用的注解:

  • @Configuration:标明该类使用Spring 基于Java 的配置。
  • @ComponentScan:启用组件扫描,这样你写的Web控制器类和其他组件才能被自动发现并注册为Spring 应用程序上下文中的Bean。
  • @EnableAutoConfiguration:这一个配置开启了Spring boot 的自动配置。

这里使用到main 方法是需要提供一个@EnableAutoConfiguration 注解的引导类,来引导整个应用程序的启动。

SpringBootWebApplicationTests

项目创建时问我们创建了一个带有上下文的测试类。

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 -- 通过SpringBoot 加载上下文
public class SpringBootWebApplicationTests {

@Test
public void contextLoads() {
-- 测试加载的上下文
}

}

application.properties

实际上,这个文件是可选的,你可以删掉它而不影响应用程序的运行。
我们可以通过向application.properties 中添加变量,从而改变程序的默认配置。例如:

server.port=8000
server.contextPath=SpringBootWeb

在上述代码中,我们将程序的默认端口(8080) 修改成为使用 8000 端口,并且将应用程序的项目名修改为 SpringBootWeb。

原访问地址:

http://127.0.0.1:8080/

修改后:

http://127.0.0.1:8000/SpringBootWeb/

除此之外 还可以配置多环境的变量设置等一系列的设置:

spring.profiles.active = dev

pom.xml

在代码清单中,我们引用了 spring-boot-starter-parent 作为上一级,这样一来就能利用到Maven 的依赖管理功能,集成很多常用库的依赖,并且不需要知道版本。除此之外,也使用到了开篇所提到过的起步依赖,我们只需要引入 spring-boot-starter-web 这一依赖,就可以使用到Web 中常用的包。

<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.7.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
...
</dependencies>

如下图所示,我们使用到的 spring-boot-starter-web 依赖中,已经集成了常用的mvc json 等相关依赖。

org.springframework.boot:spring-boot-starter-web:jar:1.5.7.RELEASE:compile
[INFO] | +- org.springframework.boot:spring-boot-starter-tomcat:jar:1.5.7.RELEASE:compile
[INFO] | | +- org.apache.tomcat.embed:tomcat-embed-core:jar:8.5.20:compile
[INFO] | | +- org.apache.tomcat.embed:tomcat-embed-el:jar:8.5.20:compile
[INFO] | | \- org.apache.tomcat.embed:tomcat-embed-websocket:jar:8.5.20:compile
[INFO] | +- org.hibernate:hibernate-validator:jar:5.3.5.Final:compile
[INFO] | | +- javax.validation:validation-api:jar:1.1.0.Final:compile
[INFO] | | \- com.fasterxml:classmate:jar:1.3.4:compile
[INFO] | +- com.fasterxml.jackson.core:jackson-databind:jar:2.8.10:compile
[INFO] | | +- com.fasterxml.jackson.core:jackson-annotations:jar:2.8.0:compile
[INFO] | | \- com.fasterxml.jackson.core:jackson-core:jar:2.8.10:compile
[INFO] | +- org.springframework:spring-web:jar:4.3.11.RELEASE:compile
[INFO] | \- org.springframework:spring-webmvc:jar:4.3.11.RELEASE:compile
[INFO] | \- org.springframework:spring-expression:jar:4.3.11.RELEASE:compile

4、开发功能

4.1 定义实体类 Book

如你所见,Book类就是简单的Java对象,其中有些描述书的属性,还有必要的访问方法。
@Entity注解表明它是一个JPA实体,id属性加了@Id和@GeneratedValue注解,说明这个字段
是实体的唯一标识,并且这个字段的值是自动生成的。

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

/**
* Created by weijie_huang on 2017/9/20.
*/

@Entity
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
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;
}

4.2 定义仓库接口 ReadRepository

通过扩展JpaRepository,ReadingListRepository直接继承了18个执行常用持久化操作
的方法。JpaRepository是个泛型接口,有两个参数:仓库操作的领域对象类型,及其ID属性的
类型。此外,我还增加了一个findByReader()方法,可以根据读者的用户名来查找阅读列表。

import com.jaycekon.demo.domain.Book;
import org.springframework.data.jpa.repository.JpaRepository;

import java.util.List;

/**
* Created by weijie_huang on 2017/9/20.
*/
public interface ReadRepository extends JpaRepository<Book,Long> {
List<Book> findByReader(String reader);
}

4.3 定义控制层 ReadController

在定义好了应用程序的实体类,持久化接口后。我们还需要创建一个MVC 控制器来处理HTTP请求。

import com.jaycekon.demo.dao.ReadRepository;
import com.jaycekon.demo.domain.Book;
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;

/**
* Created by weijie_huang on 2017/9/20.
*/
@Controller
public class ReadController {
@Autowired
private ReadRepository readRepository;

@RequestMapping(value="/{reader}", method= RequestMethod.GET)
public String readersBooks(
@PathVariable("reader") String reader,
Model model) {
List<Book> readingList =
readRepository.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);
readRepository.save(book);
return "redirect:/{reader}";
}

}

使用了@Controller注解,这样组件扫描会自动将其注册为
Spring应用程序上下文里的一个Bean。通过@Autowired 将仓库接口注入到控制类中。

4.4 启动服务

在开发完成后,我们去到Application 类下,启动main 方法。即可将应用程序启动,然后进入到下述页面(html 文件不细述,可通过查看源码进行了解)。可以看到,我们的服务已经成功启动。

4.5 流程分析

大家可能会很疑惑,为什么我们没有配置数据库信息,却没有报异常。我们明明创建了 ReadRepository 数据库接口,如果没有DataSource 的话,应该是会报异常的。但是Spring boot 却巧妙的避开了这种问题。

首先我们需要来了解一下Spring-boot-autoconfigure 这个依赖包。这个Jar包下包含了很多的配置类。例如Thymeleaf,JPA以及Mvc的相关配置。

这里主要涉及到了Condition 接口,该接口的作用是,只有到某个条件达成后,才回对这个Bean 进行实例化。

注解:

  • @ConditionalOnBean  配置了某个特定Bean
  • @ConditionalOnMissingBean 没有配置特定的Bean
  • @ConditionalOnClass Classpath里有指定的类
  • @ConditionalOnMissingClass Classpath里缺少指定的类
  • @ConditionalOnExpression 给定的Spring Expression Language(SpEL)表达式计算结果为true
  • @ConditionalOnJava Java的版本匹配特定值或者一个范围值
  • @ConditionalOnJndi 参数中给定的JNDI位置必须存在一个,如果没有给参数,则要有JNDI
  • @ConditionalOnProperty 指定的配置属性要有一个明确的值
  • @ConditionalOnResource Classpath里有指定的资源

上述程序之所有没有进行数据库操作,主要可以参考 DataSourceAutoConfiguratio 这个类的相应配置。

@Configuration
@ConditionalOnClass({DataSource.class, EmbeddedDatabaseType.class})
@EnableConfigurationProperties({DataSourceProperties.class})
@Import({Registrar.class, DataSourcePoolMetadataProvidersConfiguration.class})
public class DataSourceAutoConfiguration 

可以看到,只有DataSource 这个类实例化之后,这个Bean才会进行实例化。我们再往下观察可以看到 JdbcTemplateConfiguratio 也有想类似的情况。

此处看到的只是DataSourceAutoConfiguration的冰山一角,Spring Boot提供的其他自
动配置类也有很多知识没有提到。但这已经足以说明SpringBoot如何利用条件化配置实现自动配置。

自动配置会做出以下配置决策,它们和之前的例子息息相关。

- 因为Classpath 里有H2 , 所以会创建一个嵌入式的H2 数据库Bean , 它的类型是
javax.sql.DataSource,JPA实现(Hibernate)需要它来访问数据库。

- 因为Classpath里有Hibernate(Spring Data JPA传递引入的)的实体管理器,所以自动配置
会配置与Hibernate 相关的Bean , 包括Spring 的LocalContainerEntityManager-
FactoryBean和JpaVendorAdapter。

- 因为Classpath里有Spring Data JPA,所以它会自动配置为根据仓库的接口创建仓库实现。

- 因为Classpath里有Thymeleaf,所以Thymeleaf会配置为Spring MVC的视图,包括一个
Thymeleaf的模板解析器、模板引擎及视图解析器。视图解析器会解析相对于Classpath根
目录的/templates目录里的模板。

- 因为Classpath 里有Spring MVC ( 归功于Web 起步依赖), 所以会配置Spring 的
DispatcherServlet并启用Spring MVC。

- 因为这是一个Spring MVC Web应用程序,所以会注册一个资源处理器,把相对于Classpath
根目录的/static目录里的静态内容提供出来。(这个资源处理器还能处理/public、/resources
和/META-INF/resources的静态内容。)

- 因为Classpath里有Tomcat(通过Web起步依赖传递引用),所以会启动一个嵌入式的Tomcat
容器,监听8080端口。

总结

通过Spring Boot的起步依赖和自动配置,你可以更加快速、便捷地开发Spring应用程序。起步依赖帮助你专注于应用程序需要的功能类型,而非提供该功能的具体库和版本。与此同时,自动配置把你从样板式的配置中解放了出来。这些配置在没有Spring Boot的Spring应用程序里非常常见。

虽然自动配置很方便,但在开发Spring应用程序时其中的一些用法也有点武断。要是你在配置Spring时希望或者需要有所不同,该怎么办?在第3章,我们将会看到如何覆盖Spring Boot自动配置,借此达成应用程序的一些目标,还有如何运用类似的技术来配置自己的应用程序组件。

github 地址:https://github.com/jaycekon/SpringBoot

时间: 2024-10-26 13:30:59

Spring-Boot:6分钟掌握SpringBoot开发的相关文章

spring boot + vue + element-ui全栈开发入门——开篇

最近经常看到很多java程序员朋友还在使用Spring 3.x,Spring MVC(struts),JSP.jQuery等这样传统技术.其实,我并不认为这些传统技术不好,而我想表达的是,技术的新旧程度体现了做项目时的生产力.生产力低了,项目的开发成本就高.反之,生产力高,则成本低.笔者写本系列的目的是让使用“前后端不分离”的老技术的开发者做一个入门级的过度.因为目前流行的“前后端分离”技术足够简单,足够方便,足够易学,也足够完善. 项目所使用的前端技术是:element-ui,文档地址是:ht

spring boot + vue + element-ui全栈开发入门——基于Electron桌面应用开发

 前言 Electron是由Github开发,用HTML,CSS和JavaScript来构建跨平台桌面应用程序的一个开源库. Electron通过将Chromium和Node.js合并到同一个运行时环境中,并将其打包为Mac,Windows和Linux系统下的应用来实现这一目的. Electron于2013年作为构建Github上可编程的文本编辑器Atom的框架而被开发出来.这两个项目在2014春季开源. 目前它已成为开源开发者.初创企业和老牌公司常用的开发工具. 看看谁在使用Electron

Spring Boot——2分钟构建spring web mvc REST风格HelloWorld

之前有一篇<5分钟构建spring web mvc REST风格HelloWorld>介绍了普通方式开发spring web mvc web service.接下来看看使用spring boot如何快速构建一个. Spring Boot使我们更容易去创建基于Spring的独立和产品级的可以”即时运行“的应用和服务.支持约定大于配置,目的是尽可能快地构建和运行Spring应用. 之前我们创建基于Spring的项目需要考虑添加哪些Spring依赖和第三方的依赖.使用Spring Boot后,我们可

Spring Boot基础教程8-web应用开发-模板引擎jsp

一.spring boot的web应用开发,是基于spring mvc 二.Spring boot 在spring默认基础上,自动配置添加了以下特性: 1.   包含了ContentNegotiatingViewResolver和BeanNameViewResolver beans. 2.   对静态资源的支持,包括对WebJars的支持. 3.   自动注册Converter,GenericConverter,Formatter beans. 4.   对HttpMessageConverte

spring boot + vue + element-ui全栈开发入门——前后端整合开发

一.配置 思路是通过node的跨域配置来调用spring boot的rest api. 修改config\index.js文件,设置跨域配置proxyTable: proxyTable: { '/api': { target: 'http://localhost:18080/', changeOrigin: true, pathRewrite: { '^/api': '/' } } } 完整的config\index.js代码如下: 'use strict' // Template versio

spring boot + vue + element-ui全栈开发入门——项目部署

 前言 常用的部署方式有两种: 1.是把生成好的静态页面放到spring boot的static目录下,与打包后的spring boot项目一起发布,当spring boot运行起来后,自然而然就能访问到静态页面文件了. 这种方法比较简单,适用于非常小型的系统.优点是:不需要复杂的配置.而缺点也很明显:需要两者一同发布.我在这里就不做赘述了. 2.是通过http服务器发布,本文以nginx为例,重点介绍这种方式. 一.生成静态页面 运行npm run build 生成的页面文件在dist目录下:

基于Spring Boot框架企业级应用系统开发全面实战

Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程.该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置.通过这种方式,Boot致力于在蓬勃发展的快速应用开发领域(rapid application development)成为领导者.    教程由浅入深,一步一步学习Spring Boot,最后学到的不单单是基础! 使用Spring Boot 进行Web 开发.数据访问.安全控制.批处理.异步消息.系统集

Spring Boot带前后端 渐进式开发企业级博客系统

第1章 Spring Boot 简介   1-1 Spring Boot 博客_课程导学   1-2 Spring Boot 是什么第2章 开启 Spring Boot 的第一个 Web 项目   2-1 -初始化第一个Web项目    2-2 -用Gradle编译项目   2-3 -探索项目第3章 一个Hello World项目   3-1 编写项目构建信息    3-2 自定义存储库,加速构建   3-3 编写程序代码及测试用例    3-4 配置Wrapper,运行程序第4章 开发环境的搭

Spring Boot + Vue 前后端分离开发,权限管理的一点思路

在传统的前后端不分的开发中,权限管理主要通过过滤器或者拦截器来进行(权限管理框架本身也是通过过滤器来实现功能),如果用户不具备某一个角色或者某一个权限,则无法访问某一个页面. 但是在前后端分离中,页面的跳转统统交给前端去做,后端只提供数据,这种时候,权限管理不能再按照之前的思路来. 首先要明确一点,前端是展示给用户看的,所有的菜单显示或者隐藏目的不是为了实现权限管理,而是为了给用户一个良好的体验,不能依靠前端隐藏控件来实现权限管理,即数据安全不能依靠前端. 这点就像普通的表单提交一样,前端做数据