定制Banner

Spring Boot项目在启动的时候会有一个默认的启动图案:

  1. . ____ _ __ _ _
  2. /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
  3. ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
  4. \\/ ___)| |_)| | | | | || (_| | ) ) ) )
  5. ' |____| .__|_| |_|_| |_\__, | / / / /
  6. =========|_|==============|___/=/_/_/_/
  7. :: Spring Boot :: (v1.5.9.RELEASE)

我们可以把这个图案修改为自己想要的。在src/main/resources目录下新建banner.txt文件,然后将自己的图案黏贴进去即可。ASCII图案可通过网站http://www.network-science.de/ascii/一键生成,比如输入mrbird生成图案后复制到banner.txt,启动项目,eclipse控制台输出如下:

  1. _ _ _ _ _ _
  2. / \ / \ / \ / \ / \ / \
  3. ( m | r | b | i | r | d )
  4. \_/ \_/ \_/ \_/ \_/ \_/
  5. ...
  6. 2017-08-12 10:11:25.952 INFO 7160 --- [main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup
  7. 2017-08-12 10:11:26.057 INFO 7160 --- [main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
  8. 2017-08-12 10:11:26.064 INFO 7160 --- [main] com.springboot.demo.DemoApplication : Started DemoApplication in 3.933 seconds (JVM running for 4.241)

banner也可以关闭,在main方法中:

  1. public static void main(String[] args) {
  2. SpringApplication app = new SpringApplication(DemoApplication.class);
  3. app.setBannerMode(Mode.OFF);
  4. app.run(args);
  5. }

全局配置文件

在src/main/resources目录下,Spring Boot提供了一个名为application.properties的全局配置文件,可对一些默认配置的配置值进行修改。

附:application.properties中可配置所有官方属性

自定义属性值

Spring Boot允许我们在application.properties下自定义一些属性,比如:

  1. mrbird.blog.name=mrbird's blog
  2. mrbird.blog.title=Spring Boot

定义一个BlogProperties Bean,通过@Value("${属性名}")来加载配置文件中的属性值:

  1. @Component
  2. public class BlogProperties {
  3. @Value("${mrbird.blog.name}")
  4. private String name;
  5. @Value("${mrbird.blog.title}")
  6. private String title;
  7. // get,set略
  8. }

编写IndexController,注入该Bean:

  1. @RestController
  2. public class IndexController {
  3. @Autowired
  4. private BlogProperties blogProperties;
  5. @RequestMapping("/")
  6. String index() {
  7. return blogProperties.getName()+"——"+blogProperties.getTitle();
  8. }
  9. }

启动项目,访问http://localhost:8080,页面显示如下:

Spring Boot一些基础配置 - 图1

在属性非常多的情况下,也可以定义一个和配置文件对应的Bean:

  1. @ConfigurationProperties(prefix="mrbird.blog")
  2. public class ConfigBean {
  3. private String name;
  4. private String title;
  5. // get,set略
  6. }

通过注解@ConfigurationProperties(prefix="mrbird.blog")指明了属性的通用前缀,通用前缀加属性名和配置文件的属性名一一对应。

除此之外还需在Spring Boot入口类加上注解@EnableConfigurationProperties({ConfigBean.class})来启用该配置:

  1. @SpringBootApplication
  2. @EnableConfigurationProperties({ConfigBean.class})
  3. public class Application {
  4. public static void main(String[] args) {
  5. SpringApplication.run(Application.class, args);
  6. }
  7. }

之后便可在IndexController中注入该Bean,并使用了:

  1. @RestController
  2. public class IndexController {
  3. @Autowired
  4. private ConfigBean configBean;
  5. @RequestMapping("/")
  6. String index() {
  7. return configBean.getName()+"——"+configBean.getTitle();
  8. }
  9. }

属性间的引用

在application.properties配置文件中,各个属性可以相互引用,如下:

  1. mrbird.blog.name=mrbird's blog
  2. mrbird.blog.title=Spring Boot
  3. mrbird.blog.wholeTitle=${mrbird.blog.name}--${mrbird.blog.title}

自定义配置文件

除了可以在application.properties里配置属性,我们还可以自定义一个配置文件。在src/main/resources目录下新建一个test.properties:

  1. test.name=KangKang
  2. test.age=25

定义一个对应该配置文件的Bean:

  1. @Configuration
  2. @ConfigurationProperties(prefix="test")
  3. @PropertySource("classpath:test.properties")
  4. @Component
  5. public class TestConfigBean {
  6. private String name;
  7. private int age;
  8. // get,set略
  9. }

注解@PropertySource("classpath:test.properties")指明了使用哪个配置文件。要使用该配置Bean,同样也需要在入口类里使用注解@EnableConfigurationProperties({TestConfigBean.class})来启用该配置。

通过命令行设置属性值

在运行Spring Boot jar文件时,可以使用命令java -jar xxx.jar --server.port=8081来改变端口的值。这条命令等价于我们手动到application.properties中修改(如果没有这条属性的话就添加)server.port属性的值为8081。

如果不想项目的配置被命令行修改,可以在入口文件的main方法中进行如下设置:

  1. public static void main(String[] args) {
  2. SpringApplication app = new SpringApplication(Application.class);
  3. app.setAddCommandLineProperties(false);
  4. app.run(args);
  5. }

使用xml配置

虽然Spring Boot并不推荐我们继续使用xml配置,但如果出现不得不使用xml配置的情况,Spring Boot允许我们在入口类里通过注解@ImportResource({"classpath:some-application.xml"})来引入xml配置文件。

Profile配置

Profile用来针对不同的环境下使用不同的配置文件,多环境配置文件必须以application-{profile}.properties的格式命,其中{profile}为环境标识。比如定义两个配置文件:

  • application-dev.properties:开发环境

    1. server.port=8080
  • application-prod.properties:生产环境

    1. server.port=8081

至于哪个具体的配置文件会被加载,需要在application.properties文件中通过spring.profiles.active属性来设置,其值对应{profile}值。

如:spring.profiles.active=dev就会加载application-dev.properties配置文件内容。可以在运行jar文件的时候使用命令java -jar xxx.jar --spring.profiles.active={profile}切换不同的环境配置。

参考:maven根据profile,resources,filters来区分部署环境