Maven - 应用案例(六)

通过上面基础知识的准备,我们已经对Maven基本概念有了一定认识。现在,让我们以一个项目案例开启Maven应用开发之旅吧!

 

Note: 该案例参考自Maven实战,源码已经提供在附件中。文章只挑选Maven配置要点讲解,在读文章的时候读者应该配合源码观看。

 

1. 案例场景:

 

我们要开发一个账号服务系统,实现账号注册,登录,验证码,持久化,邮箱服务的基本功能。

模块划分如下:

account-web       :    交互入口

account-service  :    核心服务模块,负责业务组织与模块调用

account-persist   :    持久化支持

account-captcha :    google开源验证码模块

account-email     :    邮件服务


Maven - 应用案例(六)_第1张图片
 

2. 聚合与继承 account-parent

 

目前已经对各模块进行了简单的划分,每一个模块都是一个Maven项目(带pom.xml),可独立开发测试的。

我们在外层做一个叫 account-parent 的模块,将各个子模块聚合起来,变成一个项目:

 

聚合模块 account-parent:

Maven - 应用案例(六)_第2张图片

通过关键字 modules 实现了模块聚合,同时,各模块间会存在一些共享资源(如:都依赖spring),那么我们就可以将这部分共享资源放在 account-parent 中,子模块以继承的方式实现共享资源访问。

 

共享资源定义:

Maven - 应用案例(六)_第3张图片

Note : 如果不确定该依赖在所有的子模块中都会用到,就把它放到<dependencyManagement/>元素中,表示可选的继承依赖。

 

到这里,我们先切换到 account-parent 目录下,运行命令 mvn clean install (前面章节的clean, default生命周期命令哦)

Maven - 应用案例(六)_第4张图片
 

 

3. account-email

 

首先这是一个普通的Maven项目,结构如下:

Maven - 应用案例(六)_第5张图片

 

该模块通过 javax.mail 实现邮件发送功能:

<dependency>
  <groupId>javax.mail</groupId>
  <artifactId>mail</artifactId>
  <version>${javax.mail.version}</version>
</dependency>	
public interface AccountEmailService {
	void sendMail(String to, String subject, String htmlText);
}

 

通过关键字 parent 和父模块坐标,继承了 account-parent:

<parent>
  <groupId>com.juvenxu.mvnbook.account</groupId>
  <artifactId>account-parent</artifactId>
  <version>1.0.0-SNAPSHOT</version>
</parent>

 

因为 account-email 是一个独立的模块,所以我们可以切换到 account-email 目录下,单独对它构建:mvn clean test

Maven - 应用案例(六)_第6张图片

可以看到AccountEmailServiceTest的测试已经通过了。

 

4. account-captcha

该模块通过使用三方构件,实现验证码生成的功能,配置与email相似。由于该校验码构件并没有提交到中央仓库,所以需要自定义远程仓库路径:

<repositories>
 <repository>
  <id>sonatype-forge</id>
  <name>Sonatype Forge</name>
  <url>http://repository.sonatype.org/content/groups/forge/</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>false</enabled>
  </snapshots>
 </repository>
</repositories>

 

5. account-service

这是对外提供业务调度的模块,需要依赖其它的模块才能完成构建行为:

<dependency>
  <groupId>${project.groupId}</groupId>
  <artifactId>account-email</artifactId>
  <version>${project.version}</version>
</dependency>
<dependency>
  <groupId>${project.groupId}</groupId>
  <artifactId>account-persist</artifactId>
  <version>${project.version}</version>
</dependency>

6. account-web

该模块负责前端交互,依赖于 account-service 实现业务的管理

<dependency>
  <groupId>${project.groupId}</groupId>
  <artifactId>account-service</artifactId>
  <version>${project.version}</version>
</dependency>

同时,因为是Web项目,我们需要将它的打包方式改为war包(缺省jar):

<packaging>war</packaging>

还可以看到项目依赖于容器提供的包(前面章节的依赖范围哦):

<dependency>
  <groupId>javax.servlet</groupId>
  <artifactId>servlet-api</artifactId>
  <version>2.4</version>
  <scope>provided</scope>
</dependency>

为了方便开发,还提供了jetty容器插件的集成:

<plugin>
  <groupId>org.mortbay.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <version>7.1.0.RC1</version>
  <configuration>
    <scanIntervalSeconds>10</scanIntervalSeconds>
    <webAppConfig>
      <contextPath>/account</contextPath>
    </webAppConfig>
  </configuration>
</plugin>

 

因为有一个邮件发送的模块,所以在运行项目之前,还需要配置一下邮件服务器的信息:

Maven - 应用案例(六)_第7张图片

 

开启QQ邮箱的SMTP功能: 

 

7. 运行项目

现在我们已经认识了项目主要的知识点,回到 account-parent 目录,重构建一下项目 mvn clean install

然后再到 account-web 目录,执行 mvn jetty:run ,访问 http://localhost:8080/account  就可以看到项目了。


Maven - 应用案例(六)_第8张图片

 

到QQ邮箱中已经可以看到激活邮件了: 
Maven - 应用案例(六)_第9张图片
 

项目对于初学者可能比较复杂,需要配合源码,多运行琢磨一下!

 

资料参考:

http://maven.apache.org

Maven实战  - 许晓斌

你可能感兴趣的:(Maven - 应用案例(六))