如何创建带子模块的Maven Web工程

        当在Eclipse中创建Maven带子模块的Web工程时，对于新手经常会遇到无法部署Web站点的问题。下面就带着大家走一遍带子工程的Maven站点，顺便讲一下如何解决这个问题。

一、创建父工程

1、  创建Maven工程

        首先，在Eclipse中新建一个Maven Project：

图1

        单击“Next”，直到出现如下界面：

图2

        在这一步中，选中上面的“Create a simple project”复选框，然后单击“Next”：

图3

        在上图中，Group Id为组Id，也就是所有子模块都公用的Id；Artifact Id是模块Id，每个子模块都有自己独立的Artifact Id；Packaging一定要选择“pom”，否则后面无法在它下面创建子模块。

        单击“Finish”完成父工程创建。创建完毕后的工程如下图所示：

图4

二、创建web子模块

        接下来创建子模块。

1、  创建web工程子模块

        首先创建web工程子模块，在parent工程上单击右键，选择“New/Other”，打开如下所示窗口：

图5

        在该窗口中选择“Maven Module”，单击“Next”：

图6

        在“Module Name”中输入“website”，单击“Next”：

图7

        在该窗口的模板列表中选择“maven-archetype-webapp”，单击“Next”：

图8

        在该窗口中可根据需要修改version和Package(最好将Package改为“GroupId + Artifact Id”的格式，便于以后识别和管理)，单击“Finish”即可完成子模块创建，如下图所示：

图9

2、  修改站点配置信息

        对于新创建的站点，需要修改一下配合信息。打开website的Properties窗口，在“Java Build Path”下的Libraries选项卡中将J2SE的引用删除，添加J2EE的引用，如下图所示：

图10

        并将Java Compilier中的Java版本改为1.7：

图11

        然后切换到“Project Facets”节点，如下图所示：

图12

        单击右侧的“Convert to faceted form…”，打开如下图所示窗口：

图13

        在上图中，选中“Project Facet”列表中的“Dynamic Web Module”，先后单击“Apply”按钮和“OK”按钮，完成工程类型转换。

        接下来创建组件包子模块。

三、创建组件包子模块

1、  创建组件包子模块

        同样是在parent工程上单击右键，新建Maven Module，并在新弹出的窗口中输入组件子模块的名称，如“component”，然后一直单击next直到子模块创建完毕。新创建的component子模块结构如下图所示：

图14

2、  修改子模块参数

        与创建web子模块类似，需要将component引用的Java版本改为JDK1.7。

3、  创建package

        在component子模块下创建名称为“com.unitname.test.math”的package。

4、  创建类

        在新创建的“com.unitname.test.math”package下新建名称为“CCalculate”的class，并在里面编写方法，如下图所示：

图15

四、在web站点中调用组件

1、  引用组件包

        打开website工程下的pom.xml，在里面添加对component子模块的引用，如下图所示：

图16

        在上图中，红框圈住的部分即为需要增加的内容。其中，groupId和version节点中可以写被引用的工程的对应内容，如果与本模块相同，也可以像上图中所示的使用“${project.groupId}”和“${project.version}”的方式。

2、  编写servlet调用组件

        在website模块中创建一个名为“com.unitname.test.service”的package，并在下面新建一个名为matchservice的servlet，代码如下图所示：

图17

        此时代码中会提示找不到javax.servlet包，可通过在站点中增加对servlet-api组件的引用：

图18

        也可通过在web站点的引用中添加对Server Runtime的引用的方式解决：

图19

五、发布站点

1、  发布站点

        将站点部署到tomcat中，并启动。

2、  访问servlet

        在浏览器中输入上面创建的servlet地址http://localhost:8080/website/mathservice?a=2&b=3，此时页面出现如下错误：

图20

        Tomcat中也提示相同的错误：

图21

        此时还需要做一步操作：添加Deployment配置。

3、  添加DeploymentAssembly配置

        在web子模块上单击右键，选择“Properties”，在打开的窗口中选择“Deployment Assembly”，如下图所示：

图22

        在上图中，打击右侧的“Add”按钮，打开如下图所示窗口：

图23

        在上图所示窗口中选择“Java Build Path Entries”，单击“Next”：

图24

        在上图中选择“Maven Dependencies”，单击“Finish”完成添加。

        然后接着添加对Project的引用。在图23中选择“Project”，单击“Next”，打开如下图所示窗口：

图25

        在上图选择要引用的工程component，单击“Finish”完成添加。

        重启Tomcat，再次访问该servlet，出现如下所示的正常结果：

图26

        搞定！