从零开始使用IDEA搭建Springboot+JPA+Swagger2.0+Logback+Lombok+Redis+Shiro1.4项目(一)
搭建Springboot项目——Hello World
前言
在校期间,学习的是最原生的Spring + SpringMVC + JDBC
,到后来的JDBCutil
,Hibernate
,以及最后接触的MyBatis
,因此在校写的小项目一直都是使用SSM
框架。后来在发现绝大部分公司使用的都是Springboot
之后,才意识到软件行业发展确实很快,学到的东西真的很容易过时。
由于以前一直使用Eclipse
作为开发工具,开发过程中所需要的 jar 包也是提前下载好的,几十个 jar 包一股脑塞进去,也不知道用上了几个,所以显得很臃肿。反正是学习新的框架,不如全都换成新的,使用更便捷的IDEA
作为开发工具来对新框架进行学习。
准备工作
- 下载并安装
Maven
、IDEA
、JDK
、MySQL
、SQLyog
。 - 配置
Maven
、JDK
、MySQL
环境变量。 - 修改
Maven
的默认镜像为阿里的镜像。 - 启动
IDEA
。
代码工作
创建Springboot项目
创建 Springboot项目:选择Spring Initializr
项目,Project SDK
中选择配置好的 JDK
。
填写域名、项目名
填写Group
和Artifact
:Group
和Artifact
是 Maven 中区分项目的字段。Group
如 com.example,com是域,example 是自己的域名,Artifact
是项目名。但是个人练手项目就随便起就好了,因为我当时也不懂。
添加所需依赖
添加依赖:根据自己的项目添加所需的初始依赖。如果只是简单地跑出 Hello World 只需在 Web 中添加Spring Web Starter
即可(也可以先添加依赖,然后去pom.xml
中将暂时用不到的依赖注释掉)。
选择项目存放路径
选择项目的路径:可以自建一个文件夹专门用来存放 IDEA 的项目。
导入依赖
点击右下角的Import Changes
配置pom.xml
文件。在pom.xml
中配置的信息就相当于给项目导入依赖的 jar 包。
修改 application 的文件类型&创建 controller 文件夹
将 resources
包下的 application.properties
文件改为 application.yml
,此类型的文件较之properties
文件显的更加清晰明了。找到java
文件夹下的 Application
文件,创建一个与之同级的controller
文件夹,文件夹下存放的是用于界面跳转或者数据传递Controller
类。
创建 Controller 类
创建 HelloController 类,在HelloController中添加注释 @RestController,构造一个返回值为 String 类型的方法,加以 @RequestMapping 注解,配置地址映射。
package com.demo.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author Dawn
* @ClassName com.demo.controller.HelloController
* @Description
* @date 2019/7/26 13:51
*/
@RestController
public class HelloController {
@RequestMapping(value = "/hello")
public String sayHello(){
return "Hello World!";
}
}
运行
运行,出现界面,一个简单的 Springboot 项目便完成了。
总结
Group & Artifact
<groupId>com</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>demo</name>
<packaging>jar</packaging>
groupId
和 artifactId
作为坐标的意义存在于项目中,为了确保项目的唯一性。如果该项目要部署进 Maven 本地仓库,就需要依靠这两个 id 来定位项目。
groupId
定义了该项目属于哪个组,一般分为多段,可以简单表示为:域名.公司名.项目名。
artifactId
定义了该项目在组中的唯一标识。
version
指定了该项目的当前版本,如果版本是SNAPSHOT
——快照,则说明该项目仍处于开发阶段。
name
不是必须的,是相比于原项目名来说,对于用户更为友好的名称,方便信息交流。
packaging
是该项目的打包方式,如果如图中进行声明,则打包为jar
形式,如果不声明,则默认为war
形式。
pom.xml
官方解释:pom 是项目对象模型,以 xml 文件形式表示。pom.xml
中包含了配置文件、涉及的开发人员及其所扮演的角色、缺陷跟踪系统、组织和许可证、项目所在的URL、项目的依赖关系以及所有可以发挥代码生命的其他小部分。这是项目所有事情的一站式商店。事实上,在Maven世界中,一个项目根本不需要包含任何代码,只需要一个pom.xml
。
对于刚接触Springboot
+Maven
形式的来说,pom.xml
的主要作用应该是省去了频繁下载jar
并buildpath
的麻烦,需要什么服务的支持就添加依赖,并从Maven
镜像中拉取,import
到项目中。
@Controller & @RestController
以前的方法是使用 @Controller 注解 Controller 类,配合视图解析器 InternalResourceViewResolver 实现界面的跳转。如果需要返回 json 等值到界面,在对应的方法上使用 @ResponseBody 注解。
而注解 @RestController 相当于 @Controller + @ResponseBody 的组合,省去了在每个方法上添加 @ResponseBody 注解的麻烦,缺点是整个 Controller 类都不支持界面的跳转,想要实现界面的跳转需要新建一个专门用于界面跳转的类,并使用 @Controller 注解。