前言

难度:简单
类型:step-by-step
适用:初学者,完全没有接触过 Spring-Boot
开发环境:jdk 1.8
关键词:java, sring-boot, spring-mvc, restful
笔者环境:macOS

1. 项目创建

1.1 使用脚手架生成项目

打开 http://start.spring.io/ 网站,选择Gradle ,依赖项选择Web(网站)DevTools(开发工具)JPA(ORM)MySQL(数据库)Thymeleaf(模板)
如下图所示:

start.spring.io

2. 项目配置

2.1 配置 application.properties

打开~demo/src/main/resource/application.properties文件,添加必要配置,如下:

#服务端口
server.port=8012
#mysql 配置
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
#mysql 链接字符串
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=UTF-8&useSSL=false&autoReconnect=true&failOverReadOnly=false
#mysqly用户名和密码
spring.datasource.username=your_mysql_name
spring.datasource.password=your_mysql_password
#jap 配置,是否输出 sql
spring.jpa.show-sql=true
#thymeleaf配置
#开发环境关闭缓存
spring.thymeleaf.cache=false
spring.thymeleaf.encoding=utf-8
#设置使用非严格的HTML5校验
spring.thymeleaf.mode=LEGACYHTML5
#调整id生成策略
spring.jpa.hibernate.use-new-id-generator-mappings=false

2.2 配置 Application 主入口

打开类文件 demo/src/main/java/com/example/demo/DemoApplication.java

2.2.1 添加注解@ComponentScan

组件扫描,如果不添加,可能无法正确的@Autowired

2.2.2 添加注解@Configuration

声明配置,告诉 Spring,该类是bean 的配置类

2.2.3 完成后的样子

如下图:

DemoApplication

3. Resftful 接口的示例

3.1 添加数据表的 Entity 实体类

3.1.1假设有一个数据表test_user_info

结构如下图 :

表结构

插入一些测试数据:

测试数据

3.1.2 新建包名 entities

其中新建 Entity 实体 TestUserInfo,完整如下图:

TestUserInfo.java

其中@Entity 声明这是一个数据实体,因为表名和类名不一致,所以用@Table 告诉 Jpa,这个表名的具体名字。

@Id 声明了主键,@GeneratedValue声明了主键是自增的,

@Column 声明了字段名的真实名字,Jpa 大小写是代表下划线分割,所以只能传全部小写的字段名。

3.2 新建 Repository

3.2.1 新建包名 repositories

新建接口 TestUserInfoRepository,该接口继承自,,需要JpaRepository<T,ID>T就是数据实体类,ID是类 id 字段的类型,如下图:

TestUserInfoRepository.java

@Repository 声明,告诉Spring-Boot,这是一个仓储的组件。

3.2.2 创建查询

因为 JpaData,采用的是规范契约的方式来声明查询,所以只要按照规范来创建接口中的方法,框架会自动生成对应的 sql 语句。如果有特殊需求,也可以用声明的方式写 sql 语句,例如:

TestUserInfoRepository.java

上下两条语句的效果一样,区别就是第一条按照规格来写,框架会自动提示字段的名字,定义了方法,框架会自动解析 sql,第二条框架会读取@Query中的 sql 使用。

3.3 创建 Service 服务

3.3.1 新建包名 services,

新建服务类TestInfoService,如下图

TesrInfoService.java

```@Service`` 声明了这是一个服务类。

3.3.2 关联 Repository

如下图,

自动关联

因为 TestUserInfoRepository 声明了@Repository,所以能够使用@Autowired 进行关联,这里要说明一点,SpringMvc 中的@Controller,@Service,@Repository 本质都是@Component,Spring-Boot 本质上能够使用@Autowired 进行关联的必须是有@Component声明,或者其子继承声明的才行。

3.3.3 创建查询方法

如下图,

查询方法

一个简单的服务查询类和方法。

3.4 创建 Model 实体

3.4.1 创建报名 models

TestUserInfoResponseModel用于接口返回相应 json 使用,如下图

TestUserInfoResponseModel.java

3.5 创建 Restful 的 Controller

3.5.1 创建包名 controllers

ApiController 类,如下图,

ApiController.java

@RestController 声明这是一个Restful 的控制器,@RequestMapping 声明了 url-route,是/api开头的。

3.5.2 关联 service

如下图,

关联 service

Repository 一样,TestUserInfoService 声明了@Service,所以他可以被@Autowired,前面讲过原因了。

3.5.3 创建 aciton方法

如下图,

action方法

@RequestMapping,声明了 action 的 url-route,那么这个action 的完整路径就是/api/get_user

另外,因为是 Restful 的 controller ,所以,如果不声明@ResponseBody 的话,就必须返回一个对象实体,框架会自动序列化成一个 json。

3.5.4 创建返回 plain 字符串的action

如下图,

plain action

声明了@ResponseBody,接口机会以纯文本的形式返回。

4. 请求测试

4.1 运行项目

4.1.1 点击运行,看到控制输出如下图,

console logs

看到端口的展示,代表运行成功了。

4.1.2 请求get_user接口

地址为:http://localhost:8012/api/get_user?name=test1

get_user

4.1.3 请求 get_plain 接口

地址为:http://localhost:8012/api/get_plain?name=test1

get_plain

4.1.4 至此,Restful 的项目 Demo 创建完毕。

5. 创建动态Web项目

5.1 创建 HomeController

并且关联service,如下图,

HomeController

@Controller 声明这是一个 web 的控制器,/home 是 url-route

5.2 创建 action

如下图,

index

@RequestMapping中 value 可以多一个,空白,代表可以省略,/home/index,或者/home都是请求这个 action。

方法返回的 String,是 ViewName,比如新建一个 index.html 的模板,这里使用就是返回字符串index

参数中的 Model 是在模板中使用的 Model 实体,示例中把查询出来的实体,装入了 model的字典中,这样在前台模板就能使用。

5.3 另外一种 aciton

如果不太喜欢返回字符串,可以使用另外一种,如下图,

ModelAndView

返回 ModelAndView,这样自己实例化的 ModelAndView,传入模板的名字,还有前台需要使用的 model,就能避免返回字符串,我个人推荐使用第一种方式,会比较灵活。

5.4 创建模板页面

/resource/templates 中创建index.html,如下图,

index.html

因为我们使用的是thymeleaf模板,所以html 中声明了 xmlns=th="http://www.thymeleaf.org",这样在 html 种就能使用模板属性去绑定数据,控制元素。

span中的 th:text=“${model?.id}”,告诉了模板,这个spantext 设置为model?.id的值。带上?问号的意思是,model 可能为 null,这样不会报错,null 的时候,text 就是空。

model 就是我们在 action 传给 model的名字,idnameage,就是 model 的字段。

5.5 运行请求

请求地址:http://localhost:8012/home/index?name=test1
如下图,

请求访问 index

请求另一个 aciton:
http://localhost:8012/home/test

请求访问test

5.6 至此动态 web的示例结束

作者:mcjiffy
链接:https://www.jianshu.com/p/512f84c439d8
來源:简书

从零开始完整搭建 Spring-Boot 项目开发框架的教程的更多相关文章

  1. Spring Boot系列学习文章(一) -- Intellij IDEA 搭建Spring Boot项目

    前言: 最近做的一个项目是用Spring Boot来做的,所以把工作中遇到的一些知识点.问题点整理一下,做成一系列学习文章,供后续学习Spring Boot的同仁们参考,我也是第一次接触Spring ...

  2. Myeclipse下使用Maven搭建spring boot项目

    开发环境:Myeclipse2017.JDK1.6.Tomcat 8.0.Myeclipse下使用Maven搭建spring boot项目,详细过程如下: 1. New -> Project.. ...

  3. Spring Boot入门(一):搭建Spring Boot项目

    从本篇博客开始,我们开始进入Spring Boot的世界,它的出现使Spring的开发变得更加简洁,因此一经推出受到众多程序员的喜爱. 作为Spring Boot系列的第一篇博客,我们先来讲解下如何搭 ...

  4. 基于 intellij IDEA 快速搭建Spring Boot项目

           在<一步步搭建 Spring Boot maven 框架的工程>一文中,已经介绍了如何使用Eclipse快速搭建Spring Boot项目.由于最近将开发工具由Eclipse ...

  5. 使用IDEA,Eclispe搭建Spring Boot项目

    如何创建一个Spring Boot项目?这里使用maven来进行依赖管理,根据常用的IDE,可以使用IDEA.Eclipse.或者访问官方网站搭建. 项目搭建环境准备 JDK:1.8 MAVEN:3. ...

  6. Myeclipse下使用Maven搭建spring boot项目(第二篇)

    现在需要搭建spring boot框架,并实现一个HelloWorld的项目,让程序真正运行起来. 一.在pom.xml中引入spring-boot-start-parent,spring官方的叫st ...

  7. Spring boot入门(一):快速搭建Spring boot项目

    (一)Spring boot介绍 本部分摘自:https://www.zhihu.com/question/64671972/answer/223383505 Spring Boot是由Pivotal ...

  8. 构建微服务:快速搭建Spring Boot项目

    Spring Boot简介: Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程.该框架使用了特定的方式来进行配置,从而使开发人员 ...

  9. 基于gralde搭建spring boot项目

    搭建基于gradle的sprint boot项目,swagger-ui辅助 spring boot官网:http://projects.spring.io/spring-boot/get start ...

  10. 快速搭建Spring Boot项目

    Spring boot是Spring推出的一个轻量化web框架,主要解决了Spring对于小型项目饱受诟病的配置和开发速度问题. Spring Boot 包含的特性如下: 创建可以独立运行的 Spri ...

随机推荐

  1. 解决table边框在打印中不显示的问题

    先了解一下,table边框如何设置 一.只对表格table标签设置边框 只对table标签设置border(边框)样式,将让此表格最外层table一个边框,而表格内部不产生边框样式.CSS代码: .t ...

  2. cs231n(一)

    1.Nearest Neighbor Classifier 计算未分类数据(图片)与已标记类别的训练数据(training set)的距离(L1,L2等距离),然后返回与训练数据(图片)最小距离的图片 ...

  3. mosquitto配置文件/etc/mosquitto/mosquitto.conf配置参数详细说明

    mosquitto配置文件/etc/mosquitto/mosquitto.conf配置参数详细说明 摘自:https://blog.csdn.net/weixin_43025071/article/ ...

  4. Yii2 修改 breadcrumb 首页图标

    <?=Breadcrumbs::widget([ 'homeLink' => [ 'label' => '<i class="fa fa-home"> ...

  5. mysql链接错误:2003 can't connect to mysql server on 10038

    出现这个错误原因是端口号不是3306.  打开D:\Program Files\MySQL\MySQL Server 5.5 \my.ini文件,当然还有其他的.ini的文件:   [client] ...

  6. python之CSV文件格式

    1.csv文件是以一些以逗号分隔的值 import csv filename = "wenjian.csv" with open(filename) as f: reader = ...

  7. 编写高质量代码改善C#程序的157个建议——建议100:静态方法和实例方法没有区别

    建议100:静态方法和实例方法没有区别 静态方法在加载时机和内存使用上和实例方法完全一致.在这里,我们先引出一个概念“类型对象”.比如类型Person,我们都知道new Person() 会产生一个对 ...

  8. Mybatis 多个Mapper

    在实际应用中的,会有较多个mapper.如果每新建一个mapper,就向SqlMapConfig上加上对应的配置文件,会十分不便. 可以新建一个package,在其下面放置Mapper.java,同时 ...

  9. C#函数式程序设计之惰性列表工具——迭代器

    有效地处理数据时当今程序设计语言和框架的一个任务..NET拥有一个精心构建的集合类系统,它利用迭代器的功能实现对数据的顺序访问. 惰性枚举是一个迭代方法,其核心思想是只在需要的时候才去读取数据.这个思 ...

  10. redis整理の持久化机制

    redis是一个支持持久化的内存数据库,也就是说 redis 需要经常将内存中的数据同步到磁盘 来保证持久化.redis 支持两种持久化方式,一种是 Snapshotting(快照)也是默认方式,另 ...