VFP 愛用者社區

iswith · 註冊時間: 2022-11-04 文章: 92 第 1 樓

接口对接疑问：

1.怎样获取MailKit 授权？
MailKit 是开源库，采用 MIT 许可证，无需额外授权即可免费使用所有功能（包括 SMTP、POP3、IMAP、IDLE 模块）。

若需专MailKitVFP移值版支持，可联系：
WX：Z68256904
Email：iswithzhz@outlook.com

MailKit分两类：1.STMP、POP3模块授权
2.STMP、POP3模块、IMAP、IDLE 模块授权

2.STMP发送邮件使用同步还是异步发送？
推荐异步发送：使用 SendEmailAsync方法避免阻塞主线程，提升应用响应速度。
同步特殊情况下使用。

3.VFP是单线程程序，如果使用异步发送，我的VFP当前线程如果执行一个耗时较长的应用：如SPT查询，会次会延迟SendEmailAsync发送吗？
不会

验证逻辑的步骤说明及示例

以下是分步验证 SendEmailAsync 在VFP主线程阻塞时仍能异步发送邮件的方法：

1. 核心逻辑验证目标
确认异步发送不依赖VFP主线程：即使VFP主线程被阻塞（如执行Sleep(20分钟)），邮件发送应能在后台独立完成。
验证事件通知的队列机制：发送完成后的回调信息会在主线程恢复后显示，而非被丢弃。

2. 示例代码实现
以下为完整的VFP示例代码，模拟异步发送邮件后阻塞主线程的场景：

* 1. 定义Win32API的Sleep函数
->DECLARE INTEGER Sleep IN Win32API INTEGER nMilliseconds
->执行 mailkit_how stmp add attachments async sending email.prg &&该DEMO是执行一个附件发送，你可以适当添加一个20MB左右的附件执行。
* 2. 立即阻塞VFP主线程20分钟
->Sleep(1000 * 60 * 20) && 20分钟

邮件在20分钟内到达收件箱若异步发送逻辑正确，附件上传和SMTP通信将在后台线程完成，无需等待主线程恢复。
检查方式：在VFP主线程休眠期间，登录邮箱查看是否收到邮件。事件回调在VFP主线程恢复后执行发送完成事件 OnStmpSendEmailAsync 会被VFP的消息队列暂存，待主线程恢复后触发。

4.STMP发送邮件使用异步发送，如何知道某次发送的邮件是否成功？
依赖 MessageId 追踪状态：
创建邮件时生成唯一 MessageId：发送成功完成后由“OnStmpSendEmailAsync”获取信息，
其返回参数：iMimeMessage结构类中存在相同的MessageId，即某次发送邮件成功。

参考逻辑：
->创建发件草稿记录"iMimeMessage.MessageId"
->通过“SendEmailAsync”异步发送，标识记录“发送”
->当“OnStmpSendEmailAsync”事件触发时通过iMimeMessage.MessageId重新检索草稿记录，并标识“已发送”或“发送失败”
->当用户退出时检测是否有“发送”草稿记录"iMimeMessage.MessageId"时未检测到“已发送”标识提醒客户是否退出，邮件将停止发送。

草稿状态管理：结合数据库或本地缓存记录发送状态。

可参考DEMO：
mailkit_how stmp send email async.prg

5.STMP发送邮件支持多个收件人吗？
支持：直接在 To、Cc、Bcc 中添加多个地址

6.STMP发送邮件支持多个附件吗？
支持，通过 AddAttachment 添加多个附件：m.lcContentId =.AddAttachment( "NetMailKit.dll" , @lcErrorMsg )

注意邮件容量大小每家账户其服务器处理是不一样的。这点很重要。
不同的邮件服务提供商（如Gmail、Outlook、企业自建服务器）对邮件大小可能有不同的限制。
通常，这个限制可能在10MB到50MB之间，但具体需要查看各家的文档或服务条款。
如果邮件超过服务器允许的大小，发送会被拒绝，或者收件方可能无法接收。

可参考DEMO：
mailkit_how stmp add attachments async sending email.prg

7.STMP发送邮件支持抄送，密送,回复吗？
支持

可参考DEMO：
mailkit_how stmp add cc.bcc.replyto in sending email.prg

8.POP3是增量收件还是全量收件
默认是“全量收件”，虽然可以通过 UIDL 可实现增量,但增量收件的可靠性依赖服务器 UID 稳定性，
某些邮件服务器不会保留多长时间，比如QQ只有30天，所以后期也不会对该模块有很大的升级，
逻辑上可以POP3全量收件后删除服务器邮件，但移动端可能无法查看了。

9.IDLE 可以支持多个账户自动收件吗？
支持，理论可以实例化无限账户的IDLE，每个账户独立实例化 ImapClient 并启动 IDLE 监听：
DEMO只有三个分别为：oMailKit_IMAP_LELD 、oMailKit_IMAP_LELDa、oMailKit_IMAP_LELDb

可参考DEMO：
mailkit_how iamp startidle.prg
mailkit_how iamp startidle(another account a).prg
mailkit_how iamp startidle(another account b).prg

资源管理：多账户需注意线程和网络连接开销。

10.IMAP支持将某个邮件下载为本地文件吗？
支持，方法“DownloadMessagesById()”
“DownloadMessageStreamsById()” 流式处理大邮件
可以根据ID将邮件下载为本地eml文件保存，由方法“MailKit.LoadLocalEml()”解析为“iMimeMessage”类结构读取信息。

可参考DEMO：
mailkit_how iamp sync and download messages by uniqueid to local eml files.prg
mailkit_how iamp sync and download messages by uniqueid to imimemessage.prg
mailkit_how to parse local eml files.prg

11.初次启用IDLE是不是“全量收件”，如何增量收件？
在初次使用IDLE模式是“全量收摘要件”！
增量收件：需要配合LastUid或LastCount 二者可以增量收件。

12.为何在“OnIDLEiamp”事件，经常看到“tnStatus:4099”？
通常表示网络断开或服务器主动终止 IDLE 连接。
无论是轮询还是IDLE 这在这里都统一为IDLE模式：而这种模式不会一直持续连接，空闲时会断开，Client端主动断开或Server断开
当有新邮件到达时，事件“OnIDLENewMailArrives”会重新连接上，周而复始。

13.IDLE支持多文件夹吗？
暂时不支持。

14.如何判别邮件接要是否是大型邮件？
可以通过 "IMessageSummary.Size"确定容量大小。

可参考DEMO：
mailkit_how iamp startidle.prg

15.支持改变邮件标识如：删除，已读，已回复吗？
可参考DEMO：
mailkit_how iamp change flags async(seen answered deleted).prg

16.如何设计表单收发件箱模块？
建议主流方式：
+----------------+---------------------+-----------------------+
| 账户列表 | 邮件摘要列表 | 邮件详情 |
| (多账户切换) | (显示发件人、主题、 | (显示完整内容、附件) |
| | 时间、摘要) | |
+----------------+---------------------+-----------------------+

20250317 en:

MailKit FAQ
1.How to obtain MailKit authorization?
MailKit is an open-source library under the MIT license. No additional authorization is required to use all features (including SMTP, POP3, IMAP, and IDLE modules).

For customized MailKit VFP port support, contact:
WeChat: Z68256904
Email: iswithzhz@outlook.com

MailKit offers two license types:

SMTP & POP3 Module Authorization
SMTP, POP3, IMAP, & IDLE Module Authorization

2.Should I use synchronous or asynchronous SMTP email sending?
Recommended: Use asynchronous sending (SendEmailAsync) to avoid blocking the main thread and improve
application responsiveness.
Use synchronous methods only in specific scenarios.

3.VFP is a single-threaded program. If the main thread is busy with a long task (e.g., SPT query),
will SendEmailAsync be delayed?
No.
Validation Steps:
Use Sleep(20 minutes) to block the VFP main thread.
Attach a 20MB file and execute mailkit_how_stmp_add_attachments_async_sending_email.prg.
Observe that the email is delivered before the main thread resumes.
Event callbacks (e.g., OnStmpSendEmailAsync) are queued and triggered after the main thread unblocks.

4.How to track email sending success with asynchronous SMTP?
Use a unique MessageId for each email.
Workflow:
Generate a MessageId when creating a draft.
Use SendEmailAsync and mark the draft as "sending."
In the OnStmpSendEmailAsync event, match the MessageId to update the draft status ("sent" or "failed").
Warn users if unsent drafts exist upon exit.

Reference Demo:
mailkit_how_stmp_send_email_async.prg

5.Does SMTP support multiple recipients?
Yes. Add multiple addresses to To, Cc, or Bcc.

6,Does SMTP support multiple attachments?
Yes. Use AddAttachment to add multiple files:

m.lcContentId = .AddAttachment("NetMailKit.dll", @lcErrorMsg)
Note: Email size limits vary by provider (e.g., 10MB–50MB). Exceeding limits may cause rejection.

Reference Demo:
mailkit_how_stmp_add_attachments_async_sending_email.prg

7.Does SMTP support CC, BCC, and Reply-To?
Yes.
Reference Demo:
mailkit_how_stmp_add_cc_bcc_replyto_in_sending_email.prg

8.Does POP3 fetch all emails or incrementally?

Default: Full download.
Incremental fetching via UIDL is possible but unreliable due to server UID retention policies (e.g., QQ deletes emails after 30 days).

Caution: Deleting server emails after download may affect mobile access.

9.Can IDLE support multiple accounts for auto-fetching?
Yes. Instantiate separate ImapClient instances for each account (e.g., oMailKit_IMAP_LELD, oMailKit_IMAP_LELDa).

Reference Demos:
mailkit_how_iamp_startidle.prg
mailkit_how_iamp_startidle(another account a).prg
mailkit_how_iamp_startidle(another account b).prg

Note: Manage thread and connection overhead for multi-account setups.

10.Can IMAP download emails as local files?
Yes. Use:
DownloadMessagesById() to save as .eml files.
DownloadMessageStreamsById() for large emails.
Parse local .eml files with MailKit.LoadLocalEml().

Reference Demos:
mailkit_how_iamp_sync_and_download_messages_by_uniqueid_to_local_eml_files.prg
mailkit_how_iamp_sync_and_download_messages_by_uniqueid_to_imimemessage.prg
mailkit_how_to_parse_local_eml_files.prg

11.Does IDLE fetch all emails on initial use? How to enable incremental fetching?
Initial IDLE: Full summary download.
Incremental: Use LastUid or LastCount.

12.Why does the OnIDLEiamp event frequently show tnStatus:4099?
Indicates network disconnection or server-initiated IDLE termination.
IDLE mode periodically reconnects; the OnIDLENewMailArrives event resumes listening.

13.Does IDLE support multiple folders?
Not currently supported.

14.How to check if an email is large?
Use IMessageSummary.Size.

Reference Demo:
mailkit_how_iamp_startidle.prg

15.Can email flags (e.g., deleted, read, replied) be modified?
Yes.
Reference Demo:
mailkit_how_iamp_change_flags_async(seen_answered_deleted).prg

16.How to design an email inbox/outbox interface?
Recommended Layout:

+---------------------+-------------------------+---------------------+
| Account List | Email Summary List | Email Details |
| (Multi-account | (Sender, Subject, Time, | (Full content, |
| switching) | Preview) | Attachments) |
+---------------------+-------------------------+---------------------+