Smdn.Net.Pop3

機能と特徴

ダウンロード

本ライブラリはMIT X11ライセンスでのリリースとなります。

最新版 (ソースコード)

Smdn.Net.Pop3.Client-1.00.tar.bz2 182.7kB [MD5] 746ee631a31c107e3c6f674953a5501f

開発版

http://svn.smdn.jp/anonsvn/libs/Smdn/trunk/よりチェックアウトできます

ビルド済みパッケージ・過去のバージョン

リリース一覧をご覧ください

使い方・サンプルコード

もっとも簡単なサンプルコードとして、System.Net.WebClientクラスとPOP URLを使ったメッセージのダウンロード方法を例示します。　Gmailアカウントにアクセスし、メッセージをダウンロードしてファイルに保存するサンプルです。

using System;
using System.Net;

using Smdn.Net.Pop3.WebClients;

class GpopRetrieveExample {
  public static void Main()
  {
    PopWebRequestCreator.RegisterPrefix();
    PopSessionManager.ServerCertificateValidationCallback += delegate {
      return true;
    };

    using (var client = new WebClient()) {
      client.Credentials = new NetworkCredential("username", "password");
      client.DownloadFile("pops://username@pop.gmail.com/;MSG=1", "message.eml");
    }
  }
}

Imports System
Imports System.Net
Imports System.Net.Security
Imports System.Security.Cryptography.X509Certificates

Imports Smdn.Net.Pop3.WebClients

Class GpopRetrieveExample
  Public Shared Sub Main()
    PopWebRequestCreator.RegisterPrefix()
    PopSessionManager.ServerCertificateValidationCallback = New RemoteCertificateValidationCallback(AddressOf ValidateRemoteCertificate)

    Using client As New WebClient()
      client.Credentials = New NetworkCredential("username", "password")
      client.DownloadFile("pops://username@pop.gmail.com/;MSG=1", "message.eml")
    End Using
  End Sub

  Private Shared Function ValidateRemoteCertificate(ByVal sender As Object, _
                                                    ByVal certificate As X509Certificate, _
                                                    ByVal chain As X509Chain, _
                                                    ByVal sslPolicyErrors As SslPolicyErrors) As Boolean
    Return True
  End Function
End Class

この例で使用している修飾子(;MSG=1)はPOP URLに対する独自の拡張です。　詳細・その他のサンプルコードはドキュメント・サンプルおよびデモ用アプリケーションMRAConnector, TundereBirdをご覧ください。

不具合・要望・質問等

不具合の報告、ライブラリに対する要望や提案、使い方の質問などは掲示板へどうぞ。

実装済み機能一覧

サポートするPOP標準仕様・拡張仕様の一覧です。

implemented

実装済みの機能
一部不完全な箇所があったり、仕様と異なる実装になっているかもしれません

partially implemented

部分的に実装済みの機能
コマンドの送受信のみサポートする、仕様の一部のみをサポートする、などの状態です

not tested

実装済みだが動作確認できていない機能

not implemented

実装されていない機能

通常のレスポンスと同様_*1

そのレスポンスを受信したということだけを検知します。　レスポンスに応じた処理を行うといったことはしません。

動作状況

以下のPOPサーバに対して概ね問題なく動作することを確認済みです。

• GMail (Gpop)
• Dovecot (1.2.11)

以下の環境で概ね問題なく動作することを確認済みです。　テストはしていますが、予期しないバグがあるかもしれません。

• .NET Framework 4
• .NET Framework 3.5 SP 1
• Mono 2.7 (r156985)
• Mono 2.6.4

制限事項・特記事項

• MIMEメッセージのデコード機能は含んでいません。　デコード機能が必要な場合は他のライブラリか、Smdn.Formats.Mimeを使ってください。
• SASLの実装は、本体とは別ライブラリのSmdn.Security.Authentication.Saslに含まれています。
• 実装にあたり、セキュリティ上の考慮はしていますが、十分な検証は行っていないため保証はできません。　SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。

参考文献