在平时的Java web项目开发中为了便于后期的维护，我们一般会进行分模块开发，每个模块都对应着一个pom.xml。它们之间通过继承和聚合相互关联。这样各层之间的职责会比较明确，也方便后期的维护。

今天我们是使用 Maven 来构建以上的各个层。

文字内容只涉及工程搭建的基本流程，请主要参照文章末尾的源代码。

项目目录：
mavenweb-parent
　 |----pom.xml
mavenweb-service
　 |----pom.xml
mavenweb-web
　 |----pom.xml

创建主模块：mavenweb-parent

• 在 Eclipse 中新建工程：
  New -> Other -> Maven Project -> 填写配置信息 -> Finish

Mavenweb Parent New Proj.png

• 在 Eclipse 中，设置 目标JDK 版本：
  在工程中，点击右键 -> Build Path -> Configure Build Path -> Java Build Path -> 在 Libraries 选项卡中选择 JDK1.7 或以上版本

Mavenweb Parent JDK Setting.png

• 在硬盘上，删除 src 文件夹；并在 Eclpse 中刷新该工程。

  
  Mavenweb Parent Delete Folders.png

• 设置 pom 文件：
  务必设置 packaging 为 pom

<project ...>
    ...
    <packaging>pom</packaging>
    
    <properties>
        <springversion>3.1.1.RELEASE</springversion>
        <junitversion>4.10</junitversion>
    </properties>
    
    <dependencyManagement>
        <dependencies>
            <!-- junit -->
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>${junitversion}</version>
                <scope>test</scope>
            </dependency>
            ...         
    </dependencyManagement>
</project>

创建子模块：mavenweb-server

• 使用类似的方式创建 maven 工程
• 修改 pom:
  设置 packaging 为 jar，并添加 parent 与 dependencies 节点。

<project>
    ...
    <packaging>jar</packaging>
    
    <parent>
        ...
        <relativePath>../mavenweb-parent/pom.xml</relativePath>
    </parent>
    ...
</project>

• 添加 spring 配置
  设置 component-scan 以便令代码中注解能被读取与解析，并使用 propertyConfigurer 读取配置文件。

<beans>
    <!-- 扫描包 -->
    <context:component-scan base-package="com.stevexie" />
    
    <bean id="propertyConfigurer" >
        <property name="location">
            <value>file:/.../configInfo.properties</value>
        </property>
    </bean>
    
    <!-- 这个包负责读取配置文件信息 -->
    <!-- 若使用注解初始化这个类，编译后的 jar 包无法正确地读取配置，原因未知 -->
    <!-- 所以仅这个类实例需要在 xml 中定义 -->
    <bean id="configInfo" class="com.stevexie.util.ConfigInfo">
        <property name="name" value="${prop.name}"></property>
    </bean>
</beans>

创建子模块：mavenweb-client

• 首先，同样使用类似的方式创建 maven 工程，但与 Server 工程相比多了以下几部
• 转换项目类型
  项目右键 -> properties -> Project Facets -> 勾选 Dynamic Web Module 和 Java -> OK

Mavenweb Client Proj Facets Setting.png

• 修正编译设置与输出目录
  项目右键 -> properties -> Deployment Assembly，如下图设置：

  
  Mavenweb Client Deployment Assembly Setting.png

• 设置 JDK 1.8

• 设置 web.xml
  因为我们的 url 会使用 restful 风格，所以需要改变两个文件：1) 在web.xml中，修改 servlet-mapping；2) 在client-spring-mvc.xml中，添加 <mvc:default-servlet-handler />

web.xml:

<web-app >
...
<servlet-mapping>
    <servlet-name>appServlet</servlet-name>
    <!-- 使用 resful 风格的 url 前 -->
    <!-- <url-pattern>/</url-pattern> -->
    <!-- 使用 resful 风格的 url 后 -->
    <url-pattern>/login</url-pattern>
</servlet-mapping>
...
</web-app>

client-spring-mvc.xml:

<beans ">
    ...
    <mvc:default-servlet-handler />
    <!-- Enables the Spring MVC @Controller programming model -->
    <mvc:annotation-driven />
    ...
</beans>

项目 mavenweb-client 中的表单验证：

• pom.xml 中添加 hibernate-validator.jar

<!-- spring mvc validator -->
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>4.3.1.Final</version>
   </dependency>

• 在 UserVo.java 中添加验证条件

@NotEmpty(message = "用户名不能为空")
private String name;
    
@Size(min=6 ,max= 20 ,message = "密码长度不符合标准")
private String pwd;

• 修正 Controller

public class UserController {
    @RequestMapping(value="/login", method = {RequestMethod.GET})
    public String test(Model model) {
        if(!model.containsAttribute("userVo")){
            model.addAttribute("userVo", new UserVo());
        }
        return "login";
    }
    
    @RequestMapping(value="/login", method = {RequestMethod.POST})
    public ModelAndView test(ModelMap model, @Valid @ModelAttribute("userVo") UserVo userVo, BindingResult result) 
            throws NoSuchAlgorithmException {
        MsgVo msgVo = new MsgVo();
        msgVo.setMsg("Hi " + userVo.getName() + ", " + helloService.sayHello());
        
        if (result.hasErrors()) {
            return new ModelAndView("/login", null);
        }
        model.addAttribute("msgVo", msgVo);
        
        return new ModelAndView("/login_success", model);
    }
} 

再次配置 mavenweb-parent 项目

在 pom 文件中，添加两个子模块:

<modules>
    <module>../mavenweb-client</module>
    <module>../mavenweb-server</module>
</modules>

至此，工程基本设置完毕了。

编译

使用命令行：

cd ../mavenweb-proj/
mvn clean install -DskipTests=true

运行

可以使用命令把 war 包发布到 tomcat 中，并启动 tomcat 服务；或直接在 Eclipse 中运行。
为节省篇幅，这里只介绍后者；命令行的启动则会放到下一篇博文中讨论，

在 Eclipse 中运行：

• 编译后，刷新 Eclipse 工程
• 右键点击工程 -> Run as -> Run on Server -> 选择 Tomcat 9.0（注意 Tomcat 与 JDK 的兼容性问题）
• 浏览器中输入：http://localhost:8080/mavenweb-client/

Login.png Login Validation.png Login Success.png

完整源码下载：

请移步到百度网盘下载源码，并导入到 Eclipse 中。下载地址：
https://pan.baidu.com/s/1pLo0Ynx

下一篇预告

在本文基础上，添加并完善一些 web 项目的基本功能，包括：

• 完善 Login 页面，添加 css 与 js 事件。
• 添加日志功能及 hibernate 模块。

P.S. 如有介绍不准确之处或者在运行源代码遇到问题，请在请留下您评论留言。您的鼓励永远是我前进的动力。

参考资料

• 如何使用 Maven:
  http://www.cnblogs.com/leiOOlei/p/3359561.html
• 如何搭建 Maven Web 工程:
  http://www.cnblogs.com/leiOOlei/p/3361633.html
• Maven 依赖管理详解：
  http://blog.csdn.net/liutengteng130/article/details/46991829
• Spring MVC 表单验证详解：
  http://blog.csdn.net/miketom155/article/details/45058195