使用maven插件运行web项目

妖狐艹你老母 2023-10-05 10:04 36阅读 0赞

常见的web服务器有：jetty、tomcat等等

## 使用tomcat7-maven-plugin插件 ##

[官方文档][Link 1]  
配置示例：  
运行 `mvn tomcat7:run` 启动项目，访问链接为 http://localhost:8080/app

...
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.tomcat.maven</groupId>
                    <artifactId>tomcat7-maven-plugin</artifactId>
                    <version>2.1</version>
                    <configuration>
                        <port>8080</port>
                        <path>/app</path>
                        <warSourceDirectory>${basedir}/src/main/webapp</warSourceDirectory>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    ...

重点[<configuration>参数说明][configuration]

*  port ：端口（默认 8080）
 *  path ：应用访问路径（默认 /$\{project.artifactId\}）
 *  warSourceDirectory ：web应用目录（默认 $\{basedir\}/src/main/webapp）

## 使用jetty-maven-plugin插件 ##

[官方文档][Link 2]  
配置示例：  
运行 `mvn jetty:run` 启动项目，访问链接为 http://localhost:8080/app

...
        <build>
            <plugins>
                <plugin>
                    <groupId>org.eclipse.jetty</groupId>
                    <artifactId>jetty-maven-plugin</artifactId>
                    <version>9.4.31.v20200723</version>
                    <configuration>
                        <httpConnector>
                            <port>8080</port>
                        </httpConnector>
                        <webApp>
                            <contextPath>/app</contextPath>
                        </webApp>
                        <webAppSourceDirectory>${basedir}/src/main/webapp</webAppSourceDirectory>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    ...

重点[<configuration>参数说明][configuration 1]

*  httpConnector.port ：端口（默认 8080）
 *  webApp.contextPath ：应用访问路径（默认 /）
 *  warSourceDirectory ：web应用目录（默认 $\{basedir\}/src/main/webapp）

## 常见问题 ##

### 没有 src/main/webapp，只有 WebContent 或 WebRoot 怎么办？ ###

以前的项目一般是通过Eclipse或者MyEclipse创建的，其项目结构和标准的maven项目结构有所不同，一般其web目录为 `WebContent` 或 `WebRoot` 而不是 `src/main/webapp`。  
**解决**：只需要修改`<warSourceDirectory>`配置指向具体的web目录即可。eg: `<warSourceDirectory>${basedir}/WebContent</warSourceDirectory>`

### 如何配置tomcat数据源？ ###

在插件<configuration>配置加上`<contextFile>`配置指定 `context.xml` 即可。eg: `<contextFile>WebContent/context.xml</contextFile>`  
context.xml 内容样例：

<?xml version="1.0" encoding="UTF-8"?>
    <Context>
        <Resource name="jndi_name" auth="Container" type="javax.sql.DataSource"  maxActive="20" maxIdle="10"
                  driverClassName="com.mysql.jdbc.Driver"
                  url="jdbc:mysql://localhost:3306/testdb" username="root" password="root"/>
    </Context>

### 如何配置jetty数据源？ ###

1.  在插件<configuration>配置的`<webApp>`加上`<jettyEnvXml>`配置指定 `jetty-eng.xml`。eg: `<jettyEnvXml>${basedir}/src/main/webapp/WEB-INF/jetty-env.xml</jettyEnvXml>`  
    jetty-eng.xml 内容样例：

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_3.dtd">
    <Configure id='wac' class="org.eclipse.jetty.webapp.WebAppContext">
        <New id="DSTest" class="org.eclipse.jetty.plus.jndi.Resource">
            <Arg></Arg>
            <Arg>jndi_name</Arg>
            <Arg>
                <New class="com.mysql.cj.jdbc.MysqlConnectionPoolDataSource">
                    <Set name="Url">jdbc:mysql://localhost:3306/testdb</Set>
                    <Set name="User">root</Set>
                    <Set name="Password">root</Set>
                </New>
            </Arg>
        </New>
    </Configure>

1.  在项目 `web.xml` 添加数据源引用

<web-app>
    ...
      <resource-ref>
        <res-ref-name>jndi_name</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
      </resource-ref>
    ...
    </web-app>

references:  
[Difference webcontent and webapp][]

[Link 1]: http://tomcat.apache.org/maven-plugin-2.1/tomcat7-maven-plugin/plugin-info.html
[configuration]: http://tomcat.apache.org/maven-plugin-2.1/tomcat7-maven-plugin/run-mojo.html
[Link 2]: http://www.eclipse.org/jetty/documentation/jetty-9/index.html#jetty-maven-plugin
[configuration 1]: http://www.eclipse.org/jetty/documentation/jetty-9/index.html#configuring-jetty-container
[Difference webcontent and webapp]: https://stackoverflow.com/questions/18412866/difference-webcontent-and-webapp