官方文档:https://docs.spring.io/spring-boot/docs/2.2.4.RELEASE/reference/html/index.html
官方API:https://docs.spring.io/spring-boot/docs/2.2.4.RELEASE/api/
说明
本栏目以搭建前后端分离的java web项目为目标,后端项目采用spingboot开发,提供restful风格的服务端API接口。
这一章记录作者使用springboot官网提供的Spring Initializr
功能搭建基础的java web项目的过程,作为整个栏目的开端。
一. 官网下载 springboot web 项目
登录 https://start.spring.io/ ,在官网配置并下载springboot项目
-
配置项目基本信息
projcet 选择gradle projcet
、 Language 选择Java
、 Spring Boot 选择2.2.4
版本、项目名称为tysite-service
。
-
调整项目参数
调整 Package name为org.tysite.tyservice
、Packaging 为war
包模式、 Java 版本为8(即jdk1.8)
说明:java web项目的常用部署方案为war
模式 -
选择默认依赖
本章旨在搭建最基础的 java web 项目,故依赖仅选择spring web
-
下载项目
确认配置信息准确后,点击Generate - Ctrl + Enter
下载项目,完成后获得项目包tysite-service.zip
-
解压项目
解压tysite-service.zip
到项目目录D:\workspace\tysite_workspace
。
tysite-service
目录结构如下:
二. 配置maven仓库
编辑 build.gradle
文件,注释中央仓库mavenCentral()
,然后增加本地仓库mavenLocal()
和 私有maven仓库,如下所示:
mavenLocal()
maven {
url "http://nexus.tysite.org/repository/maven-public/"
}
三. 启动项目
1、环境准备
启动本项目,需要本地安装 jdk1.8 和 gradle 6.0.1
2、清空默认版本号
gradle bootWar
命令生成的war包,会包含version
,如tysite-service-0.0.1-SNAPSHOT.war
,故须将version设置为空字符串。
version = ''
3、springboot启动
本项目中内置了tomcat,打包后进入war包存储目录build\libs
,可以直接通过 java -jar tysite-service.war
命令启动。
从启动日志中可以看到,本项目的默认端口为8080
,在浏览器中访问如下地址
http://localhost:8080
界面反馈信息如图所示
4、构建启动任务
为了简化 gradle
启动命令,我们在 build.gradle
创建如下 gradle task
,实现在windows 或 linux系统中启动该项目
task run(type:Exec) {
dependsOn bootWar
workingDir '.'
if (System.getProperty('os.name').toLowerCase(Locale.ROOT).contains('windows')) {
commandLine 'cmd', '/c', 'java -jar build/libs/tysite-service.war'
} else {
commandLine 'sh', '-c', 'java -jar build/libs/tysite-service.war'
}
}
启动本项目的命令如下
gradle run