此篇文章将详细介绍如何用Idea工具构建一个完整的springboot项目,包括数据库的连接,配置文件的设置,依赖的添加,maven命令的说明,以及项目的打包运行和发布。
Idea版本:2018.2(也可以使用其他版本)
jdk版本:1.8.201 (至少Jdk1.8以上版本)
SpringBoot版本:2.1.5(至少2.0以上版本)
关于idea和jdk的安装大家可以在网上自行搜索
1、使用Spring初始化工具新建项目
(不喜欢看文字的,视频教程在最后面,百度网盘已分享)
打开Idea工具后,点击左上角File>New>Project...
会弹出一个New Project的对话框,我们选择左边的Spring Initializr模板初始化项目,此模块是spring官方提供的,要确保连接到网络
Project SDK为默认的jdk版本,其他不用修改,点击Next按钮。
参数说明
Group:组织域名,域名的倒写,比如com.apgblogs
Artifact:项目名称,使用小写,如果有多个单词用“-”分割
Type:默认是mave项目,mave用的人比较多也比较简单
Language:选择java语言
Packaging:默认jar包发布,也可以选择war包发布,在微服务流行的情况下都是用jar包发布
Java Version:8
Version:我们项目的版本号,默认值不用修改,如果有项目版本迭代可以修改此值。
Name:表示项目名,会自动生成,无需修改,修改Artifact参数会联动修改此值
Description:项目描述,可以自己写,比如这是个大数据项目,人工智能项目等等
Package:包名,此值也是自动生成,无需修改
参数确认无误后,点击Next按钮,进入下一步操作
这一步我们选择项目依赖的jar包,右边红色框是我已经选好的依赖,第一个Web依赖,在左边Web目录下,进入后在中间的框框进行勾选即可。
SpringBoot版本号选择2.1.5,如果有的话选择这项,没有的话就选择2.0以上的版本,1.5和2.0变化是比较大的,版本号选择在中间框框的上面,下拉选择。
确认无误后,我们点击Next按钮,进入下一步
此对话框选择项目名,和项目路径,确认项目路径无误后,选择Finish按钮,完成此操作。
如果弹出此对话框,意思是在新窗口打开,还是当前窗口打开,如果有多个项目可以在新窗口打开,如果只有这一个则选择当前窗口,我们选择This Window按钮。
这时候会打开一个新窗口,Spring模板会自动创建目录,Maven会根据pom文件在Maven中心仓库下载依赖,确保电脑网络连接正常,否则会导致依赖下载失败。
我们删除无用的文件,红色框框选择的文件都可以删除,属于无用文件,HELP.md是帮助,spring会根据选择的依赖生成此文件,如果想看那个依赖的官方帮助,可以点击此文件里面的链接查看。
删除后的项目目录如下图所示
目录结构说明
src:是整个项目的主目录,存放所有代码文件和配置文件
main:表示主项目目录,里面存放源代码和资源文件
java:表示源代码目录
com.apgblogs.firstspringboot:就是我们写自己业务代码所在的包名
FirstSpringBootApplication:是我们启动springBoot项目的入口方法
resources:表示资源目录,springBoot的配置文件或者其他配置文件存放到此目录
application.properties:是springBoot配置文件,一般我们使用yaml格式编写
test:表示测试用例目录,我们写完的代码如果想进行测试,可以再此目录中写测试用例
pom.xml:是maven的构建文件,此文件包含项目所需要的所有依赖,项目依赖的加入和删除在此文件中配置。
接下来我们不编写任何代码,启动SpringBoot项目
在 FirstSpringBootApplication 类上右键直接Run即可
我们遗憾的发现启动失败了,说是数据源的问题
意思是我们在配置文件中没有配置数据库,这个错误原因主要跟我们导入了Jpa的依赖确没有配置数据源
我们在pom.xml中将jpa的依赖注释掉,然后用同样的方式启动项目
我们发现项目启动成功了,访问的端口号是8080,springBoot内置了tomcat,所以我们无需在安装tomcat即可开发web项目,当然也可以使用tomcat启动,这里就不说明了,网上有很多的案例。
我们打开浏览器输入:http://localhost:8080
出现此提示说明已经能正常访问了,404表示我们没有写任何的controller,用来处理地址的跳转
接下来我们编写一个自定义的controller,输出Hello SpringBoot
我们在com.apgblogs.firstspringboot包名上右击,New>Package,创建一个名为controller的包,包名都小写。
然后在controller包名上新建一个类名为HelloController
然后我们加入SpringBoot的注解,让其可以被spring容器管理,并处理我们的访问,添加代码如下图所示
注解说明
@RestController:此注解表示这个类是控制器,Rest表示此累的所有方法默认返回Json格式的数据。
@GetMapping(""):此注解表示访问只能用get方式,参数为空表示从根目录映射。
然后我们用同样的方式启动项目
刷新刚刚浏览器的地址就可以看到输出了Hello SpringBoot
至此我们一个springBoot项目就构建完了,接下来我们开始连接数据库。