Mail (hutool 5.8.33 API)

java.lang.Object
- cn.hutool.extra.mail.Mail

All Implemented Interfaces:

Builder<javax.mail.internet.MimeMessage>, Serializable
```
public class Mail
extends Object
implements Builder<javax.mail.internet.MimeMessage>
```
邮件发送客户端

Since:

3.2.0

Author:

looly

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

Mail()
构造，使用全局邮件帐户

Mail(MailAccount mailAccount)
构造

Constructors
Constructor and Description
`Mail()` 构造，使用全局邮件帐户
`Mail(MailAccount mailAccount)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Mail`	`addImage(String cid, File imageFile)` 增加图片，图片的键对应到邮件模板中的占位字符串
`Mail`	`addImage(String cid, InputStream imageStream)` 增加图片，图片的键对应到邮件模板中的占位字符串，图片类型默认为"image/jpeg"
`Mail`	`addImage(String cid, InputStream imageStream, String contentType)` 增加图片，图片的键对应到邮件模板中的占位字符串
`javax.mail.internet.MimeMessage`	`build()` 构建
`static Mail`	`create()` 创建邮件客户端，使用全局邮件帐户
`static Mail`	`create(MailAccount mailAccount)` 创建邮件客户端
`String`	`send()` 发送
`Mail`	`setAttachments(DataSource... attachments)` 增加附件或图片，附件使用`DataSource` 形式表示，可以使用`FileDataSource`包装文件表示文件附件
`Mail`	`setBccs(String... bccs)` 设置多个密送人（blind carbon copy）
`Mail`	`setCcs(String... ccs)` 设置多个抄送人（carbon copy）
`Mail`	`setCharset(Charset charset)` 设置字符集编码
`Mail`	`setContent(String content)` 设置正文正文可以是普通文本也可以是HTML（默认普通文本），可以通过调用`setHtml(boolean)` 设置是否为HTML
`Mail`	`setContent(String content, boolean isHtml)` 设置正文
`Mail`	`setDebugOutput(PrintStream debugOutput)` 设置debug输出位置，可以自定义debug日志
`Mail`	`setFiles(File... files)` 设置文件类型附件，文件可以是图片文件，此时自动设置cid（正文中引用图片），默认cid为文件名
`Mail`	`setHtml(boolean isHtml)` 设置是否是HTML
`Mail`	`setReply(String... reply)` 设置多个回复地址(reply-to)
`Mail`	`setTitle(String title)` 设置标题
`Mail`	`setTos(String... tos)` 设置多个收件人
`Mail`	`setUseGlobalSession(boolean isUseGlobalSession)` 设置是否使用全局会话，默认为true
`Mail`	`to(String... tos)` 设置收件人

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Mail
```
public Mail()
```
    构造，使用全局邮件帐户
  - Mail
```
public Mail(MailAccount mailAccount)
```
    构造
    
    Parameters:
    
    mailAccount - 邮件帐户，如果为null使用默认配置文件的全局邮件配置
- Method Detail
  - create
```
public static Mail create(MailAccount mailAccount)
```
    创建邮件客户端
    
    Parameters:
    
    mailAccount - 邮件帐号
    
    Returns:
    
    Mail
  - create
```
public static Mail create()
```
    创建邮件客户端，使用全局邮件帐户
    
    Returns:
    
    Mail
  - to
```
public Mail to(String... tos)
```
    设置收件人
    
    Parameters:
    
    tos - 收件人列表
    
    Returns:
    
    this
    
    See Also:
    
    setTos(String...)
  - setTos
```
public Mail setTos(String... tos)
```
    设置多个收件人
    
    Parameters:
    
    tos - 收件人列表
    
    Returns:
    
    this
  - setCcs
```
public Mail setCcs(String... ccs)
```
    设置多个抄送人（carbon copy）
    
    Parameters:
    
    ccs - 抄送人列表
    
    Returns:
    
    this
    
    Since:
    
    4.0.3
  - setBccs
```
public Mail setBccs(String... bccs)
```
    设置多个密送人（blind carbon copy）
    
    Parameters:
    
    bccs - 密送人列表
    
    Returns:
    
    this
    
    Since:
    
    4.0.3
  - setReply
```
public Mail setReply(String... reply)
```
    设置多个回复地址(reply-to)
    
    Parameters:
    
    reply - 回复地址(reply-to)列表
    
    Returns:
    
    this
    
    Since:
    
    4.6.0
  - setTitle
```
public Mail setTitle(String title)
```
    设置标题
    
    Parameters:
    
    title - 标题
    
    Returns:
    
    this
  - setContent
```
public Mail setContent(String content)
```
    设置正文
    正文可以是普通文本也可以是HTML（默认普通文本），可以通过调用setHtml(boolean) 设置是否为HTML
    
    Parameters:
    
    content - 正文
    
    Returns:
    
    this
  - setHtml
```
public Mail setHtml(boolean isHtml)
```
    设置是否是HTML
    
    Parameters:
    
    isHtml - 是否为HTML
    
    Returns:
    
    this
  - setContent
```
public Mail setContent(String content,
                       boolean isHtml)
```
    设置正文
    
    Parameters:
    
    content - 正文内容
    
    isHtml - 是否为HTML
    
    Returns:
    
    this
  - setFiles
```
public Mail setFiles(File... files)
```
    设置文件类型附件，文件可以是图片文件，此时自动设置cid（正文中引用图片），默认cid为文件名
    
    Parameters:
    
    files - 附件文件列表
    
    Returns:
    
    this
  - setAttachments
```
public Mail setAttachments(DataSource... attachments)
```
    增加附件或图片，附件使用DataSource 形式表示，可以使用FileDataSource包装文件表示文件附件
    
    Parameters:
    
    attachments - 附件列表
    
    Returns:
    
    this
    
    Since:
    
    4.0.9
  - addImage
```
public Mail addImage(String cid,
                     InputStream imageStream)
```
    增加图片，图片的键对应到邮件模板中的占位字符串，图片类型默认为"image/jpeg"
    
    Parameters:
    
    cid - 图片与占位符，占位符格式为cid:${cid}
    
    imageStream - 图片文件
    
    Returns:
    
    this
    
    Since:
    
    4.6.3
  - addImage
```
public Mail addImage(String cid,
                     InputStream imageStream,
                     String contentType)
```
    增加图片，图片的键对应到邮件模板中的占位字符串
    
    Parameters:
    
    cid - 图片与占位符，占位符格式为cid:${cid}
    
    imageStream - 图片流，不关闭
    
    contentType - 图片类型，null赋值默认的"image/jpeg"
    
    Returns:
    
    this
    
    Since:
    
    4.6.3
  - addImage
```
public Mail addImage(String cid,
                     File imageFile)
```
    增加图片，图片的键对应到邮件模板中的占位字符串
    
    Parameters:
    
    cid - 图片与占位符，占位符格式为cid:${cid}
    
    imageFile - 图片文件
    
    Returns:
    
    this
    
    Since:
    
    4.6.3
  - setCharset
```
public Mail setCharset(Charset charset)
```
    设置字符集编码
    
    Parameters:
    
    charset - 字符集编码
    
    Returns:
    
    this
    
    See Also:
    
    MailAccount.setCharset(Charset)
  - setUseGlobalSession
```
public Mail setUseGlobalSession(boolean isUseGlobalSession)
```
    设置是否使用全局会话，默认为true
    
    Parameters:
    
    isUseGlobalSession - 是否使用全局会话，默认为true
    
    Returns:
    
    this
    
    Since:
    
    4.0.2
  - setDebugOutput
```
public Mail setDebugOutput(PrintStream debugOutput)
```
    设置debug输出位置，可以自定义debug日志
    
    Parameters:
    
    debugOutput - debug输出位置
    
    Returns:
    
    this
    
    Since:
    
    5.5.6
  - build
```
public javax.mail.internet.MimeMessage build()
```
    Description copied from interface: Builder
    
    构建
    
    Specified by:
    
    build in interface Builder<javax.mail.internet.MimeMessage>
    
    Returns:
    
    被构建的对象
  - send
```
public String send()
            throws MailException
```
    发送
    
    Returns:
    
    message-id
    
    Throws:
    
    MailException - 邮件发送异常

Class Mail

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Mail

Mail

Method Detail

create

create

to

setTos

setCcs

setBccs

setReply

setTitle

setContent

setHtml

setContent

setFiles

setAttachments

addImage

addImage

addImage

setCharset

setUseGlobalSession

setDebugOutput

build

send