MailAccount (hutool-extra 5.8.8 API)

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

所有已实现的接口:

Serializable
```
public class MailAccount
extends Object
implements Serializable
```
邮件账户对象

作者:

Luxiaolei

另请参阅:

序列化表格

字段概要

字段
限定符和类型字段和说明

static String[] MAIL_SETTING_PATHS

字段
限定符和类型	字段和说明
`static String[]`	`MAIL_SETTING_PATHS`

构造器概要

构造器
构造器和说明

MailAccount()
构造,所有参数需自行定义或保持默认值

MailAccount(Setting setting)
构造

MailAccount(String settingPath)
构造

构造器
构造器和说明
`MailAccount()` 构造,所有参数需自行定义或保持默认值
`MailAccount(Setting setting)` 构造
`MailAccount(String settingPath)` 构造

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`MailAccount`	`defaultIfEmpty()` 如果某些值为null，使用默认值
`Charset`	`getCharset()` 获取字符集编码
`Map<String,Object>`	`getCustomProperty()` 获取自定义属性列表
`String`	`getFrom()` 获取发送方，遵循RFC-822标准
`String`	`getHost()` 获得SMTP服务器域名
`String`	`getPass()` 获取密码
`Integer`	`getPort()` 获得SMTP服务端口
`Properties`	`getSmtpProps()` 获得SMTP相关信息
`String`	`getSocketFactoryClass()` 获取指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
`int`	`getSocketFactoryPort()` 获取指定的端口连接到在使用指定的套接字工厂。
`String`	`getSslProtocols()` 获取SSL协议，多个协议用空格分隔
`String`	`getUser()` 获取用户名
`Boolean`	`isAuth()` 是否需要用户名密码验证
`boolean`	`isDebug()` 是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
`boolean`	`isEncodefilename()` 对于文件名是否使用`charset`编码，默认为 `true`
`boolean`	`isSocketFactoryFallback()` 如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
`boolean`	`isSplitlongparameters()` 对于超长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）
`Boolean`	`isSslEnable()` 是否使用 SSL安全连接
`boolean`	`isStarttlsEnable()` 是否使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
`MailAccount`	`setAuth(boolean isAuth)` 设置是否需要用户名密码验证
`MailAccount`	`setCharset(Charset charset)` 设置字符集编码，此选项不会修改全局配置，若修改全局配置，请设置此项为`null`并设置： System.setProperty("mail.mime.charset", charset);
`MailAccount`	`setConnectionTimeout(long connectionTimeout)` 设置Socket连接超时值，单位毫秒，缺省值不超时
`MailAccount`	`setCustomProperty(String key, Object value)` 设置自定义属性，如mail.smtp.ssl.socketFactory
`MailAccount`	`setDebug(boolean debug)` 设置是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
`void`	`setEncodefilename(boolean encodefilename)` 设置对于文件名是否使用`charset`编码，此选项不会修改全局配置如果此选项设置为`false`，则是否编码取决于两个系统属性： mail.mime.encodefilename 是否编码附件文件名 mail.mime.charset 编码文件名的编码
`MailAccount`	`setFrom(String from)` 设置发送方，遵循RFC-822标准发件人可以是以下形式： 1. user@xxx.xx 2.
`MailAccount`	`setHost(String host)` 设置SMTP服务器域名
`MailAccount`	`setPass(String pass)` 设置密码
`MailAccount`	`setPort(Integer port)` 设置SMTP服务端口
`MailAccount`	`setSocketFactoryClass(String socketFactoryClass)` 设置指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
`MailAccount`	`setSocketFactoryFallback(boolean socketFactoryFallback)` 如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
`MailAccount`	`setSocketFactoryPort(int socketFactoryPort)` 指定的端口连接到在使用指定的套接字工厂。
`void`	`setSplitlongparameters(boolean splitlongparameters)` 设置对于超长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）注意此项为全局设置，此项会调用 System.setProperty("mail.mime.splitlongparameters", true)
`MailAccount`	`setSslEnable(Boolean sslEnable)` 设置是否使用SSL安全连接
`void`	`setSslProtocols(String sslProtocols)` 设置SSL协议，多个协议用空格分隔
`MailAccount`	`setStarttlsEnable(boolean startttlsEnable)` 设置是否使用STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
`MailAccount`	`setTimeout(long timeout)` 设置SMTP超时时长，单位毫秒，缺省值不超时
`MailAccount`	`setUser(String user)` 设置用户名
`MailAccount`	`setWriteTimeout(long writeTimeout)` 设置Socket写出超时值，单位毫秒，缺省值不超时
`String`	`toString()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - MAIL_SETTING_PATHS
```
public static final String[] MAIL_SETTING_PATHS
```
- 构造器详细资料
  - MailAccount
```
public MailAccount()
```
    构造,所有参数需自行定义或保持默认值
  - MailAccount
```
public MailAccount(String settingPath)
```
    构造
    
    参数:
    
    settingPath - 配置文件路径
  - MailAccount
```
public MailAccount(Setting setting)
```
    构造
    
    参数:
    
    setting - 配置文件
- 方法详细资料
  - getHost
```
public String getHost()
```
    获得SMTP服务器域名
    
    返回:
    
    SMTP服务器域名
  - setHost
```
public MailAccount setHost(String host)
```
    设置SMTP服务器域名
    
    参数:
    
    host - SMTP服务器域名
    
    返回:
    
    this
  - getPort
```
public Integer getPort()
```
    获得SMTP服务端口
    
    返回:
    
    SMTP服务端口
  - setPort
```
public MailAccount setPort(Integer port)
```
    设置SMTP服务端口
    
    参数:
    
    port - SMTP服务端口
    
    返回:
    
    this
  - isAuth
```
public Boolean isAuth()
```
    是否需要用户名密码验证
    
    返回:
    
    是否需要用户名密码验证
  - setAuth
```
public MailAccount setAuth(boolean isAuth)
```
    设置是否需要用户名密码验证
    
    参数:
    
    isAuth - 是否需要用户名密码验证
    
    返回:
    
    this
  - getUser
```
public String getUser()
```
    获取用户名
    
    返回:
    
    用户名
  - setUser
```
public MailAccount setUser(String user)
```
    设置用户名
    
    参数:
    
    user - 用户名
    
    返回:
    
    this
  - getPass
```
public String getPass()
```
    获取密码
    
    返回:
    
    密码
  - setPass
```
public MailAccount setPass(String pass)
```
    设置密码
    
    参数:
    
    pass - 密码
    
    返回:
    
    this
  - getFrom
```
public String getFrom()
```
    获取发送方，遵循RFC-822标准
    
    返回:
    
    发送方，遵循RFC-822标准
  - setFrom
```
public MailAccount setFrom(String from)
```
    设置发送方，遵循RFC-822标准
    发件人可以是以下形式：
```
 1. user@xxx.xx
 2.  name <user@xxx.xx>
 
```
    参数:
    
    from - 发送方，遵循RFC-822标准
    
    返回:
    
    this
  - isDebug
```
public boolean isDebug()
```
    是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
    
    返回:
    
    是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
    
    从以下版本开始:
    
    4.0.2
  - setDebug
```
public MailAccount setDebug(boolean debug)
```
    设置是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
    
    参数:
    
    debug - 是否打开调试模式，调试模式会显示与邮件服务器通信过程，默认不开启
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.0.2
  - getCharset
```
public Charset getCharset()
```
    获取字符集编码
    
    返回:
    
    编码，可能为null
  - setCharset
```
public MailAccount setCharset(Charset charset)
```
    设置字符集编码，此选项不会修改全局配置，若修改全局配置，请设置此项为null并设置：
```
        System.setProperty("mail.mime.charset", charset);
 
```
    参数:
    
    charset - 字符集编码，null 则表示使用全局设置的默认编码，全局编码为mail.mime.charset系统属性
    
    返回:
    
    this
  - isSplitlongparameters
```
public boolean isSplitlongparameters()
```
    对于超长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）
    
    返回:
    
    对于超长参数是否切分为多份
  - setSplitlongparameters
```
public void setSplitlongparameters(boolean splitlongparameters)
```
    设置对于超长参数是否切分为多份，默认为false（国内邮箱附件不支持切分的附件名）
    注意此项为全局设置，此项会调用
```
 System.setProperty("mail.mime.splitlongparameters", true)
 
```
    参数:
    
    splitlongparameters - 对于超长参数是否切分为多份
  - isEncodefilename
```
public boolean isEncodefilename()
```
    对于文件名是否使用charset编码，默认为 true
    
    返回:
    
    对于文件名是否使用charset编码，默认为 true
    
    从以下版本开始:
    
    5.7.16
  - setEncodefilename
```
public void setEncodefilename(boolean encodefilename)
```
    设置对于文件名是否使用charset编码，此选项不会修改全局配置
    如果此选项设置为false，则是否编码取决于两个系统属性：
    - mail.mime.encodefilename 是否编码附件文件名
    - mail.mime.charset 编码文件名的编码
    参数:
    
    encodefilename - 对于文件名是否使用charset编码
    
    从以下版本开始:
    
    5.7.16
  - isStarttlsEnable
```
public boolean isStarttlsEnable()
```
    是否使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL），而不是使用一个单独的加密通信端口。
    
    返回:
    
    是否使用 STARTTLS安全连接
  - setStarttlsEnable
```
public MailAccount setStarttlsEnable(boolean startttlsEnable)
```
    设置是否使用STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。它将纯文本连接升级为加密连接（TLS或SSL），而不是使用一个单独的加密通信端口。
    
    参数:
    
    startttlsEnable - 是否使用STARTTLS安全连接
    
    返回:
    
    this
  - isSslEnable
```
public Boolean isSslEnable()
```
    是否使用 SSL安全连接
    
    返回:
    
    是否使用 SSL安全连接
  - setSslEnable
```
public MailAccount setSslEnable(Boolean sslEnable)
```
    设置是否使用SSL安全连接
    
    参数:
    
    sslEnable - 是否使用SSL安全连接
    
    返回:
    
    this
  - getSslProtocols
```
public String getSslProtocols()
```
    获取SSL协议，多个协议用空格分隔
    
    返回:
    
    SSL协议，多个协议用空格分隔
    
    从以下版本开始:
    
    5.5.7
  - setSslProtocols
```
public void setSslProtocols(String sslProtocols)
```
    设置SSL协议，多个协议用空格分隔
    
    参数:
    
    sslProtocols - SSL协议，多个协议用空格分隔
    
    从以下版本开始:
    
    5.5.7
  - getSocketFactoryClass
```
public String getSocketFactoryClass()
```
    获取指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
    
    返回:
    
    指定实现javax.net.SocketFactory接口的类的名称, 这个类将被用于创建SMTP的套接字
  - setSocketFactoryClass
```
public MailAccount setSocketFactoryClass(String socketFactoryClass)
```
    设置指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
    
    参数:
    
    socketFactoryClass - 指定实现javax.net.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
    
    返回:
    
    this
  - isSocketFactoryFallback
```
public boolean isSocketFactoryFallback()
```
    如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
    
    返回:
    
    如果设置为true, 未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
  - setSocketFactoryFallback
```
public MailAccount setSocketFactoryFallback(boolean socketFactoryFallback)
```
    如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
    
    参数:
    
    socketFactoryFallback - 如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用java.net.Socket创建的套接字类, 默认值为true
    
    返回:
    
    this
  - getSocketFactoryPort
```
public int getSocketFactoryPort()
```
    获取指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
    
    返回:
    
    指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
  - setSocketFactoryPort
```
public MailAccount setSocketFactoryPort(int socketFactoryPort)
```
    指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
    
    参数:
    
    socketFactoryPort - 指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口
    
    返回:
    
    this
  - setTimeout
```
public MailAccount setTimeout(long timeout)
```
    设置SMTP超时时长，单位毫秒，缺省值不超时
    
    参数:
    
    timeout - SMTP超时时长，单位毫秒，缺省值不超时
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.1.17
  - setConnectionTimeout
```
public MailAccount setConnectionTimeout(long connectionTimeout)
```
    设置Socket连接超时值，单位毫秒，缺省值不超时
    
    参数:
    
    connectionTimeout - Socket连接超时值，单位毫秒，缺省值不超时
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.1.17
  - setWriteTimeout
```
public MailAccount setWriteTimeout(long writeTimeout)
```
    设置Socket写出超时值，单位毫秒，缺省值不超时
    
    参数:
    
    writeTimeout - Socket写出超时值，单位毫秒，缺省值不超时
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.8.3
  - getCustomProperty
```
public Map<String,Object> getCustomProperty()
```
    获取自定义属性列表
    
    返回:
    
    自定义参数列表
    
    从以下版本开始:
    
    5.6.4
  - setCustomProperty
```
public MailAccount setCustomProperty(String key,
                                     Object value)
```
    设置自定义属性，如mail.smtp.ssl.socketFactory
    
    参数:
    
    key - 属性名，空白被忽略
    
    value - 属性值， null被忽略
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.6.4
  - getSmtpProps
```
public Properties getSmtpProps()
```
    获得SMTP相关信息
    
    返回:
    
    Properties
  - defaultIfEmpty
```
public MailAccount defaultIfEmpty()
```
    如果某些值为null，使用默认值
    
    返回:
    
    this
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 MailAccount

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

MAIL_SETTING_PATHS

构造器详细资料

MailAccount

MailAccount

MailAccount

方法详细资料

getHost

setHost

getPort

setPort

isAuth

setAuth

getUser

setUser

getPass

setPass

getFrom

setFrom

isDebug

setDebug

getCharset

setCharset

isSplitlongparameters

setSplitlongparameters

isEncodefilename

setEncodefilename

isStarttlsEnable

setStarttlsEnable

isSslEnable

setSslEnable

getSslProtocols

setSslProtocols

getSocketFactoryClass

setSocketFactoryClass

isSocketFactoryFallback

setSocketFactoryFallback

getSocketFactoryPort

setSocketFactoryPort

setTimeout

setConnectionTimeout

setWriteTimeout

getCustomProperty

setCustomProperty

getSmtpProps

defaultIfEmpty

toString