W3 Jmail使用详细教程+简单实例

W3 JMail 邮件组件是Dimac公司开发的用来完成邮件的发送、接收、加密和集群传输等工作的。w3 Jmail组件是国际最为流行的邮件组件之一，当今世界上绝大部分ASP程序员都在使用w3 Jmail组件构建邮件发送系统，那是因为w3 Jmail组件使用了新的内核技术，使其更加可靠和稳定。

一、下面向读者介绍w3 Jmail4.3组件的新特性：

1、 w3 Jmail4.3组件重新设计了其内部结构——使用Message对象代替原来的单一对象Jmail.smtpmail发送邮件；

2、 w3 Jmail4.3组件一共有十多个对象（后面将详细介绍）——这些对象中，绝大多数是针对Jmail.Message对象操作的；

3、 支持从POP3邮件服务器收取邮件；

4、 支持加密邮件的传输；

5、 快速发送，一次会话就完成邮件发送；

6、 还有一个特性就是可以使用w3 Jmail4.3组件的集群发送功能一次发送成千上万个邮件，还可以通过邮件合并（mailmerge）对象来个性化邮件。

二、Jmail邮件组件的安装及卸载：

1、 安装

跟使用别个组件一样，在使用Jmail邮件组件之前要先安装或注册该组件Jmail.dll。具体注册方法，是先把Jmail.dll文件拷贝到硬盘的某一目录下（如C:/Jmail/Jmail.dll），然后执行命令Regsvr32 C:/Jmail/Jmail.dll即可。

2、 卸载

卸载组件是安装组件的相反动作，可以使用参数/U来卸载已安装的组件，执行命令Regsvr32 /U Jmail.dll即可。

三、详细介绍W3 Jmail组件的对象（12个）:

1、.POP3对象

属性（或方法）
说明

Connect(Username,Password,Server,Port)
连接POP3服务器，断口可选，默认110。

DeleteMessages()
从邮件服务器上删除所有邮件。

DeleteSingleMessage(MessageID)
从邮件服务器上删除由MessageID指定的邮件。

Disconnect()
关闭跟邮件服务器的连接。

DownloadHeaders()
从邮件服务器上读取所有的邮件头并传递给Messages集合。

DownloadMessages()
从邮件服务器读取所有邮件。

DownloadSingleHeader(MessageID)
从邮件服务器读取指定的邮件头并传递给Messages集合。

DownloadUnreadMessages()
从邮件服务器上读取所有未读邮件。




2、.Messages对象

属性（或方法）
说明

Clear()
清除集合中的所有内容，并不会删除邮件服务器上的任何邮件。

Count():Integer
返回集合中记录的数目：I=Messages.Count

Item(Index):Pointer
返回一个Message对象。Set oMsg=Messages.Item(0)




3、.Message对象

属性（或方法）
说明

AddAttachment(FileName,isInline,ContentType):String
给邮件添加一个文件型的附件。isInline设置为True时，添加的这个附件就是一个可嵌入的附件。

AddCustomAttachment(FileName,Data,isInline):String
给邮件添加一个自定义类型的附件。

AddHeader(Xheader,Value)
给邮件添加一个自定义邮件头X-Header。

AddNativeHeader(Header,Value)
给邮件添加一个邮件头。

AddRecipient(emailAddress,recipientName,PGPKey)
给邮件添加一个收件人。RecipientName和PGPKey是可选项，RecipientName为收件人姓名，PGPKey给邮件加密。

AddRecipientBCC(emailAddress,PGPKey)
添加一个邮件暗送人（BCC）地址。

AddRecipientCC(emailAddress,recipientName,PGPKey)
给邮件添加一个邮件抄送人（CC）地址。

AddURLAttachment(bstrURL,bstrAttachAs,isInline,bstrAuth):String
从指定的URL下载文件并添加为邮件附件。参数bstrAttachAs是用来更改添加为邮件附件的文件名。

AppendBodyFromFile(FileName)
清除邮件正文，并把指定文件的内容作为邮件正文。

AppendHTML(Text)
从邮件追加HTML格式正文，如例所示：Message. AppendHTML(“

Hello Word

”)

AppendText(Text)
向邮件添加文本正文。

Clear()
清除所有邮件消息，是成为一个空对象。

ClearAttachments()
清除附件列表。如：Message.ClearAttachments

ClearCustomHeaders()
清除所有自定义的邮件头。

ClearRecipients()
清除所有收件人地址列表。

Close()
释放Jmail与邮件服务器连接而使用的缓存（Cache）。

DecodeHeader(Header):String
输出一个邮件头消息。

ExtractEmailAddressesFromURL(bstrURL,bstrAuth)
从指定的网制（URL）读取并添加邮件列表。

GetMessageBodyFromURL(同上)
删除邮件正文并用指定的URL的内容代替。

KeyInformation(keyIdentifier):pointer
返回一个PGPKey对象。

LoadFromStream(Stream)
从数据库流读取数据，该数据库流必须符合RFC822标准。

LogCustomMessage(Message)
给Jmail日志文件添加自定义日志。此函数只有在logging属性被设置为True时有效。

Nq()
将邮件追加到发送队列等待发送。

ParseMessage(MessageSource)
解析一个邮件，数据流必须符合RFC822格式标准。

SaveToStream(Stream)
保存邮件到数据流，数据流必须符合RFC822格式标准。

Send(MailServer,enque):Boolean
发送邮件。邮件服务器是一个描述邮件服务器名称或地址的字符串，用户名和密码是可选项。当要发送认证邮件时使用格式为：用户名:密码@邮件服务器

SendToNewsGroup(ServerName,NewsGroup)
使用指定的ＮＮＴＰ服务器发送邮件到新闻组，多个邮件用“,”隔开。

About():string
设置一些附加信息。

Attachments():Pointer
返回邮件的附件集合。Set Attachments=Message.Attachments

Body():String
返回邮件正文。Response.Write (Message.Body) [NextPage]
  BodyText():String
返回全部的文本正文。Response.Write (Message.BodyText)

Charset():String
设置邮件使用的字符集。默认为US-ASCII,支持中文则设置为GB2312。

ContentTransferEncoding():String
设置邮件编码。默认为：Quoted-Printable.

ContentType():string
返回正文类型。

Date():Date
返回邮件发送时间。

DeferredDelivery():Date
设置邮件定时发送。

Encoding():String
设置附件的默认编码：Base64或Quoted-Printable

EncryptAttachments():Boolean
设置为True时，所有的附件都被加密，当然是编译器可用的情况下。其默认值为True.

ErrorCode():Integer
如果message.silent设置为True时，该函数包含错误号。

ErroeMessage():String
如果message.silent设置为True时，该函数包含错误描述。

ErroeSource():String
如果message.silent设置为True时，该函数包含错误来源。

From():String
返回或设置发件人的Email地址。

FromName():String
返回或设置发件人的名字。

HtmlBody():String
返回或设置邮件正文的HTML部分。

ISOEncodeHeaders():Boolean
邮件头是否使用iso-8859-1编码。（默认为True）

Log():String
当Logging为True时，该函数返回创建的日志。

Logging():Boolean
是否启用日志。Message.Logging=True时，启用日志。

MailData():String
返回邮件的源代码。

MailDomain():String
设置发送邮件时使用的邮件服务器。

MailServerPassWord():String
当邮件服务器使用SMTP发信认证时，该函数设置登录密码。

MailServerUserName():String
当邮件服务器使用SMTP发信认证时，该函数设置登录帐号。

MimeVersion():String
声明Mime版本，默认为1.0。

MsPickupdirectory():String
指定MS SMTP服务的Pickup文件夹的位置。

PGPEncrypt():Boolean
当邮件是使用PGP发送时并该属性被设置为True时，该邮件将被自动加密。

PGPSign():Boolean
当邮件是使用PGP发送时并该属性被设置为True时，该邮件将被自动签名。

Priority():Byte
设置邮件的优先级：1、2和3

Recipients():Pointer
返回收件人集合。

RecipientsString():String
返回收件人集合（只读）。

ReplyTo():String
指定一个回复地址。

Silent():Boolean
当设置为True时，Send()方法就会忽略错误并不将错误信息返回给操作系统。

SimpleLayout():Boolean
当设置为True时，发信时Jmail不会添加邮件头到邮件里。

Size():Integer
返回邮件的总字节数。

Subject():String
设置邮件标题。

Text():string
返回完整的邮件内容。

Version():String
返回Jmal的版本信息。




4、 Headers对象

属性（或方法）
描述

GetHeader(HeaderName):String
返回指定的邮件头的值。

Text():String
返回所有的邮件头的值。




5、 Recipients对象

属性（或方法）
描述

Add(Value)
追加一个收件人到集合中。

Clear()
清除集合中的全部记录。

Count():Integer
返回集合中收件人的总数。

Item(Index):Pointer
返回集合中的一个指定的收件人。




6、 Recipient对象

属性（或方法）
描述

New(Name,Email,recipientType):Pointer
创建一个可以添加到收件人集合中Recipients的收件人。

Email():String
返回收件人的邮件。

Name():String
返回收件人的姓名。

ReType():Integer
返回收件人模式（收件人To=0,抄送CC=1,暗送BCC=2）。




7、 Attachments对象

属性（或方法）
描述

Add(Attachment)
添加一个附件到集合。

Clear()
清除集合中的全部附件。

Count():Integer
返回集合中附件的总数。

Item(Index):Pointer
返回集合中指定的附件。[NextPage]
   8、 Attachment对象

属性（或方法）
描述

New(FileName,ContentType,Data):Pointer
创建一个可以加入到Attachments集合的附件。如果指定Data的值，那么Jmail将创建一个以Data参数为内容的自定义附件。

SaveToFile(FileName)
保存附件到硬盘。

ContentType():String
返回附件类型（ContentType）

Data():String
返回附件的内容。

BinaryData():String
以二进制模式返回附件的内容。

IsInline():Boolean
如果附件被设置为可嵌入（inline）,则返回True。

Name():String
返回附件的文件名称。

Size():Integer
返回附件的大小。





9、 MailMerge对象

属性（或方法）
描述

BulkMerge(RecordSet,enque,Maildestination)
参照邮件 模板合并所有记录，要指定使用的pickuo文件夹或邮件服务器。

Expand():Pointer
参照用户指定的方式合并邮件 模板（mailTemplate）。

ExpandFromRecordSet(RecordSet):Pointer
参照邮件 模板（mailTemplate）合并ADO对象中的一例。

SetDebugMode(TestMailAddress,TestCount)
将邮件合并（mailMerge）设置为测试模式。

Item(VariableNmae):String
手工设置合并参数。注意：该功能不使用于ADO数据例的合并。

MailTemplate():Pointer
设置一个创建好的Message对象，这个对象将被作为邮件合并的 模板。

MergeAttachments():Boolean
当该属性设置为 True时，附件被作为邮件合并的一个选项。





10、 PGPKeys对象

属性（或方法）
描述

Count():Integer
返回密码的总数。

Item(Index):Pointer
返回PGPKey信息对象。





11、 PGPKeyInfo对象

属性（或方法）
描述

KeyCreateDate():String
返回邮件密码创建的时间。

KeyID():String
返回密码的ID号。

KeyUser():String
返回创建密码的用户名。





12、 SpeedMailer对象

属性（或方法）
描述

EnqueMail(FromEmail,RecipientEmails,

Subject,Body,MsPickupdirectory)
添加一个邮件到发送队列。内容、主题等数据通过该方法的参数传递。

SendMail(FromEMail,RecipientEMails,

Subject,Body,MailServers)
通过SMTP发送一封邮件。内容、主题等数据通过该方法的参数传递。

SendXMLMail(XML)
关于该函数的用法请访问：http://xml.dimac.net/namespace/jmail





四、利用Jmail4.3邮件组件发送邮件示例：

通过以上的介绍，相信读者对Dimac W3 Jmail及其一些常用的对笠延辛吮冉先娴牧私狻Ｏ旅娼ü桓隼永唇步馊绾未唇╳3 Jmail对象，并使用它来创建一个新邮件，设置邮件的标题、内容等并发送该邮件。

JmailSend.asp

<%@Language=”VBScript”%>

<%

Response.Buffer=True

‘创建Jmail.Message对象实例oJmail

Set oJmail=Server.CreateObject(“Jmail.Message”)

‘启动日志功能

oJmail.Logging=True

‘不将错误返回给操作系统

oJmail.Silent=True

‘设置邮件发送者的邮件地址

oJmail.From=”[email protected]”

‘设置邮件发送者的姓名

oJmail.FromName=”小虎”

‘设置接收邮件人的邮箱地址

oJmail.AddRecipient “[email protected]”

‘设置邮件标题

oJmail.Subject=”邮件测试系统”

‘邮件正文

oJmail.Body=”朋友：”&vbCrLf&vbCrLf&”最近，我使用Jmail开发一个邮件发送系统。”

‘发送邮件，Mail.myDomain.com假设为SMTP服务器

oJmail.Send(“Mail.myDomain.com”)

%>



接下来我们再来看一个比较简单的邮件接收系统。这个例子的执行过程，首先是从存放邮件的服务器上取出邮件，然后把它同附件一起显示在WEB也面上。

JmailReceipt.asp

<% @LANGUAGE=VBSCRIPT %>
<%

Set pJmail = Server.CreateObject( "JMail.POP3" )
pJmail.Connect "username", "password", "mail.mydomain.com"
Response.Write( "你有 " & pJmail.count & " 封新邮件

" )
if pJmail.count > 0 then
Set msg = pJmail.Messages.item(1)
ReTo = ""
ReCC = ""
Set Recipients = msg.Recipients
separator = ", "
For i = 0 To Recipients.Count - 1
If i = Recipients.Count - 1 Then
separator = ""
End If
Set re = Recipients.item(i)
If re.ReType = 0 Then
ReTo = ReTo & re.Name & " (" & re.EMail & ")" & separator
else
ReCC = ReTo & re.Name & " (" & re.EMail & ")" & separator
End If
Next
Function getAttachments()
Set Attachments = msg.Attachments
separator = ", "
For i = 0 To Attachments.Count - 1
If i = Attachments.Count - 1 Then
separator = ""
End If
Set at = Attachments(i)
at.SaveToFile( "c:/fujian/" & at.Name )
getAttachments = getAttachments & "at.Name &""">" & at.Name & "(" & at.Size & " bytes)" &_
"" & separator
Next
End Function

%>

主题	<%= msg.Subject %>
发件人	<%= msg.FromName %>
收件人	<%= ReTO %>
抄送人	<%= ReCC %>
附件	<%= getAttachments %>
正文	<%= msg.Body %>

<%
end if
pJmail.Disconnect ‘断开POP3连接
%>

至此，一个简单的邮件发送和接收系统就开发完成了。至于有些网友要开发比较复杂的邮件系统，可以结合以上所讲的对象及其属性方法来开发，肯定会开发出功能强大齐全的邮件系统。