Ant内置任务之mail

一、概述

        mail是Ant内置任务,用于发送SMTP电子邮件。可以使用纯文本、UU编码或MIME格式发送邮件。SMTP身份验证和SSL/TLS需要JavaMail,并且只能使用MIME格式。可以使用嵌套的attachments元素发送附件,任何基于文件系统的资源或者资源集合都可以用来指向附件。ant1.7之前只支持fileset。此任务需要依赖包javax.mail-api.jar,如果java版本低于1.6还需要activation.jar。

二、属性

        from:发送人电子邮件地址。
        replyto:回复电子邮件地址。
        tolist:逗号分隔的收件人列表。
        cclist:逗号分隔的抄送收件人列表。
        bcclist:逗号分隔的密送收件人列表。
        message:要发送的邮件的正文。
        messagefile:做为要发送的邮件的正文的文件,文件中的属性会被扩展。
        messagemimetype:消息的内容类型,默认为text/plain。
        files:做为邮件附件发送的文件,使用逗号或空格分隔多个文件名,还可以通过fileset指定。
        failonerror:发生错误时是否停止构建,默认为true。
        includefilenames:在文件内容之前是否包含文件名,只有使用plain编码时有效,默认为false。
        mailhost:SMTP服务器主机名,默认为localhost。
        mailport:SMTP服务器TCP端口,默认为25。
        user:SMTP身份验证的用户名。如果SMTP服务器需要身份验证,并且使用MIME发送邮件,需要指定此属性,并且需要JavaMail依赖包。
        password:SMTP身份验证的密码。如果SMTP服务器需要身份验证,并且使用MIME发送邮件,需要指定此属性,并且需要JavaMail依赖包。
        ssl:是否需要TLS/SSL。
        encoding:指定电子邮件内容的编码,可选值为mime、uu、plain或auto,默认为auto。uu和plain不支持SMTP身份验证。
        charset:电子邮件的字符集。还可以在message嵌套元素中设置字符集。
        subject:电子邮件标题。
        ignoreInvalidRecipients:ant1.8起,是否尝试将邮件发送到尽可能多的人,只有在无法访问时才失败,默认为false。
        enableStartTLS:STARTTLS命令是否用于切换到加密连接进行身份验证。
        支持以下嵌套元素:
to/cc/bcc/from/replyto:添加一个电子邮件地址元素,具有以下属性:
       name:地址显示的名字,不是必需的。
                address:邮件地址。
        message:指定邮件的正文。具有以下属性:
                src:做为邮件正文的文件。
                mimetype:消息的内容类型。
                charset:电子邮件的字符集。
        header:ant1.7起,通过嵌套一个或多个header元素来添加任意的邮件头,具有以下属性:
                name:与邮件头关联的名称。
                value:邮件头的值。

三、简单示例



	
		
		
		this is send by ant!
		
			
				
			
		
	


你可能感兴趣的:(Ant入门)