Spring boot学习(二) Spring boot基础配置

前言

上一篇博客中介绍了如何创建一个简单的Spring boot应用,本篇文章介绍Spring boot中的一些基本配置,只有认识和了解这些配置,才能为我们以后的深入学习Spring boot做好铺垫。

文章首发于个人博客:【http://www.xiongfrblog.cn

入口类

首先,我们在新建一个Spring boot项目的时候,Spring boot会自动为我们在包的根目录下创建一个名为xxxApplication.java的启动类,该启动类是我们项目的入口类,包含一个main方法,执行该方法就启动了项目。

启动类中有一个核心的注解@SpringBootApplication,它是一个组合注解,包含以下三个注解:

  1. @Configuration:表示将当前类作为Spring的配置类,经常配合@Bean使用将某个对象注册到Spring上下文。
  2. @EnableAutoConfiguration:表示启动程序时自动加载Spring boot的默认配置。
  3. @ComponentScan:表示启动程序时自动扫描当前包及子包下所有交由Spring管理的类,比如被@Component@Service@Controller等标记的类。

注意

上边说过启动类一般放在包的根目录下,是因为@ComponentScan注解默认扫描当前包及子包,如果需要指定扫描路径,需要加上参数,例如@ComponentScan("com.example.demo.dao")

Spring boot官方配置了@SpringBootApplication注解来替代上边介绍的三个注解,更加简洁明了。

全局配置文件

Spring boot使用一个全局的配置文件application.propertiesapplication.yml,该配置文件一般位于src/main/resource目录下,两种配置文件唯一的区别就在于书写的格式不一样,现在比较主流的是application.yml格式的配置文件,要熟练使用该种格式的配置文件需要熟悉基础的yaml语法,这里不做过多介绍,本篇博客均使用application.properties格式的配置文件,下面介绍两个最基本的配置。

修改项目启动端口

server.port=1188

修改访问项目的默认路径

一般访问项目的根路径默认localhost:11188,但是有时候我们会在访问路径上加上当前项目的名字,这时候就需要修改默认的访问路径了。

#spring boot版本2.0以下
server.context-path=/demo
#spring boot版本2.0以上
server.servlet.context-path=/demo

这里根据Spring boot的版本不同有不同的配置们大家根据自己的版本选择对应的属性名即可,由于我的Spring boot版本是2.1.2,所以选择server.servlet.context-path的属性名,此时访问项目的根路径就的url就变成了localhost:11188/demo

其它配置

当然,Spring boot中可以配置属性还有很多,比如配置 Email:

spring.mail.default-encoding=UTF-8 # Default MimeMessage encoding.
spring.mail.host= # SMTP server host. For instance, `smtp.example.com`.
spring.mail.jndi-name= # Session JNDI name. When set, takes precedence over other Session settings.
spring.mail.password= # Login password of the SMTP server.
spring.mail.port= # SMTP server port.
spring.mail.properties.*= # Additional JavaMail Session properties.
spring.mail.protocol=smtp # Protocol used by the SMTP server.
spring.mail.test-connection=false # Whether to test that the mail server is available on startup.
spring.mail.username= # Login user of the SMTP server.

这里就不列举了,太多了,具体可以查阅官方文档【传送门】

自定义属性

在实际项目中,很多情况我们需要定义一些全局属性,在需要的地方注入使用即可,Spring boot允许我们在application.properties下自定义一些属性,下面介绍自定义属性并且使用。

在配置文件中定义属性

blog.login.name=admin
blog.login.pass=1234

我们在application.properties定义了blog.login.nameblog.login.pass两个属性。

注入自定义属性

为了方便演示,我们定义一个名为TestController.java的控制器,使用@Value注解注入属性,全部代码如下:

package com.web.springbootconfig.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**
* @author Promise
* @createTime 2018年12月27日 下午10:11:35
* @description 
*/
@Controller
public class TestController {
    
    @Value("${blog.login.name}")
    private String name;
    
    @Value("${blog.login.pass}")
    private String pass;
    
    @RequestMapping("/test")
    @ResponseBody
    public String configTest() {
        return "name="+name+";pass="+pass+";nick="+nick;
    }
}

可以看到使用@Value(属性名名)的方式注入我们自定义的属性,此时启动项目浏览器访问localhost:1188/demo/test127.0.0.1:1188/demo/test得到如下结果:

在这里插入图片描述

由图可以看出,我们拿到了在配置文件中自定义属性的值admin1234

这里有一点需要大家特别注意,只有在被Spring管理的类中才能注入属性,比如上文中我们的TestController.java控制器类名上加了@Controller注解,表明将此类交由Spring管理。

简单验证

新建一个Text.java类,内容如下:

package com.web.springbootconfig.entity;

import org.springframework.beans.factory.annotation.Value;

/**
* @author Promise
* @createTime 2019年1月14日 下午11:35:52
* @description 
*/
public class Test {

    @Value("${blog.login.name}")
    private String name;
    
    @Value("${blog.login.pass}")
    private String pass;

    //省略getter,setter方法
}

再在TestController.java控制器中添加如下方法:

    @RequestMapping("/check")
    @ResponseBody
    public String check() {
        Test test =new Test();
        return "name="+test.getName()+";pass="+test.getPass();
    }

重启项目,浏览器访问localhost:1188/demo/check,此时得到如下结果:

在这里插入图片描述

可以看到输出为null,正是因为我们的Text.java类没有交由Spring管理,所以Spring并没有为我们自动注入属性,这点一定要注意!

热部署

从之前的操作中,很多小伙伴肯定已经发现了我们每次对项目做修改的时候都需要手动重启项目才能够正确访问到新的内容,这对我们平常的开发来说肯定非常不友好的,别担心,Spring boot也为我们设计了热部署功能,修改完代码保存之后Spring boot会自动重启加载最新的内容,只需要我们简单的配置即可。

Devtools

Spring为开发者提供了一个名为spring-boot-devtools的模块来使Spring boot应用支持热部署,提高开发者的开发效率,无需手动重启Spring boot应用。

修改pom.xml

pom.xml文件中添加Devtools依赖,代码如下:

<!-- 热部署 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

并且修改build模块,如下:

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <fork>true</fork>
            </configuration>
        </plugin>
    </plugins>
</build>

修改application.properties配置文件

在配置文件中添加如下内容(其实不添加也可以,因为默认就是打开的,这里提出来是方便有时候可以关闭热部署。)

spring.devtools.restart.enabled: true

需要关闭热部署功能时将属性值设置为false即可。

好了,至此热部署的功能就已经配置完成了,现在可以启动项目,然后随便修改一个文件保存,你会发现控制台已经更新了日志,等待项目重新启动之后发现更新的内容已经展示在浏览器上了。

Profile配置

在实际的企业级开发过程中,我们总是有开发环境,生产环境等不同的环境,同一个项目在每一个不同的环境需要的配置总是不一样的,这时候如果每换一个环境就修改一次application.properties配置文件的内容,对开发人员来说是非常糟糕的体验,所以Spring boot为我们提供了不同环境指定特定的配置文件的功能,而我们只需要简单的配置即可,完美解决难题。

多环境配置文件必须以application-{profile}.properties的格式命名,其中{profile}为环境标识,比如我们有一个开发环境需设置启动端口为1188,一个生产环境需设置启动端口为1189,两个配置文件分别为:

  • application-dev.properties:开发环境
    server.port=1188
    
  • application-prod.properties:生成环境
    server.port=1189
    

启动项目具体加载哪个配置文件需要在application.properties配置文件中添加如下代码指定(比如我们使用开发环境):

spring.profiles.active=dev

项目打包

pom.xml配置

Spring boot可以将项目打成不同类型的包,比如jar包,war包,pom包等,这里我们只介绍最长用的jar包,打包需要在pom.xml文件中有如下的配置(这里贴出完整的pom.xml):

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.web</groupId>
    <artifactId>springboot-config</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>springboot-config</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- 热部署 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <fork>true</fork>
                </configuration>                
            </plugin>
        </plugins>
    </build>

</project>

其中关于打包的重要代码为:

指定打包的类型

<packaging>jar</packaging>

Spring Boot Maven打包插件spring-boot-maven-plugin,该插件将项目打成一个可执行的jar包,包括把应用程序的所有依赖打入jar文件内,能让你在命令行用java -jar来运行应用程序。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <fork>true</fork>
            </configuration>                
        </plugin>
    </plugins>
</build>

使用eclipse打包

右键项目选择Run As->Maven build,在弹出框的Goals输入clean package点击Run即可。

打包前在项目的根目录下会发现一个空的target文件夹,打包生成的文件会放在这个文件夹内,打包前:

在这里插入图片描述

打包后:

在这里插入图片描述

可以看到生成了一个jar文件。

执行jar包

命令行进入jar包所在的目录,运行Java -jar jar包名.jar即可启动项目,此时启动浏览器访问localhost:1188/demo/test可以看到与之前一样的内容。

命令行参数

在执行jar包的时候我们也可以指定参数,比如指定端口号为8089java -jar jar包名.jar --server.port=8089,也可以指定使用哪个环境的配置文件等很多东西,这里不一一概述了。

结语

好了,Spring boot的一些基础的配置就说到这里,更多的内容需要我们自己在不断的实践中继续了解,下期内容再见,bye~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,688评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,559评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,749评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,581评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,741评论 3 271
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,684评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,122评论 2 292
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,847评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,441评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,939评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,333评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,783评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,275评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,830评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,444评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,553评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,618评论 2 249

推荐阅读更多精彩内容