架构系列四：Maven实现动静分离打war包及zip包

痛定思痛。 2022-05-20 06:47 213阅读 0赞

目标：实现Maven动静分离打包，静态资源打成zip包，动态资源打成war包，方便独立部署

**工程结构**  
打包前先看下工程结构  
![这里写图片描述][70]  
我的静态资源都是放在webapp目录下面，有css,fonts,html,images,js，根目录下的login.js,login.html，打包时需要将这些静态资源文件打成单独的zip包，动态资源打成单独的war包

**打war包**  
pom.xml文件内容如下

这里使用maven-war-plugin打war包，打包时，在packagingExcludes标签中排除所有的静态资源文件，打出来的war包只有resource文件文件,jsp文件,class文件等，结构如下  
![这里写图片描述][70 1]

**打静态zip包**  
这里使用maven-assembly-plugin插件打zip包，打包之前，需要在src/main/assembly/路径下增加static-zip.xml文件，该文件主要用来指定zip包中要包含有哪些静态资源文件，及静态资源文件的输出目录，static-zip.xml文件内容如下：

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">          
        <id>dp-static</id>  
        <formats>  
            
            <format>zip</format>  
        </formats>  
        
        <includeBaseDirectory>false</includeBaseDirectory>  
        <fileSets>  
            
            <fileSet>  
                <directory>${project.basedir}/target/dp/css/</directory>  
                <outputDirectory>css</outputDirectory>  
            </fileSet>  
            
            <fileSet>
                <directory>${project.basedir}/target/dp/fonts</directory>
                <outputDirectory>fonts</outputDirectory>
            </fileSet>
            
            <fileSet>
                <directory>${project.basedir}/target/dp/html</directory>
                <outputDirectory>html</outputDirectory>
            </fileSet>
            
            <fileSet>
                <directory>${project.basedir}/target/dp/images</directory>
                <outputDirectory>images</outputDirectory>
            </fileSet>
            
            <fileSet>
                <directory>${project.basedir}/target/dp/js</directory>
                <outputDirectory>js</outputDirectory>
            </fileSet>
            
            <fileSet>
                <directory>${project.basedir}/target/dp/</directory>
                <includes>
                    <include>login.js</include>
                    <include>login.html</include>
                </includes>
                <outputDirectory>/</outputDirectory>
            </fileSet>
        </fileSets>
    </assembly>

重点说下，为什么这里指定的是target目录下呢，编译完成后，在target目录下会生成dp目录(也就是你的工程名)，在dp目录下有编译过后的所有文件，包括静态资源文件因此zip包时，因此从target/dp目录下取静态资源文件，target/dp目录如下  
![这里写图片描述][70 2]

再来看下pom.xml文件的配置

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.2.1</version>
        <executions>
            <execution>
                <id>>make-assembly</id>
                <phase>package</phase>
                <goals>
                    <goal>single</goal>
                </goals>
                <configuration>
                    <finalName>dp-static</finalName>
                    <appendAssemblyId>false</appendAssemblyId>
                    <descriptors>
                        <descriptor>src/main/assembly/static-zip.xml</descriptor>
                    </descriptors>
                </configuration>
            </execution>
        </executions>
    </plugin>

说明：  
1.phase标签：值为package，在打包时执行，打包前会先编译并在target目录下生成dp目录，确保在打包时，能从target目录下获取到所有的静态资源文件  
2.finalName标签：自定义zip包名称，打出来的zip文件名为dp-static  
3.descriptor标签：指定了上面新增的static-zip.xml文件，打包时，会自动执行这个文件生成zip文件

执行maven install命令后，在target目录下，生成了dp.war包，也生成了dp-static.zip包，如下  
![这里写图片描述][70 3]

最后附上完整的pom文件的打包代码，如下

<build>
        <finalName>dp</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <useCache>false</useCache>
                    
                    <packagingExcludes>
                        css/**,fonts/**,html/**,images/**,js/**,login.html,login.js
                    </packagingExcludes>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <finalName>dp-static</finalName>
                            <appendAssemblyId>false</appendAssemblyId>
                            <descriptors>
                                <descriptor>src/main/assembly/static-zip.xml</descriptor>
                            </descriptors>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        <plugins>
    <build>

[70]: /images/20220520/85fa87dd10b8436e81f717f71a672277.png
[70 1]: /images/20220520/96de38b45d00446fbfe1363e386e485e.png
[70 2]: /images/20220520/2324265c4ee44ef795be31ff1ff1cd7d.png
[70 3]: /images/20220520/1369562e2854448c8815a09549fea8db.png