springboot打包部署
开发阶段
单元测试
在开发阶段的时候最重要的是单元测试了,springboot对单元测试的支持已经很完善了。
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"); }
} |
实际使用中,可以按照项目的正常使用去注入dao层代码或者是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包
和普通jar包一样;
打成war包
测试使用1,2,4,5中黄色部分就可以了;
springboot 带有内置Tomcat 服务器,可以直接将项目打包成jar运行,但是如果在需要把项目达成war包该怎么办呢?下面是将springboot项目部署为war项目的一些步骤
1、首先 在pom.xml中将打包形式 jar 修改为war
<packaging>war</packaging>
2、将springboot内置的Tomcat依赖移除 ,需要注意的是,使用不同的模板引擎的时候,需要移除的依赖位置也不同,下面是原生的依赖和thymeleaf 模板引擎移除依赖的一些方法 (后面打包发现。 可以不需要在依赖中去除tomcat 依赖 直接添加)
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
就可以了
原生Tomcat依赖移除
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
thymeleaf 模板引擎依赖移除
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
3、将Tomcat依赖移除后,为了保证编译正确,还需要添加对 servlet-api 的依赖(开始使用的时候是需要加servlet-api的依赖的,但是在后面使用中发现,可以不添加该依赖)
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-servlet-api</artifactId>
<version>7.0.42</version>
<scope>provided</scope>
</dependency>
4、设置,打包后的项目访问名称,在build节点里设置文件名 (这里是一个特别需要注意的地方,由于开始的时候是使用的单模块程序,所以可以对项目命名,但是在多模块打包中发现,如果添加项目名称 这个结点。打包好的程序在tomcat中运行的时候会发生错误,war 包的目录格式有问题)
</plugins>
<finalName>项目名称</finalName>
</build>
5、由于我们需要使用外部Tomcat服务器部署war包,所以不能使用创建项目的application.java 这个main方法了,需要重写一个类似于 web.xml 文件配置的方式来启动 Spring 应用上下文,此时我们需要声明一个类,这个类的作用与在 web.xml 中配置负责初始化 Spring 应用上下文的监听器作用类似。可以直接将原来main方法所在的类继承然后添加方法,如下面表格中所示;
public class AdminApplication extends SpringBootServletInitializer { public static void main(String[] args) { SpringApplication.run(AdminApplication.class, args); } @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(AdminApplication.class); } } |
这样就可以将项目打包成war 包,并放入外部Tomcat就可以使用了。
不过需要重点注意的地方是 项目中所有请求路径都必须加上上面步骤4所写的项目名。不然会访问不到路径。
mvn clean package -Dmaven.test.skip=true
打成war包一般可以分两种方式来实现,第一种可以通过eclipse这种开发工具来导出war包,另外一种是使用命令来完成,这里主要介绍后一种
会在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" } } ... |
再使用构建命令
1 | 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,需要包含下面配置
1 2 3 | 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 |
到此 springboot项目如何测试、联调和打包投产均已经介绍完,以后可以找时间研究一下springboot的自动化运维,以及spring boot 和docker相结合的使用。
参考