SpringBoot简单打包部署(附工程)

前言

本文主要介绍SpringBoot的一些打包事项和项目部署以及在其中遇到一些问题的解决方案。

SpringBoot打包

在SpringBoot打包这块，我们就用之前的一个web项目来进行打包。

首先需要明确的是，该项目打包的形态是可执行的jar包，还是在tomcat下运行的war包。

虽然本项目是用maven构建的，用maven打包也更加方便，但是这里也说明普通非maven打包的项目如何打包。

Maven打包

首先是maven方式打包:

如果是jar包

需在pom.xml指定打成的包为：

<packaging>jar</packaging>

如果是war包。

需在pom.xml指定打成的包为：

<packaging>war</packaging>

并通过<scope>标签在打包的时候排除tomcat依赖

<dependency>

	<groupId>org.springframework.boot</groupId>

	<artifactId>spring-boot-starter-tomcat</artifactId>

	<scope>provided</scope>

</dependency>

然后添加SpringBoot自带的打包方式

示例如下:

<build>

		<defaultGoal>compile</defaultGoal>

		<sourceDirectory>src</sourceDirectory>

		<finalName>springboot-package</finalName>

		<plugins>

			<plugin>

				<groupId>org.springframework.boot</groupId>

				<artifactId>spring-boot-maven-plugin </artifactId>

				<configuration>

					<fork>true</fork>

					<mainClass>com.pancm.App</mainClass>

				</configuration>

				<executions>

					<execution>

						<goals>

							<goal>repackage</goal>

						</goals>

					</execution>

				</executions>

			</plugin>

		</plugins>

	</build>

注：<finalName>标签是指定打包之后的名称，<mainClass>是指定main函数。

也可以不用SpringBoot自带的打包方式，使用maven的assembly插件进行打包。

示例如下:

<build>

    <plugins>

		  <plugin>

            <groupId>org.apache.maven.plugins</groupId>

            <artifactId>maven-assembly-plugin</artifactId>

            <version>2.5.5</version>

            <configuration>

                <archive>

                    <manifest>

                        <mainClass>com.pancm.App</mainClass>

                    </manifest>

                </archive>

                <descriptorRefs>

                    <descriptorRef>jar-with-dependencies</descriptorRef>

                </descriptorRefs>

            </configuration>

        </plugin>

       </plugins>

	</build>

在pom.xml中添加完相应的标签之后，我们只需在项目同级（pom.xml同级）输入

mvn clean package

即可完成打包

如果想排除测试代码，则可以输入:

mvn clean package  -Dmaven.test.skip=true

来进行打包。

一般我们是把application.properties和logback.xml文件放在resources文件夹中，但是进行打包之后，它们也会包含在jar或war包中，如果我们想更改配置，则会比较麻烦。

如果想将它们和项目放在同级目录下，application.properties可以直接移出和项目同级的目录下，因为Spring程序会按优先级从下面这些路径来加载application.properties配置文件：

springboot默认加载的logback是在classpath目录下，这时我们只需要在application.properties配置文件指定logback.xml的路径即可。

添加如下:

logging.config=logback.xml

如果引入了第三方的jar包，但是又无法通过maven私服进行下载，这时可以手动进行编译。

例如，我写了一个工具类为Mytools，然后把它打成了一个jar包，然后放在我的这个项目中lib目录下，并且需要引用它，那么此时便可以对该jar包进行编译到本地仓库中，然后再pom.xml添加相应的名称和版本号。

命令示例:

mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar

pom.xml添加

<dependency>

			<groupId>com.panncm.utils</groupId>

			<artifactId>pancm-utils</artifactId>

			<version>1.0</version>

</dependency>

便可以进行打包了。

普通项目打包

如果是普通的项目，没有使用maven构建的话，可以使用eclipse等工具进行打包。

如果是jar包

首先在eclipse中运行该项目(main方法运行)，然后在eclipse中右键项目 export ->java -> runnable jar file-> package required libraries into generated jar 指定main方法，然后选择打包的名称以及打包的路径。点击finish完成打包。

如果是war包

在eclipse中右键项目 export ->web -> war file，然后选择打包的名称以及打包的路径。点击finish完成打包。

Ant打包

介绍了上述两种打包之后，这里介绍下通过ant方法进行打包(需要安装ant环境，安装方式基本和maven一致，指定路径，配置环境变量，这里就不在过多讲述了)。

一般打包之后，我们需要将包和配置文件放在一个目录下，这时我们又不想手动进行复制粘贴的话，就可以用ant来进行打包，将打包的文件整合在一起。

这里我们就编写一个build.xml的配置文件。

<?xml version="1.0" encoding="UTF-8"?>

<project name="springboot-package" default="copyAll" basedir=".">

	<property name="build" value="build" />

	<property name="target" value="target" />

	<target name="clean">

		<delete dir="${target}" />

		<delete dir="${build}" />

	</target>

	<target name="create-path" depends="clean">

		<mkdir dir="${build}" />

	</target>

	<target name="mvn_package" depends="create-path">

		<exec executable="cmd" failonerror="true">

			<arg line="/c mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar" />

		</exec>

		<exec executable="cmd" failonerror="true">

			<arg line="/c mvn clean package" />

		</exec>

	</target>

	<target name="copyAll" depends="mvn_package">

		<copy todir="${build}" file="${target}/springboot-package.jar"></copy>

		<copy todir="${build}" file="logback.xml"></copy>

		<copy todir="${build}" file="application.properties"></copy>

		<copy todir="${build}" file="run.bat"></copy>

	</target>

</project>

注：<mkdir dir="${build}" />是指定文件存放的文件夹，executable是使用cmd命令，line是执行的语句，标签是将文件复制到指定的文件夹中。

然后再新建一个 build.bat文件，里面只需要填写 ant就行了。

准备完之后，只需双击build.bat，项目和配置文件就自动到build文件中了，省去了很多操作。

虽然现在流行通过jenkins进行打包部署，不过使用ant加maven进行打包也不错的，比较简单。

打包遇到的一些问题

问题:source-1.5 中不支持 diamond运算符

解决办法一:

在properties添加

<maven.compiler.source>1.8</maven.compiler.source>和<maven.compiler.target>1.8</maven.compiler.target>

  <properties>

    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

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

    <fastjson>1.2.41</fastjson>

    <maven.compiler.source>1.8</maven.compiler.source>

    <maven.compiler.target>1.8</maven.compiler.target>

  </properties>

解决方案二:

在plugin中添加 <source>1.8</source> 和 <target>1.8</target>

<build>

        <plugins>

            <plugin>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-compiler-plugin</artifactId>

                <version>3.3</version>

                <configuration>

                    <source>1.8</source>

                    <target>1.8</target>

                </configuration>

            </plugin>

        </plugins>

    </build>

问题二:打包出现某jar包无法打入

实际是可以下载，但是无法将此打入包中

解决办法:

在pom.xml中添加

  <repositories>

     <repository>

            <id>spring-milestone</id>

            <url>http://repo.spring.io/libs-release</url>

     </repository>

   </repositories>

问题三:mvn clean 失败，出现Failed to execute goal

原因: 在clean的时候，target里面的文件被占用了。

解决办法: 不占用就行了。

SpringBoot部署

如果是jar项目

Windows系统在项目同级目录下输入:

java -jar springboot-package

即可启动项目。

关闭项目，只需关掉dos界面就可以了。

也可以写一个bat文件进行运行。

示例:

@echo off

title "springboot-package"

java -jar springboot-package.jar

Linux系统在项目同级目录下输入:

nohup -jar springboot-package &

即可启动。

关闭输入:

kill -9 pid（jar的进程id）

也可以在init.d注册一个服务

示例:

ln -s /home/jars/app/springboot-package.jar /etc/init.d/springboot-package

chmod +x /etc/init.d/springboot-package

然后输入:

service springboot-package start|stop|restart

进行启动或者停止。

当然也可以编写xshell脚本进行启动和关闭。

示例:

#!/bin/bash

APPDIR=`pwd`

PIDFILE=$APPDIR/springboot-package.pid

if [ -f "$PIDFILE" ] && kill -0 $(cat "$PIDFILE"); then

echo "springboot-package is already running..."

exit 1

fi

nohup java -jar $APPDIR/springboot-package.jar >/dev/null 2>&1 &

echo $! > $PIDFILE

echo "start springboot-package..."

如果是war项目

将war放在tomcat/webapp目录下，然后启动tomcat就可以了。Windows系统在tomcat/bin目录下双击startup.bat即可启动，双击shutdown.bat关闭。

Linux系统则在tomcat/bin 目录下输入startup.sh即可启动，输入shutdown.sh关闭。

其它

关于SpringBoot打包部署就讲解到这里了，如有不妥，欢迎指正！

SpringBoot打包部署的项目工程地址:

https://github.com/xuwujing/springBoot-study/tree/master/springboot-package

SpringBoot整合系列:

原创不易，如果感觉不错，希望给个推荐！您的支持是我写作的最大动力！

版权声明:

作者：虚无境

博客园出处：http://www.cnblogs.com/xuwujing

CSDN出处：http://blog.csdn.net/qazwsxpcm　　　　

个人博客出处：http://www.panchengming.com