基于 Maven 的 Web 项目搭建

发表于 Disqus：

基于 Maven 的 Web 项目搭建

创建 Maven Web App 项目

Command Line

  1. 创建 Maven Java Web Project

    1
    $ mvn archetype:generate -DgroupId=xyz.yamdestiny -DartifactId=simpleDemo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
    • 命令解析
      • mvn archetype:generate: 固定格式
      • -DgroupId: 组织标识（包名）
      • -DartifactId: 项目名称
      • -DarchetypeArtifactId: 指定 ArchetypeId，常用以下两种：
        • maven-archetype-quickstart: 创建一个 Java Project
        • maven-archetype-webapp: 创建一个 Java Web Project
      • -DinteractiveMode: 是否使用交互模式

  2. 通过 Eclipse Import Project 导入到 Eclipse

Eclipse Maven 插件

  1. 菜单栏 -> New -> Maven Project

  2. 默认设置，Next
    new maven project 1

  3. 选择 maven-archetype-webapp，Next
    new maven project 2

  4. 填写Group Id、Artifact Id，Next
    new maven project 3

项目基础配置

  1. 修改JRE System Library

    1. Project -> Properties(Window) -> Java Build Path(List) -> Libraries(Tag)
    2. 选择 JRE System Library，点击 Edit.. 按钮
      modify build path 1
    3. 选择Workspace default JRE(xxx)
      modify build path 2
    4. Finish

  2. Maven Project 约定目录。如没有，新建Source Folder

    • src/main/java
    • src/main/resources
    • src/test/java
    • src/test/resources

  3. 修改Output folder

    1. Project -> Properties(Window) -> Java Build Path(List) -> Source(Tag)
      modify build path 3
    2. 修改如图
      • src/main/java -> target/classes
      • src/main/resources -> target/classes
      • src/test/java -> target/test-classes
      • src/test/resources -> target/test-classes

  4. 修改Dynamic Web Module（maven-artchetype-webapp版本较低，默认 2.3）
    modify project facets 1

    1. 直接修改会提示错误，先取消勾选，点击 Apply
    2. 选择 Version 3.1，勾选选项
      modify project facets 2
    3. 点击Further configuration available...
      • 修改Content director: WebContent -> src/main/webapp
      • 勾选Generate web.xml deployment descriptor
        modify project facets 3
    4. OK -> Apply and Close
    5. 修改web.xml 
      1
      2
      3
      4
      <?xml version="1.0" encoding="UTF-8"?>
      <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
        <display-name>Archetype Created Web Application</display-name>
      </web-app>

  5. 更新项目

    • 项目右键 -> Maven -> Update Project
    • 如遇如图报错
      First Check Error
      • 检查 Workspace 的Compiler
      • 检查项目的Compiler
      • 在pom.xml中添加如下信息 
        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        11
        12
        13
        14
        <build>
            <finalName>simpleDemo</finalName>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.1</version>
                    <configuration>
                        <source>1.8</source>
                        <target>1.8</target>
                    </configuration>
                </plugin>
            </plugins>
        </build>

  6. 添加一个 Tomcat Server，启动项目
    First Check

参考资料