Springboot2專案配置(熱部署+war+外部tomcat+外部配置檔案)

zhoujumbo發表於2019-06-05

很多人在學習springboot時感嘆於它便捷的自動化配置、內建tomcat、jar包啟動,當然,這是我們很多人轉用boot開發的原因。但是,在有些場景下或者實際工作中,往往有很多原因使我們陷入困擾,比如將boot的jar交給docker部署,比如我們是舊的專案改造,比如我們的配置檔案是外部平臺來管理,比如我們必須用外部tomcat來執行等等,經常使我們有些初入坑的同學感到頭疼。當然,這些問題對於springboot來說都不是問題。springboot除了可以在application.properties配置外,其實是將很多配置交給了程式碼來管理,我們可以通過繼承配置類或者實現配置介面來進行很多的自定義開發方案實現。

本文主要記錄一下幾種定製化配置

  • 開發/測試/生產多環境配置檔案切換
  • 將springboot打成war包
  • 在IDEA中用外部tomcat執行部署
  • 通過啟動環境變數讀取配置檔案
  • IDEA下配置設部署,提高開發效率

環境介紹

  • OS:windows10
  • IDE:IDEA2017.2
  • JDK:1.8
  • MAVEN:3.5

一、開發/測試/生產多環境配置檔案切換

在這裡插入圖片描述

如圖,在application配置檔案外新建n個字尾自定義的配置檔案,然後在application中方不經常變化的預設的系統配置,在新建的配置
檔案中放例如像資料庫連線這類的需要切換環境的配置;
在application中通過spring.profiles.active=dev可以自由切換不同的環境

二、將springboot打成war包,並用外部tomcat執行部署

首先上pom.xml

<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>
	<artifactId>com-jum-demo</artifactId>
	<packaging>war</packaging>
	<parent>
		<groupId>com.jum.demo</groupId>
		<artifactId>jum-base</artifactId>
		<version>1.0.0-SNAPSHOT</version>
		<relativePath/>
	</parent>

	<dependencies>
		<!-- 其他你必須的 或者 可能需要的依賴-->
		<!-- tomcat -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-tomcat</artifactId>
			<scope>provided</scope>
		</dependency>
		
	</dependencies>

	<build>
		<plugins>
			<!-- spring boot 打包  -->
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
			<!-- 如果是war包 並且配置外部配置引數  則打包時可以選擇要忽略的配置檔案 -->
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-war-plugin</artifactId>
				<configuration>
					<packagingExcludes>
						WEB-INF/classes/application.properties
					</packagingExcludes>

				</configuration>
			</plugin>
		</plugins>
		<finalName>demo</finalName>
	</build>
</project>

在pom中排除不打進war的配置檔案,指定打包型別為war
然後,修改啟動類

package com.jum;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
import org.springframework.web.WebApplicationInitializer;

/**
 * @author zhoujumbo
 *
 */
@SpringBootApplication
public class DemoApplication extends SpringBootServletInitializer implements WebApplicationInitializer {

	@Override
	protected SpringApplicationBuilder configure(SpringApplicationBuilder application){
		return application.sources(DemoApplication.class);
	}

	public static void main(String[] args) {
		SpringApplication.run(DemoApplication.class, args);
	}
}

配置外部tomcat

在這裡插入圖片描述

左上角“+”號新增tomcat>local,右側皮膚上部,設定自定義名稱(這個名稱值是自己給tomcat起的名字,隨便都可以
Application server 設定自己的tomcat安裝根路徑
VM引數選填
儲存
進入皮膚上部tab頁Deployment

在這裡插入圖片描述

如上圖,選第一個Artifacts

在這裡插入圖片描述
在這裡插入圖片描述

這一步,右側的Application context是你專案啟動時候到名字
啟動tomcat

三、通過啟動環境變數讀取配置檔案

基本配置沿用標題二中的基本配置,在此基礎上

在任意java包路徑下建立任意名稱的類(儘量符合你專案的規範),加入如下程式碼:

package com.jum.config;
import org.omg.CORBA.PRIVATE_MEMBER;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.MutablePropertySources;
import org.springframework.core.env.PropertiesPropertySource;
import org.springframework.core.io.FileSystemResource;
import org.springframework.core.io.support.PropertiesLoaderUtils;
import java.io.File;
import java.io.IOException;
import java.util.Properties;
/**
 * 讀取外部配置檔案
 */
public class ExternalProperties implements EnvironmentPostProcessor {
    private Logger logger = LoggerFactory.getLogger(getClass());
    private static final String  LOCATION = "application.properties";

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        logger.info("系統引數>>>"+System.getProperty("DEMO-HOME-CONFIG"));
        File file = new File(System.getProperty("DEMO-HOME-CONFIG"), LOCATION);
        if (file.exists()) {
            MutablePropertySources propertySources = environment.getPropertySources();
            logger.info("Loading local settings from {}" , file.getAbsolutePath());
            Properties properties = loadProperties(file);
            propertySources.addFirst(new PropertiesPropertySource("Config", properties));
        }
    }

    private Properties loadProperties(File f) {
        FileSystemResource resource = new FileSystemResource(f);
        try {
            return PropertiesLoaderUtils.loadProperties(resource);
        }
        catch (IOException ex) {
            throw new IllegalStateException("Failed to load local settings from " + f.getAbsolutePath(), ex);
        }
    }
}

注意,DEMO-HOME-CONFIG是預設指定的要在環境變數中設定的啟動引數名稱,可以定義設定;
然後配置專案啟動引數:-DDEMO-HOME-CONFIG=D:\temp\config_spaces\
注意:啟動引數前是有-D符號的

在這裡插入圖片描述

resources下建立資料夾META-INF,新增檔案spring.factories,新增內容org.springframework.boot.env.EnvironmentPostProcessor=com.jum.config.ExternalProperties
完成

在這裡插入圖片描述

四、IDEA下配置熱部署,提高開發效率

涉及到的幾個點

  1. 設定選單中設定自動編譯

在這裡插入圖片描述
2. 引入devtools相關依賴包,並進行外掛引數配置

		<!--熱部署-->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<optional>true</optional>
		</dependency>
		<!-- tomcat -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-tomcat</artifactId>
			<scope>provided</scope>
		</dependency>
		<!-- 外掛出配置 -->
		<build>
			<finalName>xxx</finalName>
			<plugins>
				<!-- spring boot 打包  -->
				<plugin>
					<groupId>org.springframework.boot</groupId>
					<artifactId>spring-boot-maven-plugin</artifactId>
					<configuration>
						<!--fork :  如果沒有該項配置,肯定devtools不會起作用,即應用不會restart -->
						<fork>true</fork>
						<addResources>true</addResources>
					</configuration>
				</plugin>
			</plugins>
		</build>
  1. 如果是war包部署,必須在伺服器設定中進行如下選擇
    在這裡插入圖片描述
  2. 開啟idea系統配置,勾選自動編譯選項。在介面按“shift+ctrl+alt+/”
    在這裡插入圖片描述
    在這裡插入圖片描述
    找到“compiler.automake.allow.when.app.running” 勾選,然後close。
  3. 如果是springboot,在配置檔案加上相關引數配置
#熱部署配置 僅開發環境用
spring.devtools.restart.enabled=true
spring.devtools.restart.additional-paths=resources/**,static/**,basepages/**
spring.devtools.restart.additional-exclude=error/**
#說明:spring.devtools.restart.additional-paths:由於devtool預設是不會監聽靜態資源的,此處將boot下的靜態目錄配置上,
#	  其中basepages是自己後來自定義設定的靜態目錄,可不加或者配置成你自己的

END

相關文章