(二)Maven的坐标和依赖&利用Maven实现邮件发送

本文中将《Maven实战》中对坐标和依赖的定义展示给初学Maven的程序猿们,并加上书中实例展示,具体详细请购买《Maven实战》--许晓斌著,更加详细的学习Maven。

坐标详解

groupld:定义当前Maven项口隶属的实际项口。首先,Maven 项目和实际项目不一定是一对一的关系。比如SpringFramework这实际项目, 其对应的Maven项口会有很多,如spring-core、spring-context 等。这是由于Maven中模块的概念,因此,一个实际项目往往会被划分成很多模块。其次,groupld不应该对应项目隶属的组织成公同。原因很简单,一个组织下会有很多实际项目,如果groupld 只定义到组织级别,而后面我们会看到、arifactld 只能定义Maven项目(模块),那么实际项目这个层将难以定义。最后,groupld 的表示方式与Java包名的表示方式类似,通常与域名反向一一对应。 上例中,groupld 为ong. sonatype. nexus, ong sonatype 表示Sonatype公司建立的一个非盈利性组织,nexus 表示Nexus这实际项目,该groupld 与城名nerus sonatype. ong对应。
artifactld: 该元素定义实际项目中的一个Maven项目(模块),推荐的做法是使用实际项目名称作为artifactld的前级。比如上例中的artifaectld是nexus-indexer,使用了实际项目名nexus作为前级,这样做的好处是方便寻找实际构件。在默认情况下,Maven生成的构件,其文件名会以artifaetld作为开头,如nexus-indexer-2.0.0. jar,使用实际项目名称作为前缀之后,就能方便从一个lib文件夹中找到某个项目的组构件。考虑有5个项目,每个项目都有一个core模块,如果没有前级,我们会看到很多core-1.2. jar这样的文件,加上实际项目名前级之后,便能很容易区分foo-core-1.2. jar、bar-core-1. 2. jar...... 

 

version:该元素定义Maven项目当前所处的版本,如上例中nexus-indexer的版本是2.0.0。需要注意的是,Maven 定义了一套完整的版本规范,以及快照(SNAPSHOT)的概念。
packaging:该元素定义Maven项目的打包方式。首先,打包方式通常与所生成构件的文件扩展名对应,如上例中packaging为jar,最终的文件名为nexus-indexer-2.0.0. ar,面使用war打包方式的Maven项目,最终生成的构件会一个.war文件,不过这不是地对的。其次,打包方式会影响到构建的生命用期,比如jar打包和war打包会使用不同的命令。最后,当不定义packogne的时候,Maven会使用默认值jar。

上述4个元素中,goupld. arifaeld version 是必须定义的,packaging 是可选的(默认为jar)。
同时,项目构件的文件名是与坐标相对应的,一般的规则为 atifactld-version [ -classifi-er] . packaging, [-classifer] 表示可选。比如上例nexus-indexer的主构件为nexus-indexer-2.0.0. jar,附属构件有nexus-indexer-2.0.0-javadoc. jar。这里还要强调的一点是,packaging非一定与构件扩展名对应,比如packaging为maven-plugin的构件扩展名为jar.

依赖范围

compile:编译依赖范围。如果没有指定,就会默认使用该依赖范围。使用此依精范围的Meven依赖,对于编译、测试、运行三种classpath 都有效。典型的例子局spring-core,在编译、测试和运行的时候都需要使用该依赖。
test:测试依赖范围。使用此依赖范围的Maven依赖,只对于测试classpath有效,在编译主代码成者运行项目的使用时将无法使用此类依赖。典型的例子基JUnit,它只有在编译测试代码及运行测试的时候才需要。
provided:已提供依赖范围。使用此依赖范围的Maven依赖,对于编译和测试claerpath有效,但在运行时无效。典型的例子是servlet-api,编译和测试项目的时候需要该依赖,但在运行项目的时候,由于容器已经提供,就不需要Maven重复地引入。
runtime:运行时依赖范围。使用此依赖范围的Maven依赖,对于测试和运行clapath有效,但在编译主代码时无效。典型的例子是JDBC驱动实现,项目主代码的编译只需要JDK提供的JDBC接口,只有在执行测试成者运行项目的时候才需要实现上述接口的具体JDBC驱动。
system:系统依赖范围。该依赖与三种casspath的关系,和provided依赖范围完全一致。但是,使用system范围的依顿时必须通过systemPath 元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven 仓库解析的,而且往往与本机系统绑定,可能造成构建的不可移植,因此应该谨慎使用。systemPath 元素可以引用环境变量,如:

<dependency>
        <groupId >javax.sql</groupId >
        <artifactId>jdbe-stdext</artifactId>
        <version>2.0 </version>
        <scope>system</scope>
        <systemPath>${java.home}/lib/rt.jar</systemPath>
    </dependency>


利用Maven实现邮件发送

文件结构

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.feiyu.web</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.1.7.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>4.1.7.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>2.5.6</version>
        </dependency>
        <dependency>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
            <version>1.4.1</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.7</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.icegreen</groupId>
            <artifactId>greenmail</artifactId>
            <version>1.3.1b</version>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>RELEASE</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>

</project>

 一个很简单的接口AccountEmailService.java

package com.feiyu.account.email;


public interface AccountEmailService {
    void sendMail(String to, String subject,String htmlText) throws AccountEmailException;
}

接口的实现类AccountEmailServiceImpl.java

package com.feiyu.account.email;

import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;

public class AccountEmailServiceImpl implements AccountEmailService{
    private JavaMailSender javaMailSender;
    private String systemEmail;
    public void sendMail(String to, String subject, String htmlText) throws AccountEmailException {
        try{
            MimeMessage mimeMessage = javaMailSender.createMimeMessage();
            MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage);

            messageHelper.setFrom(systemEmail);
            messageHelper.setTo(to);
            messageHelper.setSubject(subject);
            messageHelper.setText(htmlText,true);
            javaMailSender.send(mimeMessage);
        } catch (MessagingException e) {
            throw new AccountEmailException("Faild to send mail.", e);
        }
    }

    public JavaMailSender getJavaMailSender() {
        return javaMailSender;
    }

    public void setJavaMailSender(JavaMailSender javaMailSender) {
        this.javaMailSender = javaMailSender;
    }

    public String getSystemEmail() {
        return systemEmail;
    }

    public void setSystemEmail(String systemEmail) {
        this.systemEmail = systemEmail;
    }
}

异常捕获类AccountEmailException.java

package com.feiyu.account.email;

public class AccountEmailException
        extends Exception
{
    public AccountEmailException( String message )
    {
        super( message );
    }

    public AccountEmailException( String message, Throwable throwable )
    {
        super( message, throwable );
    }
}

配置文件email.properties

email.protocol = smtps
email.host = smtps.qq.com
email.port = 456
email.username = your_id@qq.com
email.password = your_password
email.auth = true
email.systemEmail = your_id@qq.com

Spring配置文件email.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean id="propertyConfigurer"
          class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="location" value="classpath:email.properties" />
    </bean>
    <!--定义邮件服务器的一些配置、包括协议、端口、主机、用户名、密码,是否需要认证等属性-->
    <bean id="javaMailSender" class="org.springframework.mail.javamail.JavaMailSenderImpl">
        <property name="protocol" value="${email.protocol}" />
        <property name="host" value="${email.host}" />
        <property name="port" value="${email.port}" />
        <property name="username" value="${email.username}" />
        <property name="password" value="${email.password}" />
        <property name="javaMailProperties">
            <props>
                <prop key="mail.${email.protocol}.auth">${email.auth}</prop>
            </props>
        </property>
    </bean>
    <!--注入javaMailSender-->
    <bean id="accountEmailService"
          class="com.feiyu.account.email.AccountEmailServiceImpl">
        <property name="javaMailSender" ref="javaMailSender" />
        <property name="systemEmail" value="${email.systemEmail}" />
    </bean>
</beans>

测试类AccountEmailServiceTest.java

package com.feiyu.account.email;

import static org.junit.Assert.*;

import javax.mail.Message;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.icegreen.greenmail.util.GreenMail;
import com.icegreen.greenmail.util.GreenMailUtil;
import com.icegreen.greenmail.util.ServerSetup;

public class AccountEmailServiceTest {
    private GreenMail greenMail; // 使用GreenMail作为测试服务器

    @Before
    // Before注解表示会先于测试方法@Test执行
    public void startMailServer() throws Exception {
        greenMail = new GreenMail(ServerSetup.SMTP);
        greenMail.setUser("your_id@qq.com", "your_password"); // 创建邮件账户
        greenMail.start(); // 启动邮件服务
    }

    @Test
    public void testSendMail() throws Exception {

        ClassPathXmlApplicationContext classPathXmlApplicationContext = new ClassPathXmlApplicationContext(
                "email.xml");

        AccountEmailService accountEmailService = (AccountEmailService) classPathXmlApplicationContext
                .getBean("accountEmailService");

        String subject = "your_Test_subject"; //邮件主题
        String htmlText = "<h3>your_content</h3>"; //邮件内容
        accountEmailService.sendMail("your_id@qq.com", subject, htmlText); // 发送

        greenMail.waitForIncomingEmail(3000, 1); // 最多等待3s

        Message[] msgs = greenMail.getReceivedMessages(); // 读取收到的邮件
        assertEquals(1, msgs.length); // 检查数目
        assertEquals(subject, msgs[0].getSubject());
        assertEquals(htmlText, GreenMailUtil.getBody(msgs[0]).trim());
    }

    @After
    public void stopMailServer()
            throws Exception {
        greenMail.stop();			//停止
    }
}

 

 

阅读更多

没有更多推荐了,返回首页