Spring Boot(十二):Spring Boot 如何測試打包部署


有很多網友會時不時的問我, Spring Boot 項目如何測試,如何部署,在生產中有什么好的部署方案嗎?這篇文章就來介紹一下 Spring Boot 如何開發、調試、打包到最后的投產上線。

開發階段

單元測試

在開發階段的時候最重要的是單元測試了, Spring Boot 對單元測試的支持已經很完善了。

1、在 pom 包中添加 spring-boot-starter-test 包引用

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-test</artifactId>
	<scope>test</scope>
</dependency>

2、開發測試類

以最簡單的 helloworld 為例,在測試類的類頭部需要添加:@RunWith(SpringRunner.class)@SpringBootTest注解,在測試方法的頂端添加@Test即可,最后在方法上點擊右鍵run就可以運行。

@RunWith(SpringRunner.class)
@SpringBootTest
public class ApplicationTests {

	@Test
	public void hello() {
		System.out.println("hello world");
	}

}

實際使用中,可以按照項目的正常使用去注入數據層代碼或者是 Service 層代碼進行測試驗證,spring-boot-starter-test 提供很多基礎用法,更難得的是增加了對 Controller 層測試的支持。

//簡單驗證結果集是否正確
Assert.assertEquals(3, userMapper.getAll().size());

//驗證結果集,提示
Assert.assertTrue("錯誤,正確的返回值為200", status == 200); 
Assert.assertFalse("錯誤,正確的返回值為200", status != 200);  

引入了MockMvc支持了對 Controller 層的測試,簡單示例如下:

public class HelloControlerTests {

    private MockMvc mvc;

    //初始化執行
    @Before
    public void setUp() throws Exception {
        mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
    }

    //驗證controller是否正常響應並打印返回結果
    @Test
    public void getHello() throws Exception {
        mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andDo(MockMvcResultHandlers.print())
                .andReturn();
    }
    
    //驗證controller是否正常響應並判斷返回結果是否正確
    @Test
    public void testHello() throws Exception {
        mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("Hello World")));
    }

}

單元測試是驗證你代碼第一道屏障,要養成每寫一部分代碼就進行單元測試的習慣,不要等到全部集成后再進行測試,集成后因為更關注整體運行效果,很容易遺漏掉代碼底層的bug.

集成測試

整體開發完成之后進入集成測試, Spring Boot 項目的啟動入口在 Application 類中,直接運行 run 方法就可以啟動項目,但是在調試的過程中我們肯定需要不斷的去調試代碼,如果每修改一次代碼就需要手動重啟一次服務就很麻煩, Spring Boot 非常貼心的給出了熱部署的支持,很方便在 Web 項目中調試使用。

pom 需要添加以下的配置:

 <dependencies>
    <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>

添加以上配置后,項目就支持了熱部署,非常方便集成測試。

投產上線

其實我覺得這個階段,應該還是比較簡單一般分為兩種;一種是打包成 jar 包直接執行,另一種是打包成 war 包放到 tomcat 服務器下。

打成 jar 包

如果你使用的是 maven 來管理項目,執行以下命令既可以

cd 項目跟目錄(和pom.xml同級)
mvn clean package
## 或者執行下面的命令
## 排除測試代碼后進行打包
mvn clean package  -Dmaven.test.skip=true

打包完成后 jar 包會生成到 target 目錄下,命名一般是 項目名+版本號.jar

啟動 jar 包命令

java -jar  target/spring-boot-scheduler-1.0.0.jar

這種方式,只要控制台關閉,服務就不能訪問了。下面我們使用在后台運行的方式來啟動:

nohup java -jar target/spring-boot-scheduler-1.0.0.jar &

也可以在啟動的時候選擇讀取不同的配置文件

java -jar app.jar --spring.profiles.active=dev

也可以在啟動的時候設置 jvm 參數

java -Xms10m -Xmx80m -jar app.jar &

gradle
如果使用的是 gradle,使用下面命令打包

gradle build
java -jar build/libs/mymodule-0.0.1-SNAPSHOT.jar

打成 war 包

打成 war 包一般可以分兩種方式來實現,第一種可以通過 eclipse 這種開發工具來導出 war 包,另外一種是使用命令來完成,這里主要介紹后一種

1、maven 項目,修改 pom 包

<packaging>jar</packaging>  

改為

<packaging>war</packaging>

2、打包時排除tomcat.

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-tomcat</artifactId>
	<scope>provided</scope>
</dependency>

在這里將 scope 屬性設置為 provided,這樣在最終形成的 WAR 中不會包含這個 JAR 包,因為 Tomcat 或 Jetty 等服務器在運行時將會提供相關的 API 類。

3、注冊啟動類

創建 ServletInitializer.java,繼承 SpringBootServletInitializer ,覆蓋 configure(),把啟動類 Application 注冊進去。外部 Web 應用服務器構建 Web Application Context 的時候,會把啟動類添加進去。

public class ServletInitializer extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }
}

最后執行

mvn clean package  -Dmaven.test.skip=true

會在 target 目錄下生成:項目名+版本號.war文件,拷貝到 tomcat 服務器中啟動即可。

gradle

如果使用的是 Gradle,基本步奏一樣,build.gradle中 添加 war 的支持,排除 spring-boot-starter-tomcat:

...

apply plugin: 'war'

...

dependencies {
    compile("org.springframework.boot:spring-boot-starter-web:1.4.2.RELEASE"){
    	exclude mymodule:"spring-boot-starter-tomcat"
    }
}
...

再使用構建命令

gradle build

war 會生成在 build\libs 目錄下。

生產運維

查看 JVM 參數的值

可以根據 Java 自帶的 jinfo 命令:

jinfo -flags pid

來查看 jar 啟動后使用的是什么 gc、新生代、老年代分批的內存都是多少,示例如下:

-XX:CICompilerCount=3 -XX:InitialHeapSize=234881024 -XX:MaxHeapSize=3743416320 -XX:MaxNewSize=1247805440 -XX:MinHeapDeltaBytes=524288 -XX:NewSize=78118912 -XX:OldSize=156762112 -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:+UseFastUnorderedTimeStamps -XX:+UseParallelGC
  • -XX:CICompilerCount :最大的並行編譯數
  • -XX:InitialHeapSize-XX:MaxHeapSize :指定 JVM 的初始和最大堆內存大小
  • -XX:MaxNewSize : JVM 堆區域新生代內存的最大可分配大小
  • ...
  • -XX:+UseParallelGC :垃圾回收使用 Parallel 收集器

如何重啟

簡單粗暴

直接 kill 掉進程再次啟動 jar 包

ps -ef|grep java 
##拿到對於Java程序的pid
kill -9 pid
## 再次重啟
Java -jar  xxxx.jar

當然這種方式比較傳統和暴力,所以建議大家使用下面的方式來管理

腳本執行

如果使用的是maven,需要包含以下的配置

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <executable>true</executable>
    </configuration>
</plugin>

如果使用是 gradle,需要包含下面配置

springBoot {
    executable = true
}

啟動方式:

1、 可以直接./yourapp.jar 來啟動

2、注冊為服務

也可以做一個軟鏈接指向你的jar包並加入到init.d中,然后用命令來啟動。

init.d 例子:

ln -s /var/yourapp/yourapp.jar /etc/init.d/yourapp
chmod +x /etc/init.d/yourapp

這樣就可以使用stop或者是restart命令去管理你的應用。

/etc/init.d/yourapp start|stop|restart

或者

service yourapp start|stop|restart

到此 Spring Boot 項目如何測試、聯調和打包投產均已經介紹完,以后可以找時間研究一下 Spring Boot 的自動化運維,以及 Spring Boot 和 Docker 相結合的使用。

文章內容已經升級到 Spring Boot 2.x

示例代碼-github

示例代碼-碼雲

參考:
Installing Spring Boot applications


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM