maven 構建的 webapp 基本配置

一、核心依賴

webapp 的依賴，大致分為三部分：基本的 spring 組件依賴、日志及測試組件、web組件依賴等。大致為：

<dependencies>
    <!-- 1.base spring dependency -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    
    <!-- 2.base logger and test dependency -->
    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-core</artifactId>
      <version>${version.log4j}</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>${version.slf4j}</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>${version.slf4j}</version>
    </dependency>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>${version.junit}</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${version.springframework}</version>
      <scope>test</scope>
    </dependency>
    
    <!-- 3.base web dependency -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${version.springframework}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>${version.javax.servlet.api}</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>javax.servlet.jsp-api</artifactId>
      <version>${version.javax.servlet.jsp.api}</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.tutianer</groupId>
      <artifactId>common</artifactId>
      <version>${version.tutianer.common}</version>
    </dependency>
    
  </dependencies>

 

二、項目構建配置

項目構建常見的配置項主要是設置jdk版本和資源過濾。如下：

<build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <configuration>
            <source>1.8</source>
            <target>1.8</target>
          </configuration>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-resources-plugin</artifactId>
          <configuration>
            <resources>
              <resource>
                <directory>${project.basedir}/src/main/resources</directory>
                <filtering>true</filtering>
              </resource>
            </resources>
          </configuration>
        </plugin>
        <plugin>
          <groupId>org.eclipse.jetty</groupId>
          <artifactId>jetty-maven-plugin</artifactId>
          <version>${version.jetty}</version>
          <configuration>
            <httpConnector>
              <port>8003</port>
            </httpConnector>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
    
    <finalName>v1</finalName>
  </build>

其中finaleName表示 webapp 打包后的名字，作為默認的 web 項目，設置為 ROOT 可以直接在 tomcat 中使用。

 

三、屬性配置

<profiles>
    <profile>
          <id>dev</id>
          <activation>
              <activeByDefault>true</activeByDefault>
          </activation>
          <properties>
            <config.logger.level>INFO</config.logger.level>
            <config.redis.server>127.0.0.1</config.redis.server>
            <config.redis.port>6379</config.redis.port>
            <config.redis.prefixKey>local_</config.redis.prefixKey>
            <config.db.driverClassName>com.mysql.jdbc.Driver</config.db.driverClassName>
            <config.db.url>jdbc:mysql://localhost:3306/dbname?characterEncoding=utf8&amp;useUnicode=true&amp;useSSL=false</config.db.url>
            <config.db.username>root</config.db.username>
            <config.db.password>123456</config.db.password>
            <config.domain>http://localhost:8002</config.domain>
          </properties>
      </profile>
      <profile>
          <id>prod</id>
          <properties>
            <config.logger.level>INFO</config.logger.level>
            <config.redis.server>127.0.0.1</config.redis.server>
            <config.redis.port>6382</config.redis.port>
            <config.redis.prefixKey>prod_</config.redis.prefixKey>
            <config.db.driverClassName>com.mysql.jdbc.Driver</config.db.driverClassName>
            <config.db.url>jdbc:mysql://localhost:3306/dbname?characterEncoding=utf8&amp;useUnicode=true&amp;useSSL=false</config.db.url>
            <config.db.username>username</config.db.username>
            <config.db.password>pwd</config.db.password>
            <config.domain>http://domain</config.domain>
          </properties>
      </profile>
  </profiles>

 

在常規開發中，一個常見問題是在本地開發、測試、生產等幾個環境中來回切換需要手工修改各項配置，而 maven 的屬性配置則很好的解決了這個問題。當項目構建配置中使用了maven-resources-plugin插件時，在測試或者打包時，會自動將屬性中配置的值替換到maven-resources-plugin所指定的資源目錄中。

需要注意的是，其中的數據庫配置要用&做轉義；而該項直接在 xml 文件中配置則不需要轉義。

這里默認激活的是activeByDefault所在的配置節，在打包或者測試時激活其他配置需要加參數P 來指定激活的配置項：-Pprod 

 

四、web 版本配置

由於 maven 的 archvetype 略微陳舊，創建的 webapp 會被設置為2.3版本，可以在配置文件中修改為2.5。配置文件是web 項目.setting 目錄中的org.eclipse.wst.common.project.facet.core.xml 文件，將

<installed facet="jst.web" version="2.3"/>

 

修改為：

<installed facet="jst.web" version="2.5"/>

 

五、其余配置

其余諸如spring、web.xml 等配置信息。