快速创建SpringBoot项目指南与Restful服务详解
文章目录
- 1.1 快速创建SpringBoot项目指南
- 1.1.1 创建新Spring Boot项目一
- 1.1.1.1 浏览器中生成新Spring Boot项目
- 1.1.1.2 在新项目中添加自己代码
- 1.1.1.3 测试新项目
- 1.1.2 创建新Spring Boot项目二
- 1.2 RESTful 服务
- 1.2.1 Restful理解
- 1.2.2 创建实体类
- 1.2.3 RESTful 控制器类
- 1.2.4 RESTful 服务测试
1.1 快速创建SpringBoot项目指南
目标
1、从0创建一个Spring Boot项目
2、测试Spring Boot项目是否能正常访问。
满足如上的2个条件之后，大家就自由发挥啦！！！
1.1.1 创建新Spring Boot项目一
前面我们已经了解咯Spring Boot是什么，下面我们接着学习Spring Boot项目相关内容。
首先创建Spring Boot项目方式有很多种，不同的方式，几乎相同的结果，所以选择哪一种方式都可以，如下是几种创建Spring Boot项目的方式：
- 在浏览器中访问：https://spring.io/quickstart 地址，然后再该网页上填写项目信息并生成代码。
- 在IDEA中创建：File—>New—>Project—>Spring Initializer -->Next —> 填写项目信息即可。
- 复制一份已经存在的Spring Boot项目，然后再修改成自己想要的也行。
1.1.1.1 浏览器中生成新Spring Boot项目
在浏览器地址栏输入：https://spring.io/quickstart
**步骤1：**在浏览器页面中填写如下项目信息即可—>最后生成代码—>下载zip到本地电脑。
**步骤2：**然后解压刚下载的zip—>IDEA加载刚解压的zip代码目录—>等待Maven下载依赖—>项目构建成功。
注意:
解压刚下载的zip到任意一个目录即可，推荐解压到自己的IDEA WorkSpace下面，不建议解压到空格、中文、特殊符号目录下。
1.1.1.2 在新项目中添加自己代码
在com/qianfeng下新建一个controller。然后并在com/qianfeng/controller下创建一个HelloSpringBoot的Java类。代码如下：
1.1.1.3 测试新项目
测试和运行方式也有很多种，可以使用命令运行项目、也可以直接运行主类、可以在右侧Maven—>Plugins—>spring-boot:run运行。
-
第一种：命令方式
暂未测试！！！
-
第二种：直接运行主类
注意：
一定是项目中包含main函数的主类。
-
第三种：直接运行spring-boot:run
使用如上的任意一方式启动后(我采用第二种方式启动)，我们就可以请求主机为：localhost，port为：8080的服务。
**在浏览器地址栏输入：**http://localhost:8080/hello
**在浏览器增加那么参数请求地址：**http://localhost:8080/hello?name=bingbing
1.1.2 创建新Spring Boot项目二
该项目使用在IDEA中创建：File—>New—>Project—>Spring Initializer -->Next —> 填写项目信息即可。了解完该种创建项目方式即可，其他写自己代码、测试项目请参考4.1.1.2、4.1.1.3即可。
**步骤1：**File—>New—>Project：
**步骤2：**Spring Initializer -->Next
**步骤3：**填写项目信息—>Next
**步骤4：**选择Web—>Spring Boot版本—>Next
**步骤5：**Project name—>Project location—>Finish
点击Finsh完成后。选择This Window 或者 New Window都可以。完成后项目结构如下：
到此为止，快速创建Spring Boot指南结束。
1.2 RESTful 服务
目标
1、在原有的Spring Boot项目上测试Restful服务。
2、测试服务返回结果为Json格式。浏览器访问： http://localhost:8080/greeting返回json格式为：{"id":1,"content":"Hello, World!"}
如果服务返回数据类型为对象，该对象将会被解析为对应Json格式，解析格式具体根据返回对象而定：
返回User对象，解析为：{"uid":1,"uname":"bingbing"}
返回为数组或List等，解析为:[1,2,3,4,5,6]
返回为Map类型，解析为:{“sex”:1,"age":18}
返回为嵌套类型，解析为：嵌套格式Json封装。注意：
这个应用程序使用Jackson JSON库自动将类型实例解析到JSON中。web starter中默认自带Jackson包。
接下来，带大家使用Spring来创建一个Restful 的web服务。Restful风格服务大家先知道一下即可。
1.2.1 Restful理解
Restful 与技术无关，代表的是一种软件架构风格，REST是Representational State Transfer的简称，中文翻译为“表征状态转移”或“表现层状态转化”。REST是一种原则和约束，符合它的就称它为RESTful架构。要理解RESTful架构，最好的方法就是去理解Representational State Transfer这个词组到底是什么意思，它的每一个词代表了什么涵义。资源（Resources）:所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。表现层（Representation）:我们把"资源"具体呈现出来的形式，叫做它的"表现层"（Representation）。状态转化（State Transfer）:，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生"状态转化"（State Transfer）。而这种转化是建立在表现层之上的，所以就是"表现层状态转化。具体来说，就是HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。
1.2.2 创建实体类
需要在com/qianfeng包下创建entry包，然后再在com/qianfeng/entry包下创建Greeting的Java类。该类用于封装数据：id和content。
1.2.3 RESTful 控制器类
在Spring构建RESTful web服务的方法中，HTTP请求交由控制器处理。这些控制器组件由@RestController注解标识。我们在com/qianfeng/controller包下创建GreetingController的Java类。具体代码如下：
1.2.4 RESTful 服务测试
现在启动服务，**并在浏览器地址栏输入：**http://localhost:8080/greeting
**浏览器地址栏输入：**http://localhost:8080/greeting?name=bignbing
到此为止，你已经使用SpringBoot开发完一个Restful的Web服务啦。