Spring Boot 实战 入门
目前没有系统学习过 spring 框架,参与工作时,直接参与到了 spring boot 项目的开发。目前还比较菜,所以,你要是和我一样,不妨也跳过 spring 框架的学习,直接学习 sring boot。
官方文档 的一段介绍:
spring boot makes it easy to create stand-alone, production-grade spring-based applications that you can run. we take an opinionated view of the spring platform and third-party libraries, so that you can get started with minimum fuss. most spring boot applications need very little spring configuration.
you can use spring boot to create java applications that can be started by using java -jar or more traditional war deployments. we also provide a command line tool that runs “spring scripts”.
大体意思是说,spring boot 可以轻松创建可以运行的独立的,基于生产级 spring 的应用程序。这个框架简化了我们 spring 的配置。可以使用 spring boot 创建 java 应用,只需要使用 java -jar
或 war
包部署方式就可以启动。也内嵌了 tomcat
,在开发时无需以 war
包也可以运行应用。
环境
下面是本文编写时,我机器的环境:
- java 1.8.0_181
- maven 3.5.4
创建项目
本文目的是创建一个基本的 restful web 服务。创建 spring boot 服务的方式主要有两种:
- 在 idea 中使用
spring initializr
创建,我个人比较倾向这种方式,方便快捷; - 访问网站 spring initializr 网站,勾选相关项目依赖,最后生成一个初始化项目,导入 ide。
下面主要介绍 idea 如何初始化一个 sring boot 项目:
1.file-new-porject,选择 spring initializr
,选择 sdk 版本;
2.输入项目的元数据信息,关系到项目的路径、 pom
文件中项目的 maven 坐标( gav
),;
3.选择需要的 maven 依赖,这里 spring boot 版本,我选择了 2.1.6
版本;
4.最后一步指定项目存放位置;
-
src/main/java
中有项目代码文件,根目录下是入口类:springboothelloworldapplication
类。@springbootapplication
注解,这是整个 spring boot 的核心注解,它的目的就是开启 spring boot 的自动配置。 -
src/main/resources
下是配置文件:application.properties
-
src/test/
下的测试入口:chapter1applicationtests
添加控制器类 —— controller
通常在项目中对外提供的 api 都会放在叫做 controller
的包下。
这里向大家推荐一个测试交流圈q裙:790047143。
我们创建一个 controller
的包,并添加一个叫做 helloworld
的类:
@restcontroller public class helloworld { @getmapping("/hello") public string sayhello() { return "hello world"; } }
-
@restcontroller
注解加在这个类上,使之变为一个controller
这是我们启动项目,便可以通过地址 localhost:8080/hello
或 127.0.0.1:8080/hello
看到 sayhello
函数执行的内容。
查看控制台的输出,我们可以知道 spring boot 项目启动时,默认的端口是 8080
profile
官方文档中有关于 profile 的描述。 prorile
有 轮廓、外形、简况
的含义,这里我就把它理解为「配置描述」好了。
在实际项目中,生产、beta 不同环境将采用不同的配置,比如数据库配置等等。这时候,我们只需要创建多分 profile 文件即可。
除了 application.properties
文件,配置文件还可以采用下面的命名规则 application-{profile}.properties
。environment 中具有一组可选的值。如果没有设置需要激活什么配置文件,就默认激活 default
配置,即 application-default.properties
。
指定的配置文件都是从同一个位置被激活,即从标准的配置文件 application.properties
。
如果指定了多个配置文件,采取 last-win
策略,即「最后获胜侧率」。这句话意思是什么呢,就是说,在你的 application.properties
中如果指定了激活好几个配置文件,那么,最后指定的那个配置文件才会生效。
我们分别创建两个环境配置文件:
-
application-dev.properties
测试环境
server.port=8081
-
application-prod.properties
生产环境
#server.port=8082
通过 application.prperties 指定 profile
applcation.properties
公共配置文件。激活 dev 配置文件,需要在 application.properties
设置:
#这里定义8080主要是为了看端口设置是否会被 dev 覆盖 server.port=8080 spring.profiles.active=dev
这时候启动程序时,我们查看控制台就可看到 dev
环境被激活了,应用端口是 8081
。这时候观察 application.properties
的端口设置是否会会生效。经过测试可以发现,此时 8080
端口被 dev
的配置覆盖了。
接着,我们激活 prod
配置,注意,此时我将 prod
端口配置注释掉了,这时候观察 application.properties
的端口设置是否会会生效。经过测试可以发现,此时 8080
端口生效了。
通过 environment 指定 profile
除了上面在 application.properties
指定激活的配置外,还可以在 envirionment 中设置相关环境变量激活:
经过测试,我在 environment 中设置环境变量激活了 dev
的配置,然后在 application.properties
激活的是 prod
的配置,最终控制台日志显示, dev
配置被激活。
jar 方式运行时
如果采用 mvn clean package
打出 jar
包,那么可以使用如下方式指定 profile:
java -jar spring-boot-hello-world-0.0.1-snapshot.jar --spring.profiles.active=dev
property 值获取
我们可以在 profile 中指定一些 propety
的值,在程序中可以获取到。
在 application-dev.properties
定义如下:
server.port=8081 author.name=michael
接着,我们在 controller 类中使用 @value
注,即可获取到这个属性:
@restcontroller public class helloworld { @value(value = "${author.name}") private string authorname; @getmapping("/hello") public string sayhello() { return "hello world by " + authorname; } }
定制 banner
banner 就是指我们在启动应用时控制台一开始打印的那个内容,默认是打印 spring boot
。
-
src/main/resorces
下新建一个名为banner.txt
的内容; - 复制你想显示的内容到
banner.txt
。
个性化 banner 来源:
送一个有趣的 banner:
//////////////////////////////////////////////////////////////////// // _ooooo_ // // o8888888o // // 88" . "88 // // (| ^_^ |) // // o\ = /o // // ____/`---'\____ // // .' \\| |// `. // // / \\||| : |||// \ // // / _||||| -:- |||||- \ // // | | \\\ - /// | | // // | \_| ''\---/'' | | // // \ .-\__ `-` ___/-. / // // ___`. .' /--.--\ `. . ___ // // ."" '< `.___\_<|>_/___.' >'"". // // | | : `- \`.;`\ _ /`;.`/ - ` : | | // // \ \ `-. \_ __\ /__ _/ .-` / / // // ========`-.____`-.___\_____/___.-`____.-'======== // // `=---=' // // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ // // 佛祖保佑 永不宕机 永无bug // ////////////////////////////////////////////////////////////////////
补充知识
spring-boot-starter
spring boot 提供了很多”开箱即用“的依赖模块,都是以 spring-boot-starter-xx
作为命名的。下面列举一些常用的模块:
- spring-boot-starter-logging :使用 spring boot 默认的日志框架 logback。
- spring-boot-starter-log4j :添加 log4j 的支持。
- spring-boot-starter-web :支持 web 应用开发,包含 tomcat 和 spring-mvc。
- spring-boot-starter-tomcat :使用 spring boot 默认的 tomcat 作为应用服务器。
- spring-boot-starter-jetty :使用 jetty 而不是默认的 tomcat 作为应用服务器。
- spring-boot-starter-test :包含常用的测试所需的依赖,如 junit、hamcrest、mockito 和 spring-test 等。
- spring-boot-starter-aop :包含 spring-aop 和 aspectj 来支持面向切面编程(aop)。
- spring-boot-starter-security :包含 spring-security。
- spring-boot-starter-jdbc :支持使用 jdbc 访问数据库。
- spring-boot-starter-redis :支持使用 redis。
- spring-boot-starter-data-mongodb :包含 spring-data-mongodb 来支持 mongodb。
- spring-boot-starter-data-jpa :包含 spring-data-jpa、spring-orm 和 hibernate 来支持 jpa。
- spring-boot-starter-amqp :通过 spring-rabbit 支持 amqp。
- spring-boot-starter-actuator : 添加适用于生产环境的功能,如性能指标和监测等功能。
springboot 目录结构
目录结构理解
- controller:控制层,前端控制器,负责页面访问控制,主要是对外提供的api接口,用户使用服务时的入口处,可以结合swagger生成对应的api文档
- service:业务层,逻辑层,主要是业务类代码,归档了前端控制器中相关服务的操作方法接口类,该文件夹下包含子impl文件夹,归档对应的实现接口
- domain:实体类,归档对应的实体(entity),一个实体尝尝就对应着数据库中一张表
- dao:数据访问层,实体类对应的数据库操作接口类,它与数据库进行交互,封装了对数据库的curd操作
- config:配置信息类
- utils:工具类
- constant:常量接口类
当请求来了,controller 就会将相应的请求分发到相应的 service层,在 service 层中再调用 dao 层进行数据库交互。这里的 dao 层其实就是之前的 model 层,封装了对数据库的操作。这样一来,就把业务处理逻辑从 controller 中分离出来,从而实现了解耦。
感谢您的观看,如有不足之处,欢迎批评指正。
获取资料
本次给大家推荐一个免费的学习群,里面概括java架构/分布式/微服务/docker/高性能高并发以及面试资源等。对java架构感兴趣的程序猿,欢迎加入q群:790047143,不管你是刚入行得还是大牛我都欢迎,还有大牛整理的一套高效率学习路线和教程与您免费分享,同时每天更新视频资料。
最后,祝大家早日学有所成。