新建一個(gè) SMTPServer 對象，它會(huì )綁定到本機地址 localaddr。 它將把 remoteaddr 當作上游 SMTP 中繼器。 localaddr 和 remoteaddr 都應當是 (host, port) 元組。 該對象繼承自 asyncore.dispatcher，因而會(huì )在實(shí)例化時(shí)將自己插入到 asyncore 的事件循環(huán)。

data_size_limit 指定將在 DATA 命令中被接受的最大字節數。 值為 None 或 0 表示無(wú)限制。

map 是用于連接的套接字映射（初始為空的字典是適當的值）。 如果未指定則會(huì )使用 asyncore 全局套接字映射。

enable_SMTPUTF8 決定是否應當啟用 SMTPUTF8 擴展（如 RFC 6531 所定義的。 默認值為 False。 當設為 True 時(shí)，會(huì )接受 SMTPUTF8 作為 MAIL 命令的形參并在被提供時(shí)將其傳給 kwargs['mail_options'] 列表中的 process_message()。 decode_data 和 enable_SMTPUTF8 不可同時(shí)被設為 True。

decode_data 指明 SMTP 事務(wù)的數據部分是否應當使用 UTF-8 來(lái)解碼。 當 decode_data 為 False 時(shí)（默認值），服務(wù)器會(huì )聲明 8BITMIME 擴展 (RFC 6152)，接受來(lái)自 MAIL 命令的 BODY=8BITMIME 形參，并在該形參存在時(shí)將其傳給 kwargs['mail_options'] 列表中的 process_message() 方法。 decode_data 和 enable_SMTPUTF8 不可同時(shí)被設為 True。

process_message(peer, mailfrom, rcpttos, data, **kwargs)?

引發(fā) NotImplementedError 異常。 請在子類(lèi)中重載此方法以實(shí)際運用此消息。 在構造器中作為 remoteaddr 傳入的任何東西都可以 _remoteaddr 屬性的形式來(lái)訪(fǎng)問(wèn)。 peer 是遠程主機的地址，mailfrom 是封包的發(fā)送方，rcpttos 是封包的接收方而 data 是包含電子郵件內容的字符串（應該為 RFC 5321 格式）。

如果構造器關(guān)鍵字參數 decode_data 被設為 True，則 data 參數將為 Unicode 字符串。 如果被設為 False，則將為字節串對象。

kwargs 是包含附加信息的字典。 如果給出 decode_data=True 作為初始參數則該字典為空，否則它會(huì )包含以下的鍵:

mail_options:

由 MAIL 命令所接收的所有參數組成的列表 (其元素為大寫(xiě)形式的字符串；例如: ['BODY=8BITMIME', 'SMTPUTF8'])。

rcpt_options:

與 mail_options 類(lèi)似但是針對 RCPT 命令。 目前不支持任何 RCPT TO 選項，因此其值將總是為空列表。

process_message 的實(shí)現應當使用 **kwargs 簽名來(lái)接收任意關(guān)鍵字參數，因為未來(lái)的增強特性可能會(huì )向 kwargs 字典添加新鍵。

返回 None 以請求一個(gè)正常的 250 Ok 響應；在其他情況下則以 RFC 5321 格式返回所需的響應字符串。

channel_class?

重載這個(gè)子類(lèi)以使用自定義的 SMTPChannel 來(lái)管理 SMTP 客戶(hù)端。

創(chuàng )建一個(gè)新的調試服務(wù)器。 參數是針對每個(gè) SMTPServer。 消息將被丟棄，并在 stdout 上打印出來(lái)。

創(chuàng )建一個(gè)新的純代理服務(wù)器。 參數是針對每個(gè) SMTPServer。 一切都將被轉發(fā)到 remoteaddr。 請注意運行此對象有很大的機會(huì )令你成為一個(gè)開(kāi)放的中繼站，所以需要小心。

創(chuàng )建一個(gè)新的 SMTPChannel 對象，該對象會(huì )管理服務(wù)器和單個(gè) SMTP 客戶(hù)端之間的通信。

conn 和 addr 是針對下述的每個(gè)實(shí)例變量。

data_size_limit 指定將在 DATA 命令中被接受的最大字節數。 值為 None 或 0 表示無(wú)限制。

enable_SMTPUTF8 確定 SMTPUTF8 擴展 (如 RFC 6531 所定義的) 是否應當被啟用。 默認值為 False。 decode_data 和 enable_SMTPUTF8 不能被同時(shí)設為 True。

可以在 map 中指定一個(gè)字典以避免使用全局套接字映射。

decode_data 指明 SMTP 事務(wù)的數據部分是否應當使用 UTF-8 來(lái)解碼。 默認值為 False。 decode_data 和 enable_SMTPUTF8 不能被同時(shí)設為 True。

要使用自定義的 SMTPChannel 實(shí)現你必須重載你的 SMTPServer 的 SMTPServer.channel_class。

SMTPChannel 具有下列實(shí)例變量:

smtp_server?

存放生成此通道的 SMTPServer。

conn?

存放連接到客戶(hù)端的套接字對象。

addr?

存放客戶(hù)端的地址，socket.accept 所返回的第二個(gè)值。

received_lines?

存放從客戶(hù)端接收的行字符串列表 (使用 UTF-8 解碼)。 所有行的 "\r\n" 行結束符都會(huì )被轉寫(xiě)為 "\n"。

smtp_state?

存放通道的當前狀態(tài)。 其初始值將為 COMMAND 而在客戶(hù)端發(fā)送 "DATA" 行后將為 DATA。

seen_greeting?

存放包含客戶(hù)端在其 "HELO" 中發(fā)送的問(wèn)候信息的字符串。

mailfrom?

存放包含客戶(hù)端在 "MAIL FROM:" 行中標識的地址的字符串。

rcpttos?

存放包含客戶(hù)端在 "RCPT TO:" 行中標識的地址的字符串。

received_data?

存放客戶(hù)端在 DATA 狀態(tài)期間發(fā)送的所有數據的字符串，直至但不包括末尾的 "\r\n.\r\n"。

fqdn?

存放由 socket.getfqdn() 所返回的服務(wù)器完整限定域名。

peer?

存放由 conn.getpeername() 所返回的客戶(hù)端對等方名稱(chēng)，其中 conn 為 conn。

SMTPChannel 在接收到來(lái)自客戶(hù)端的命令行時(shí)會(huì )通過(guò)發(fā)起調用名為 smtp_<command> 的方法來(lái)進(jìn)行操作。 在基類(lèi) SMTPChannel 中具有用于處理下列命令（并對他們作出適當反應）的方法: