Vue 搭配 Spring MVC 创建一个 web 项目

想要写一个登录的web应用程序。页面使用Vue，后端使用Spring MVC，最终打成war包，放在tomcat下启动。

1.创建Spring MVC项目，命名loginbackend，配置成web项目。

创建好web项目后，在src/main目录下创建webapp目录用来存放静态文件和web配置。（可以用idea开发工具直接配置成web项目，但是idea配置出来的webRoot目录不在src/main下边，我们自己新建webapp目录，配置成webRoot），目录结构如下图：

pom文件中配置打包方式为war包，引入spring-webmvc依赖。pom如下：

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<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>

    <groupId>top.xiong</groupId>
    <artifactId>loginbackend</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <packaging>war</packaging>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.14</version>
        </dependency>
    </dependencies>
</project>

2.创建Vue工程，命名loginfrontend。

用Vue CLI工具创建工程。创建好后工作目录如下：

执行npm install安装依赖包，执行npm run build编译项目，编译好后会在项目根目录下生成dist文件夹，dist文件夹里的内容就是前端的执行文件。

3.将loginfrontend与loginbackend工程结合，打成war包。

要把loginfrontend和loginbackend打成一个war包，需要在打包的收把 loginfrontend 工程 dist 下的文件copy到 loginbackend 打包目录的 webapp/static 下，在打成 war 包，这样前后端的工程就在一起了。

3.1 修改web.xml改变默认页面

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">
    <welcome-file-list>
        <welcome-file>/static/index.html</welcome-file>
    </welcome-file-list>
</web-app>

3.2 修改loginfrontend工程编译后默认引用文件路径

前端工程执行npm run build后编译出来的index.html中引用的js文件和css文件的目录是从dist目录下开始的，dist相当于工程的根目录，但是我们是把dist下的文件到copy到了后端工程static目录下的。工程启动后，index.html中引用的js和css资源文件的路径变成了ContextRoot/static/js、ContextRoot/static/css目录，所以要修改前端工程编译后的引用资源路径，修改方法为，在vue.config.js中加入publicPath:'static/配置：

js 复制代码

const { defineConfig } = require('@vue/cli-service')
module.exports = defineConfig({
  transpileDependencies: true,
  publicPath: 'static/'
})

这样编译后的index.html中js和css的引用路径就成了static/js/**.js、static/css/**.css。

3.3 修改pom文件，使用插件将前端代码copy到后端打包目录下。

pom中加入build插件，如下；

xml 复制代码

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>copy-dist</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>copy-resources</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/${project.artifactId}-${project.version}/static</outputDirectory>
                            <resources>
                                <resource>
                                    <directory>${project.basedir}/../loginfrontend/dist</directory>
                                </resource>
                            </resources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <!-- 打war包插件，不用这个会报错，不知道为啥 -->
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.3.1</version>
            </plugin>
        </plugins>
    </build>

3.4tomcat启动工程

将war包放到tomcat的webapps目录下，在tomcat的bin目录下启动startup.bat脚本，tomcat会自动将war包解压。

因为我们没有修改tomcat的任何配置，所以 Application Context 就是 war 包解压后的目录名，所以我们的访问rul就是http://localhost:8080/loginbackend-1.0-SNAPSHOT。浏览器访问试一下

因为我们没有写任何的代码，所以页面展示的就是 vue 的默认页面。

至此，vue 和 Spring MVC 结合的框架就搭好了，可以愉快的敲代码了。