オーディオプレイヤー[[Banshee:http://banshee-project.org/]]について。
*ソースからのビルド・インストール
version 1.5.1のソースからビルドしてインストールする手順。 ビルドに使用した環境はUbuntu 9.10 Desktop。
version 1.6 RC1をソースからビルドしてインストールする手順。 ビルドに使用した環境はUbuntu 9.10 Desktop。
-関連するページ
--[[programming/mono/install_trunk]]
configureの結果例。
#prompt{{
:
checking for gmcs... /usr/local/bin/gmcs
checking for mono... /usr/local/bin/mono
checking for gacutil... /usr/local/bin/gacutil
checking for pkg-config... /usr/bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for monodocer... /usr/local/bin/monodocer
checking for mdassembler... /usr/local/bin/mdassembler
checking for GNOME_SHARP... yes
checking for MONO_NUNIT... yes
checking for nunit-console2... /usr/local/bin/nunit-console2
configure: creating ./config.status
config.status: creating Makefile
config.status: creating taglib-sharp.pc
config.status: creating src/Makefile
config.status: creating src/AssemblyInfo.cs
config.status: creating src/policy.2.0.taglib-sharp.config
config.status: creating examples/Makefile
config.status: creating docs/Makefile
config.status: creating docs/Package.en.xml
config.status: creating tests/Makefile
configure: WARNING: unrecognized options: --enable-compile-warnings
TagLib# is ready to be compiled.
TagLib# is ready to be compiled.
Now type `make' to compile
}}
Number of items = 1
}}
**google-gdata
ソースのダウンロード。
#code(sh){{
wget http://google-gdata.googlecode.com/files/libgoogle-data-mono-1.4.0.2.tar.gz
tar -xvf libgoogle-data-mono-1.4.0.2.tar.gz
cd libgoogle-data-mono-1.4.0.2/
}}
configureは用意されていないので、インストール先を指定する場合は、MakefileのPREFIXを変更する必要がある(デフォルトは/usr/local)。
make、make installする。
#code(sh){{
make
sudo make install
}}
gacutilでインストールされたアセンブリを確認する。
#prompt{{
$ gacutil -l | grep Google
Google.GData.AccessControl, Version=1.4.0.2, Culture=neutral, PublicKeyToken=b4b8eb9a7afc8328
Google.GData.Apps, Version=1.4.0.2, Culture=neutral, PublicKeyToken=e6feebfe441b89cb
Google.GData.Blogger, Version=1.4.0.2, Culture=neutral, PublicKeyToken=6f8943d33947d761
Google.GData.Calendar, Version=1.4.0.2, Culture=neutral, PublicKeyToken=aa6748391206b888
Google.GData.Client, Version=1.4.0.2, Culture=neutral, PublicKeyToken=04a59ca9b0273830
Google.GData.CodeSearch, Version=1.4.0.2, Culture=neutral, PublicKeyToken=cac30bb7c678972d
Google.GData.Contacts, Version=1.4.0.2, Culture=neutral, PublicKeyToken=7e065189dd4b982f
Google.GData.Documents, Version=1.4.0.2, Culture=neutral, PublicKeyToken=099e9a853da5b089
Google.GData.Extensions, Version=1.4.0.2, Culture=neutral, PublicKeyToken=0b4c5df2ebf20876
Google.GData.GoogleBase, Version=1.4.0.2, Culture=neutral, PublicKeyToken=b361faa2ad5bd3db
Google.GData.Health, Version=1.4.0.2, Culture=neutral, PublicKeyToken=7dc2246c3cef9211
Google.GData.Photos, Version=1.4.0.2, Culture=neutral, PublicKeyToken=a25b50f2e8e3887a
Google.GData.Spreadsheets, Version=1.4.0.2, Culture=neutral, PublicKeyToken=3f77feb76ff0d9a1
Google.GData.YouTube, Version=1.4.0.2, Culture=neutral, PublicKeyToken=af04a32718ae8833
}}
**Banshee本体
-依存するパッケージ類
--intltool
configureの結果例。
#prompt{{
banshee-1-1.5.1
banshee-1-1.5.5
Build Environment
Install Prefix: /usr/local
Datadir: /usr/local/share
Libdir: /usr/local/lib
C Compiler: /bin/bash /srv/files/build/banshee/banshee-1-1.5.1/build/m4/shave/shave cc gcc
Mono C# Compiler: /bin/bash /srv/files/build/banshee/banshee-1-1.5.1/build/m4/shave/shave mcs /usr/local/bin/gmcs -define:RELEASE
C Compiler: /bin/bash /srv/files/build/banshee/banshee-1-1.5.5/build/m4/shave/shave cc gcc
Mono C# Compiler: /bin/bash /srv/files/build/banshee/banshee-1-1.5.5/build/m4/shave/shave mcs /usr/local/bin/gmcs -define:RELEASE
Mono Runtime: /usr/local/bin/mono
Video/Graphics:
Operating System/Desktop Environment:
GNOME Support: yes
Builtin Equalizer: yes
OSX Support: no
Moblin Support: no
Digital Audio Player Support:
Mass Storage: yes
Karma: no
Extra Features:
DAAP Support: yes
Podcast Support: no
Boo Scripting: no
Moblin Support: no
Builtin Equalizer: yes
DAAP: yes
GIO Backend: no
Library Watcher: yes
Podcasts: no
Wikipedia: no
Gapless playback: no
YouTube extension: yes
Build/Development:
Unit Tests: yes
Unit Tests: no
Custom a11y: no
Release Build: yes
Vendor Build ID: source-tarball
WARNING: An existing Banshee install is in /usr/local/lib/banshee-1
Remove the existing install before installing this build.
Installing over an existing install will cause conflicts!
}}
configureした結果に問題が無ければmake、make installする。
sudo make install
}}
なお、ビルド中エラーが発生したため、以下の箇所を修正した。
#code(diff,src/Extensions/Banshee.YouTube/Makefile){{
141c141
< GDATASHARP_LIBS = -r:/usr/local/lib/mono/GData-Sharp/Google.GData.Client.dll -r/usr/local/lib/mono/GData-Sharp/Google.GData.Extensions.dll -r:/usr/local/lib/mono/GData-Sharp/Google.GData.YouTube.dll
---
> GDATASHARP_LIBS = -r:/usr/local/lib/mono/GData-Sharp/Google.GData.Client.dll -r:/usr/local/lib/mono/GData-Sharp/Google.GData.Extensions.dll -r:/usr/local/lib/mono/GData-Sharp/Google.GData.YouTube.dll
}}
#code(diff,src/Extensions/Banshee.NotificationArea/Notifications/Notification.cs){{
23c23
< #if INTERNAL_NOTIFY_SHARP
---
> //#if INTERNAL_NOTIFY_SHARP
388c388
< #endif
---
> //#endif
}}
#code(diff,src/Extensions/Banshee.NotificationArea/Notifications/Notifications.cs){{
23c23
< #if INTERNAL_NOTIFY_SHARP
---
> //#if INTERNAL_NOTIFY_SHARP
98c98
< #endif
---
> //#endif
}}
${smdncms:title,FFmpeg用PV4デコーダ}
${smdncms:keywords,FFmpeg,PV4,デコーダ,デマクサ}
*概要
FFmpegにアースソフト製ビデオキャプチャボード[[PV3/PV4:http://earthsoft.jp/PV/index.html]]のキャプチャファイルをデマックス・デコードする機能を追加するパッチです。
*ダウンロード
本パッチはMIT X11ライセンスでのリリースとなります。
-FFmpeg(SVN-r22118)
--${smdncms:distfilelink,ffmpeg-r22118-earthsoftdv.patch,FFmpeg本体用}
--${smdncms:distfilelink,libavcodec-r22118-earthsoftdv.patch,libavcodecのみ}
--${smdncms:distfilelink,libavformat-r22118-earthsoftdv.patch,libavformatのみ}
*パッチ適用・ビルド手順
trunkからチェックアウトしたソースに適用する例。
#code(bash){{
svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
cd ffmpeg
patch -p0 < ffmpeg-eathsoftdv.patch
}}
パッチを有効にするには、configureで'--enable-demuxer=earthsoftdv'と'--enable-decoder=earthsoftdv'のオプションを指定します。
#code(sh){{
./configure --enable-demuxer=earthsoftdv --enable-decoder=earthsoftdv ...
}}
configureした結果、'Enabled decoders'と'Enabled demuxers'の一覧に'earthsoftdv'が表示されていれば有効になっています。
あとは、make、make installするだけです。
#code(bash){{
make
sudo make install
}}
問題なくビルドできた場合、'ffmpeg -codecs'でコーデックの一覧に'earthsoftdv'が表示されるようになります。
#prompt{{
$ ffmpeg -codecs
:
:
Codecs:
D..... = Decoding supported
.E.... = Encoding supported
..V... = Video codec
..A... = Audio codec
..S... = Subtitle codec
...S.. = Supports draw_horiz_band
....D. = Supports direct rendering method 1
.....T = Supports weird frame truncation
------
:
D V earthsoftdv Earthsoft PV3/PV4 DV video codec
:
:
}}
*使い方
通常のトランスコード方法と同じです。 dviファイルがない場合でもトランスコードできます。
#code(sh){{
ffmpeg -i 1280x720p.dv test.wmv
}}
*動作状況
以下のフォーマットのファイルでトランスコードできることを確認済です。
-映像フォーマット
--1920x1080i
--1440x1080i
--1280x1080i
--1280x720p
--720x480i
--720x480p
-音声フォーマット
--リニアPCM
以下の環境で動作することを確認済みです。
-Intel Core 2 Duo E6600 + Ubuntu 9.10 Desktop + FFmpeg(SVN-r22118)
*不具合・要望等
不具合・要望等は[[掲示板>misc/forum/tools]]へどうぞ。
-[[works/libs/Smdn.Formats.Mime]]
-[[works/libs/Smdn.Formats.Ini]]
以下の2つのサンプルアプリケーションを含んでいます。 機能はほぼ同等です。
:TundereBird|Smdn.Net.Imap4.WebClients名前空間およびSmdn.Net.Pop3.WebClients名前空間のクラスを使って実装したサンプル
:TungireBird|Smdn.Net.Imap4.Client名前空間およびSmdn.Net.Pop3.Client名前空間のクラスを使って実装したサンプル
*スクリーンショット
//&ref(tunderebird.png);
&ref(tunderebird-win.png);
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.27.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.27
----[[works/libs/Smdn.Net.Pop3]] 0.27
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.25
----[[works/libs/Smdn.Formats.Mime]] 0.17
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.26.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.26
----[[works/libs/Smdn.Formats.Ini]] 0.10
*使い方
+tunderebird.iniを開いてアカウント情報を記入してから起動してください。
+Visual Studioではログ出力により動作が遅くなる場合があります。 遅くなる場合は、tunderebird.exe.configを編集してログを出力しないようにしてください。
+tunderebird.ini/tungirebird.iniを開いてアカウント情報を記入してから起動してください。
+Visual Studioではログ出力により動作が遅くなる場合があります。 遅くなる場合は、tunderebird.exe.config/tungirebird.exe.configを編集してログを出力しないようにしてください。
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.27
-機能追加
--ImapClient/PopClientを使用したサンプルTungireBirdを追加
--サーバ証明書の確認ダイアログを表示するかどうか設定する項目を追加
**0.26
-機能追加
--メッセージのContent-TypeとUnique IDを表示するカラムを追加した
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.27.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.26.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.24.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.27
主に新しいクライアント実装ImapClientの追加、ImapMessageまわりのインターフェイスの整理、LIST-EXTENDEDとLIST-STATUS関連の実装の修正。
-機能追加
--新しいクライアント実装ImapClientをSmdn.Net.Imap4.Client名前空間に追加(ただしインターフェイスは未確定、実装は不完全)
--ImapMessageまわりの実装・インターフェイスを変更、動的属性・静的属性・本文を別々のクラスで取り扱うようにした
-修正・改善
--ImapMailboxFlagListの代わりにIImapMailboxFlagSetインターフェイスを公開するように変更
--ImapMessageFlagListの代わりにIImapMessageFlagSetインターフェイスを公開するように変更
--\NonExistentフラグがセットされている既知のメールボックスに対してRENAME/CREATEできなくなる不具合を修正
--\NonExistentフラグがセットされている既知のメールボックスに対してSELECT/STATUSしようとした場合にImapProtocolViolationExceptionをスローするようにした
--APPENDの引数をImapMessageからIImapAppendMessageに変更
--STOREのoutパラメータをImapMessageからImapMessageAttributeに変更
--body-fld-dspのbody-fld-paramがNILの場合にArgumentNullExceptionがスローされる不具合を修正
--WebClients名前空間
---ImapWebResponse.Messagesプロパティを廃止、代わりにImapWebResponse.MessageAttributesプロパティを追加
---ResponseStreamからのReadの際に生じる内部バッファのコピー回数を減らした
0.26と0.27のパフォーマンスの比較。
|~テストケース|>|~テスト環境|
|~|Ubuntu 9.10 + Mono(r152382)|Windows Vista + .NET Framework 3.5|
|4kBのメッセージを1500回ダウンロード&br;3回試行|[1]03.82sec -> 03.99sec&br;[2]03.70sec -> 03.91sec&br;[3]03.78src -> 03.76sec|[1]04.82sec -> 05.12sec&br;[2]04.69sec -> 04.91sec&br;[3]04.74src -> 05.46sec|
|17MBのメッセージを10回ダウンロード&br;3回試行|[1]33.50sec -> 31.37sec&br;[2]32.50sec -> 30.45sec&br;[3]32.62src -> 31.22sec|[1]42.58sec -> 39.39sec&br;[2]39.59sec -> 39.43sec&br;[3]40.06src -> 39.94sec|
**0.26
主にBODYSTRUCTURE関連の機能強化、下位ライブラリの実装改善、新しいクライアント実装を追加するための下準備。
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.26時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.27時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間の説明を参照してください。
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間およびSmdn.Net.Imap4.Client名前空間の説明を参照してください。
**メッセージのダウンロード
WebClientクラスを使って、localhostのINBOXメールボックスからUIDが1のメールをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs){{
localhostのINBOXメールボックスからUIDが1のメールをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs,WebClientクラスを使う場合){{
using System;
using System.Net;
}
}}
#code(cs,ImapClientクラスを使う場合){{
using System;
using System.IO;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Client;
class Sample {
public static void Main(string[] args)
{
using {
client.Connect("pass");
using {
var message = inbox.GetMessageByUid(1);
File.WriteAllBytes("sample.eml", message.ReadAllBytes());
}
}
}
}
}}
**メッセージのアップロード
WebClientクラスを使って、localhostのINBOXメールボックスにsample.emlをアップロードするサンプル。
#code(cs){{
localhostのINBOXメールボックスにsample.emlをアップロードするサンプル。
#code(cs, WebClientクラスを使う場合){{
using System;
using System.IO;
using System.Net;
}
}}
#code(cs,ImapClientクラスを使う場合){{
using System;
using System.IO;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Client;
class Sample {
public static void Main(string[] args)
{
using {
client.Connect("pass");
using {
using {
inbox.AppendMessage(messageStream);
}
}
}
}
}
}}
**メッセージの検索
WebRequestクラスを使って、Gmailアカウントのメールボックスからタイトルに[Mono-dev]を含むメールの一覧を取得する例。
#code(cs){{
Gmailアカウントのメールボックスからタイトルに[Mono-dev]を含むメールの一覧を取得する例。
#code(cs,WebRequestクラスを使う場合){{
using System;
using System.Net;
request.Credentials = new NetworkCredential("user", "pass");
using {
foreach {
foreach {
Console.WriteLine(message.Url);
}
}
}
}}
#code(cs,ImapClientクラスを使う場合){{
using System;
using System.IO;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Client;
using Smdn.Net.Imap4.Protocol.Client;
class Sample {
public static void Main(string[] args)
{
ImapConnection.ServerCertificateValidationCallback += delegate { return true; };
using {
client.Connect("pass");
using {
foreach {
Console.WriteLine("UID {0}: {1}", message.Uid, message.Envelope.Subject);
}
}
}
}
}
}}
*ライブラリの設計と実装の概要
クライアントの実装は2種類あります。 一つはSmdn.Net.Imap4.Client.Session名前空間のImapSessionクラス、もう一つはSmdn.Net.Imap4.WebClients名前空間のImapWebRequest/ImapWebResponseクラスです。 Smdn.Net.Imap4.WebClients名前空間のクライアントは、System.Net.WebRequest/System.Net.WebResponseを継承したもので、内部でImapSessionクラスを使用しています。
クライアントの実装は次の3種類があります。
+Smdn.Net.Imap4.Client.Session名前空間のImapSessionクラス
+Smdn.Net.Imap4.Client名前空間のImapClientクラス
+Smdn.Net.Imap4.WebClients名前空間のImapWebRequest/ImapWebResponseクラス
二つのクライアントのモデルと概要は次の通りです。
三つのクライアントのモデルと概要は次の通りです。
:ImapSessionクラス|IMAPのコマンドとほぼ1対1で対応するメソッドを持つクラスです。 IMAPの操作は抽象化していません。 仕様と1対1で対応するような実装にしてあります。
切断する/されるまで選択済みメールボックス・メールボックス毎のフラグ・サーバの能力・名前空間等のセッションの状態を保持します。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、送信されるIMAPコマンドをあまり意識せずに扱えます。 メッセージのダウンロード・アップロードにWebClientクラスのメソッドを使うこともできます。
切断する/されるまで選択済みメールボックス・メールボックス毎のフラグ・サーバの能力・名前空間等のセッションの状態を保持します。 このクラスは他の2種類のクライアント実装で使用しています。
:ImapClientクラス|IMAPの操作を抽象化したクラスです。 メールボックス/メッセージをSystem.IO.DirectoryInfo/FileInfoクラスに似たインターフェイスで操作できるようにしてあります。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、送信されるIMAPコマンドをあまり意識せずに扱えます。 System.Net.WebRequest/System.Net.WebResponseを継承しているので、メッセージのダウンロード・アップロードにWebClientクラスのメソッドを使うこともできます。
FtpWebRequest等と同様、WebRequest.Methodプロパティで送信するコマンドを制御できます。
以下でクライアント実装に共通する部分について解説します。 個々のクライアント実装の詳細については各項を参照してください。
リクエストURLがメールボックスを表す場合(imap://imap.example.net/mailboxの形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.MessageAttributesプロパティに設定されます。|
|ImapWebRequestMethods.Append, "APPEND"|APPENDコマンドを送信してメールボックスにメッセージをアップロードします。|アップロードするメッセージはWebRequest.GetRequestStreamメソッドが返すStreamに書き込みます。 現在の実装では、リクエスト開始時にContentLengthの値が指定されているか、GetRequestStreamメソッドが返すStreamを閉じるまでアップロードは保留されます。 メッセージはMIME形式であるべきですが、ライブラリ側ではアップロードする内容をチェックしません。|サーバがアップロードしたメッセージのUIDを返す場合は、アップロードしたメッセージのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|EXPUNGEコマンドを送信してメールボックスから\Deletedフラグの付いたメッセージを削除します。|-|-|
|ImapWebRequestMethods.Create, "CREATE"|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|ImapWebRequest.Subscriptionプロパティがtrueの場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|作成したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、作成したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
リクエストURLがメールボックスに対する検索クエリを表す場合(imap://imap.example.net/mailbox?...の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.MessageAttributesプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して検索クエリに該当するメッセージに\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、検索クエリに該当したメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信して検索クエリに該当するメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;サーバがSORTコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したソート済みメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;サーバがTHREADコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。 また、個々のメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;サーバがSORTコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したソート済みメッセージの一覧は、ImapWebResponse.MessageAttributesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;サーバがTHREADコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。 また、個々のメッセージの一覧は、ImapWebResponse.MessageAttributesプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックス内の特定のメッセージに対するリクエスト
}
}}
*Smdn.Net.Imap4.Client名前空間
Smdn.Net.Imap4.Client名前空間のクラスの使い方。 このドキュメントは作成中です。 前述のサンプルおよび[[works/tools/junk/TundereBird]]の実装を参照してください。
*Smdn.Net.Imap4.Client.Session名前空間
Smdn.Net.Imap4.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Imap4.WebClientsの各クラスの実装を参照してください。
その他、サポートしている機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。
**クライアント実装
クライアント実装として以下の2つのクラスを用意しています。
クライアント実装として以下の3つのクラスを用意しています。
:ImapSessionクラス|IMAPコマンドと1対1に対応するメソッドを持つクライアント
:ImapClientクラス|メールボックス/メッセージをSystem.IO.DirectoryInfo/FileInfoクラスに似たインターフェイスで操作できるようにIMAP操作を抽象化したクライアント
:ImapWebRequest/ImapWebResponseクラス|WebRequest/WebResponseクラスから派生し、IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)での操作に対応したクライアント
**その他の主な特徴
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.26.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.27.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
-既知の不具合
--IDLEして5分程度経過すると、Mono.Security.Protocol.Tls.SslStreamBase.EndReadでMono.Security.Protocol.Tls.TlsExceptionがスローされる
--GMailにアップロードしたメッセージのBODYSTRUCTUREが正しくパースできない
*動作状況
以下のIMAPサーバに対して概ね問題なく動作することを確認済みです。
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.27.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.26.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.24.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.27
主に新しいクライアント実装PopClientの追加とそれに付随する変更。
-機能追加
--新しいクライアント実装PopClientをSmdn.Net.Pop3.Client名前空間に追加(ただしインターフェイスは未確定、実装は不完全)
--PopUriBuilderを追加
**0.26
主にライブラリ本体と下位ライブラリの実装改善、新しいクライアント実装を追加するための下準備。
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.25時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.27時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Pop3.WebClients名前空間の説明を参照してください。
個々のサンプルの詳細については、後述するSmdn.Net.Pop3.WebClients名前空間およびSmdn.Net.Pop3.Client名前空間の説明を参照してください。
**メッセージのダウンロード
WebClientクラスを使って、localhostのメールボックスから1番目のメッセージをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs){{
localhostのメールボックスから1番目のメッセージをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs,WebClientクラスを使う場合){{
using System;
using System.Net;
}
}}
#code(cs,PopClientクラスを使う場合){{
using System;
using System.IO;
using System.Net;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
class Sample {
public static void Main(string[] args)
{
using {
client.Connect("pass");
var message = client.GetMessage(1);
File.WriteAllBytes("sample.eml", message.ReadAllBytes());
}
}
}
}}
**メッセージ一覧の取得
WebRequestクラスを使って、Gmailアカウントのメールボックスからメールの一覧を取得し、もっとも最近のメールをダウンロード・表示する例。
#code(cs){{
Gmailアカウントのメールボックスからメールの一覧を取得し、もっとも最近のメールをダウンロード・表示する例。
#code(cs,WebRequestクラスを使う場合){{
using System;
using System.IO;
using System.Text;
}
}}
#code(cs,PopClientクラスを使う場合){{
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
using Smdn.Net.Pop3.Protocol.Client;
class Sample {
public static void Main(string[] args)
{
PopConnection.ServerCertificateValidationCallback += delegate {
return true;
};
using {
client.Connect("pass");
var messages = new List<PopMessageInfo>(client.GetMessages());
var recentMessage = messages[messages.Count - 1];
using {
Console.WriteLine(reader.ReadToEnd());
}
}
}
}
}}
*ライブラリの設計と実装の概要
このドキュメントは作成中です。
記述内容については[[ネットワーク設定スキーマ:http://msdn.microsoft.com/ja-jp/library/dacty7ed%28VS.80%29.aspx]]および[[構成セクション スキーマ:http://msdn.microsoft.com/ja-jp/library/0hyxd0xc%28VS.80%29.aspx]]も合わせて参照してください。
*Smdn.Net.Pop3.Client名前空間
Smdn.Net.Pop3.Client名前空間のクラスの使い方。 このドキュメントは作成中です。 前述のサンプルおよび[[works/tools/junk/TundereBird]]の実装を参照してください。
*Smdn.Net.Pop3.Client.Session名前空間
Smdn.Net.Pop3.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Pop3.WebClientsの各クラスの実装を参照してください。
**クライアント実装
クライアント実装として以下の2つのクラスを用意しています。
:PopSessionクラス|POPコマンドと1対1に対応するメソッドを持つクライアント
:PopClientクラス|メッセージをSystem.IO.FileInfoクラスに似たインターフェイスで操作できるようにPOP操作を抽象化したクライアント
:PopWebRequest/PopWebResponseクラス|WebRequest/WebResponseクラスから派生し、POP URL(&urn2url(urn:ietf:rfc:2384,short);)での操作に対応したクライアント
**その他の主な特徴
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.26.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.27.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
-[[works/libs/Smdn.Formats.Ini]]
*スクリーンショット
&ref(tunderebird.png); &ref(tunderebird-win.png);
//&ref(tunderebird.png);
&ref(tunderebird-win.png);
*ダウンロード
#googleadunit
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.26.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.26
----[[works/libs/Smdn.Net.Pop3]] 0.26
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.25
----[[works/libs/Smdn.Formats.Mime]] 0.17
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.25.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.25
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.26
-機能追加
--メッセージのContent-TypeとUnique IDを表示するカラムを追加した
--メッセージの取得にかかった時間を出力するようにした
--IMAP
---メッセージのセクションごとに本文の取得と保存ができるようにした
-修正・改善
--Content-Typeの比較処理をcase insensitiveにした
**0.25
-修正・改善
--IMAP
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.26.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.24.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.23.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.26
主にBODYSTRUCTURE関連の機能強化、下位ライブラリの実装改善、新しいクライアント実装を追加するための下準備。
-機能追加
--BODYSTRUCTUREまわりの実装とインターフェイスを整理した
--BODYSTRUCTUREを含むレスポンスからすべてのextension dataを取得できるようにした
--すべてのIImapBodyStructureからSECTIONを取得できるようにした
--FETCHでUIDも取得した場合に限り、すべてのIImapBodyStructureからSECTIONを含むURLを取得できるようにした
--ImapMailboxに上位のメールボックス名、階層末尾の名前を取得するプロパティを追加
--WebClients名前空間
---ImapWebRequest.FetchDataItemを追加
-修正・改善
--ストリームのアップグレードに失敗した場合、ImapUpgradeConnectionExceptionをスローするようにした
--SSL接続/STARTTLSに失敗した場合、ImapSecureConnectionExceptionをスローするようにした
--IDコマンドで送信するIDをDictionary<string, string>ではなくIDictionary<string, string>で引き受けるように変更
--ログ
---POP/IMAPのプロトコルログを分けて収集できるように修正
---プロトコルログのTraceSourceのnameを'IMAP'に変更
--パフォーマンス関連
---下位ライブラリの実装の最適化、バッファアロケーションと動作速度を改善
--WebClients名前空間
---すべて小文字でなければimapsスキームとみなされない不具合を修正
---LOGIN-REFERRAL, MAILBOX-REFERRALのサポートを削除
0.25と0.26のパフォーマンスの比較。
|~テストケース|>|~テスト環境|
|~|Ubuntu 9.10 + Mono(r151732)|Windows Vista + .NET Framework 3.5|
|4kBのメッセージを1500回ダウンロード&br;3回試行|[1]04.50sec -> 04.47sec&br;[2]04.38sec -> 04.38sec&br;[3]04.58src -> 03.90sec|[1]05.03sec -> 04.89sec&br;[2]04.77sec -> 04.62sec&br;[3]04.98src -> 04.70sec|
|17MBのメッセージを10回ダウンロード&br;3回試行|[1]34.95sec -> 33.68sec&br;[2]33.87sec -> 34.79sec&br;[3]33.78src -> 34.62sec|[1]41.65sec -> 38.39sec&br;[2]39.92sec -> 39.02sec&br;[3]38.61src -> 38.14sec|
**0.25
主に未サポートだった拡張の実装、アプリケーション構成ファイルでの設定のサポート、パフォーマンスと.NET Frameworkでの動作の改善。
|4kBのメッセージを1500回ダウンロード&br;2回試行|[1]06.05sec -> 03.80sec&br;[2]06.40sec -> 04.46sec|[1]03.94sec -> 03.68sec&br;[2]04.04sec -> 03.57sec|
|17MBのメッセージを10回ダウンロード&br;2回試行|[1]45.00sec -> 31.95sec&br;[2]46.43sec -> 32.78sec|[1]37.09sec -> 32.54sec&br;[2]36.99sec -> 32.63sec|
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.25時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.26時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間の説明を参照してください。
リクエストURLがメールボックスを表す場合(imap://imap.example.net/mailboxの形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Append, "APPEND"|APPENDコマンドを送信してメールボックスにメッセージをアップロードします。|アップロードするメッセージはWebRequest.GetRequestStreamメソッドが返すStreamに書き込みます。 現在の実装では、リクエスト開始時にContentLengthの値が指定されているか、GetRequestStreamメソッドが返すStreamを閉じるまでアップロードは保留されます。 メッセージはMIME形式であるべきですが、ライブラリ側ではアップロードする内容をチェックしません。|サーバがアップロードしたメッセージのUIDを返す場合は、アップロードしたメッセージのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|EXPUNGEコマンドを送信してメールボックスから\Deletedフラグの付いたメッセージを削除します。|-|-|
|ImapWebRequestMethods.Create, "CREATE"|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|ImapWebRequest.Subscriptionプロパティがtrueの場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|作成したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、作成したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
リクエストURLがメールボックスに対する検索クエリを表す場合(imap://imap.example.net/mailbox?...の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみです。 メッセージ本文は取得しません。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して検索クエリに該当するメッセージに\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、検索クエリに該当したメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信して検索クエリに該当するメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;サーバがSORTコマンドをサポートするかどうかはチェックせずにリクエストを実行します。|取得したソート済みメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;サーバがTHREADコマンドをサポートするかどうかはチェックせずにリクエストを実行します。|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。 また、個々のメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;サーバがSORTコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したソート済みメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;サーバがTHREADコマンドをサポートするかどうかはチェックせずにリクエストを実行します。&br;SEARCH同様、取得するのはメッセージの属性のみです。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。 また、個々のメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックス内の特定のメッセージに対するリクエスト
リクエストURLが特定のメッセージを表す場合(imap://imap.example.net/mailbox/;UID=1の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|取得の際にBODY[]とBODY.PEEK[]のどちらを使用するかはImapWebRequest.FetchPeekプロパティで指定します。&br;該当するUIDのメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得するメッセージのサイズはWebResponse.ContentLength、Content-TypeはWebResponse.ContentTypeプロパティに設定されます。|
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|取得の際にBODY[]とBODY.PEEK[]のどちらを使用するかはImapWebRequest.FetchPeekプロパティで指定します。&br;URLにSECTION/PARTIALのいずれも指定していない場合は、メッセージの本文だけでなく属性も取得します。 取得するメッセージ属性は、ImapWebRequest.FetchDataItemプロパティで指定します。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 URLでSECTION/PARTIALを指定している場合は、メッセージ本文のうち、該当する部分のみ取得されます。&br;URLにSECTION/PARTIALのいずれも指定していない場合のみ、取得するメッセージのサイズがWebResponse.ContentLength、Content-TypeがWebResponse.ContentTypeプロパティに設定されます。&br;UID/SECTION/PARTIALに該当するメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信してメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、URLで指定されたメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信してメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。 現在の実装では、APPENDコマンドでTRYCREATEが返された場合でもメールボックスは作成せず、常にエラーとなります。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先メールボックス名、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前(WebRequest.RequestUri)と同一サーバ、同一ユーザである必要があります。 それ以外の場合、ArgumentExceptionをスローします。|
|Subscription|true|CREATE, DELETE, RENAME, COPY|メールボックスを作成・削除する際に、対象のメールボックスに対して自動的にSUBSCRIBE/UNSUBSCRIBEコマンドを送信し、購読・購読解除するかどうかを指定します。|
|FetchDataItem|ImapFetchDataItemMacro.All|SEARCH, SORT, THREAD, FETCH|メッセージの属性を取得する際に、取得する属性を表すマクロを指定します。 マクロと取得する属性の対応は後述の対応表を参照してください。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|StatusDataItem|null|STATUS|STATUSコマンドで取得するメールボックスの情報を指定します。|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|FetchBlockSize|10240|FETCH|FETCHコマンドでメッセージ本文を取得する際に、1回のFETCHコマンドで取得するブロックのサイズをバイト単位で指定します。|
|FetchPeek|true|FETCH|FETCHコマンドでメッセージ本文を取得する際に、BODY.PEEK[]とBODY[]のどちらを使用するかを指定します。 trueの場合はBODY.PEEK[]が使用され、取得したメッセージは未読のままになります。|
ImapWebRequest.FetchDataItemプロパティに指定できるマクロの値と、取得する属性の種類は次のとおりです。
|*ImapWebRequest.FetchDataItemプロパティに指定できる値
|値|取得される属性|
|ImapFetchDataItemMacro.All|ALLマクロで表される属性を取得します。 取得するのはFLAGS、INTERNALDATE、RFC822.SIZE、ENVELOPEです。|
|ImapFetchDataItemMacro.Fast|FASTマクロで表される属性を取得します。 取得するのはFLAGS、INTERNALDATE、RFC822.SIZEです。|
|ImapFetchDataItemMacro.Full|FULLマクロで表される属性を取得します。 取得するのはFLAGS、INTERNALDATE、RFC822.SIZE、ENVELOPE、BODYです。|
|ImapFetchDataItemMacro.Extensible|Fullと同じですが、BODYのかわりに拡張されたデータを含むBODYSTRUCTUREを取得します。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
|*WebRequestクラスから継承されるプロパティ
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|解説|h
|UseDeflateIfAvailable|false|全て|サーバがサポートしている場合、DEFLATE圧縮アルゴリズムを使用した接続に変更します。 (この機能は現在動作しません。 trueにした場合、NotImplementedExceptionがスローされます)|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
***ImapWebRequestクラスのデフォルト値の変更
ImapWebRequestDefaultsクラスのプロパティの値を変更することにより、ImapWebRequestクラスのプロパティに設定されるデフォルト値を一括して指定することができます。 全てのリクエストでデフォルトの値を変更したい場合は、ImapWebRequestDefaultsクラスのプロパティの値を変更してください。
<add key="readWriteTimeout" value="-1"/>
<add key="fetchBlockSize" value="102400"/>
<add key="fetchPeek" value="true"/>
<add key="fetchDataItem" value="all"/>
<add key="subscription" value="true"/>
<add key="allowCreateMailbox" value="true"/>
<add key="useTlsIfAvailable" value="true"/>
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.25.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.26.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
|CLOSE|&urn2url(urn:ietf:rfc:3501,#6.4.2,short);|&color(green){implemented};||
|EXPUNGE|&urn2url(urn:ietf:rfc:3501,#6.4.3,short);|&color(green){implemented};||
|SEARCH, UID SEARCH|&urn2url(urn:ietf:rfc:3501,#6.4.4,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.6,short);|&color(green){implemented};|非ASCII文字での検索に対応&sub{*2};|
|FETCH, UID FETCH|&urn2url(urn:ietf:rfc:3501,#6.4.5,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.4,short);|&color(green){implemented};|body-extension fieldsはレスポンスに含まれていても無視します。|
|FETCH, UID FETCH|&urn2url(urn:ietf:rfc:3501,#6.4.5,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.4,short);|&color(green){implemented};||
|STORE, UID STORE|&urn2url(urn:ietf:rfc:3501,#6.4.6,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.5,short);|&color(green){implemented};||
|COPY, UID COPY|&urn2url(urn:ietf:rfc:3501,#6.4.7,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short);|&color(green){implemented};|Modified UTF-7対応&sub{*1};|
|~Extensions|-|-|-|
--base64, quoted-printable, 7bit, 8bit, binary
-MIME Encoding
--B-Encoding(base64), Q-Encoding(quoted-printable)
-メッセージのパース・デコード
-メッセージの組み立て・エンコード(不完全)
*ダウンロード
#googleadunit
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.1x
--${smdncms:distfilelink,Smdn.Formats.Mime-0.17.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.16.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.15.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.14.tar.bz2}
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*変更履歴
**0.17
-機能追加
--Content-Transfer-EncodingおよびCharsetに基づいてデコード・エンコードするStreamを取得するためのユーティリティメソッドを追加
**0.16
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
*動作状況
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
version 0.13の時点では、手元にある計9,189通のメール(スパム、メーリングリスト・メールマガジンから、携帯から、添付ファイル付きなどを含む)を解析した結果、ほぼ正常に解析できています。 ただし解析した結果が「読める」かどうかまでは検証していません。 またMono 1.9ではJISからのデコードが出来ない場合があるようです。
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.26.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.24.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.23.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.26
主にライブラリ本体と下位ライブラリの実装改善、新しいクライアント実装を追加するための下準備。
-修正・改善
--SSL接続/STLSに失敗した場合、PopUpgradeConnectionExceptionをスローするようにした
--ログ
---POP/IMAPのプロトコルログを分けて収集できるように修正
---プロトコルログのTraceSourceのnameを'POP'に変更
--パフォーマンス関連
---下位ライブラリの実装の最適化、バッファアロケーションと動作速度を改善
---RETR/TOPの実装を修正、取得したレスポンスは保持せずに破棄するようにし、またオーバーヘッドが少なくなるようにした
--WebClients名前空間
---すべて小文字でなければpopsスキームとみなされない不具合を修正
0.25と0.26のパフォーマンスの比較。
|~テストケース|>|~テスト環境|
|~|Ubuntu 9.10 + Mono(r151732)|Windows Vista + .NET Framework 3.5|
|4kBのメッセージを1500回ダウンロード&br;3回試行|[1]04.39sec -> 02.97sec&br;[2]04.62sec -> 02.80sec&br;[3]04.55src -> 02.65sec|[1]04.31sec -> 03.93sec&br;[2]03.89sec -> 04.06sec&br;[3]04.19src -> 04.07sec|
|17MBのメッセージを10回ダウンロード&br;3回試行|[1]66.18sec -> 30.13sec&br;[2]60.20sec -> 30.09sec&br;[3]60.12src -> 29.24sec|[1]20.93sec -> 18.19sec&br;[2]21.23sec -> 18.29sec&br;[3]21.38src -> 18.30sec|
**0.25
主にアプリケーション構成ファイルでの設定のサポート、パフォーマンスと.NET Frameworkでの動作の改善。
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.25.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.26.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.25.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.25
----[[works/libs/Smdn.Net.Pop3]] 0.25
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.25
----[[works/libs/Smdn.Formats.Mime]] 0.16
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.24.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.24
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.25
-修正・改善
--IMAP
---送信するIDにsupport-urlを含めるようにした
--POP
---設定ファイルのCertFilesに記載されているサーバ証明書を読み込んでいなかったのを修正
**0.24
-修正・改善
--パスワードの入力ダイアログを追加、設定ファイルにパスワードを記入しなくても接続できるようにした。
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.24.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.23.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Imap4.Client-0.22.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.25
主に未サポートだった拡張の実装、アプリケーション構成ファイルでの設定のサポート、パフォーマンスと.NET Frameworkでの動作の改善。
-機能追加
--&urn2url(urn:ietf:rfc:2087){QUOTA};に対応
--&urn2url(urn:ietf:rfc:3516){BINARY}; FETCH/APPENDに対応(実機での動作は未確認)
--&urn2url(urn:ietf:rfc:5464){METADATA};に対応(実機での動作は未確認)
--&urn2url(urn:ietf:rfc:5466){FILTERS};に部分的に対応(実機での動作は未確認)
--WebClients名前空間
---アプリケーション構成ファイルのconfiguration/system.net/webRequestModules要素でimap/imapsスキームを登録できるようにした
---ImapWebRequestDefaultsクラスを追加、コード内もしくはアプリケーション構成ファイルでImapWebRequestの各プロパティのデフォルト値を設定できるようにした
---ImapWebRequest.FetchPeekプロパティを追加
-修正・改善
--ImapResponseCodeをSmdn.Net.Imap4.Protocol.ClientからSmdn.Net.Imap4.Protocolに移動
--SslStream.AuthenticateAsClientでAuthenticationExceptionが発生した場合、ストリームを閉じるようにした
--ライブラリ内のメッセージとサーバからのレスポンスを区別できるように内部処理と書式を変更した
--Mono 2.6.x, Mono 2.4.xで文字列からDateTimeOffsetへの変換でFormatExceptionがスローされないようにした
--パフォーマンス関連
---レスポンスパーサの実装を最適化、冗長な処理を削除
---文字列比較処理を最適化
---ロック処理にSemaphoreを使用していた箇所をMonitorに置き換えた
--.NET Framework関連
---NetworkCredentialの各プロパティがnullを返すことを期待していた実装を修正、nullではなくstring.Emptyの場合に認証をキャンセルするようにした
---SocketError.TimedOutのSocketExceptionが発生した場合、ImapConnectionExceptionではなくTimeoutExceptionをスローするようにした
--WebClients名前空間
---SslStream作成用のコールバック、証明書関連のコールバックのプロパティ名を変更、また値をImapConnectionと共有しないようにした
---ImapSessionManagerからIWebRequestCreateの実装を分離、WebRequest.RegisterPrefixはImapWebRequestCreator.RegisterPrefixで行うようにした
---RequestStreamへの書き込み待ち合わせにAutoResetEventを使用していた箇所をMonitorに置き換えた
---ImapWebRequestDefaults.Subscriptionがtrueの場合はLSUB、falseの場合はLISTをImapWebRequest.Methodプロパティのデフォルトとするようにした
0.24と0.25のパフォーマンスの比較。
|~テストケース|>|~テスト環境|
|~|Ubuntu 9.10 + Mono(r148762)|Windows Vista + .NET Framework 3.5|
|4kBのメッセージを1500回ダウンロード&br;2回試行|[1]06.05sec -> 03.80sec&br;[2]06.40sec -> 04.46sec|[1]03.94sec -> 03.68sec&br;[2]04.04sec -> 03.57sec|
|17MBのメッセージを10回ダウンロード&br;2回試行|[1]45.00sec -> 31.95sec&br;[2]46.43sec -> 32.78sec|[1]37.09sec -> 32.54sec&br;[2]36.99sec -> 32.63sec|
**0.24
主にIMAP URL関連の修正と、WebClients名前空間のクラスでの非ASCII文字を含む検索とpartial fetchのサポート。
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.24時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.25時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間の説明を参照してください。
class Sample {
public static void Main(string[] args)
{
ImapSessionManager.RegisterWebRequestPrefix();
ImapWebRequestCreator.RegisterPrefix();
using {
client.Credentials = new NetworkCredential("user", "pass");
class Sample {
public static void Main(string[] args)
{
ImapSessionManager.RegisterWebRequestPrefix();
ImapWebRequestCreator.RegisterPrefix();
using {
client.Credentials = new NetworkCredential("user", "pass");
class Sample {
public static void Main(string[] args)
{
ImapSessionManager.RegisterWebRequestPrefix();
ImapSessionManager.CertificateValidationCallback = delegate { return true; };
ImapWebRequestCreator.RegisterPrefix();
ImapSessionManager.ServerCertificateValidationCallback = delegate { return true; };
var request = WebRequest.Create("imaps://user@imap.gmail.com/INBOX?SUBJECT \"[Mono-dev]\"");
|*証明書に関する型と該当するメンバ(いずれもクラス・プロパティ)
|~証明書に関する型|>|~該当するメンバ|h
|~|~Smdn.Net.Imap4.Protocol.Client名前空間|~Smdn.Net.Imap4.WebClients名前空間|
|X509Certificate2Collection|ImapConnection.CertCollection|ImapSessionManager.CertCollection|
|RemoteCertificateValidationCallback|ImapConnection.CertificateValidationCallback|ImapSessionManager.CertificateValidationCallback|
|LocalCertificateSelectionCallback|ImapConnection.CertificateSelectionCallback|ImapSessionManager.CertificateSelectionCallback|
|X509Certificate2Collection|ImapConnection.ClientCertificates|ImapSessionManager.ClientCertificates|
|RemoteCertificateValidationCallback|ImapConnection.ServerCertificateValidationCallback|ImapSessionManager.ServerCertificateValidationCallback|
|LocalCertificateSelectionCallback|ImapConnection.ClientCertificateSelectionCallback|ImapSessionManager.ClientCertificateSelectionCallback|
**操作とデータ構造
ImapSessionクラスには、IMAPコマンドと1対1に対応するメソッドが用意されています。 また、すべてのコマンドの引数とレスポンスのデータ構造は、それに対応する型が定義されています。 これらの型は出来る限り仕様と1対1で対応するように実装してあり、IMAPの詳細が分からなくても使えることを目的とするような抽象化はしていません。
の順でIMAPコマンドを実行、レスポンスを取得できます。 以下でSmdn.Net.Imap4.WebClientsに固有な部分について解説します。
**imap, imapsスキームの登録
Smdn.Net.Imap4.WebClients名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
Smdn.Net.Imap4.WebClients名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapWebRequestCreator.RegisterPrefixメソッドを呼び出しておく必要があります。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、imapスキームおよびimapsスキームに対してImapSessionManagerを関連付けます。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、imapスキームおよびimapsスキームに対してImapWebRequestCreatorを関連付けます。
**リクエストURLと接続時の動作
接続時の動作は&urn2url(urn:ietf:rfc:5092);に記述されている内容に準じた動作となるようにしています。 (ただしimapsスキームを使用した場合にSSL/TLSでの接続を試みる動作は本ライブラリ固有の動作です)
***SSL/TLS・接続ポート
リクエストURLのスキームがimapsの場合は、常にSSL/TLSでの接続を試みます。 スキームがimapの場合は、ImapWebRequest.UseTlsIfAvailableプロパティがtrueで、かつサーバがSTARTTLSに対応している場合、認証を開始する前にSSL/TLSを使用した接続にアップグレードします。 URLでポート番号を指定しない場合、デフォルトのポート(imapは143、imapsは993)に接続します。
|*リクエストURLの形式と認証動作の例
|リクエストURLの形式|ユーザ名|使用する認証メカニズム|h
|imap://user;AUTH=DIGEST-MD5@imap.example.net/|user|DIGEST-MD5|
|imap://;AUTH=DIGEST-MD5@imap.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|imap://user;AUTH=*@imap.example.net/&br;imap://user@imap.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|imap://;AUTH=ANONYMOUS@imap.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|imap://user;AUTH=DIGEST-MD5@imap.example.net/|user|DIGEST-MD5|
|imap://;AUTH=DIGEST-MD5@imap.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|imap://user;AUTH=*@imap.example.net/&br;imap://user@imap.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|imap://;AUTH=ANONYMOUS@imap.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|imap://imap.example.net/|匿名ユーザ(anonymous)|ANONYMOUSもしくはLOGINコマンドを使用|
試行する認証メカニズムを制御するには、後述するImapWebRequest.UsingSaslMechanismsプロパティの値を変更してください。
WebRequest.Createメソッドが返すWebRequestインスタンスのMethodプロパティにデフォルトで設定される値は、リクエストURLの形式によって決まります。
ImapWebRequest.GetResponseの動作は、リクエストURLで表されるリクエストの対象と、WebRequest.Methodプロパティに設定する値によって変わります。 以下でリクエストURLの形式とMethodプロパティに指定可能な値、リクエストとレスポンスについて解説します。 ImapWebRequestクラスのプロパティのうち、リクエストに影響するその他のプロパティについては別項で説明します。
ImapWebRequest.GetResponseの動作は、リクエストURLで表されるリクエストの対象と、WebRequest.Methodプロパティに設定する値によって変わります。 基本的な動作は&urn2url(urn:ietf:rfc:5092);に記述されている内容に準じたものになっていますが、ImapWebRequestは本ライブラリ固有の拡張を含んでいます。
以下でリクエストURLの形式とMethodプロパティに指定可能な値、リクエストとレスポンスについて解説します。 ImapWebRequestクラスのプロパティのうち、リクエストに影響するその他のプロパティについては別項で説明します。
***サーバ・アカウントに対するリクエスト
リクエストURLがサーバ・アカウントを表す場合(imap://imap.example.net/の形式)のリクエストとレスポンスの動作は次のとおりです。
リクエストURLが特定のメッセージを表す場合(imap://imap.example.net/mailbox/;UID=1の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|該当するUIDのメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得するメッセージのサイズはWebResponse.ContentLength、Content-TypeはWebResponse.ContentTypeプロパティに設定されます。|
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|取得の際にBODY[]とBODY.PEEK[]のどちらを使用するかはImapWebRequest.FetchPeekプロパティで指定します。&br;該当するUIDのメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得するメッセージのサイズはWebResponse.ContentLength、Content-TypeはWebResponse.ContentTypeプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信してメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、URLで指定されたメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信してメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
ImapWebRequestクラスにはMethodプロパティ以外にもコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|プロパティ|デフォルト|対象となるコマンド|解説|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます。|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
|ReadOnly|false|FETCH, SEARCH等|メールボックスを選択する際に、SELECTコマンドの代わりにEXAMINEコマンドを送信するかどうかを指定します。 メッセージに対する操作を行うコマンドを送信する場合に有効になります。 EXAMINEコマンドで選択したメールボックスのメッセージに対する操作の結果はサーバの実装によります。 ReadOnlyがtrueでもDELETEなどのコマンドには影響しません。|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。 現在の実装では、APPENDコマンドでTRYCREATEが返された場合でもメールボックスは作成せず、常にエラーとなります。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先メールボックス名、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前(WebRequest.RequestUri)と同一サーバ、同一ユーザである必要があります。 それ以外の場合、ArgumentExceptionをスローします。|
|Subscription|true|CREATE, DELETE, RENAME, COPY|メールボックスを作成・削除する際に、対象のメールボックスを自動的にSUBSCRIBE/UNSUBSCRIBEコマンドを送信して購読・購読解除するかどうかを指定します。|
|Subscription|true|CREATE, DELETE, RENAME, COPY|メールボックスを作成・削除する際に、対象のメールボックスに対して自動的にSUBSCRIBE/UNSUBSCRIBEコマンドを送信し、購読・購読解除するかどうかを指定します。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|StatusDataItem|null|STATUS|STATUSコマンドで取得するメールボックスの情報を指定します。|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|ThreadingAlgorithm|null|THREAD|THREADコマンドで使用するスレッド形式のアルゴリズムを指定します。|
|FetchBlockSize|10240|FETCH|FETCHコマンドでメッセージ本文を取得する際に、1回のFETCHコマンドで取得するブロックのサイズをバイト単位で指定します。|
|FetchPeek|true|FETCH|FETCHコマンドでメッセージ本文を取得する際に、BODY.PEEK[]とBODY[]のどちらを使用するかを指定します。 trueの場合はBODY.PEEK[]が使用され、取得したメッセージは未読のままになります。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
|*WebRequestクラスから継承されるプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|プロパティ|デフォルト|対象となるコマンド|解説|h
|Timeout|-1|全て|リクエストを開始してからレスポンスを取得するまでのタイムアウト時間を指定します。|
|ReadWriteTimeout|300000|全て|ソケット送受信のタイムアウト時間を指定します。|
|ContentLength|0|APPEND|メールボックスにアップロードするメッセージのサイズを指定します。|
以下のプロパティは、未テスト・不完全な実装に関連するプロパティです。 使用はできますが、今後廃止する可能性もあるので、現時点では使用を推奨できません。
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|プロパティ|デフォルト|対象となるコマンド|解説|h
|UseDeflateIfAvailable|false|全て|サーバがサポートしている場合、DEFLATE圧縮アルゴリズムを使用した接続に変更します。 (この機能は現在動作しません。 trueにした場合、NotImplementedExceptionがスローされます)|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
***ImapWebRequestクラスのデフォルト値の変更
ImapWebRequestDefaultsクラスのプロパティの値を変更することにより、ImapWebRequestクラスのプロパティに設定されるデフォルト値を一括して指定することができます。 全てのリクエストでデフォルトの値を変更したい場合は、ImapWebRequestDefaultsクラスのプロパティの値を変更してください。
ImapWebRequestDefaultsクラスにはImapWebRequestプロパティと同名のプロパティを用意してありますが、以下の一覧にあるプロパティはImapWebRequestでは設定できないプロパティです。
|*ImapWebRequestDefaultsクラスのプロパティ
|プロパティ|デフォルト|解説|h
|AnonymousToken|"anonymous"|匿名ユーザでログインする場合に使用されるユーザ名を指定します。|
|Subscription|true|ImapWebRequest.Subscriptionプロパティと同様ですが、falseにした場合WebRequest.Methodのデフォルト値が"LSUB"から"LIST"に変わります。|
|ClientID|name=(現在実行中のアセンブリの名前)&br;version=(現在実行中のアセンブリのバージョン)&br;environment=(ランタイムの名前とバージョン)|サーバが&urn2url(urn:ietf:rfc:2971){ID extension};をサポートしている場合に送信されるIDを指定します。|
***リクエストとIMAP URLに関するその他の留意事項
-UIDVALIDITYを含むIMAP URLも扱えますが、無視します。 現時点ではUIDVALIDITYが指定されていない場合と同様に扱います。
**アプリケーション構成ファイルでの設定
アプリケーション構成ファイルを記述することにより、imap, imapsスキームの登録と、ImapWebRequestDefaultsクラスの値を変更することができます。 コード上での変更をしたくない場合、する必要がない場合などは、アプリケーション構成ファイルに設定を記述することができます。 以下はアプリケーション構成ファイルの記述例です。
#code(xml,アプリケーション構成ファイルの記述例){{
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<!-- smdn.net.imap4.client要素を処理するためのセクションハンドラクラスの設定 -->
<sectionGroup name="smdn.net.imap4.client">
<section name="webRequestDefaults" type="System.Configuration.DictionarySectionHandler, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
</sectionGroup>
</configSections>
<system.net>
<!-- imap, imapsスキームの登録 -->
<webRequestModules>
<add prefix="imap" type="Smdn.Net.Imap4.WebClients.ImapWebRequestCreator, Smdn.Net.Imap4.Client" />
<add prefix="imaps" type="Smdn.Net.Imap4.WebClients.ImapWebRequestCreator, Smdn.Net.Imap4.Client" />
</webRequestModules>
</system.net>
<smdn.net.imap4.client>
<!-- ImapWebRequestDefaultsクラスのデフォルト値の変更 -->
<webRequestDefaults>
<add key="timeout" value="-1"/>
<add key="readWriteTimeout" value="-1"/>
<add key="fetchBlockSize" value="102400"/>
<add key="fetchPeek" value="true"/>
<add key="subscription" value="true"/>
<add key="allowCreateMailbox" value="true"/>
<add key="useTlsIfAvailable" value="true"/>
<add key="keepAlive" value="true"/>
<add key="readOnly" value="false"/>
<add key="anonymousToken" value="anonymous"/>
<add key="usingSaslMechanisms" value="DIGEST-MD5, CRAM-MD5, NTLM"/>
<add key="expectedErrorResponseCodes" value="ALREADYEXISTS, NONEXISTENT"/>
<add key="clientID" value="name=MyImapClient, support-url=http://imap.example.net/support/"/>
</webRequestDefaults>
</smdn.net.imap4.client>
</configuration>
}}
記述内容については[[ネットワーク設定スキーマ:http://msdn.microsoft.com/ja-jp/library/dacty7ed%28VS.80%29.aspx]]および[[構成セクション スキーマ:http://msdn.microsoft.com/ja-jp/library/0hyxd0xc%28VS.80%29.aspx]]も合わせて参照してください。
**サンプル
***メッセージのコピー
INBOXにあるメッセージすべてをINBOX.backupにコピーする例。 AllowCreateMailboxプロパティをtrueにしておくことで、サーバがレスポンスコードTRYCREATEを返した場合は自動的にメールボックスを作成します。
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.Protocol;
using Smdn.Net.Imap4.WebClients;
:
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.Protocol;
using Smdn.Net.Imap4.WebClients;
:
using System.Text;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClients;
:
class Sample {
public static void Main()
{
ImapConnection.CertificateValidationCallback += delegate {
ImapConnection.ServerCertificateValidationCallback += delegate {
return true;
};
--[[works/libs/Smdn.Formats.Mime]]
*機能
すべての標準コマンドといくつかの拡張コマンドの送受信、SSL/TLS接続(IMAP over SSL, STARTTLS)、SASL認証メカニズムなどに対応しています。
**主な機能
+すべての標準コマンドの送受信
+いくつかの拡張コマンドの送受信
++IDLE
++QUOTA
++SORT/THREADほか
+SSL/TLS接続(IMAP over SSL, STARTTLS)
+SASL認証メカニズム(DIGEST-MD5他)
使用可能なコマンド
:認証系コマンド|LOGIN, AUTHENTICATE, LOGOUT, STARTTLS
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
:メールボックス操作系コマンド|
::標準コマンド|CREATE, RENAME, DELETE, CLOSE, SELECT, EXAMINE, LIST, LSUB, STATUS, SUBSCRIBE, UNSUBSCRIBE
::拡張コマンド|RLIST, RLSUB, LIST(LIST-EXTENDED), XLIST(Gimap), UNSELECT, NAMESPACE
:メッセージ操作系コマンド|
::標準コマンド|APPEND,SEARCH, EXPUNGE
::拡張コマンド|(UID)SORT,, UID EXPUNGE
:その他のコマンド|
::標準コマンド|NOOP, CHECK, CAPABILITY
::拡張コマンド|ENABLE, COMPRESS, IDLE, ID, COMPARATOR, LANGUAGE
その他、サポートしている機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。
実装しているクライアントは次の二種類です。
**クライアント実装
クライアント実装として以下の2つのクラスを用意しています。
:ImapSessionクラス|IMAPコマンドと1対1に対応するメソッドを持つクライアント
:ImapWebRequest/ImapWebResponseクラス|WebRequest/WebResponseクラスから派生し、IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)での操作に対応したクライアント
その他、サポートしている機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。
**その他の主な特徴
:メッセージ本文はStreamとして取得可能|メッセージの加工・解析は任意の手段を使用できるよう、Streamとして返します。 MIMEメッセージのデコード機能は含んでいません。
:StreamReader, Regexは不使用|送受信時の文字列処理はstringではなくbyte[]のまま処理しています。 byte[]⇄stringの変換に起因する不必要なメモリの消費と速度の低下はできる限り抑えてあります。 また、大きなメッセージを取得してもLarge Object Heapを消費しないよう実装しています。
:ログ出力にTraceSourceを使用|送受信内容・動作状況のログをTraceListenerで取得できます。 またログ出力のレベルを設定できます。 イベントハンドラによる送受信時のフックは無駄と考え用意していません。
:パース済みのレスポンスにアクセス可能|受信したレスポンスは必要な部分だけを拾い読みして結果を返すのではなく、全てパースしてから結果を返します。
:フリー・オープンソース|本ライブラリは[[MIT X11ライセンス:http://sourceforge.jp/projects/opensource/wiki/licenses%2FMIT_license]]を採用しています。
*ダウンロード
#googleadunit
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.24.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.25.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
class GimapFetchExample {
public static void Main()
{
ImapSessionManager.RegisterWebRequestPrefix();
ImapSessionManager.CertificateValidationCallback += delegate {
ImapWebRequestCreator.RegisterPrefix();
ImapSessionManager.ServerCertificateValidationCallback += delegate {
return true;
};
*制限事項・特記事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
-SASLの実装は、本体とは別ライブラリの[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています。
-実装にあたり、セキュリティ上の考慮はしていますが、十分な検証は行っていないため保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
*参考文献
#amazon(4873110289,left,content)
**standards and IMAP extensions
サポートする標準仕様およびIMAP拡張仕様の一覧です。 標準化されていないドラフトも一部サポートしています。
|RFC|capability name|status|note|h
|&urn2url(urn:ietf:rfc:2087,anchor-text);|QUOTA|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2087,anchor-text);|QUOTA|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2088,anchor-text);|LITERAL+|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2177,anchor-text);|IDLE|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2180,anchor-text);|-|&color(orange){partially implemented};||
|&urn2url(urn:ietf:rfc:3348,anchor-text);|CHILDREN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3501,anchor-text);|IMAP4rev1|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3502,anchor-text);|MULTIAPPEND|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3516,anchor-text);|BINARY|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3516,anchor-text);|BINARY|&color(red){not tested};||
|&urn2url(urn:ietf:rfc:3691,anchor-text);|UNSELECT|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4314,anchor-text);|ACL|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4314,anchor-text);|RIGHTS=*|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5267,anchor-text);|CONTEXT=SEARCH|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5267,anchor-text);|CONTEXT=SORT|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5267,anchor-text);|ESORT|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5464,anchor-text);|METADATA|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5464,anchor-text);|METADATA-SERVER|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5464,anchor-text);|METADATA|&color(red){not tested};||
|&urn2url(urn:ietf:rfc:5464,anchor-text);|METADATA-SERVER|&color(red){not tested};||
|&urn2url(urn:ietf:rfc:5465,anchor-text);|NOTIFY|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5466,anchor-text);|FILTERS|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5466,anchor-text);|FILTERS|&color(red){not tested};||
|&urn2url(urn:ietf:rfc:5524,anchor-text);|URLAUTH=BINARY|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5530,anchor-text);|-|&color(green){implemented};||
|&urn2url(urn:ietf:id:ietf-morg-inthread-00,anchor-text);|SEARCH=INTHREAD|&color(green){implemented};||
|STORE, UID STORE|&urn2url(urn:ietf:rfc:3501,#6.4.6,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.5,short);|&color(green){implemented};||
|COPY, UID COPY|&urn2url(urn:ietf:rfc:3501,#6.4.7,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short);|&color(green){implemented};|Modified UTF-7対応&sub{*1};|
|~Extensions|-|-|-|
|SETQUOTA|&urn2url(urn:ietf:rfc:2087,#4.1,short);|&color(gray){not implemented};||
|GETQUOTA|&urn2url(urn:ietf:rfc:2087,#4.2,short);|&color(gray){not implemented};||
|GETQUOTAROOT|&urn2url(urn:ietf:rfc:2087,#4.3,short);|&color(gray){not implemented};||
|SETQUOTA|&urn2url(urn:ietf:rfc:2087,#4.1,short);|&color(green){implemented};||
|GETQUOTA|&urn2url(urn:ietf:rfc:2087,#4.2,short);|&color(green){implemented};||
|GETQUOTAROOT|&urn2url(urn:ietf:rfc:2087,#4.3,short);|&color(green){implemented};||
|IDLE|&urn2url(urn:ietf:rfc:2177,#3,short);|&color(green){implemented};||
|RLIST|&urn2url(urn:ietf:rfc:2193,#5.1,short);|&color(red){not tested};||
|RLSUB|&urn2url(urn:ietf:rfc:2193,#5.2,short);|&color(red){not tested};||
|THREAD, UID THREAD|&urn2url(urn:ietf:rfc:5256,#3,short);|&color(green){implemented};|非ASCII文字での検索に対応&sub{*2};|
|CONVERSIONS|&urn2url(urn:ietf:rfc:5259,#5.1,short);|&color(gray){not implemented};||
|CONVERT, UID CONVERT|&urn2url(urn:ietf:rfc:5259,#6,short);|&color(gray){not implemented};||
|GETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.2,short);|&color(gray){not implemented};||
|SETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.3,short);|&color(gray){not implemented};||
|GETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.2,short);|&color(red){not tested};||
|SETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.3,short);|&color(red){not tested};||
|NOTIFY|&urn2url(urn:ietf:rfc:5465,#3.1,short);|&color(gray){not implemented};||
|CREATE with special-use flags|&urn2url(urn:ietf:id:ietf-morg-list-specialuse-00,anchor-text);|&color(gray){not implemented};||
|LIST with STATUS return option|&urn2url(urn:ietf:id:ietf-morg-status-in-list-01,anchor-text);|&color(green){implemented};||
|UIDNEXT|&urn2url(urn:ietf:rfc:3501,short);|&color(green){implemented};||
|UIDVALIDITY|&urn2url(urn:ietf:rfc:3501,short);|&color(green){implemented};||
|UNSEEN|&urn2url(urn:ietf:rfc:3501,short);|&color(green){implemented};||
|UNKNOWN-CTE|&urn2url(urn:ietf:rfc:3516,short);|&color(gray){not implemented};||
|UNKNOWN-CTE|&urn2url(urn:ietf:rfc:3516,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|UIDNOTSTICKY|&urn2url(urn:ietf:rfc:4315,short);|&color(green){implemented};||
|APPENDUID|&urn2url(urn:ietf:rfc:4315,short);|&color(green){implemented};||
|COPYUID|&urn2url(urn:ietf:rfc:4315,short);|&color(green){implemented};||
|MAXCONVERTMESSAGES|&urn2url(urn:ietf:rfc:5259,short);|&color(gray){not implemented};||
|MAXCONVERTPARTS|&urn2url(urn:ietf:rfc:5259,short);|&color(gray){not implemented};||
|NOUPDATE|&urn2url(urn:ietf:rfc:5267,short);|&color(gray){not implemented};||
|METADATA|&urn2url(urn:ietf:rfc:5464,short);|&color(gray){not implemented};||
|METADATA LONGENTRIES|&urn2url(urn:ietf:rfc:5464,short);|&color(orange){partially implemented};|通常のレスポンスと同様&sub{*1};に扱います。|
|METADATA MAXSIZE|&urn2url(urn:ietf:rfc:5464,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|METADATA TOOMANY|&urn2url(urn:ietf:rfc:5464,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|METADATA NOPRIVATE|&urn2url(urn:ietf:rfc:5464,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|NOTIFICATIONOVERFLOW|&urn2url(urn:ietf:rfc:5465,short);|&color(gray){not implemented};||
|BADEVENT|&urn2url(urn:ietf:rfc:5465,short);|&color(gray){not implemented};||
|UNDEFINED-FILTER|&urn2url(urn:ietf:rfc:5466,short);|&color(gray){not implemented};||
|UNDEFINED-FILTER|&urn2url(urn:ietf:rfc:5466,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|UNAVAILABLE|&urn2url(urn:ietf:rfc:5530,short);|&color(orange){partially implemented};|通常のレスポンスと同様&sub{*1};に扱います。|
|AUTHENTICATIONFAILED|&urn2url(urn:ietf:rfc:5530,short);|&color(orange){partially implemented};|通常のレスポンスと同様&sub{*1};に扱います。|
|AUTHORIZATIONFAILED|&urn2url(urn:ietf:rfc:5530,short);|&color(orange){partially implemented};|通常のレスポンスと同様&sub{*1};に扱います。|
*リリース一覧
-0.2x
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.25.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.24.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.23.tar.bz2}
--${smdncms:distfilelink,../Smdn.Net.Pop3.Client-0.22.tar.bz2}
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
*変更履歴
**0.25
主にアプリケーション構成ファイルでの設定のサポート、パフォーマンスと.NET Frameworkでの動作の改善。
-機能追加
--WebClients名前空間
---アプリケーション構成ファイルのconfiguration/system.net/webRequestModules要素でpop/popsスキームを登録できるようにした
---PopWebRequestDefaultsクラスを追加、コード内もしくはアプリケーション構成ファイルでPopWebRequestの各プロパティのデフォルト値を設定できるようにした
-修正・改善
--PopResponseCodeをSmdn.Net.Pop3.Protocol.ClientからSmdn.Net.Pop3.Protocolに移動
--SslStream.AuthenticateAsClientでAuthenticationExceptionが発生した場合、ストリームを閉じるようにした
--ライブラリ内のメッセージとサーバからのレスポンスを区別できるように内部処理と書式を変更した
--パフォーマンス関連
---レスポンスパーサの実装を最適化、冗長な処理を削除
---文字列比較処理を最適化
---ロック処理にSemaphoreを使用していた箇所をMonitorに置き換えた
--.NET Framework関連
---NetworkCredentialの各プロパティがnullを返すことを期待していた実装を修正、nullではなくstring.Emptyの場合に認証をキャンセルするようにした
---SocketError.TimedOutのSocketExceptionが発生した場合、ImapConnectionExceptionではなくTimeoutExceptionをスローするようにした
--WebClients名前空間
---SslStream作成用のコールバック、証明書関連のコールバックのプロパティ名を変更、また値をPopConnectionと共有しないようにした
---PopSessionManagerからIWebRequestCreateの実装を分離、WebRequest.RegisterPrefixはPopWebRequestCreator.RegisterPrefixで行うようにした
**0.24
-機能追加
--拡張コマンドなど任意のコマンドを送信するためのメソッドを追加
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.24時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.25時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Pop3.WebClients名前空間の説明を参照してください。
using System;
using System.Net;
using Smdn.Net.Imap4.WebClients;
using Smdn.Net.Pop3.WebClients;
class Sample {
public static void Main(string[] args)
{
PopSessionManager.RegisterWebRequestPrefix();
PopWebRequestCreator.RegisterPrefix();
using {
client.Credentials = new NetworkCredential("user", "pass");
class Sample {
public static void Main(string[] args)
{
PopSessionManager.RegisterWebRequestPrefix();
PopSessionManager.CertificateValidationCallback += delegate {
PopWebRequestCreator.RegisterPrefix();
PopSessionManager.ServerCertificateValidationCallback += delegate {
return true;
};
の順でPOPコマンドを実行、レスポンスを取得できます。 以下でSmdn.Net.Pop3.WebClientsに固有な部分について解説します。
**pop, popsスキームの登録
Smdn.Net.Pop3.WebClients名前空間のクラスを使う場合には、WebRequestクラスがpopスキームおよびpopsスキームのURLを処理できるようにPopSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
Smdn.Net.Pop3.WebClients名前空間のクラスを使う場合には、WebRequestクラスがpopスキームおよびpopsスキームのURLを処理できるようにPopWebRequestCreator.RegisterPrefixメソッドを呼び出しておく必要があります。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、popスキームおよびpopsスキームに対してPopSessionManagerを関連付けます。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、popスキームおよびpopsスキームに対してPopWebRequestCreatorを関連付けます。
**リクエストURLと接続時の動作
接続時の動作は&urn2url(urn:ietf:rfc:2384);に記述されている内容に準じた動作となるようにしています。 (ただしpopsスキームを使用した場合にSSL/TLSでの接続を試みる動作は本ライブラリ固有の動作です)
***SSL/TLS・接続ポート
リクエストURLのスキームがpopsの場合は、常にSSL/TLSでの接続を試みます。 スキームがpopの場合は、PopWebRequest.UseTlsIfAvailableプロパティがtrueで、かつサーバがSTLSに対応している場合、認証を開始する前にSSL/TLSを使用した接続にアップグレードします。 URLでポート番号を指定しない場合、デフォルトのポート(popは110、popsは995)に接続します。
|*リクエストURLの形式と認証動作の例
|リクエストURLの形式|ユーザ名|使用する認証メカニズム|h
|pop://user;AUTH=+APOP@pop.example.net/|user|APOP|
|pop://user;AUTH=DIGEST-MD5@pop.example.net/|user|DIGEST-MD5|
|pop://;AUTH=DIGEST-MD5@pop.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|pop://user;AUTH=*@pop.example.net/&br;pop://user@pop.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|pop://;AUTH=ANONYMOUS@pop.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|pop://user;AUTH=+APOP@pop.example.net/|user|APOP|
|pop://user;AUTH=DIGEST-MD5@pop.example.net/|user|DIGEST-MD5|
|pop://;AUTH=DIGEST-MD5@pop.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|pop://user;AUTH=*@pop.example.net/&br;pop://user@pop.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|pop://;AUTH=ANONYMOUS@pop.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|pop://pop.example.net/|匿名ユーザ(anonymous)|ANONYMOUSもしくはUSER/PASSコマンドを使用|
試行する認証メカニズムを制御するには、後述するPopWebRequest.UsingSaslMechanismsプロパティの値を変更してください。
PopWebRequestクラスにはMethodプロパティ以外にもコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*PopWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|プロパティ|デフォルト|対象となるコマンド|解説|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます。|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
|DeleteAfterRetrieve|false|RETR|RETRコマンドでのメッセージの受信が成功した場合、同じメッセージに対して自動的にDELEコマンドを発行します。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
|*WebRequestクラスから継承されるプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|プロパティ|デフォルト|対象となるコマンド|解説|h
|Timeout|-1|全て|リクエストを開始してからレスポンスを取得するまでのタイムアウト時間を指定します。|
|ReadWriteTimeout|300000|全て|ソケット送受信のタイムアウト時間を指定します。|
***PopWebRequestクラスのデフォルト値の変更
PopWebRequestDefaultsクラスのプロパティの値を変更することにより、PopWebRequestクラスのプロパティに設定されるデフォルト値を一括して指定することができます。 全てのリクエストでデフォルトの値を変更したい場合は、PopWebRequestDefaultsクラスのプロパティの値を変更してください。
PopWebRequestDefaultsクラスにはPopWebRequestプロパティと同名のプロパティを用意してありますが、以下の一覧にあるプロパティはPopWebRequestでは設定できないプロパティです。
|*PopWebRequestDefaultsクラスのプロパティ
|プロパティ|デフォルト|解説|h
|AnonymousToken|"anonymous"|匿名ユーザでログインする場合に使用されるユーザ名を指定します。|
**アプリケーション構成ファイルでの設定
アプリケーション構成ファイルを記述することにより、pop, popsスキームの登録と、PopWebRequestDefaultsクラスのデフォルト値を変更することができます。 コード上での変更をしたくない場合、する必要がない場合などは、アプリケーション構成ファイルに設定を記述することができます。 以下はアプリケーション構成ファイルの記述例です。
#code(xml,アプリケーション構成ファイルの記述例){{
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<!-- smdn.net.pop3.client要素を処理するためのセクションハンドラクラスの設定 -->
<sectionGroup name="smdn.net.pop3.client">
<section name="webRequestDefaults" type="System.Configuration.DictionarySectionHandler, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
</sectionGroup>
</configSections>
<system.net>
<!-- pop, popsスキームの登録 -->
<webRequestModules>
<add prefix="pop" type="Smdn.Net.Pop3.WebClients.PopWebRequestCreator, Smdn.Net.Pop3.Client" />
<add prefix="pops" type="Smdn.Net.Pop3.WebClients.PopWebRequestCreator, Smdn.Net.Pop3.Client" />
</webRequestModules>
</system.net>
<smdn.net.pop3.client>
<!-- PopWebRequestDefaultsクラスのデフォルト値の変更 -->
<webRequestDefaults>
<add key="timeout" value="-1"/>
<add key="readWriteTimeout" value="-1"/>
<add key="useTlsIfAvailable" value="true"/>
<add key="deleteAfterRetrieve" value="false"/>
<add key="keepAlive" value="true"/>
<add key="anonymousToken" value="anonymous"/>
<add key="usingSaslMechanisms" value="DIGEST-MD5, CRAM-MD5, NTLM"/>
<add key="expectedErrorResponseCodes" value="ALREADYEXISTS, NONEXISTENT"/>
</webRequestDefaults>
</smdn.net.pop3.client>
</configuration>
}}
記述内容については[[ネットワーク設定スキーマ:http://msdn.microsoft.com/ja-jp/library/dacty7ed%28VS.80%29.aspx]]および[[構成セクション スキーマ:http://msdn.microsoft.com/ja-jp/library/0hyxd0xc%28VS.80%29.aspx]]も合わせて参照してください。
*Smdn.Net.Pop3.Client.Session名前空間
Smdn.Net.Pop3.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Pop3.WebClientsの各クラスの実装を参照してください。
class Sample {
public static void Main(string[] args)
{
PopConnection.CertificateValidationCallback += delegate {
PopConnection.ServerCertificateValidationCallback += delegate {
return true;
};
--[[works/libs/Smdn.Security.Authentication.Sasl]]
--[[works/libs/Smdn.Formats.Mime]]
*機能
すべての標準コマンドといくつかの拡張コマンドの送受信、SSL/TLS接続(POP over SSL, STLS)、SASL認証メカニズムなどに対応しています。
*機能と特徴
**主な機能
+すべての標準コマンドといくつかの拡張コマンドの送受信
+SSL/TLS接続(POP over SSL, STLS)
+APOP
+SASL認証メカニズム(DIGEST-MD5他)
使用可能なコマンド。
:認証系コマンド|USER, PASS, QUIT, APOP, AUTH(&urn2url(urn:ietf:rfc:5034,short);)
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
:メッセージ操作系コマンド|STAT, LIST, RETR, DELE, TOP, UIDL, RSET
:その他のコマンド|NOOP, CAPA(&urn2url(urn:ietf:rfc:2449,short);), STLS(&urn2url(urn:ietf:rfc:2595,short);)
その他、サポートしている機能の詳細は「実装済み機能一覧」の項をご覧ください。
実装しているクライアントは次の二種類です。
**クライアント実装
クライアント実装として以下の2つのクラスを用意しています。
:PopSessionクラス|POPコマンドと1対1に対応するメソッドを持つクライアント
:PopWebRequest/PopWebResponseクラス|WebRequest/WebResponseクラスから派生し、POP URL(&urn2url(urn:ietf:rfc:2384,short);)での操作に対応したクライアント
**その他の主な特徴
:メッセージ本文はStreamとして取得可能|メッセージの加工・解析は任意の手段を使用できるよう、Streamとして返します。 MIMEメッセージのデコード機能は含んでいません。
:StreamReader, Regexは不使用|送受信時の文字列処理はstringではなくbyte[]のまま処理しています。 byte[]⇄stringの変換に起因する不必要なメモリの消費と速度の低下はできる限り抑えてあります。 また、大きなメッセージを取得してもLarge Object Heapを消費しないよう実装しています。
:ログ出力にTraceSourceを使用|送受信内容・動作状況のログをTraceListenerで取得できます。 またログ出力のレベルを設定できます。 イベントハンドラによる送受信時のフックは無駄と考え用意していません。
:パース済みのレスポンスにアクセス可能|受信したレスポンスは必要な部分だけを拾い読みして結果を返すのではなく、全てパースしてから結果を返します。
:フリー・オープンソース|本ライブラリは[[MIT X11ライセンス:http://sourceforge.jp/projects/opensource/wiki/licenses%2FMIT_license]]を採用しています。
*ダウンロード
#googleadunit
本ライブラリはMIT X11ライセンスでのリリースとなります。
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.24.tar.bz2}
:最新版|${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.25.tar.bz2}
:開発版|[[anonsvn]]よりチェックアウトできます
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
class GpopRetrieveExample {
public static void Main()
{
PopSessionManager.RegisterWebRequestPrefix();
PopSessionManager.CertificateValidationCallback += delegate {
PopWebRequestCreator.RegisterPrefix();
PopSessionManager.ServerCertificateValidationCallback += delegate {
return true;
};
*制限事項・特記事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
-SASLの実装は、本体とは別ライブラリの[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています。
-実装にあたり、セキュリティ上の考慮はしていますが、十分な検証は行っていないため保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
*参考文献
#amazon(4873110289,left,content)
|&urn2url(urn:ietf:rfc:4505,anchor-text);|ANONYMOUS|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4752,anchor-text);|GSSAPI|&color(gray){not implemented};||
|[[[MS-NLMP:http://msdn.microsoft.com/en-us/library/cc236621(PROT.13).aspx]]] NT LAN Manager{partially implemented};|サーバ側の実装によっては正しく動作しない可能性があります。|
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-*|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1-PLUS|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-11,anchor-text);|SCRAM-*|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-11,anchor-text);|SCRAM-SHA-1|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-11,anchor-text);|SCRAM-SHA-1-PLUS|&color(gray){not implemented};||
|RFC|mechanism name|status|note|f
使い方・認証処理の実装は[[works/libs/Smdn.Net.Imap4]]および[[works/libs/Smdn.Net.Pop3]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.25.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.24.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.22.tar.bz2}
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.25
-SaslClientMechanismを継承した任意のクラスを既知の認証メカニズムとして登録・使用できるようにした
-NetworkCredentialの各プロパティがnullを返すことを期待していた実装を修正、nullではなくstring.Emptyの場合に認証をキャンセルするようにした
**0.24
-Mono.Security.dllがない環境でも動作するように、Mono.Security.Protocol.Ntlmの実装をインポート
-認証時に参照するNetworkCredentialのUserNameおよびPasswordプロパティがnullだった場合の動作を整理
*制限事項・特記事項
-本ライブラリには、NTLM認証でのチャレンジレスポンスの実装として、Mono.Security.Protocol.Ntlmのクラスを含んでいます。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。
-実装にあたり、セキュリティ上の考慮はしていますが、十分な検証は行っていないため保証はできません。
*関連するページ
-[[programming/mono/Mono.Security.Protocol.Ntlm]]
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.24.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.24
----[[works/libs/Smdn.Net.Pop3]] 0.24
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.24
----[[works/libs/Smdn.Formats.Mime]] 0.16
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.23.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.23
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.24
-修正・改善
--パスワードの入力ダイアログを追加、設定ファイルにパスワードを記入しなくても接続できるようにした。
**0.23
-機能追加
--IMAP
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.24時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間の説明を参照してください。
using {
client.Credentials = new NetworkCredential("user", "pass");
client.UploadData("imap://user;AUTH=DIGEST-MD5@localhost/INBOX/", ImapWebRequestMethods.Append, File.ReadAllBytes("sample.eml"));
client.UploadData("imap://user;AUTH=DIGEST-MD5@localhost/INBOX", ImapWebRequestMethods.Append, File.ReadAllBytes("sample.eml"));
}
}
}
ImapSessionManager.RegisterWebRequestPrefix();
ImapSessionManager.CertificateValidationCallback = delegate { return true; };
var request = WebRequest.Create("imaps://user@imap.gmail.com/INBOX/?SUBJECT \"[Mono-dev]\"");
var request = WebRequest.Create("imaps://user@imap.gmail.com/INBOX?SUBJECT \"[Mono-dev]\"");
request.Credentials = new NetworkCredential("user", "pass");
|*リクエストURLの形式とリクエストの対象
|リクエストURLの形式|リクエストの対象|h
|imap://imap.example.net/|URLで指定されたサーバ・アカウント|
|imap://imap.example.net/mailbox/|URLで指定されたメールボックス|
|imap://imap.example.net/mailbox/?...|URLで指定されたメールボックスにあるメッセージのうち、検索クエリに該当する全てのメッセージ|
|imap://imap.example.net/mailbox|URLで指定されたメールボックス|
|imap://imap.example.net/mailbox?...|URLで指定されたメールボックスにあるメッセージのうち、検索クエリに該当する全てのメッセージ|
|imap://imap.example.net/mailbox/;UID=1|URLで指定されたメールボックスにあるメッセージのうち、UIDに該当する特定のメッセージ|
WebRequest.Createメソッドが返すWebRequestインスタンスのMethodプロパティにデフォルトで設定される値は、リクエストURLの形式によって決まります。
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックスに対するリクエスト
リクエストURLがメールボックスを表す場合(imap://imap.example.net/mailbox/の形式)のリクエストとレスポンスの動作は次のとおりです。
リクエストURLがメールボックスを表す場合(imap://imap.example.net/mailboxの形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Append, "APPEND"|APPENDコマンドを送信してメールボックスにメッセージをアップロードします。|アップロードするメッセージはWebRequest.GetRequestStreamメソッドが返すStreamに書き込みます。 現在の実装では、リクエスト開始時にContentLengthの値が指定されているか、GetRequestStreamメソッドが返すStreamを閉じるまでアップロードは保留されます。 メッセージはMIME形式であるべきですが、ライブラリ側ではアップロードする内容をチェックしません。|サーバがアップロードしたメッセージのUIDを返す場合は、アップロードしたメッセージのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|EXPUNGEコマンドを送信してメールボックスから\Deletedフラグの付いたメッセージを削除します。|-|-|
|ImapWebRequestMethods.Create, "CREATE"|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|作成できた場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|作成したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、作成したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Delete, "DELETE"|DELETEコマンドを送信してメールボックスを削除します。|削除しようとするメールボックスに対してUNSUBSCRIBEコマンドを送信してから削除します。&br;削除しようとするメールボックスにメッセージがある場合は削除に失敗するので、STOREやEXPUNGEでメッセージを削除してからメールボックスを削除する必要があります。|-|
|ImapWebRequestMethods.Rename, "RENAME"|RENAMEコマンドを送信してメールボックスの名前を変更します。|変更後のメールボックス名はImapWebRequest.DestinationUriプロパティで指定します。|名前を変更した後のメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、名前を変更した後のメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Create, "CREATE"|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|ImapWebRequest.Subscriptionプロパティがtrueの場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|作成したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、作成したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Delete, "DELETE"|DELETEコマンドを送信してメールボックスを削除します。|ImapWebRequest.Subscriptionプロパティがtrueの場合、削除したメールボックスに対してUNSUBSCRIBEコマンドを送信します。&br;削除しようとするメールボックスにメッセージがある場合は削除に失敗するので、STOREやEXPUNGEでメッセージを削除してからメールボックスを削除する必要があります。|-|
|ImapWebRequestMethods.Rename, "RENAME"|RENAMEコマンドを送信してメールボックスの名前を変更します。|ImapWebRequest.Subscriptionプロパティがtrueの場合、変更前後のメールボックスに対して自動的にUNSUBSCRIBE/SUBSCRIBEコマンドを送信します。&br;変更後のメールボックス名はImapWebRequest.DestinationUriプロパティで指定します。|名前を変更した後のメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、名前を変更した後のメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Check, "CHECK"|CHECKコマンドを送信します。|このコマンドは何もしません。 CHECKコマンドの動作、レスポンスの内容はサーバの実装によります。|-|
|ImapWebRequestMethods.Select, "SELECT"|SELECTコマンドを送信してメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、選択したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Examine, "EXAMINE"|EXAMINEコマンドを送信して読み取り専用でメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、選択したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Status, "STATUS"|STATUSコマンドを送信してメールボックスの状態を取得します。|取得する情報は、ImapWebRequest.StatusDataItemプロパティで指定します。&br;既にメールボックスを選択している状態で、他のメールボックスの状態を取得する場合に使います。|状態を取得したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Subscribe, "SUBSCRIBE"|SUBSCRIBEコマンドを送信してメールボックスの購読を開始します。|-|-|
|ImapWebRequestMethods.Unsubscribe, "UNSUBSCRIBE"|UNSUBSCRIBEコマンドを送信してメールボックスの購読を解除します。|-|-|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックスに対する検索クエリを含むリクエスト
リクエストURLがメールボックスに対する検索クエリを表す場合(imap://imap.example.net/mailbox/?...の形式)のリクエストとレスポンスの動作は次のとおりです。
リクエストURLがメールボックスに対する検索クエリを表す場合(imap://imap.example.net/mailbox?...の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して検索クエリに該当するメッセージに\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、検索クエリに該当したメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信して検索クエリに該当するメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;''サーバがSORT=* extensionをサポートしない場合、WebExceptionをスローします。''|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;''サーバがTHREAD=* extensionをサポートしない場合、WebExceptionをスローします。''|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;サーバがSORTコマンドをサポートするかどうかはチェックせずにリクエストを実行します。|取得したソート済みメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;サーバがTHREADコマンドをサポートするかどうかはチェックせずにリクエストを実行します。|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。 また、個々のメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックス内の特定のメッセージに対するリクエスト
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|該当するUIDのメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得するメッセージのサイズはWebResponse.ContentLength、Content-TypeはWebResponse.ContentTypeプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信してメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|サーバがCOPYUIDレスポンスコードを返した場合は、コピーしたメッセージのURLがWebResponse.ResponseUriに設定されます。 また、コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、URLで指定されたメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信してメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|Methodプロパティ|リクエスト|解説|レスポンス|f
|ReadOnly|false|FETCH, SEARCH等|メールボックスを選択する際に、SELECTコマンドの代わりにEXAMINEコマンドを送信するかどうかを指定します。 メッセージに対する操作を行うコマンドを送信する場合に有効になります。 EXAMINEコマンドで選択したメールボックスのメッセージに対する操作の結果はサーバの実装によります。 ReadOnlyがtrueでもDELETEなどのコマンドには影響しません。|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。 現在の実装では、APPENDコマンドでTRYCREATEが返された場合でもメールボックスは作成せず、常にエラーとなります。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先メールボックス名、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前(WebRequest.RequestUri)と同一サーバ、同一ユーザである必要があります。 それ以外の場合、ArgumentExceptionをスローします。|
|Subscription|true|CREATE, DELETE, RENAME, COPY|メールボックスを作成・削除する際に、対象のメールボックスを自動的にSUBSCRIBE/UNSUBSCRIBEコマンドを送信して購読・購読解除するかどうかを指定します。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|StatusDataItem|null|STATUS|STATUSコマンドで取得するメールボックスの情報を指定します。|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|ThreadingAlgorithm|null|THREAD|THREADコマンドで使用するスレッド形式のアルゴリズムを指定します。|
|FetchBlockSize|10240|FETCH|FETCHコマンドでメッセージ本文を取得する際に、1回のFETCHコマンドで取得するブロックのサイズをバイト単位で指定します。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|UseDeflateIfAvailable|false|全て|サーバがサポートしている場合、DEFLATE圧縮アルゴリズムを使用した接続に変更します。 (この機能は現在動作しません。 trueにした場合、NotImplementedExceptionがスローされます)|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
|SearchCriteriaEncoding|Encoding.UTF8|SEARCH等|検索クエリのエンコードに使用する文字コードを指定します。 サーバがサポートしていない文字コードを指定した場合はエラーとなります。 (この機能は現在動作しません。 将来のバージョンで検索クエリにASCII文字以外も含められるようにした時点で機能します。)|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|ThreadingAlgorithm|null|THREAD|THREADコマンドで使用するスレッド形式のアルゴリズムを指定します。|
***リクエストとIMAP URLに関するその他の留意事項
-現時点では検索クエリに日本語等非ASCII文字を含めることはできません。 URLエンコードした文字列を検索クエリに含めた場合でも、エンコードした結果に非ASCII文字が含まれるような場合はリクエスト時にWebExceptionをスローします。
-UIDVALIDITYを含むIMAP URLも扱えますが、無視します。 現時点ではUIDVALIDITYが指定されていない場合と同様に扱います。
**サンプル
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?ALL") as ImapWebRequest;
var request = WebRequest.Create("imap://user@localhost/INBOX?ALL") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Copy;
request.AllowCreateMailbox = true;
request.DestinationUri = new Uri("imap://user@localhost/INBOX.backup/");
request.DestinationUri = new Uri("imap://user@localhost/INBOX.backup");
using {
:
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.old/") as ImapWebRequest;
var request = WebRequest.Create("imap://user@localhost/INBOX.old") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Delete;
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.new/") as ImapWebRequest;
var request = WebRequest.Create("imap://user@localhost/INBOX.new") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Create;
}
}}
***メッセージの検索
ImapStyleUriBuilderを使って、複雑な検索クエリを含むリクエストを送信する例。
#code(cs){{
using System;
using System.Text;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.WebClients;
:
var builder = new ImapUriBuilder("imap://user@localhost/INBOX");
builder.SearchCriteria =
|;
builder.Charset = Encoding.GetEncoding(932);
var request = WebRequest.Create(builder.Uri) as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
using {
:
:
}
}}
この例で指定している検索クエリは、
+fromが'差出人'かつ送信日が2010年2月6日以前、もしくは
+未読で件名に'未承諾広告'を含まない
となる。
***メッセージへのフラグの設定
fromにspammer.example.comを含むメッセージをすべて既読にし、Thunderbirdの迷惑メールのマーク(Junk)を設定する例。 ImapStoreDataItem.ReplaceFlagsメソッドを使って新しく置き換える(設定する)フラグを作成し、StoreDataItemプロパティにしています。
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?from spammer.example.com") as ImapWebRequest;
var request = WebRequest.Create("imap://user@localhost/INBOX?from spammer.example.com") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Store;
public static void Main()
{
using {
session.Credentials = new NetworkCredential("user", "pass");
var cred = new NetworkCredential("user", "pass");
if {
if {
Console.WriteLine("authentication failed");
return;
}
};
using {
session.Credentials = new NetworkCredential("user", "pass");
var cred = new NetworkCredential("user", "pass");
if {
if {
Console.WriteLine("authentication failed");
return;
}
--[[works/libs/Smdn.Security.Authentication.Sasl]]
--[[works/libs/Smdn.Formats.Mime]]
*機能概要
*機能
すべての標準コマンドといくつかの拡張コマンドの送受信、SSL/TLS接続(IMAP over SSL, STARTTLS)、SASL認証メカニズムなどに対応しています。
使用可能なコマンド
:認証系コマンド|LOGIN, AUTHENTICATE, LOGOUT, STARTTLS
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
#googleadunit
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.24.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.22.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.21.tar.bz2}
--IDLEして5分程度経過すると、Mono.Security.Protocol.Tls.SslStreamBase.EndReadでMono.Security.Protocol.Tls.TlsExceptionがスローされる
*変更履歴
**0.24
主にIMAP URL関連の修正と、WebClients名前空間のクラスでの非ASCII文字を含む検索とpartial fetchのサポート。
-機能追加
--ImapUriBuilderの実装を追加
--WebClients名前空間
---検索クエリに非ASCII文字および同期リテラル・非同期リテラルを含むURLでのSEARCH/SORT/THREADをリクエストできるようにした
---/;SECTION=および/;PARTIAL=を含むURLでのリクエストできるようにした
---サーバがCOPYUIDレスポンスコードを返す場合、ImapWebResponse.ResponseUriに返されたUIDを含むURLを設定するようにした
---ImapWebRequest.Subscriptionプロパティを追加
---ImapWebResponse.SupportedCharsetsプロパティを追加
-修正・改善
--IMAP URL関連
---ImapStyleUriParserの実装を整理、&urn2url(urn:ietf:rfc:5092){IMAP URL Scheme};に従った動作となるようにエスケープされた文字を含むURLの取扱いを修正
---クエリのデリミタのみを含むURL(例 imap://localhost/INBOX/?)が検索クエリを含んでいないと判断される不具合を修正
---ImapMailbox.Url, ImapMessage.Urlのメールボックス名がModified UTF7でエンコードされていたものを、UTF-8+URLエンコードでエンコードするように修正
---ImapMailbox.Url, ImapMessage.Urlのメールボックス名を'/'で終端しないようにした
---クエリ・UIDなどが含まれていてメールボックス名を含まないURL(例 imap://localhost/?...、imap://localhost/;uid=1)を不正なURLとして扱うようにした
---Modified-UTF7エンコードされたメールボックス名が含まれているURLからメールボックス名を取得する場合、デコードせずModified-UTF7エンコードされたままの値を取得するようにした
---URLのクエリに同期リテラルを含む場合、非同期リテラルに書き換えた上でSEARCHコマンドを開始するようにした
--コマンド送受信関連
---BADCHASETレスポンスコードに文字コードが含まれている場合、パースエラーとなる不具合を修正
---長さを指定せず開始オクテットのみの指定でpartial fetchできてしまう不具合を修正
---空のsequence-set, uid-setと結合した場合に、文字列中に不要な','が含まれる不具合を修正
---ImapSession.EndAppendが呼ばれる前にImapSession.BeginAppendを呼んでも例外とならない場合がある不具合を修正
---ImapSession.BeginAppendを呼び出した場合、処理が開始されるまではIAsyncResultを返さないようにした
---saved result($)を含むImapMatchedSequenceSetのToArrayを呼んだ場合、NotSupportedExceptionをスローするようにした
---接続時に不正なレスポンスを受信した場合、タイムアウトまで待ち合わせず、即座にImapConnectionExceptionをスローするようにした
--認証処理関連
---ImapSession.Credentialsプロパティを廃止し、ICredentialsByHostは認証系メソッドの引数で受け渡すように変更
---認証時に参照するNetworkCredentialのUserNameおよびPasswordプロパティがnullだった場合の動作を整理、例外をスローせず認証をキャンセルするようにした
--WebClients名前空間
---ImapWebRequest.SearchCriteriaEncodingプロパティを削除
---APPENDコマンドでのRequestStreamへの書き込み中に、書き込み遅延が起きていなくてもバッファーアンダーランが発生する不具合を修正
---サーバがLITERAL+に対応していても、APPENDコマンドでは常に同期リテラルを使用するようにした
---サーバがLITERAL+に対応していない場合で、URLのクエリ部分にリテラルを含む場合、ProtocolViolationExceptionをスローするようにした
---FETCHコマンドでのメッセージの属性とメッセージ本文の取得を単一のコマンドで行うようにした
---FETCHコマンドで取得するメッセージの属性を、ALLマクロ相当からFULLマクロ相当の値に変更
**0.23
主に未サポートだった拡張の実装、メールボックス操作系コマンドの実装不備の修正。
-.NET Framework 3.5
-Mono 2.7
*制限事項
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
*制限事項・特記事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
*参考文献
#amazon(4873110289,left,content)
|CLOSE|&urn2url(urn:ietf:rfc:3501,#6.4.2,short);|&color(green){implemented};||
|EXPUNGE|&urn2url(urn:ietf:rfc:3501,#6.4.3,short);|&color(green){implemented};||
|SEARCH, UID SEARCH|&urn2url(urn:ietf:rfc:3501,#6.4.4,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.6,short);|&color(green){implemented};|非ASCII文字での検索に対応&sub{*2};|
|FETCH, UID FETCH|&urn2url(urn:ietf:rfc:3501,#6.4.5,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.4,short);|&color(orange){partially implemented};|HEADER, HEADER.FIELDS, HEADER.FIELDS.NOT, MIME, TEXTのFETCHは未実装です。 またbody-extension fieldsはレスポンスに含まれていても無視します。|
|FETCH, UID FETCH|&urn2url(urn:ietf:rfc:3501,#6.4.5,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.4,short);|&color(green){implemented};|body-extension fieldsはレスポンスに含まれていても無視します。|
|STORE, UID STORE|&urn2url(urn:ietf:rfc:3501,#6.4.6,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short); &urn2url(urn:ietf:rfc:4466,#2.5,short);|&color(green){implemented};||
|COPY, UID COPY|&urn2url(urn:ietf:rfc:3501,#6.4.7,short); &urn2url(urn:ietf:rfc:3501,#6.4.11,short);|&color(green){implemented};|Modified UTF-7対応&sub{*1};|
|~Extensions|-|-|-|
:Modified UTF-7対応&sub{*1};|メールボックス名に非ASCII文字を含む場合、自動的にModified UTF-7に変換します。
:非ASCII文字での検索に対応&sub{*2};|文字コードには任意のSystem.Text.Encodingを指定できます。 明示的に指定しない場合はUTF-8を使用します。
&urn2url(urn:ietf:rfc:5255);への対応はまだ不完全です。
**response codes
サポートするレスポンスコードの一覧です。
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ここに記載されているものはversion 0.24時点のもので、記載不備などがあるかもしれません。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Pop3.WebClients名前空間の説明を参照してください。
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
|DeleteAfterRetrieve|false|RETR|RETRコマンドでのメッセージの受信が成功した場合、同じメッセージに対して自動的にDELEコマンドを発行します。|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
--[[works/libs/Smdn.Formats.Mime]]
*機能
使用可能なコマンド
すべての標準コマンドといくつかの拡張コマンドの送受信、SSL/TLS接続(POP over SSL, STLS)、SASL認証メカニズムなどに対応しています。
使用可能なコマンド。
:認証系コマンド|USER, PASS, QUIT, APOP, AUTH(&urn2url(urn:ietf:rfc:5034,short);)
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
#googleadunit
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
デモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.24.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.22.tar.bz2}
-0.1x
--[[POP3 Extension Mechanism:http://www.iana.org/assignments/pop3-extension-mechanism]]
*変更履歴
**0.24
-機能追加
--拡張コマンドなど任意のコマンドを送信するためのメソッドを追加
--WebClients名前空間
---PopWebRequest.DeleteAfterRetrieveプロパティを追加
-修正・改善
--PopSession.Credentialsプロパティを廃止し、ICredentialsByHostは認証系メソッドの引数で受け渡すように変更
--認証時に参照するNetworkCredentialのUserNameおよびPasswordプロパティがnullだった場合の動作を整理、例外をスローせず認証をキャンセルするようにした
--PopStyleUriParserの実装を整理、&urn2url(urn:ietf:rfc:2384){POP URL Scheme};に従った動作となるようにエスケープされた文字を含むURLの取扱いを修正
--接続時に不正なレスポンスを受信した場合、タイムアウトまで待ち合わせず、即座にPopConnectionExceptionをスローするように修正
**0.23
-機能追加
--&urn2url(urn:ietf:rfc:2449,#8){Extended POP3 Response Codes};に対応
-.NET Framework 3.5
-Mono 2.7
*制限事項
ただし、Windows上での動作確認は不十分です。 テストはしていますが、予期しないバグがあるかもしれません。
*制限事項・特記事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。 SSL/TLS接続を使用するか、セキュリティが保証されたネットワーク内での使用を推奨します。
*参考文献
#amazon(4873110289,left,content)
|&urn2url(urn:ietf:rfc:4422,anchor-text);|EXTERNAL|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4505,anchor-text);|ANONYMOUS|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4752,anchor-text);|GSSAPI|&color(gray){not implemented};||
|[[[MS-NLMP:http://msdn.microsoft.com/en-us/library/cc236621(PROT.13).aspx]]] NT LAN Manager{partially implemented};|Mono.Security.dllを使用します。 Mono.Security.dllを動的にロードできない環境では使用できません。 また、サーバ側の実装によっては正しく動作しない可能性があります。|
|[[[MS-NLMP:http://msdn.microsoft.com/en-us/library/cc236621(PROT.13).aspx]]] NT LAN Manager{partially implemented};|サーバ側の実装によっては正しく動作しない可能性があります。|
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-*|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1-PLUS|&color(gray){not implemented};||
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.24.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.22.tar.bz2}
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.24
-Mono.Security.dllがない環境でも動作するように、Mono.Security.Protocol.Ntlmの実装をインポート
-認証時に参照するNetworkCredentialのUserNameおよびPasswordプロパティがnullだった場合の動作を整理
**0.23
-initial client responseを取得するメソッドを追加
**0.21
-[[works/libs/Smdn.Net.Imap4]]より分離
*制限事項・特記事項
-本ライブラリには、NTLM認証でのチャレンジレスポンスの実装として、Mono.Security.Protocol.Ntlmのクラスを含んでいます。
-実装にあたり、セキュリティ上の考慮はしていますが、保証はできません。
*関連するページ
-[[programming/mono/Mono.Security.Protocol.Ntlm]]
-[[programming/tips/cram_md5]]
${smdncms:title,TundereBird}
${smdncms:parser_options,non-limited-list}
*概要
IMAP4・POP3対応のメールクライアントです。 実用を目的としたものではなく、下記ライブラリのサンプル兼デモ用アプリケーションです。
-[[works/libs/Smdn.Net.Imap4]]
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.23.tar.bz2}
---下記ライブラリのソースを同梱しています
----[[works/libs/Smdn.Net.Imap4]] 0.23
----[[works/libs/Smdn.Net.Pop3]] 0.23
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.23
----[[works/libs/Smdn.Formats.Mime]] 0.16
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.22.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[works/libs/Smdn.Net.Imap4]] 0.22
---[[works/libs/Smdn.Net.Pop3]] 0.22
---[[works/libs/Smdn.Security.Authentication.Sasl]] 0.22
---[[works/libs/Smdn.Formats.Mime]] 0.16
---[[works/libs/Smdn.Formats.Ini]] 0.16
----[[works/libs/Smdn.Net.Imap4]] 0.22
----[[works/libs/Smdn.Net.Pop3]] 0.22
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.22
----[[works/libs/Smdn.Formats.Mime]] 0.16
----[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.21.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[works/libs/Smdn.Net.Imap4]] 0.21
---[[works/libs/Smdn.Security.Authentication.Sasl]] 0.21
---[[works/libs/Smdn.Formats.Mime]] 0.15
---[[works/libs/Smdn.Formats.Ini]] 0.15
----[[works/libs/Smdn.Net.Imap4]] 0.21
----[[works/libs/Smdn.Security.Authentication.Sasl]] 0.21
----[[works/libs/Smdn.Formats.Mime]] 0.15
----[[works/libs/Smdn.Formats.Ini]] 0.15
--${smdncms:distfilelink,TundereBird-0.20.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.20
---[[works/libs/Smdn.Formats.Mime]] 0.14
---[[works/libs/Smdn.Formats.Ini]] 0.14
----[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.20
----[[works/libs/Smdn.Formats.Mime]] 0.14
----[[works/libs/Smdn.Formats.Ini]] 0.14
-0.1x
--${smdncms:distfilelink,TundereBird-0.13.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.13
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.13
---[[works/libs/Smdn.Formats.Mime]] 0.13
---[[works/libs/Smdn.Formats.Ini]] 0.13
----[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.13
----[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.13
----[[works/libs/Smdn.Formats.Mime]] 0.13
----[[works/libs/Smdn.Formats.Ini]] 0.13
--${smdncms:distfilelink,TundereBird-0.12.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.12
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.12
---[[works/libs/Smdn.Formats.Mime]] 0.12
---[[works/libs/Smdn.Formats.Ini]] 0.12
----[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.12
----[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.12
----[[works/libs/Smdn.Formats.Mime]] 0.12
----[[works/libs/Smdn.Formats.Ini]] 0.12
--${smdncms:distfilelink,TundereBird-0.11.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.11
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.11
---[[works/libs/Smdn.Formats.Mime]] 0.11
---[[works/libs/Smdn.Formats.Ini]] 0.11
----[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.11
----[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.11
----[[works/libs/Smdn.Formats.Mime]] 0.11
----[[works/libs/Smdn.Formats.Ini]] 0.11
--${smdncms:distfilelink,TundereBird-0.10.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.10
---[[works/libs/Smdn.Formats.Mime]] 0.10
---[[works/libs/Smdn.Formats.Ini]] 0.10
----[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.10
----[[works/libs/Smdn.Formats.Mime]] 0.10
----[[works/libs/Smdn.Formats.Ini]] 0.10
*使い方
+tunderebird.iniを開いてアカウント情報を記入してから起動してください。
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.23
-機能追加
--IMAP
---階層中に存在しないメールボックスがあっても正しく表示できるようにした
---Gimap XLISTに対応している場合、'Trash'の代わりに\Trashフラグを持つメールボックスをゴミ箱として使用するようにした
-修正・改善
--IMAP
---メールボックス名を変更する際に、階層も変えられるように修正
**0.22
-機能追加
--POP3のサポートを再追加
|ImapWebRequestMethods.Delete, "DELETE"|DELETEコマンドを送信してメールボックスを削除します。|削除しようとするメールボックスに対してUNSUBSCRIBEコマンドを送信してから削除します。&br;削除しようとするメールボックスにメッセージがある場合は削除に失敗するので、STOREやEXPUNGEでメッセージを削除してからメールボックスを削除する必要があります。|-|
|ImapWebRequestMethods.Rename, "RENAME"|RENAMEコマンドを送信してメールボックスの名前を変更します。|変更後のメールボックス名はImapWebRequest.DestinationUriプロパティで指定します。|名前を変更した後のメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、名前を変更した後のメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Check, "CHECK"|CHECKコマンドを送信します。|このコマンドは何もしません。 CHECKコマンドの動作、レスポンスの内容はサーバの実装によります。|-|
|ImapWebRequestMethods.Select, "SELECT"|SELECTコマンドを送信してメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Examine, "EXAMINE"|EXAMINEコマンドを送信して読み取り専用でメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Select, "SELECT"|SELECTコマンドを送信してメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、選択したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Examine, "EXAMINE"|EXAMINEコマンドを送信して読み取り専用でメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、選択したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Subscribe, "SUBSCRIBE"|SUBSCRIBEコマンドを送信してメールボックスの購読を開始します。|-|-|
|ImapWebRequestMethods.Unsubscribe, "UNSUBSCRIBE"|UNSUBSCRIBEコマンドを送信してメールボックスの購読を解除します。|-|-|
|Methodプロパティ|リクエスト|解説|レスポンス|f
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
:メールボックス操作系コマンド|
::標準コマンド|CREATE, RENAME, DELETE, CLOSE, SELECT, EXAMINE, LIST, LSUB, STATUS, SUBSCRIBE, UNSUBSCRIBE
::拡張コマンド|RLIST, RLSUB, UNSELECT, NAMESPACE
::拡張コマンド|RLIST, RLSUB, LIST(LIST-EXTENDED), XLIST(Gimap), UNSELECT, NAMESPACE
:メッセージ操作系コマンド|
::標準コマンド|APPEND,SEARCH, EXPUNGE
::拡張コマンド|(UID)SORT,, UID EXPUNGE
:その他のコマンド|
::標準コマンド|NOOP, CHECK, CAPABILITY
::拡張コマンド|ENABLE, COMPRESS, IDLE, ID
::拡張コマンド|ENABLE, COMPRESS, IDLE, ID, COMPARATOR, LANGUAGE
実装しているクライアントは次の二種類です。
:ImapSessionクラス|IMAPコマンドと1対1に対応するメソッドを持つクライアント
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.22.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.21.tar.bz2}
--${smdncms:distfilelink,Smdn.Protocols.Imap4-0.20.tar.bz2}
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
-既知の不具合
--IDLEして5分程度経過すると、Mono.Security.Protocol.Tls.SslStreamBase.EndReadでMono.Security.Protocol.Tls.TlsExceptionがスローされる
*変更履歴
**0.23
主に未サポートだった拡張の実装、メールボックス操作系コマンドの実装不備の修正。
-機能追加
--&urn2url(urn:ietf:rfc:4959){SASL-IR};に対応
--&urn2url(urn:ietf:rfc:5255){COMPARATOR};に対応(実機での動作は未確認)
--&urn2url(urn:ietf:rfc:5255){LANGUAGE};に対応(実機での動作は未確認)
--Gimap XLISTコマンドに対応
--&urn2url(urn:ietf:id:ietf-morg-list-specialuse-00){Extension to IMAP CREATE command to set special-use flags};に対応
--&urn2url(urn:ietf:id:ietf-morg-status-in-list-01,short);に対応
--ImapMailbox.Url, ImapMessage.UrlにUIDVALIDTYを含めるようにした
--コマンドを発行する際に引数のチェックを行い、ArgumentExceptionをスローするようにした(未完了につき不完全)
--プロトコル上不正な以下の操作を行おうとした場合、ImapProtocolViolationException(SystemExceptionから派生)をスローするようにした
---選択済みメールボックスに対してSTATUSしようとした場合
---\NoSelectフラグが設定されているメールボックスに対してSTATUSしようとした場合
---\NoSelectフラグが設定されていて、下位のメールボックスを持つ既知のメールボックスをDELETEしようとした場合
---既知のメールボックス名にRENAMEしようとした場合
---既知のメールボックス名でCREATEしようとした場合
---INBOXをCREATEしようとした場合
---上記以外でInvalidOperationExceptionをスローしていた箇所はImapProtocolViolationExceptionに変更
--コマンド処理中にタイムアウト値を変更しようとした場合、InvalidOperationExceptionをスローするようにした
--ImapSession.ServerID, ImapSession.ServerCapabilitiesに対してコレクションの変更を行おうとした場合、NotSupportedExceptionをスローするようにした
--WebClients名前空間
---XLISTコマンドを発行できるようにした
---RENAMEに成功した後、変更前のメールボックスをUNSUBSCRIBEするようにした
---RENAMEに成功した後、下位のメールボックスに対してSUBSCRIBE/UNSUBSCRIBEするようにした
---DELETEに成功した後、削除したメールボックスをUNSUBSCRIBEするようにした
---COPYで自動的にメールボックスを作成した後、作成したメールボックスをSUBSCRIBEするようにした
---単一のメッセージを表すURL形式でもCOPYできるようにした
---サーバがサポートしない機能を使用しようとした場合、およびプロトコル上不正な操作を行おうとした場合、System.Net.ProtocolViolationExceptionをスローするようにした
-修正・改善
--受信したレスポンスをstringで保持する機能を削除
--コマンド[LIST "" ""]を送信できない、レスポンスを受信できない不具合を修正
--同一メッセージのFETCHレスポンスが複数に分割して返された場合、複数のメッセージとして解釈してしまう不具合を修正
--RLSUB/RLISTのレスポンスを正しく取得していない不具合を修正
--ImapSession.HandlesIncapableAsExceptionがtrueの場合かつ、サーバがIMAP4rev1に対応していないかCAPABILITYコマンド未発行の場合、CAPABILITYコマンドが発行できない不具合を修正
--RENAMEで下位のメールボックスをもつメールボックスの名前を変更した場合、内部で管理している下位のメールボックス名も変更するようにした
--切断状態になった時点でImapSession.SelectedMailboxをnullにするように修正
--選択済みメールボックスに対してRENAMEしても例外を送出しないように変更
--選択済みメールボックスに対してDELETEしても例外を送出しないように変更
--ImapSession.BeginIdleメソッドでIDLEを開始した後、継続要求応答もしくはエラー応答が返されるまではIAsyncResultを返さないように変更
--ImapSession.Idleメソッドでタイムアウト時間を指定してIDLEを開始した場合、エラー応答が返された場合は即座に結果を返すように変更
--ImapSession.StatusChangedイベントを廃止し、ImapSession.Idleメソッドへコールバック用のデリゲートを指定できるように変更
--ImapSession.(Begin)IdleメソッドでIDLEを開始した後TraceSourceにアイドル中であることを出力する間隔を、ImapSession.ReceiveTimeoutから30秒の固定値に変更
**0.22
主にWebClients名前空間のクラスの改善。
*動作状況
以下のIMAPサーバに対して概ね問題なく動作することを確認済みです。
-GMail
-Dovecot
-Dovecot
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-[[IMAPプロトコルの流れを学ぶ:http://www.atmarkit.co.jp/fmobile/rensai/imap04/imap04.html]]
-[[IMAP4 and CRAM-MD5 Authentication:http://vision.kuee.kyoto-u.ac.jp/~nob/doc/cram-md5/cram-md5.html]]
-[[APOPとIMAP(CRAM-MD5)をC#で使おう:http://mobiquitous.com/programming/apop-imap.html]]
-[[The IMAP Conneco-chan:http://www.lins.jp/~obata/imap/]]
|&urn2url(urn:ietf:rfc:2342,anchor-text);|NAMESPACE|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2595,anchor-text);|STARTTLS|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2595,anchor-text);|LOGINDISABLED|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2683,anchor-text);|-|&color(orange){partially implemented};||
|&urn2url(urn:ietf:rfc:2971,anchor-text);|ID|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3348,anchor-text);|CHILDREN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3501,anchor-text);|IMAP4rev1|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4466,anchor-text);|-|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4467,anchor-text);|URLAUTH|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4469,anchor-text);|CATENATE|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4549,anchor-text);|-|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4551,anchor-text);|CONDSTORE|&color(orange){partially implemented};||
|&urn2url(urn:ietf:rfc:4731,anchor-text);|ESEARCH|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4959,anchor-text);|SASL-IR|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4959,anchor-text);|SASL-IR|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4978,anchor-text);|COMPRESS=DEFLATE|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5032,anchor-text);|WITHIN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5092,anchor-text);|-|&color(orange){partially implemented};|URLAUTHは未実装です。 URLにUIDVALIDITYが指定されていてもUIDの検証は行いません。 [独自拡張]URLのスキームがimapsの場合、デフォルトポートとして993を使用し、SSLによる接続を試みます。|
|&urn2url(urn:ietf:rfc:5161,anchor-text);|ENABLE|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5162,anchor-text);|QRESYNC|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5182,anchor-text);|SEARCHRES|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|I18NLEVEL=1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|I18NLEVEL=2|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|LANGUAGE|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|I18NLEVEL=1|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|I18NLEVEL=2|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5255,anchor-text);|LANGUAGE|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5256,anchor-text);|SORT|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5256,anchor-text);|THREAD=ORDEREDSUBJECT|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5256,anchor-text);|THREAD=REFERENCES|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5257,anchor-text);|ANNOTATE-EXPERIMENT-1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5258,anchor-text);|LIST-EXTENDED|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5258,anchor-text);|LIST-EXTENDED|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5259,anchor-text);|CONVERT|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5267,anchor-text);|CONTEXT=SEARCH|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5267,anchor-text);|CONTEXT=SORT|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5530,anchor-text);|-|&color(green){implemented};||
|&urn2url(urn:ietf:id:ietf-morg-inthread-00,anchor-text);|SEARCH=INTHREAD|&color(green){implemented};||
|&urn2url(urn:ietf:id:ietf-morg-inthread-00,anchor-text);|THREAD=REFS|&color(green){implemented};||
|&urn2url(urn:ietf:id:ietf-morg-list-specialuse-00,anchor-text);|CREATE-SPECIAL-USE|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-morg-status-in-list-01,anchor-text);|LIST-STATUS|&color(green){implemented};||
|Gimap|XLIST|&color(green){implemented};||
|RFC|capability name|status|note|f
**commands
|SORT with RETURN result specifier|&urn2url(urn:ietf:rfc:4731,#3.1,short); &urn2url(urn:ietf:rfc:5182,#2.1,short); &urn2url(urn:ietf:id:ietf-morg-inthread-00,#3.5,short);|&color(green){implemented};||
|COMPRESS|&urn2url(urn:ietf:rfc:4978,#3,short);|&color(gray){not implemented};||
|ENABLE|&urn2url(urn:ietf:rfc:5161,#3.1,short);|&color(green){implemented};||
|LANGUAGE|&urn2url(urn:ietf:rfc:5255,#3.2,short);|&color(gray){not implemented};||
|COMPARATOR|&urn2url(urn:ietf:rfc:5255,#4.7,short);|&color(gray){not implemented};||
|LANGUAGE|&urn2url(urn:ietf:rfc:5255,#3.2,short);|&color(red){not tested};||
|COMPARATOR|&urn2url(urn:ietf:rfc:5255,#4.7,short);|&color(red){not tested};||
|SORT, UID SORT|&urn2url(urn:ietf:rfc:5256,#3,short);|&color(green){implemented};|非ASCII文字での検索に対応&sub{*2};|
|THREAD, UID THREAD|&urn2url(urn:ietf:rfc:5256,#3,short);|&color(green){implemented};|非ASCII文字での検索に対応&sub{*2};|
|CONVERSIONS|&urn2url(urn:ietf:rfc:5259,#5.1,short);|&color(gray){not implemented};||
|GETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.2,short);|&color(gray){not implemented};||
|SETMETADATA|&urn2url(urn:ietf:rfc:5464,#4.3,short);|&color(gray){not implemented};||
|NOTIFY|&urn2url(urn:ietf:rfc:5465,#3.1,short);|&color(gray){not implemented};||
|CREATE with special-use flags|&urn2url(urn:ietf:id:ietf-morg-list-specialuse-00,anchor-text);|&color(gray){not implemented};||
|LIST with STATUS return option|&urn2url(urn:ietf:id:ietf-morg-status-in-list-01,anchor-text);|&color(green){implemented};||
|XLIST{implemented};||
|command|RFC|status|note|f
:Modified UTF-7対応&sub{*1};|メールボックス名に非ASCII文字を含む場合、自動的にModified UTF-7に変換します。
|COMPRESSIONACTIVE|&urn2url(urn:ietf:rfc:4978,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|CLOSED|&urn2url(urn:ietf:rfc:5162,short);|&color(gray){not implemented};||
|NOTSAVED|&urn2url(urn:ietf:rfc:5182,short);|&color(green){implemented};||
|BADCOMPARATOR|&urn2url(urn:ietf:rfc:5255,short);|&color(gray){not implemented};||
|BADCOMPARATOR|&urn2url(urn:ietf:rfc:5255,short);|&color(orange){partially implemented};|通常のNOレスポンスと同様&sub{*1};に扱います。|
|ANNOTATE|&urn2url(urn:ietf:rfc:5257,short);|&color(gray){not implemented};||
|ANNOTATIONS|&urn2url(urn:ietf:rfc:5257,short);|&color(gray){not implemented};||
|TEMPFAIL|&urn2url(urn:ietf:rfc:5259,short);|&color(gray){not implemented};||
:通常のレスポンスと同様&sub{*1};|そのレスポンスを受信したということだけを検知します。 レスポンスに応じた処理を行うといったことはしません。
**関連リンク
-[[Wg Status Pages:http://tools.ietf.org/wg/]]
--[[Eai Status Pages:http://tools.ietf.org/wg/eai/]]
--[[Morg Status Pages:http://tools.ietf.org/wg/morg/]]
-[[IANA — Protocol Registries:http://www.iana.org/protocols/]]
--[[Internet Message Access Protocol 4 Capabilities Registry:http://www.iana.org/assignments/imap4-capabilities]]
--[[IMAP Response Codes:http://www.iana.org/assignments/imap-response-codes/imap-response-codes.xhtml]]
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
//|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.22.tar.bz2}
-0.1x
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*実装済み機能一覧
サポートするPOP標準仕様・拡張仕様の一覧です。
:&color(green){implemented};|実装済みの機能
一部不完全な箇所があったり、仕様と異なる実装になっているかもしれません
:&color(orange){partially implemented};|部分的に実装済みの機能
コマンドの送受信のみサポートする、仕様の一部のみをサポートする、などの状態です
:&color(red){not tested};|実装済みだが動作確認できていない機能
:&color(gray){not implemented};|実装されていない機能
|RFC|status|note|h
|&urn2url(urn:ietf:rfc:1939,anchor-text);|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2384,anchor-text);|&color(green){implemented};|[独自拡張]URLのスキームがpopsの場合、デフォルトポートとして995を使用し、SSLによる接続を試みます。 また、修飾子;MSG=が含まれている場合、メールボックス内の特定のメッセージを表すURLとして解釈します。|
|&urn2url(urn:ietf:rfc:2449,anchor-text);|&color(orange){partially implemented};|LOGIN-DELAY, PIPELINING, EXPIREに関連する機能は未実装です。 また、レスポンスコードが含まれていても通常のレスポンスと同様&sub{*1};に扱います。|
|&urn2url(urn:ietf:rfc:2595,anchor-text);|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:3206,anchor-text);|&color(orange){partially implemented};|レスポンスコードが含まれていても通常のレスポンスと同様&sub{*1};に扱います。|
|&urn2url(urn:ietf:rfc:5034,anchor-text);|&color(green){implemented};||
|&urn2url(urn:ietf:id:ietf-eai-pop-09,anchor-text);|&color(gray){not implemented};||
|RFC|status|note|f
:通常のレスポンスと同様&sub{*1};|そのレスポンスを受信したということだけを検知します。 レスポンスに応じた処理を行うといったことはしません。
**関連リンク
-[[Wg Status Pages:http://tools.ietf.org/wg/]]
--[[Eai Status Pages:http://tools.ietf.org/wg/eai/]]
--[[Morg Status Pages:http://tools.ietf.org/wg/morg/]]
-[[IANA — Protocol Registries:http://www.iana.org/protocols/]]
--[[POP3 Extension Mechanism:http://www.iana.org/assignments/pop3-extension-mechanism]]
*変更履歴
**0.23
-機能追加
--&urn2url(urn:ietf:rfc:2449,#8){Extended POP3 Response Codes};に対応
--AUTHコマンドを発行する場合、可能なら応答を待たずにinitial-responseを送信するようにした
--プロトコル上不正な以下の操作を行おうとした場合、PopProtocolViolationException(SystemExceptionから派生)をスローするようにした
---InvalidOperationExceptionをスローしていた箇所はImapProtocolViolationExceptionに変更
--PopSession.ServerCapabilitiesに対してコレクションの変更を行おうとした場合、NotSupportedExceptionをスローするようにした
--WebClients名前空間
---PopWebRequest.ExpectedErrorResponseCodesプロパティを追加
---サーバがサポートしない機能を使用しようとした場合、およびプロトコル上不正な操作を行おうとした場合、System.Net.ProtocolViolationExceptionをスローするようにした
-修正・改善
--受信したレスポンスをstringで保持する機能を削除
**0.22
-[[works/libs/Smdn.Net.Imap4]]をベースに再実装
-PopWebRequest/PopWebResponseクラスの実装を追加
*動作状況
以下のPOPサーバに対して概ね問題なく動作することを確認済みです。
-GMail
-Dovecot
-Dovecot
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
${smdncms:keywords,Smdn.Security.Authentication.Sasl,SASL,DIGEST-MD5,CRAM-MD5,C#,.NET,ライブラリ}
C#で書いた.NET Framework/Mono用SASLクライアントライブラリです。 IMAP4クライアントライブラリ[[works/libs/Smdn.Net.Imap4]]およびPOP3クライアントライブラリ[[works/libs/Smdn.Net.Pop3]]にてSASLによる認証処理で使用しています。
*機能概要
*実装済み機能一覧
サポートするSASLメカニズムの一覧です。
|RFC|mechanism name|status|note|h
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1-PLUS|&color(gray){not implemented};||
|RFC|mechanism name|status|note|f
使い方・実装は[[works/libs/Smdn.Net.Imap4]]および[[works/libs/Smdn.Net.Pop3]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
使い方・認証処理の実装は[[works/libs/Smdn.Net.Imap4]]および[[works/libs/Smdn.Net.Pop3]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*ダウンロード
#googleadunit
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.23.tar.bz2}
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.22.tar.bz2}
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.23
-initial client responseを取得するメソッドを追加
**0.22
-[[works/libs/Smdn.Net.Imap4]], [[works/libs/Smdn.Net.Pop3]]バージョンアップに伴うリリース
**0.21
-[[works/libs/Smdn.Net.Imap4]]より分離
**関連するページ
*関連するページ
-[[programming/mono/Mono.Security.Protocol.Ntlm]]
-[[programming/tips/cram_md5]]
**関連リンク
*関連リンク
-[[IANA — Protocol Registries:http://www.iana.org/protocols/]]
--[[SIMPLE AUTHENTICATION AND SECURITY LAYER MECHANISMS:http://www.iana.org/assignments/sasl-mechanisms]]
${smdncms:title,TundereBird}
*概要
IMAP4対応のメールクライアントです。 実用を目的としたものではなく、下記ライブラリのサンプル兼デモ用アプリケーションです。
IMAP4・POP3対応のメールクライアントです。 実用を目的としたものではなく、下記ライブラリのサンプル兼デモ用アプリケーションです。
-[[works/libs/Smdn.Net.Imap4]]
-[[works/libs/Smdn.Net.Pop3]]
-[[works/libs/Smdn.Security.Authentication.Sasl]]
-[[works/libs/Smdn.Formats.Mime]]
-[[works/libs/Smdn.Formats.Ini]]
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.22.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[works/libs/Smdn.Net.Imap4]] 0.22
---[[works/libs/Smdn.Net.Pop3]] 0.22
---[[works/libs/Smdn.Security.Authentication.Sasl]] 0.22
---[[works/libs/Smdn.Formats.Mime]] 0.16
---[[works/libs/Smdn.Formats.Ini]] 0.16
--${smdncms:distfilelink,TundereBird-0.21.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.21
---[[works/libs/Smdn.Net.Imap4]] 0.21
---[[works/libs/Smdn.Security.Authentication.Sasl]] 0.21
---[[works/libs/Smdn.Formats.Mime]] 0.15
---[[works/libs/Smdn.Formats.Ini]] 0.15
--${smdncms:distfilelink,TundereBird-0.20.tar.bz2}
--${smdncms:distfilelink,TundereBird-0.13.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.13
---[[works/libs/Smdn.Protocols.Pop3]] 0.13
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.13
---[[works/libs/Smdn.Formats.Mime]] 0.13
---[[works/libs/Smdn.Formats.Ini]] 0.13
--${smdncms:distfilelink,TundereBird-0.12.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.12
---[[works/libs/Smdn.Protocols.Pop3]] 0.12
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.12
---[[works/libs/Smdn.Formats.Mime]] 0.12
---[[works/libs/Smdn.Formats.Ini]] 0.12
--${smdncms:distfilelink,TundereBird-0.11.zip}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.11
---[[works/libs/Smdn.Protocols.Pop3]] 0.11
---[[Smdn.Protocols.Pop3>works/libs/Smdn.Net.Pop3]] 0.11
---[[works/libs/Smdn.Formats.Mime]] 0.11
---[[works/libs/Smdn.Formats.Ini]] 0.11
--${smdncms:distfilelink,TundereBird-0.10.zip}
+Visual Studioではログ出力により動作が遅くなる場合があります。 遅くなる場合は、tunderebird.exe.configを編集してログを出力しないようにしてください。
*不具合・要望・質問等
ライブラリに関する不具合・要望・質問は[[掲示板>misc/forum/libs]]へどうぞ。
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.22
-機能追加
--POP3のサポートを再追加
--設定ファイルにタイムアウト時間を指定するTimeoutキーを追加
**0.21
-機能追加
--設定ファイルにメールボックスの選択時にSELECTとEXAMINEのどちらを使用するか指定するReadOnlyキーを追加
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClient名前空間の説明を参照してください。
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClients名前空間の説明を参照してください。
**メッセージのダウンロード
WebClientクラスを使って、localhostのINBOXメールボックスからUIDが1のメールをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
using System;
using System.Net;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
class Sample {
public static void Main(string[] args)
using System.IO;
using System.Net;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
class Sample {
public static void Main(string[] args)
using System;
using System.Net;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
class Sample {
public static void Main(string[] args)
}}
*ライブラリの設計と実装の概要
**クライアント
クライアントの実装は2種類あります。 一つはSmdn.Net.Imap4.Client.Session名前空間のImapSessionクラス、もう一つはSmdn.Net.Imap4.WebClient名前空間のImapWebRequest/ImapWebResponseクラスです。 Smdn.Net.Imap4.WebClient名前空間のクライアントは、System.Net.WebRequest/System.Net.WebResponseを継承したもので、内部でImapSessionクラスを使用しています。
クライアントの実装は2種類あります。 一つはSmdn.Net.Imap4.Client.Session名前空間のImapSessionクラス、もう一つはSmdn.Net.Imap4.WebClients名前空間のImapWebRequest/ImapWebResponseクラスです。 Smdn.Net.Imap4.WebClients名前空間のクライアントは、System.Net.WebRequest/System.Net.WebResponseを継承したもので、内部でImapSessionクラスを使用しています。
二つのクライアントのモデルと概要は次の通りです。
:ImapSessionクラス|IMAPのコマンドとほぼ1対1で対応するメソッドを持つクラスです。 IMAPの操作は抽象化していません。 仕様と1対1で対応するような実装にしてあります。
切断する/されるまで選択済みメールボックス・メールボックス毎のフラグ・サーバの能力・名前空間等のセッションの状態を保持します。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、読み込みのみの操作に関しては送信されるIMAPコマンドを意識せずに扱えます。
ImapWebRequest.KeepAliveプロパティでリクエスト毎にセッションを切断するか、ログイン状態を維持するかどうか設定できます。 また、送信するコマンドはImapWebRequest.Methodプロパティで変更できます。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、送信されるIMAPコマンドをあまり意識せずに扱えます。 メッセージのダウンロード・アップロードにWebClientクラスのメソッドを使うこともできます。
FtpWebRequest等と同様、WebRequest.Methodプロパティで送信するコマンドを制御できます。
**認証
以下でクライアント実装に共通する部分について解説します。 個々のクライアント実装の詳細については各項を参照してください。
**資格情報
認証時に必要なユーザ名・パスワードはSystem.Net.ICredentialsByHostインターフェイスを通して取得します。 ICredentialsインターフェイスではなく、ICredentialsByHostインターフェイスを実装していて、GetCredentialメソッドが適切なSystem.Net.NetworkCredentialを返すクラスなら何でも設定できます。
ImapWebRequest.Credentialsプロパティは、WebRequestから継承しているためICredentialsインターフェイスを実装していることを要求しますが、同時にICredentialsByHostを実装していない場合は例外をスローします。
ImapWebRequest.CredentialsプロパティはWebRequestから継承しているためICredentialsインターフェイスを実装していることを要求しますが、設定されるインスタンスはICredentialsByHostも実装している必要があります。
**証明書の選択と検証
認証時に使用する証明書はX509Certificate2Collectionで設定できます。 また、証明書の選択と検証にはRemoteCertificateValidationCallbackデリゲートとLocalCertificateSelectionCallbackデリゲートを使用できます。
SSL/TLS接続時に使用する証明書はX509Certificate2Collectionで設定できます。 また、証明書の選択と検証にはRemoteCertificateValidationCallbackデリゲートとLocalCertificateSelectionCallbackデリゲートを使用できます。
|*証明書に関する型と該当するメンバ(いずれもクラス・プロパティ)
|~証明書に関する型|>|~該当するメンバ|
|~|~Smdn.Net.Imap4.Protocol.Client名前空間|~Smdn.Net.Imap4.WebClient名前空間|
|~証明書に関する型|>|~該当するメンバ|h
|~|~Smdn.Net.Imap4.Protocol.Client名前空間|~Smdn.Net.Imap4.WebClients名前空間|
|X509Certificate2Collection|ImapConnection.CertCollection|ImapSessionManager.CertCollection|
|RemoteCertificateValidationCallback|ImapConnection.CertificateValidationCallback|ImapSessionManager.CertificateValidationCallback|
|LocalCertificateSelectionCallback|ImapConnection.CertificateSelectionCallback|ImapSessionManager.CertificateSelectionCallback|
ImapSessionクラスには、IMAPコマンドと1対1に対応するメソッドが用意されています。 また、すべてのコマンドの引数とレスポンスのデータ構造は、それに対応する型が定義されています。 これらの型は出来る限り仕様と1対1で対応するように実装してあり、IMAPの詳細が分からなくても使えることを目的とするような抽象化はしていません。
**メールボックスのインスタンス
メールボックスの情報はImapMailboxクラスに保持されます。 このクラスのインスタンスは、LISTコマンド等により作成された後は、ログアウトするまでライブラリ側で管理されます。 同じメールボックスに対してSELECTしたりRENAMEした場合はインスタンスの値のみが更新され、常に同じインスタンスが返されます。
メールボックスの情報はImapMailboxクラスに保持されます。 このクラスのインスタンスは、LIST/SELECT/CREATEコマンド等により作成された後は、ログアウトするまでライブラリ側で管理されます。 同じメールボックスに対してSELECTしたりRENAMEした場合はインスタンスの値のみが更新され、常に同じインスタンスが返されます。
**ログ
シンボルTRACEを有効にしてビルドした場合、トレースにログを出力します。 ログにはパスワードを含む送受信内容を解読可能な状態で出力します。 ログの出力が不要な場合はTrace.csを削除するか、TRACEを無効にしてリビルドしてください。
シンボルTRACEを有効にしてビルドした場合、トレースにログを出力します。 ログにはパスワードを含む内容を平文で出力します。 ログの出力が不要な場合はTrace.csを削除するか、TRACEを無効にしてリビルドしてください。
|*ログ出力に使用するTraceSourceの名前と出力内容
|TraceSource|出力内容|h
|Smdn.Net.Imap4.Client|サーバとの送受信内容とセッション毎の動作ログを出力します。|
|Smdn.Net.Imap4.Client#Connection|サーバとの送受信内容のみを出力します。|
|TraceSourceの名前|出力内容|h
|Smdn.Net.Imap4.Client|コマンドの送受信結果とセッション毎の動作ログを出力します。|
|Smdn.Net.MessageAccessProtocols|送信するコマンドと受信したレスポンスの内容を出力します。|
*Smdn.Net.Imap4.WebClients名前空間
ここではSmdn.Net.Imap4.WebClients名前空間のクラスの詳細と使い方を紹介します。 基本的にはHttpWebRequest/ResponseやFtpWebRequest/Responseと同様で、
+URLを指定してWebRequest.CreateでWebRequestのインスタンスを作成
+Method、Credentialsなどのプロパティを指定
+WebRequest.GetResponseでリクエストを実行、レスポンスを取得
+取得したWebResponseインスタンスを参照、必要に応じてWebResponse.GetResponseStreamメソッドを呼び出す
*Smdn.Net.Imap4.WebClient名前空間
Smdn.Net.Imap4.WebClient名前空間のクラスの使い方。
の順でIMAPコマンドを実行、レスポンスを取得できます。 以下でSmdn.Net.Imap4.WebClientsに固有な部分について解説します。
**imap, imapsスキームの登録
Smdn.Net.Imap4.WebClient名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
Smdn.Net.Imap4.WebClients名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、imapスキームおよびimapsスキームに対してImapSessionManagerを関連付けます。
**ログインと認証
認証に用いるユーザ名は、URLから取得します。 URLにユーザ名が指定されていない場合は、ANONYMOUS認証を行います。 パスワードはImapWebRequest.Credentialsを参照し、接続しようとしているホスト名とポート番号から適切なものを取得します。 使用する認証メカニズムもユーザ名同様にURLから取得しますが、省略した場合、"AUTH=*"が指定されている場合は対応している認証方法を順に試行します。
**リクエストURLと接続時の動作
***SSL/TLS・接続ポート
リクエストURLのスキームがimapsの場合は、常にSSL/TLSでの接続を試みます。 スキームがimapの場合は、ImapWebRequest.UseTlsIfAvailableプロパティがtrueで、かつサーバがSTARTTLSに対応している場合、認証を開始する前にSSL/TLSを使用した接続にアップグレードします。 URLでポート番号を指定しない場合、デフォルトのポート(imapは143、imapsは993)に接続します。
|*リクエストURLの形式と接続動作の例
|リクエストURLの形式|接続ポート|SSL/TLS|h
|imap://imap.example.net/|143|可能ならSSL/TLSへのアップグレードを試行|
|imap://imap.example.net:993/|993|可能ならSSL/TLSへのアップグレードを試行|
|imaps://imap.example.net/|993|常にSSL/TLSで接続|
|imaps://imap.example.net:10143/|10143|常にSSL/TLSで接続|
***認証
認証に用いるユーザ名は、リクエストURLから取得します。 パスワードはWebRequest.Credentialsプロパティを参照し、接続しようとしているホスト名・ポート番号および指定された認証メカニズムをもとに適切なものを取得します。 IMAP URLではFTPやHTTPのURLとは異なり、URLに平文パスワードを含めることが許可されていないので、リクエストURLからはパスワードを取得しません(指定されていても無視します)。
使用する認証メカニズムもユーザ名同様にURLから取得します。 省略した場合、もしくは"AUTH=*"が指定されている場合は次の順で認証を試行します。
+AUTHENTICATEコマンド
+LOGINコマンド
リクエストURLにユーザ名・認証メカニズムの両方とも指定されていない場合は、ANONYMOUS認証を行います。
|*リクエストURLの形式と認証動作の例
|リクエストURLの形式|ユーザ名|使用する認証メカニズム|h
|imap://user;AUTH=DIGEST-MD5@imap.example.net/|user|DIGEST-MD5|
|imap://;AUTH=DIGEST-MD5@imap.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|imap://user;AUTH=*@imap.example.net/&br;imap://user@imap.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|imap://;AUTH=ANONYMOUS@imap.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|imap://imap.example.net/|匿名ユーザ(anonymous)|ANONYMOUSもしくはLOGINコマンドを使用|
試行する認証メカニズムを制御するには、後述するImapWebRequest.UsingSaslMechanismsプロパティの値を変更してください。
**リクエストURLとリクエスト・レスポンスの動作
HTTPと異なり、IMAP URLではリクエストURLの形式によりリクエストの対象が変わります。
|*リクエストURLの形式とリクエストの対象
|リクエストURLの形式|リクエストの対象|h
|imap://imap.example.net/|URLで指定されたサーバ・アカウント|
|imap://imap.example.net/mailbox/|URLで指定されたメールボックス|
|imap://imap.example.net/mailbox/?...|URLで指定されたメールボックスにあるメッセージのうち、検索クエリに該当する全てのメッセージ|
|imap://imap.example.net/mailbox/;UID=1|URLで指定されたメールボックスにあるメッセージのうち、UIDに該当する特定のメッセージ|
WebRequest.Createメソッドが返すWebRequestインスタンスのMethodプロパティにデフォルトで設定される値は、リクエストURLの形式によって決まります。
ImapWebRequest.GetResponseの動作は、リクエストURLで表されるリクエストの対象と、WebRequest.Methodプロパティに設定する値によって変わります。 以下でリクエストURLの形式とMethodプロパティに指定可能な値、リクエストとレスポンスについて解説します。 ImapWebRequestクラスのプロパティのうち、リクエストに影響するその他のプロパティについては別項で説明します。
***サーバ・アカウントに対するリクエスト
リクエストURLがサーバ・アカウントを表す場合(imap://imap.example.net/の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Lsub, "LSUB"&br;(デフォルト)|LSUBコマンドを送信して購読中のメールボックスの一覧を取得します。|-|取得したメールボックスの一覧は、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.List, "LIST"|LISTコマンドを送信して全てのメールボックスの一覧を取得します。|-|取得したメールボックスの一覧は、ImapWebResponse.Mailboxesプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックスに対するリクエスト
リクエストURLがメールボックスを表す場合(imap://imap.example.net/mailbox/の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Append, "APPEND"|APPENDコマンドを送信してメールボックスにメッセージをアップロードします。|アップロードするメッセージはWebRequest.GetRequestStreamメソッドが返すStreamに書き込みます。 現在の実装では、リクエスト開始時にContentLengthの値が指定されているか、GetRequestStreamメソッドが返すStreamを閉じるまでアップロードは保留されます。 メッセージはMIME形式であるべきですが、ライブラリ側ではアップロードする内容をチェックしません。|サーバがアップロードしたメッセージのUIDを返す場合は、アップロードしたメッセージのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|EXPUNGEコマンドを送信してメールボックスから\Deletedフラグの付いたメッセージを削除します。|-|-|
|ImapWebRequestMethods.Create, "CREATE"|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|作成できた場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|作成したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、作成したメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Delete, "DELETE"|DELETEコマンドを送信してメールボックスを削除します。|削除しようとするメールボックスに対してUNSUBSCRIBEコマンドを送信してから削除します。&br;削除しようとするメールボックスにメッセージがある場合は削除に失敗するので、STOREやEXPUNGEでメッセージを削除してからメールボックスを削除する必要があります。|-|
|ImapWebRequestMethods.Rename, "RENAME"|RENAMEコマンドを送信してメールボックスの名前を変更します。|変更後のメールボックス名はImapWebRequest.DestinationUriプロパティで指定します。|名前を変更した後のメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。 また、名前を変更した後のメールボックスのURLがWebResponse.ResponseUriに設定されます。|
|ImapWebRequestMethods.Check, "CHECK"|CHECKコマンドを送信します。|このコマンドは何もしません。 CHECKコマンドの動作、レスポンスの内容はサーバの実装によります。|-|
|ImapWebRequestMethods.Select, "SELECT"|SELECTコマンドを送信してメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Examine, "EXAMINE"|EXAMINEコマンドを送信して読み取り専用でメールボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|選択したメールボックスは、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Subscribe, "SUBSCRIBE"|SUBSCRIBEコマンドを送信してメールボックスの購読を開始します。|-|-|
|ImapWebRequestMethods.Unsubscribe, "UNSUBSCRIBE"|UNSUBSCRIBEコマンドを送信してメールボックスの購読を解除します。|-|-|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックスに対する検索クエリを含むリクエスト
リクエストURLがメールボックスに対する検索クエリを表す場合(imap://imap.example.net/mailbox/?...の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Search, "SEARCH"&br;(デフォルト)|SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Copy, "COPY"|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|コピー先のメールボックスを自動的に作成した場合、作成したメールボックスはImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して検索クエリに該当するメッセージに\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、検索クエリに該当したメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信して検索クエリに該当するメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|ImapWebRequestMethods.Sort, "SORT"|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。&br;''サーバがSORT=* extensionをサポートしない場合、WebExceptionをスローします。''|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。|
|ImapWebRequestMethods.Thread, "THREAD"|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。&br;''サーバがTHREAD=* extensionをサポートしない場合、WebExceptionをスローします。''|取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***メールボックス内の特定のメッセージに対するリクエスト
リクエストURLが特定のメッセージを表す場合(imap://imap.example.net/mailbox/;UID=1の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.Fetch, "FETCH"&br;(デフォルト)|FETCHコマンドを送信してメッセージの本文を取得します。|該当するUIDのメッセージがない場合、WebExceptionStatus.SuccessのWebExceptionをスローします。|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得するメッセージのサイズはWebResponse.ContentLength、Content-TypeはWebResponse.ContentTypeプロパティに設定されます。|
|ImapWebRequestMethods.Expunge, "EXPUNGE"|STOREコマンドを送信して\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、URLで指定されたメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|-|
|ImapWebRequestMethods.Store, "STORE"|STOREコマンドを送信してメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|-|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***リクエスト対象に制限されないリクエスト
リクエストURLの形式によらず使用可能なコマンドのリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティに指定可能な値|リクエスト|解説|レスポンス|h
|ImapWebRequestMethods.NoOp, "NOOP"|NOOPコマンドを送信します。|このコマンドは何もしません。 自動ログアウトタイマの更新、セッションの接続性確認、新着メッセージの確認などに使います。|-|
|Methodプロパティに指定可能な値|リクエスト|解説|レスポンス|f
URLのスキームがimapの場合で、ポート番号を省略した場合はデフォルトでポート143に接続します。 imapsの場合でポート番号が指定されていない場合はデフォルトでポート993に接続します。 また、imapsの場合は、SSLでの接続を試みます。
***ImapWebRequestクラスのプロパティ
ImapWebRequestクラスにはMethodプロパティ以外にもコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*URLの形式と認証動作の例
|URLの形式|認証動作|h
|imap://user;AUTH=DIGEST-MD5@localhost/|ユーザ名'user'でDIGEST-MD5を使ってlocalhostのポート143に接続|
|imaps://user@localhost:10993/|ユーザ名'user'でlocalhostのポート10993にSSLで接続|
ImapWebRequest.KeepAliveプロパティにtrueを指定した場合は、リクエストが終了してもセッションは維持し、逆にfalseを指定した場合はリクエストが終了するとセッションを閉じます。 ImapWebRequest.KeepAliveプロパティのデフォルトはtrueです。
**URLの形式とリクエストの種類
HTTPと異なり、IMAP URLの形式によりリクエストする内容が変わります。
|*URLの形式とデフォルトのリクエスト内容
|URLの形式|リクエスト内容|h
|サーバを表す場合&br;(例: imap://example.com/)|サーバにあるメールボックスの一覧を取得します。|
|メールボックスを表す場合&br;(例: imap://example.com/INBOX/)|メールボックスにあるメッセージの一覧を取得します。|
|メールボックス内の単一のメッセージを表す場合&br;(例: imap://example.com/INBOX/;UID=1)|該当するUIDを持つメッセージの属性と本文を取得します。|
|メールボックスに対する検索クエリを含む場合&br;(例: imap://example.com/INBOX/?RECENT)|メールボックスにあるメッセージのうち、検索クエリに該当するものの一覧を取得します。|
リクエスト内容はImapWebRequest.Methodプロパティに設定する値によっても変わります。 URLがサーバを表す場合のリクエスト内容と動作・レスポンスは次の通りです。
|*サーバを表すURLでのリクエスト
|Methodプロパティの値|リクエスト内容|動作とレスポンス|h
|null, String.Empty&br;またはImapWebRequestMethods.Lsub|Methodを指定しない場合のデフォルトの動作です。&br;LSUBコマンドを送信してメールボックスの一覧を取得します。|取得したメールボックスの一覧は、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.List|LISTコマンドを送信してメールボックスの一覧を取得します。|取得したメールボックスの一覧は、ImapWebResponse.Mailboxesプロパティに設定されます。|
|ImapWebRequestMethods.Noop|NOOPコマンドを送信します。|このコマンドは何もしません。 自動ログアウトタイマの更新、セッションの接続性確認などに使います。|
URLがメールボックスを表す場合のリクエスト内容と動作・レスポンスは次の通りです。
|*メールボックスを表すURLでのリクエスト
|Methodプロパティの値|リクエスト内容|動作とレスポンス|h
|null, String.Empty&br;またはImapWebRequestMethods.Fetch|Methodを指定しない場合のデフォルトの動作です。&br;FETCHコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。&br;取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|
|ImapWebRequestMethods.Append|APPENDコマンドを送信してメールボックスにメッセージをアップロードします。|アップロードするメッセージはImapWebRequest.GetRequestStreamメソッドで取得したStreamに書き込みます。 メッセージはMIME形式であるべきですが、ライブラリ側ではアップロードする内容をチェックしません。|
|ImapWebRequestMethods.Create|CREATEコマンドを送信してURLで指定された名前でメールボックスを作成します。|作成できた場合、作成したメールボックスに対して自動的にSUBSCRIBEコマンドを送信します。|
|ImapWebRequestMethods.Delete|DELETEコマンドを送信してメールボックスを削除します。|削除しようとするメールボックスに対してUNSUBSCRIBEコマンドを送信してから削除します。&br;削除しようとするメールボックスにメッセージがある場合は削除に失敗するので、STOREやEXPUNGEでメッセージを削除してからメールボックスを削除する必要があります。|
|ImapWebRequestMethods.Expunge|EXPUNGEコマンドを送信してメールボックスから\Deletedフラグの付いたメッセージを削除します。||
|ImapWebRequestMethods.Examine|EXAMINEコマンドを送信して読み取り専用でメッセージボックスを選択します。|このコマンドは選択するだけで何もしません。 メールボックスの状態を取得する場合などに使います。|
|ImapWebRequestMethods.Rename|RENAMEコマンドを送信してメールボックスの名前を変更します。|変更後のメールボックス名はImapWebRequest.DestinationUriプロパティで指定します。|
|ImapWebRequestMethods.Subscribe|SUBSCRIBEコマンドを送信してメールボックスの購読を開始します。||
|ImapWebRequestMethods.Unsubscribe|UNSUBSCRIBEコマンドを送信してメールボックスの購読を解除します。||
URLが単一のメッセージを表す場合のリクエスト内容と動作・レスポンスは次の通りです。
|*単一のメッセージを表すURLでのリクエスト
|Methodプロパティの値|リクエスト内容|動作とレスポンス|h
|null, String.Empty&br;またはImapWebRequestMethods.Fetch|Methodを指定しない場合のデフォルトの動作です。&br;FETCHコマンドを送信してメッセージの本文を取得します。|メッセージ本文はImapWebResponse.GetResponseStreamメソッドで取得したStreamから読み込めます。|
|ImapWebRequestMethods.Expunge|STOREコマンドを送信して\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、URLで指定されたメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|
|ImapWebRequestMethods.Store|STOREコマンドを送信してメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|
URLが検索クエリを含む場合のリクエスト内容と動作・レスポンスは次の通りです。
|*検索クエリを含むURLでのリクエスト
|Methodプロパティの値|リクエスト内容|動作とレスポンス|h
|null, String.Empty&br;またはImapWebRequestMethods.Search|Methodを指定しない場合のデフォルトの動作です。&br;SEARCHコマンドを送信して検索クエリに該当するメッセージの一覧を取得します。|取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。&br;取得するのはメッセージの属性のみ(ALLマクロで取得されるフラグ、サイズ、internal date、エンベロープ)です。 メッセージ本文は取得しません。|
|ImapWebRequestMethods.Copy|COPYコマンドを送信して検索クエリに該当するメッセージを別のメールボックスにコピーします。|コピー先のメールボックスはImapWebRequest.DestinationUriプロパティで指定します。|
|ImapWebRequestMethods.Expunge|STOREコマンドを送信して検索クエリに該当するメッセージに\Deletedフラグを追加した後、EXPUNGEコマンドを送信してメッセージを削除します。|サーバが&urn2url(urn:ietf:rfc:4315,#2.1){UID EXPUNGE};に対応していない場合、検索クエリに該当したメッセージだけでなく''既に\Deletedフラグが設定されている他のメッセージも同時に削除されます''。|
|ImapWebRequestMethods.Store|STOREコマンドを送信して検索クエリに該当するメッセージにフラグを追加・削除・設定します。|追加・削除・設定するフラグはImapWebRequest.StoreDataItemプロパティで指定します。|
|ImapWebRequestMethods.Thread|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。 また、取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。&br;''サーバがTHREAD=* extensionをサポートしない場合、WebExceptionをスローします。''|
|ImapWebRequestMethods.Sort|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。 また、取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。&br;''サーバがSORT=* extensionをサポートしない場合、WebExceptionをスローします。''|
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
|ReadOnly|false|FETCH, SEARCH等|メールボックスを選択する際に、SELECTコマンドの代わりにEXAMINEコマンドを送信するかどうかを指定します。 メッセージに対する操作を行うコマンドを送信する場合に有効になります。 EXAMINEコマンドで選択したメールボックスのメッセージに対する操作の結果はサーバの実装によります。 ReadOnlyがtrueでもDELETEなどのコマンドには影響しません。|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。 現在の実装では、APPENDコマンドでTRYCREATEが返された場合でもメールボックスは作成せず、常にエラーとなります。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先メールボックス名、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前(WebRequest.RequestUri)と同一サーバ、同一ユーザである必要があります。 それ以外の場合、ArgumentExceptionをスローします。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|FetchBlockSize|10240|FETCH|FETCHコマンドでメッセージ本文を取得する際に、1回のFETCHコマンドで取得するブロックのサイズをバイト単位で指定します。|
***IMAP URLに関する注意事項など
-現時点では検索クエリに日本語等非ASCII文字を含めることはできません。 URLエンコードした文字列を検索クエリに含めた場合でも、エンコードした結果に非ASCII文字が含まれるような場合はリクエスト時にWebExceptionをスローします。
-UIDVALIDITYを含むIMAP URLも扱えますが、無視します。 現時点ではUIDVALIDITYが指定されていない場合と同様に扱います。
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
**ImapWebRequestクラスのプロパティ
ImapWebRequestクラスにはコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*WebRequestクラスから継承されるプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|Timeout|-1|全て|リクエストを開始してからレスポンスを取得するまでのタイムアウト時間を指定します。|
|ReadWriteTimeout|300000|全て|ソケット送受信のタイムアウト時間を指定します。|
|ContentLength|0|APPEND|メールボックスにアップロードするメッセージのサイズを指定します。|
以下のプロパティは、未テスト・不完全な実装に関連するプロパティです。 使用はできますが、今後廃止する可能性もあるので、現時点では使用を推奨できません。
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もログイン状態を維持するかどうかを指定します。|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、TLSを使用した接続に変更します。|
|UseDeflateIfAvailable|false|全て|サーバがサポートしている場合、DEFLATE圧縮アルゴリズムを使用した接続に変更します。 (この機能は現在動作しません。 trueにした場合、NotImplementedExceptionがスローされます)|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、WebExceptionがスローされません。|
|ReadOnly|false|FETCH, SEARCH等|メールボックスを選択する際に、SELECTコマンドの代わりにEXAMINEコマンドを送信するかどうかを指定します。 メッセージに対する操作を行うコマンドを送信する場合に有効になります。 EXAMINEコマンドで選択したメールボックスのメッセージに対する操作の結果はサーバの実装によります。 ReadOnlyがtrueでもDELETEなどのコマンドには影響しません。|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
|SearchCriteriaEncoding|Encoding.UTF8|SEARCH等|検索クエリのエンコードに使用する文字コードを指定します。 サーバがサポートしていない文字コードを指定した場合はエラーとなります。 (この機能は現在動作しません。 将来のバージョンで検索クエリにASCII文字以外も含められるようにした時点で機能します。)|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前と同一サーバ、同一ユーザである必要があります。 それ以外の場合、InvalidOperationExceptionをスローします。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|ThreadingAlgorithm|null|THREAD|THREADコマンドで使用するスレッド形式のアルゴリズムを指定します。|
***リクエストとIMAP URLに関するその他の留意事項
-現時点では検索クエリに日本語等非ASCII文字を含めることはできません。 URLエンコードした文字列を検索クエリに含めた場合でも、エンコードした結果に非ASCII文字が含まれるような場合はリクエスト時にWebExceptionをスローします。
-UIDVALIDITYを含むIMAP URLも扱えますが、無視します。 現時点ではUIDVALIDITYが指定されていない場合と同様に扱います。
**サンプル
***メッセージのコピー
INBOXにあるメッセージすべてをINBOX.backupにコピーする例。 AllowCreateMailboxプロパティをtrueにしておくことで、サーバがレスポンスコードTRYCREATEを返した場合は自動的にメールボックスを作成します。
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?ALL") as ImapWebRequest;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.old/") as ImapWebRequest;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.new/") as ImapWebRequest;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
using Smdn.Net.Imap4.WebClients;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?from spammer.example.com") as ImapWebRequest;
}}
*Smdn.Net.Imap4.Client.Session名前空間
Smdn.Net.Imap4.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Imap4.WebClientの各クラスの実装を参照してください。
Smdn.Net.Imap4.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Imap4.WebClientsの各クラスの実装を参照してください。
**サンプル
***ログインと各種コマンド送信の例
${smdncms:title,Smdn.Net.Imap4}
${smdncms:header_title,Smdn.Net.Imap4}
${smdncms:keywords,Smdn.Net.Imap4,IMAP,IMAP4,IMAP4rev1,C#,.NET,Mono,mail,クライアント,ライブラリ}
C#で書いた.NET Framework/Mono用IMAP4rev1クライアントライブラリです。 IMAPサーバからのメールボックスの管理(作成・削除・ステータスの取得など)、メッセージの検索・取得・アップロードなどが出来ます。
-姉妹品
--[[works/libs/Smdn.Net.Pop3]]
-関連ライブラリ
--[[works/libs/Smdn.Security.Authentication.Sasl]]
--[[works/libs/Smdn.Formats.Mime]]
*機能概要
使用可能なコマンド
:認証系コマンド|LOGIN, AUTHENTICATE, LOGOUT, STARTTLS
::認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
:メールボックス操作系コマンド|
::標準コマンド|CREATE, RENAME, DELETE, CLOSE, SELECT, EXAMINE, LIST, LSUB, STATUS, SUBSCRIBE, UNSUBSCRIBE
::拡張コマンド|RLIST, RLSUB, UNSELECT, NAMESPACE
実装しているクライアントは次の二種類です。
:ImapSessionクラス|IMAPコマンドと1対1に対応するメソッドを持つクライアント
:ImapWebRequest/ImapWebResponseクラス|WebRequest/WebResponseクラスから派生し、IMAP URLでの操作に対応したクライアント
:ImapWebRequest/ImapWebResponseクラス|WebRequest/WebResponseクラスから派生し、IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)での操作に対応したクライアント
その他、サポートしている機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。
使い方・サンプルコードは[[works/libs/Smdn.Net.Imap4/doc]]、機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*使い方・サンプルコード
もっとも簡単なサンプルコードとして、System.Net.WebClientクラスとIMAP URLを使ったメッセージのダウンロード方法を例示します。 Gmailアカウントにアクセスし、メッセージをダウンロードしてファイルに保存するサンプルです。
#code(cs){{
using System;
using System.Net;
using Smdn.Net.Imap4.WebClients;
class GimapFetchExample {
public static void Main()
{
ImapSessionManager.RegisterWebRequestPrefix();
ImapSessionManager.CertificateValidationCallback += delegate {
return true;
};
using {
client.Credentials = new NetworkCredential("username", "password");
client.DownloadFile("imaps://username@imap.gmail.com/INBOX/;UID=1", "message.eml");
}
}
}
}}
詳細・その他のサンプルコードは[[works/libs/Smdn.Net.Imap4/doc]]およびデモ用アプリケーション[[works/tools/junk/TundereBird]]をご覧ください。
*ダウンロード
#googleadunit
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.22.tar.bz2}
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.21.tar.bz2}
--${smdncms:distfilelink,Smdn.Protocols.Imap4-0.20.tar.bz2}
-0.1x
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.22
主にWebClients名前空間のクラスの改善。
-機能追加
--INBOXをDELETEしようとした場合、InvalidOperationExceptionをスローするようにした
--コマンド実行中にタイムアウトが発生した場合、TimeoutExceptionをスローするようにした
--コマンドを発行する際に引数のチェックを行い、ArgumentExceptionをスローするようにした(未完了につき不完全)
--WebClients名前空間
---任意の形式のIMAP URLでNOOPコマンドを発行できるようにした
---CHECKコマンド、SELECTコマンドを発行できるようにした
---リクエスト実行中にImapWebRequestの各プロパティを設定しようとした場合、InvalidOperationExceptionをスローするようにした
---ImapWebRequest.MethodプロパティおよびImapWebRequest.DestinationUriプロパティの値のチェックを、リクエスト実行時ではなく値の設定時に行うようにした
---ImapWebRequest.MethodプロパティがFETCHの場合、取得するメッセージのContent-TypeをWebResponse.ContentTypeプロパティに設定するようにした
---ImapWebRequest.UsingSaslMechanismsプロパティを追加
---ImapWebRequest.ReadWriteTimeoutプロパティを追加
---ImapWebRequest.FetchBlockSizeプロパティを追加
---WebClient.Download*Asyncメソッドから呼び出されても正しく動作するようにした
-修正・改善
--LIST/LSUBを発行せずにRENAMEすると例外エラーとなる不具合を修正
--ImapSession.ReceiveTimeoutを設定・取得しようとするとImapSession.SendTimeoutが設定・取得されてしまう不具合を修正
--タイムアウト関連の実装を整理
--タイムアウト・内部例外エラーが発生した場合、セッションを切断・破棄するように変更
--WebClients名前空間
---名前空間をWebClientからWebClient''s''に変更
---Imap*Exceptionなど内部で発生した例外をWebExceptionにラップしてスローするように修正
---STARTTLSを発行した後でも、レスポンス・メールボックス等のURLのスキーム部分をimapのままにするように修正
---AUTH=*の場合、LOGINDISABLEDが指示されていてもLOGINコマンドを発行してしまう不具合を修正
---ImapWebRequest.BeginGetResponseメソッドにコールバックメソッドを指定しても呼び出されない不具合を修正
---ImapWebRequest.KeepAliveプロパティがtrueの場合、異なるメールボックスを選択する際にUNSELECTコマンドを使用しないよう変更
---ImapWebRequest.MethodプロパティがNOOPの場合、NOOPコマンドが2回発行されてしまう不具合を修正
---ImapWebRequest.MethodプロパティがFETCHの場合、該当するメッセージが無い場合にWebExceptionStatus.SuccessのWebExceptionをスローするようにした
---ImapWebRequest.MethodプロパティがCOPYの場合、AllowCreateMailboxプロパティに指定されている値と逆の動作になる不具合を修正
---その他、HttpWebRequest・FtpWebRequest等と同じような動作となるように改善
-その他
--WebClients名前空間のテストケースを追加
--上記以外の細かい修正など
**0.21
-機能追加
--WebClient名前空間
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.7
-Mono 2.7
*制限事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
|&urn2url(urn:ietf:id:ietf-morg-inthread-00,anchor-text);|THREAD=REFS|&color(green){implemented};||
|RFC|capability name|status|note|f
**SASL mechanisms
サポートするSASL認証メカニズムの一覧です。
|RFC|mechanism name|status|note|h
|&urn2url(urn:ietf:rfc:1731,anchor-text);|KERBEROS_V4|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2195,anchor-text);|CRAM-MD5|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2444,anchor-text);|OTP|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2444,anchor-text);|SKEY|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2595,anchor-text);|PLAIN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2808,anchor-text);|SECURID|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2831,anchor-text);|DIGEST-MD5|&color(orange){partially implemented};|realmには対応していません。 また、サーバ側の実装によっては正しく動作しない可能性があります。|
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-RSA-SHA1-ENC|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-RSA-SHA1-ENC|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-DSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-DSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-ECDSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-ECDSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4422,anchor-text);|EXTERNAL|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4505,anchor-text);|ANONYMOUS|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4752,anchor-text);|GSSAPI|&color(gray){not implemented};||
|[[[MS-NLMP:http://msdn.microsoft.com/en-us/library/cc236621(PROT.13).aspx]]] NT LAN Manager{partially implemented};|Mono.Security.dllを使用します。 Mono.Security.dllを動的にロードできない環境では使用できません。 また、サーバ側の実装によっては正しく動作しない可能性があります。|
|RFC|mechanism name|status|note|f
--[[SIMPLE AUTHENTICATION AND SECURITY LAYER MECHANISMS:http://www.iana.org/assignments/sasl-mechanisms]]
-[[The IMAP Connection -- IMAP Documents: RFCs and Drafts:http://www.imap.org/biblio.html]]
-[[IMAP Server implementations:http://www.melnikov.ca/mel/devel/ServerReference.html]]
${smdncms:title,Smdn.Formats.Mime}
${smdncms:header_title,Smdn.Formats.Mime}
${smdncms:keywords,C#,.NET,Mono,MIME,ライブラリ}
C#で書いた.NET Framework/Mono用MIMEメッセージライブラリです。 MIME形式のメッセージの読み込み、デコードが出来ます。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.1x
--${smdncms:distfilelink,Smdn.Formats.Mime-0.16.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.15.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.14.tar.bz2}
--上記以前のバージョン
---[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*サンプル
emlファイルを読み込んでヘッダの一覧とボディの内容を表示する例。
*変更履歴
**0.16
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
**0.15
-機能追加
--添付ファイル・代替メッセージの作成機能、メッセージのエンコード・フォーマット機能を追加(ただしインターフェイスは未確定)
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Pop3]]のドキュメントとサンプルです。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Pop3.WebClients名前空間の説明を参照してください。
**メッセージのダウンロード
WebClientクラスを使って、localhostのメールボックスから1番目のメッセージをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs){{
using System;
using System.Net;
using Smdn.Net.Imap4.WebClients;
class Sample {
public static void Main(string[] args)
{
PopSessionManager.RegisterWebRequestPrefix();
using {
client.Credentials = new NetworkCredential("user", "pass");
client.DownloadFile("pop://user;AUTH=DIGEST-MD5@localhost/;MSG=1", "sample.eml");
}
}
}
}}
**メッセージ一覧の取得
WebRequestクラスを使って、Gmailアカウントのメールボックスからメールの一覧を取得し、もっとも最近のメールをダウンロード・表示する例。
#code(cs){{
using System;
using System.IO;
using System.Text;
using System.Net;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.WebClients;
class Sample {
public static void Main(string[] args)
{
PopSessionManager.RegisterWebRequestPrefix();
PopSessionManager.CertificateValidationCallback += delegate {
return true;
};
var baseUrl = new Uri("pops://user@pop.gmail.com/");
var credential = new NetworkCredential("user", "pass");
var request = WebRequest.Create(baseUrl) as PopWebRequest;
request.Credentials = credential;
request.Method = "LIST";
request.KeepAlive = true;
PopScanListing[] scanLists;
using {
scanLists = response.ScanLists;
}
var recentMessageUrl = string.Format("./;MSG={0}", scanLists[scanLists.Length - 1].MessageNumber);
request = WebRequest.Create(new Uri(baseUrl, recentMessageUrl)) as PopWebRequest;
request.Credentials = credential;
request.Method = "RETR";
request.KeepAlive = false;
using {
using {
var reader = new StreamReader(stream, Encoding.GetEncoding("iso-2022-jp"));
Console.WriteLine(reader.ReadToEnd());
}
}
}
}
}}
*ライブラリの設計と実装の概要
このドキュメントは作成中です。
[[works/libs/Smdn.Net.Imap4]]の[[works/libs/Smdn.Net.Imap4/doc]]を参照してください。 プロトコルに固有な部分をのぞき、設計・実装は[[works/libs/Smdn.Net.Imap4]]と同様です。
*Smdn.Net.Pop3.WebClients名前空間
ここではSmdn.Net.Pop3.WebClients名前空間のクラスの詳細と使い方を紹介します。 基本的にはHttpWebRequest/ResponseやFtpWebRequest/Responseと同様で、
+URLを指定してWebRequest.CreateでWebRequestのインスタンスを作成
+Method、Credentialsなどのプロパティを指定
+WebRequest.GetResponseでリクエストを実行、レスポンスを取得
+取得したWebResponseインスタンスを参照、必要に応じてWebResponse.GetResponseStreamメソッドを呼び出す
の順でPOPコマンドを実行、レスポンスを取得できます。 以下でSmdn.Net.Pop3.WebClientsに固有な部分について解説します。
**pop, popsスキームの登録
Smdn.Net.Pop3.WebClients名前空間のクラスを使う場合には、WebRequestクラスがpopスキームおよびpopsスキームのURLを処理できるようにPopSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、popスキームおよびpopsスキームに対してPopSessionManagerを関連付けます。
**リクエストURLと接続時の動作
***SSL/TLS・接続ポート
リクエストURLのスキームがpopsの場合は、常にSSL/TLSでの接続を試みます。 スキームがpopの場合は、PopWebRequest.UseTlsIfAvailableプロパティがtrueで、かつサーバがSTLSに対応している場合、認証を開始する前にSSL/TLSを使用した接続にアップグレードします。 URLでポート番号を指定しない場合、デフォルトのポート(popは110、popsは995)に接続します。
|*リクエストURLの形式と接続動作の例
|リクエストURLの形式|接続ポート|SSL/TLS|h
|pop://pop.example.net/|110|可能ならSSL/TLSへのアップグレードを試行|
|pop://pop.example.net:995/|995|可能ならSSL/TLSへのアップグレードを試行|
|pops://pop.example.net/|995|常にSSL/TLSで接続|
|pops://pop.example.net:10110/|10143|常にSSL/TLSで接続|
***認証
認証に用いるユーザ名は、リクエストURLから取得します。 パスワードはWebRequest.Credentialsプロパティを参照し、接続しようとしているホスト名・ポート番号および指定された認証メカニズムをもとに適切なものを取得します。 POP URLではFTPやHTTPのURLとは異なり、URLに平文パスワードを含めることが許可されていないので、リクエストURLからはパスワードを取得しません(指定されていても無視します)。
使用する認証メカニズムもユーザ名同様にURLから取得します。 APOPを使用する場合は、"AUTH=+APOP"を指定してください。 認証メカニズムを省略した場合、もしくは"AUTH=*"が指定されている場合は次の順で認証を試行します。
+AUTHコマンド
+APOPコマンド
+USER/PASSコマンド
リクエストURLにユーザ名・認証メカニズムの両方とも指定されていない場合は、ANONYMOUS認証を行います。
|*リクエストURLの形式と認証動作の例
|リクエストURLの形式|ユーザ名|使用する認証メカニズム|h
|pop://user;AUTH=+APOP@pop.example.net/|user|APOP|
|pop://user;AUTH=DIGEST-MD5@pop.example.net/|user|DIGEST-MD5|
|pop://;AUTH=DIGEST-MD5@pop.example.net/|WebRequest.Credentialsより取得|DIGEST-MD5|
|pop://user;AUTH=*@pop.example.net/&br;pop://user@pop.example.net/|user|サーバ・クライアントが対応しているものを順に試行|
|pop://;AUTH=ANONYMOUS@pop.example.net/|匿名ユーザ(anonymous)|ANONYMOUS|
|pop://pop.example.net/|匿名ユーザ(anonymous)|ANONYMOUSもしくはUSER/PASSコマンドを使用|
試行する認証メカニズムを制御するには、後述するPopWebRequest.UsingSaslMechanismsプロパティの値を変更してください。
**リクエストURLとリクエスト・レスポンスの動作
POP URL(&urn2url(urn:ietf:rfc:2384,short);)ではPOPサーバ(メールボックス)を表す形式しか規定されていませんが、本ライブラリでは独自の拡張としてメッセージ番号を指定してリクエストできるようにしてあります。 リクエストURLにメッセージ番号(;MSG=x)が含まれているかどうかでリクエストの対象が変わります。
|*リクエストURLの形式とリクエストの対象
|リクエストURLの形式|リクエストの対象|h
|pop://pop.example.net/|URLで指定されたメールボックス|
|pop://pop.example.net/;MSG=1|URLで指定されたメールボックスにあるメッセージのうち、メッセージ番号に該当する特定のメッセージ|
WebRequest.Createメソッドが返すWebRequestインスタンスのMethodプロパティにデフォルトで設定される値は、リクエストURLの形式によって決まります。
PopWebRequest.GetResponseの動作は、リクエストURLで表されるリクエストの対象と、WebRequest.Methodプロパティに設定する値によって変わります。 以下でリクエストURLの形式とMethodプロパティに指定可能な値、リクエストとレスポンスについて解説します。 PopWebRequestクラスのプロパティのうち、リクエストに影響するその他のプロパティについては別項で説明します。
***メールボックスに対するリクエスト
リクエストURLがメールボックスを表す場合(pop://pop.example.net/の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|PopWebRequestMethods.List, "LIST"&br;(デフォルト)|LISTコマンドを送信してメールボックスにあるメッセージの一覧を取得します。|-|取得したメッセージの一覧は、PopWebResponse.ScanListsプロパティに設定されます。|
|PopWebRequestMethods.Rset, "RSET"|RSETコマンドを送信してDELEコマンドの操作をキャンセルします。|-||
|PopWebRequestMethods.Stat, "STAT"|STATコマンドを送信してメールボックスにあるメッセージの数と総サイズを取得します。|-|取得したメッセージ数と総サイズは、PopWebResponse.DropListプロパティに設定されます。|
|PopWebRequestMethods.Uidl, "UIDL"|UIDLコマンドを送信してメールボックスにあるメッセージのIDの一覧を取得します。|-|取得したIDの一覧は、PopWebResponse.UniqueIdListsプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***特定のメッセージに対するリクエスト
リクエストURLが特定のメッセージを表す場合(pop://pop.example.net/;MSG=1の形式)のリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティ|リクエスト|解説|レスポンス|h
|PopWebRequestMethods.Retr, "RETR"&br;(デフォルト)|RETRコマンドを送信してメッセージの本文を取得します。|-|メッセージ本文はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得したメッセージのサイズはWebResponse.ContentLengthプロパティに設定されます。|
|PopWebRequestMethods.Dele, "DELE"|DELEコマンドを送信してメッセージを削除します。|-|-|
|PopWebRequestMethods.List, "LIST"|LISTコマンドを送信してメッセージの番号とサイズを取得します。|-|取得したメッセージ番号とサイズは、PopWebResponse.ScanListsプロパティに設定されます。|
|PopWebRequestMethods.Top, "TOP"|TOPコマンドを送信してメッセージをヘッダ部分を取得します。|現時点ではTOPで取得するボディ部分の行数は指定できません(常に0を指定します)。|メッセージのヘッダ部分はWebResponse.GetResponseStreamメソッドが返すStreamから読み込めます。 取得したヘッダ部分のサイズはWebResponse.ContentLengthプロパティに設定されます。|
|PopWebRequestMethods.Uidl, "UIDL"|UIDLコマンドを送信してメッセージの番号とIDを取得します。|-|取得したメッセージ番号とIDは、PopWebResponse.UniqueIdListsプロパティに設定されます。|
|Methodプロパティ|リクエスト|解説|レスポンス|f
***リクエスト対象に制限されないリクエスト
リクエストURLの形式によらず使用可能なコマンドのリクエストとレスポンスの動作は次のとおりです。
|Methodプロパティに指定可能な値|リクエスト|解説|レスポンス|h
|PopWebRequestMethods.NoOp, "NOOP"|NOOPコマンドを送信します。|このコマンドは何もしません。 自動ログアウトタイマの更新、セッションの接続性確認などに使います。|-|
|Methodプロパティに指定可能な値|リクエスト|解説|レスポンス|f
***PopWebRequestクラスのプロパティ
PopWebRequestクラスにはMethodプロパティ以外にもコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*PopWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もセッションを維持するかどうかを指定します。 trueの場合はリクエストが終了してもセッションは維持し、falseの場合はリクエストの度にセッションを開きリクエスト終了と同時にセッションを閉じます|
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、認証を行う前にTLSを使用した接続にアップグレードします。|
|UsingSaslMechanisms|{"DIGEST-MD5", "CRAM-MD5", "NTLM"}|全て(認証時)|認証メカニズムが指定されていない場合に、試行する認証メカニズムとその順番を配列で指定します。 サーバ・クライアントの両方がサポートするメカニズム以外が指定されている場合は無視します。|
//|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、エラーレスポンスでもWebExceptionがスローされません。|
WebRequestクラスから継承されるプロパティのうち、以下のプロパティは使用することができます。
|*WebRequestクラスから継承されるプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|Timeout|-1|全て|リクエストを開始してからレスポンスを取得するまでのタイムアウト時間を指定します。|
|ReadWriteTimeout|300000|全て|ソケット送受信のタイムアウト時間を指定します。|
*Smdn.Net.Pop3.Client.Session名前空間
Smdn.Net.Pop3.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Pop3.WebClientsの各クラスの実装を参照してください。
**Gmail
Gmailに接続し、メッセージの一覧を取得した後、一番最後のメッセージを取得し、表示するサンプル。
#code(cs){{
using System;
using System.IO;
using System.Text;
using System.Net;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client.Session;
using Smdn.Net.Pop3.Protocol.Client;
class Sample {
public static void Main(string[] args)
{
PopConnection.CertificateValidationCallback += delegate {
return true;
};
using {
session.Credentials = new NetworkCredential("user", "pass");
if {
Console.Error.WriteLine("authentication failed");
return;
}
PopScanListing[] scanLists;
session.List(out scanLists);
PopMessage message;
session.Retr(scanLists[scanLists.Length - 1].MessageNumber, out message);
var reader = new StreamReader(message.Body, Encoding.GetEncoding("iso-2022-jp"));
Console.WriteLine(reader.ReadToEnd());
}
}
}
}}
${smdncms:title,Smdn.Net.Pop3}
${smdncms:header_title,Smdn.Net.Pop3}
${smdncms:keywords,C#,.NET,Mono,POP,POP3}
C#で書いた.NET Framework/Mono用POP3クライアントライブラリです。 POPサーバからのメールボックスのステータス取得、メッセージのダウンロード・削除が出来ます。
*機能
現在対応している機能の一覧です。 部分的に対応しているものも含みます。
-認証
--APOP
--AUTH
--USER/PASS
--STLS
-コマンド
--STAT, LIST, RETR, DELE, NOOP, RSET, TOP, UIDL, QUIT
--CAPA
-その他
--RFC 2384 POP URL Scheme
RFC 1939で規定されているコマンドは概ね実装が完了しています。
-姉妹品
--[[works/libs/Smdn.Net.Imap4]]
-関連ライブラリ
--[[works/libs/Smdn.Security.Authentication.Sasl]]
--[[works/libs/Smdn.Formats.Mime]]
*ダウンロード
#googleadunit
[[works/tools/junk/TundereBird]]に含まれているものを使ってください。
*機能
使用可能なコマンド
:認証系コマンド|USER, PASS, QUIT, APOP, AUTH(&urn2url(urn:ietf:rfc:5034,short);)
::SASL認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
SASLの実装は[[works/libs/Smdn.Security.Authentication.Sasl]]に含まれています
:メッセージ操作系コマンド|STAT, LIST, RETR, DELE, TOP, UIDL, RSET
:その他のコマンド|NOOP, CAPA(&urn2url(urn:ietf:rfc:2449,short);), STLS(&urn2url(urn:ietf:rfc:2595,short);)
実装しているクライアントは次の二種類です。
:PopSessionクラス|POPコマンドと1対1に対応するメソッドを持つクライアント
:PopWebRequest/PopWebResponseクラス|WebRequest/WebResponseクラスから派生し、POP URL(&urn2url(urn:ietf:rfc:2384,short);)での操作に対応したクライアント
*サンプル
本ライブラリを使用して、GMail POPサーバからメールをダウンロードして本文を表示したあと、サーバ上のメールを削除する例です。
*使い方・サンプルコード
もっとも簡単なサンプルコードとして、System.Net.WebClientクラスとPOP URLを使ったメッセージのダウンロード方法を例示します。 Gmailアカウントにアクセスし、メッセージをダウンロードしてファイルに保存するサンプルです。
#code(cs){{
using System;
using Smdn.Protocols.Pop3;
using Smdn.Protocols.Pop3.Client;
using System.Net;
public class GmailRetrieveSample {
public static void Main(string[] args) {
using {
agent.Initialize();
agent.ServerCertificateValidationCallback = delegate {
return true;
};
using Smdn.Net.Pop3.WebClients;
var client = agent.CreateClient();
class GpopRetrieveExample {
public static void Main()
{
PopSessionManager.RegisterWebRequestPrefix();
PopSessionManager.CertificateValidationCallback += delegate {
return true;
};
using {
client.Credentials = new NetworkCredential("username", "password");
client.DownloadFile("pops://username@pop.gmail.com/;MSG=1", "message.eml");
}
}
}
}}
client.HostUri = new PopUri("pop://username;AUTH=*@pop.gmail.com:995/");
client.Password = "password";
client.UseSsl = true;
この例で使用している修飾子(;MSG=1)はPOP URLに対する独自の拡張です。 詳細・その他のサンプルコードは[[works/libs/Smdn.Net.Pop3/doc]]およびデモ用アプリケーション[[works/tools/junk/TundereBird]]をご覧ください。
client.Login();
*ダウンロード
#googleadunit
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
foreach {
client.Retrieve(message);
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Pop3.Client-0.22.tar.bz2}
-0.1x
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
Console.WriteLine(message.Body);
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
client.Delete(message);
}
*変更履歴
**0.22
-[[works/libs/Smdn.Net.Imap4]]をベースに再実装
-PopWebRequest/PopWebResponseクラスの実装を追加
-アセンブリ名・名前空間をSmdn.Protocols.Pop3からSmdn.Net.Pop3に改名
**0.13
-STLSコマンドによるTLSへのアップグレードに対応
-取得したメッセージの改行文字が環境によって変わってしまう不具合を修正
client.Logout();
}
}
}
}}
**0.12
-HMACMD5アルゴリズムの実装を独自の実装からライブラリ標準のクラスを用いたものに変更
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もご覧ください。
**0.11
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
*変更履歴
:0.13|STLSコマンドによるTLSへのアップグレードに対応
取得したメッセージの改行文字が環境によって変わってしまう不具合を修正
:0.12|HMACMD5アルゴリズムの実装を独自の実装からライブラリ標準のクラスを用いたものに変更
:0.11|[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
:0.10|初版
**0.10
-初版
*動作状況
以下のPOPサーバに対して動作することを確認済みです。
-Gpop(GMail)
-Dovecot
--1.0.rc17
以下のPOPサーバに対して概ね問題なく動作することを確認済みです。
-GMail
-Dovecot
以下の環境で動作することを確認済みです。
-.NET Framework 2.0.50727
-Mono 1.2.6
-Mono 1.9
*対応予定
今後対応する予定の機能です。
-RFC 3206 The SYS and AUTH POP Response Codes
-[[works/libs/Smdn.Net.Imap4]]と統合したバージョンの作成
-.NET Framework 3.5
-Mono 2.7
*注意
*制限事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
-本ライブラリはトレースにログを出力します。 ログにはパスワードを含む送受信内容を解読可能な状態で書き出します。 不要な場合はTrace.csを削除するか、TRACEオプションおよびDUMPオプションを外してリビルドしてください。
-タイムアウト処理を実装してありますが、タイムアウトさせると内部状態がおかしくなるので使わない方がいいです。
*参考文献
#amazon(4873110289,left,content)
${smdncms:title,Smdn.Security.Authentication.Sasl}
${smdncms:header_title,Smdn.Security.Authentication.Sasl}
${smdncms:keywords,Smdn.Security.Authentication.Sasl,SASL,DIGEST-MD5,CRAM-MD5,C#,.NET,ライブラリ}
C#で書いた.NET Framework/Mono用SASLクライアントライブラリです。 IMAP4クライアントライブラリ[[works/libs/Smdn.Net.Imap4]]およびPOP3クライアントライブラリ[[works/libs/Smdn.Net.Pop3]]にてSASLによる認証処理で使用しています。
*機能概要
サポートするSASLメカニズムの一覧です。
|RFC|mechanism name|status|note|h
|&urn2url(urn:ietf:rfc:1731,anchor-text);|KERBEROS_V4|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2195,anchor-text);|CRAM-MD5|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2444,anchor-text);|OTP|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2444,anchor-text);|SKEY|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2595,anchor-text);|PLAIN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:2808,anchor-text);|SECURID|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:2831,anchor-text);|DIGEST-MD5|&color(orange){partially implemented};|realmには対応していません。 また、サーバ側の実装によっては正しく動作しない可能性があります。|
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-RSA-SHA1-ENC|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-RSA-SHA1-ENC|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-DSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-DSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-U-ECDSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:3163,anchor-text);|9798-M-ECDSA-SHA1|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4422,anchor-text);|EXTERNAL|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4505,anchor-text);|ANONYMOUS|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4752,anchor-text);|GSSAPI|&color(gray){not implemented};||
|[[[MS-NLMP:http://msdn.microsoft.com/en-us/library/cc236621(PROT.13).aspx]]] NT LAN Manager{partially implemented};|Mono.Security.dllを使用します。 Mono.Security.dllを動的にロードできない環境では使用できません。 また、サーバ側の実装によっては正しく動作しない可能性があります。|
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-*|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1|&color(gray){not implemented};||
|&urn2url(urn:ietf:id:ietf-sasl-scram-10,anchor-text);|SCRAM-SHA-1-PLUS|&color(gray){not implemented};||
|RFC|mechanism name|status|note|f
使い方・実装は[[works/libs/Smdn.Net.Imap4]]および[[works/libs/Smdn.Net.Pop3]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*ダウンロード
#googleadunit
すべてMIT X11ライセンスでのリリースとなります。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Security.Authentication.Sasl-0.22.tar.bz2}
*不具合・要望・質問等
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
**0.22
-[[works/libs/Smdn.Net.Imap4]], [[works/libs/Smdn.Net.Pop3]]バージョンアップに伴うリリース
**0.21
-[[works/libs/Smdn.Net.Imap4]]より分離
**関連するページ
-[[programming/mono/Mono.Security.Protocol.Ntlm]]
-[[programming/tips/cram_md5]]
**関連リンク
-[[IANA — Protocol Registries:http://www.iana.org/protocols/]]
--[[SIMPLE AUTHENTICATION AND SECURITY LAYER MECHANISMS:http://www.iana.org/assignments/sasl-mechanisms]]
${smdncms:title,Smdn.Formats.Ini}
${smdncms:header_title,Smdn.Formats.Ini}
${smdncms:keywords,C#,.NET,Mono,Ini,ライブラリ}
C#で書いた.NET Framework/Mono用INIファイル読み込み/保存ライブラリです。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.1x
--${smdncms:distfilelink,Smdn.Formats.Ini-0.16.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Ini-0.15.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Ini-0.14.tar.bz2}
--上記以前のバージョン
---[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
不具合の報告、ライブラリに対する要望や提案、使い方の質問などは[[掲示板>misc/forum/libs]]へどうぞ。
*サンプル
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
}}
*変更履歴
**0.16
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
**0.15
-機能追加
--任意の型変換用デリゲート(Converter<string, TOutput>)を指定して値を取得できるようにした
cp -ipr repo_old/conf/* repo_old/conf/*
}}
**リポジトリの一部分を切り出す
ダンプファイルからリポジトリツリーの一部分を取り出したり除外したりするにはsvndumpfilterを使う。
#code{{
/
|-- mod_foo/
`-- mod_bar/
}}
例えば、上記のような構成のリポジトリから、mod_fooだけを切り出して一つのリポジトリを作成するには次のようにする。
まずリポジトリのダンプファイルを作成する。
#code(sh){{
svnadmin dump repo > repo.dump
}}
続いて、このダンプファイルから、mod_fooだけを含むようにsvndumpfilterでフィルタする。
#code(sh){{
svndumpfilter include mod_foo/ --drop-empty-revs --renumber-revs < repo.dump > mod_foo.dump
}}
後は、出来上がったmod_foo.dumpを新しいリポジトリにロードすることで、mod_fooだけを含むリポジトリを作成できる。
#code(sh){{
svnadmin create mod_foo
svnadmin load mod_foo < mod_foo.dump
}}
svndumpfilterで指定できるオプションは次のとおり。
:include|指定したパスを''含む''変更をフィルタして切り出す
:exclude|指定したパスを''除く''変更をフィルタして切り出す
:--drop-empty-revs|フィルタした結果、切り出すサブツリーに関係する変更がないリビジョンはダンプファイルに含めない
:--renumber-revs|フィルタした結果に、新しくリビジョン番号を振り直す
:--preserve-revprops|もとのリビジョン属性を維持する(リビジョン属性はフィルタしない)
**異なるバージョン間でのリポジトリ移動
あるバージョンのSubversionで管理されているリポジトリを、別のバージョンのSubversionで管理されている環境に移動する場合は、svnadmin dump/loadを使い次の手順で行う。
+バージョンAのsvnadminでリポジトリをダンプする
**最新版
#googleadunit
-パッケージ
--安定版 ${smdncms:distfilelink,ThbgmExtractor-1.4.2.lzh,version 1.4.2 パッケージ}
--プレビュー版 ${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.lzh,version 1.5.0pre パッケージ}
--安定版 ${smdncms:distfilelink,ThbgmExtractor-1.4.3.lzh,version 1.4.3 パッケージ}
--プレビュー版 ${smdncms:distfilelink,ThbgmExtractor-1.5.0-beta1.lzh,version 1.5.0 beta1 パッケージ}
-ソース
--開発版は[[anonsvn]]からチェックアウトできます
--${smdncms:distfilelink,ThbgmExtractor-1.4.2.tar.bz2,version 1.4.2 ソース}
--${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.tar.bz2,version 1.5.0pre ソース}
--${smdncms:distfilelink,ThbgmExtractor-1.4.3.tar.bz2,version 1.4.3 ソース}
--${smdncms:distfilelink,ThbgmExtractor-1.5.0-beta1.tar.bz2,version 1.5.0 beta1 ソース}
--ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります
各バージョンのパッケージに含まれる曲目ファイルは下記のとおりです。 表に無い作品、または×が付いている作品の音楽を抜き出す場合は別途曲目ファイルを用意してください。
**過去のバージョン
-パッケージ
--version 1.5系
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.lzh,version 1.5.0pre パッケージ}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev253.lzh,version 1.5.0pre パッケージ}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.lzh,version 1.5.0pre}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.lzh,version 1.5.0pre}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev253.lzh,version 1.5.0pre}
--version 1.4系
---${smdncms:distfilelink,ThbgmExtractor-1.4.2.lzh,version 1.4.2}
---${smdncms:distfilelink,ThbgmExtractor-1.4.1.lzh,version 1.4.1}
---${smdncms:distfilelink,ThbgmExtractor-1.4.lzh,version 1.4}
---${smdncms:distfilelink,ThbgmExtractor-1.4-beta2.lzh,version 1.4 beta2}
---${smdncms:distfilelink,thbgmextractor_exe.lzh,version 1.0}
-ソース
--version 1.5系(ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります)
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.tar.bz2,version 1.5.0pre}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.tar.bz2,version 1.5.0pre}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev253.tar.bz2,version 1.5.0pre}
--version 1.4系(ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります)
---${smdncms:distfilelink,ThbgmExtractor-1.4.2.tar.bz2,version 1.4.2}
---${smdncms:distfilelink,ThbgmExtractor-1.4.1.tar.bz2,version 1.4.1}
---${smdncms:distfilelink,ThbgmExtractor-1.4.tar.bz2,version 1.4}
---${smdncms:distfilelink,ThbgmExtractor-1.4-beta2.tar.bz2,version 1.4 beta2}
---${smdncms:distfilelink,thbgmextractor_src.lzh,version 1.0}
**曲目ファイル
上記のパッケージに含まれていない曲目ファイルは、以下からダウンロードしてください。 曲目ファイルはexeファイルと同じ位置にコピーしてください。
-製品版用曲目ファイル
--${smdncms:distfilelink,titles_th10.txt,「東方風神録」用曲目ファイル}
--${smdncms:distfilelink,titles_th09.txt,「東方花映塚」用曲目ファイル}
--${smdncms:distfilelink,titles_th08.txt,「東方永夜抄」用曲目ファイル}
--${smdncms:distfilelink,titles_th07.txt,「東方妖々夢」用曲目ファイル}
-体験版用曲目ファイル
--${smdncms:distfilelink,titles_th10tr.txt,「東方風神録 体験版」用曲目ファイル}
--${smdncms:distfilelink,titles_th09tr.txt,「東方花映塚 体験版」用曲目ファイル}
--${smdncms:distfilelink,titles_th08tr.txt,「東方永夜抄 体験版」用曲目ファイル}
version 1.3以前のパッケージに含まれていない曲目ファイルは、[[anonsvn]]の以下の場所で取得できます。 曲目ファイルはexeファイルと同じ位置にコピーしてください。
-http://smdn.invisiblefulmoon.net/anonsvn/tools/ThbgmExtractor/tags/20071027_release-1.3/src/ThbgmExtractor/Titles/
また、以下のサイトにて公開されている曲目ファイルも使用できます。
:[[Variabler Stern:http://variabler-stern.sakura.ne.jp/]]さん|東方妖々夢以降の作品の曲目ファイルが公開されています。
:[[また〜り不定期日記（仮）:http://www.selena-net.com/~piabrpg/mata-ri/tohotool.html]]さん|東方妖々夢体験版以降の作品および上海アリス幻樂団以外の作品の曲目ファイルが公開されています。
version 1.4以降の曲目ファイルのフォーマットについては、[[works/libs/Smdn.Formats.Thbgm]]を参照してください。
version 1.4以降の曲目ファイルのフォーマットについては、[[works/libs/Smdn.Formats.Thbgm]]を参照してください。 最新の曲目ファイルは[[anonsvn]]の以下の場所で取得できます。
-http://smdn.invisiblefulmoon.net/anonsvn/libs/Smdn/trunk/Smdn.Formats.Thbgm/
*必須環境・動作確認済み環境
-必須
--Ubuntu 9.10 + Mono 2.5
*使い方の簡単な説明
**version 1.5
準備中、version 1.4の説明を参照してください。
**version 1.4
設定など気にせずとにかく抜き出せればいいのであれば、thbgm.datをThbgmExtractor.exeにドラッグアンドドロップするだけで抜き出しを開始できます。 Waveファイルの出力先を設定すればデフォルトの設定で抜き出しを開始します。
#ref(thbgmextractor_howto_1_4_fastest.jpg,thbgm.datをThbgmExtractor.exeにドラッグアンドドロップすれば抜き出しを開始します)
英語の翻訳を修正してくれる方、英語以外の言語(主に繁体字中国語・ロシア語あたり)に翻訳してくれる方を募集しています。
*変更履歴
**version 1.5.0 beta1
-機能追加
--標準入力を経由してエンコードできるようにした
--抜き出し・エンコード後のファイルにタグ付けできるようにした
--リスト上でもエフェクトの各値を編集できるようにした
--出力ファイル名をトラック毎に編集できるようにした
--リスト上で抜き出し・エンコード処理の進捗を表示するようにした
-修正・改善
--機能追加に伴いデフォルトのEncoders.confの内容を修正
--抜き出し・エンコード・タグ付け処理の実装を改良
--WAVE出力時、dataチャンクを2048バイト単位でアラインメントためのJUNKチャンクをヘッダに付記するように修正
--1.4.3と同様の修正・改善
**version 1.5.0pre
-機能追加
--出力ファイルサイズをリストに表示するようにした
--case sensitiveな環境ではTitles_*.txt, TITLES_*.TXTなどの曲目ファイルを読み込まない不具合を修正
--起動後、読み込んだ曲目ファイルを開いたままになっている不具合を修正
**version 1.4.3
-修正・改善
--libasoundのsoファイルのパスを設定ファイル(Smdn.Media.Alsa.dll.config)で変更出来るように改善、デフォルトをlibasound.so.2に変更
--波形表示部分を隠そうとした場合にエラーとならないように修正
--波形上のアンカーをポイントしたときのカーソルを水平矢印にするように変更
**version 1.4.2
-修正・改善
--LAME等のエンコーダを使用する際に、ダメ文字を含む以下の曲目のエンコードに失敗する不具合を修正(1.3から1.4でのエンバグ)
#googleadunit
-パッケージ
--安定版 ${smdncms:distfilelink,ThbgmExtractor-1.4.2.lzh,version 1.4.2 パッケージ}
--プレビュー版 ${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.lzh,version 1.5.0pre パッケージ}
--プレビュー版 ${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.lzh,version 1.5.0pre パッケージ}
-ソース
--開発版は[[anonsvn]]からチェックアウトできます
--${smdncms:distfilelink,ThbgmExtractor-1.4.2.tar.bz2,version 1.4.2 ソース}
--${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.tar.bz2,version 1.5.0pre ソース}
--${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev320.tar.bz2,version 1.5.0pre ソース}
--ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります
各バージョンのパッケージに含まれる曲目ファイルは下記のとおりです。 表に無い作品、または×が付いている作品の音楽を抜き出す場合は別途曲目ファイルを用意してください。
**過去のバージョン
-パッケージ
--version 1.5系
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.lzh,version 1.5.0pre パッケージ}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev253.lzh,version 1.5.0pre パッケージ}
--version 1.4系
---${smdncms:distfilelink,ThbgmExtractor-1.4.1.lzh,version 1.4.1}
---${smdncms:distfilelink,thbgmextractor_exe.lzh,version 1.0}
-ソース
--version 1.5系(ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります)
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev290.tar.bz2,version 1.5.0pre}
---${smdncms:distfilelink,ThbgmExtractor-1.5.0pre-rev253.tar.bz2,version 1.5.0pre}
--version 1.4系(ソース中に含まれる各ライブラリはMIT X11ライセンスでのリリースとなります)
---${smdncms:distfilelink,ThbgmExtractor-1.4.1.tar.bz2,version 1.4.1}
英語の翻訳を修正してくれる方、英語以外の言語(主に繁体字中国語・ロシア語あたり)に翻訳してくれる方を募集しています。
*変更履歴
**version 1.5.0pre
-機能追加
--出力ファイルサイズをリストに表示するようにした
--全トラックの合計値・設定値をリストに表示するようにした
--選択したトラックを抜き出し・エンコードするメニュー項目を追加した
-修正・改善
--波形の描画速度を改善
--抜き出し中に別の抜き出しを開始できないように修正
--保存しても保存されていないと判断される不具合を修正
**version 1.5.0pre
-機能追加
--以下の形式のプレイリストを出力できるようにした
${smdncms:title,Mono 2.6のインストール}
${smdncms:keywords,Mono,2.6,ビルド,インストール,Ubuntu 9.10,Fedora 12}
[[Mono 2.6:http://www.mono-project.com/Main_Page]]をソースからビルドしてインストールする手順。 検証に使った環境はUbuntu 9.10 DesktopおよびFedora 12 Desktop。
-リンク
--[[Release Notes Mono 2.6 - Mono:http://www.mono-project.com/Release_Notes_Mono_2.6]]
--[[Download - Mono:http://www.go-mono.com/mono-downloads/download.html]]
-関連するページ
--[[programming/mono/install_trunk]]
--[[programming/mono]]
ここで紹介する手順は[[MonoDevelop 2.2>programming/mono/install_monodevelop_2.2]]を動作させるために必要なアセンブリ一式をインストールするためのもの。 ディストリビューションが提供しているバージョンのMonoと共存できるようにするため、/opt/monoにインストールする。
1つの環境に複数のMonoをインストールする方法については[[Parallel Mono Environments - Mono:http://www.mono-project.com/Parallel_Mono_Environments]]で詳しく解説されている。
ビルドにはgcc、libtool、autotools、gettext、pkg-config等が必要になるので、あらかじめインストールしておく必要がある。
#googleadunit
*libgdiplus
**依存するパッケージのインストール
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libcairo2-dev libexif-dev libfreetype6-dev libfontconfig1-dev libglib2.0-dev libjpeg62-dev libpng12-dev \
libtiff4-dev libungif4-dev libx11-dev libxrender-dev
}}
#code(sh,Fedoraの場合){{
yum install \
cairo-devel libexif-devel freetype-devel fontconfig-devel glib-devel libjpeg-devel libpng-devel \
libtiff-devel giflib-devel libX11-devel libXrender-devel
}}
**ソースのダウンロードとconfigure
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/libgdiplus/libgdiplus-2.6.tar.bz2
tar -xvf libgdiplus-2.6.tar.bz2
cd libgdiplus-2.6/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix = /opt/mono-2.6
* Cairo = 1.8.8
* Text = cairo
* EXIF tags = yes
* Codecs supported:
- TIFF: yes
- JPEG: yes
- GIF: yes
- PNG: yes
NOTE: if any of the above say 'no' you may install the
corresponding development packages for them, rerun
autogen.sh to include them in the build.
---
}}
**ビルド、インストール
configureした結果に問題が無ければmake、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
正しくインストールできたか確認する。
#code(sh){{
ls -l /opt/mono/lib/libgdiplus*
}}
*Mono本体(コンパイラ、クラスライブラリ)
**依存するパッケージのインストール
#code(sh,Ubuntuの場合){{
sudo apt-get install \
bison
}}
#code(sh,Fedoraの場合){{
yum install \
bison
}}
**ソースのダウンロードとconfigure
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/mono/mono-2.6.tar.bz2
tar -xvf mono-2.6.tar.bz2
cd mono-2.6/
./configure --prefix=/opt/mono --with-libgdiplus=installed --with-ikvm-native=no --with-profile2=yes --with-profile4=yes --with-moonlight=no --with-monotouch=no --with-mcs-docs=no
}}
configureの結果例。
#prompt{{
mcs source: $(top_srcdir)/mcs
olive source:
GC: included
GLIB: system
TLS: __thread
SIGALTSTACK: yes
Engine: Building and using the JIT
2.0 Profile: yes
Moon Profile: no
4.0 Alpha: yes
MonoTouch: no
JNI support:
libgdiplus: assumed to be installed
zlib: system zlib
oprofile: no
BigArrays: no
DTrace: no
Parallel Mark: yes
LLVM Back End: no
}}
-コンパイルオプションに関するドキュメント
--[[Advanced Mono Compile Options - Mono:http://www.mono-project.com/Advanced_Mono_Compile_Options]]
--[[Unsupported Advanced Mono Compile Options - Mono:http://www.mono-project.com/Unsupported_Advanced_Mono_Compile_Options]]
**ビルド、インストール
コンパイルする環境にMonoおよびmcsがない場合は、makeする前に最新のMonoLite([[Mono Daily Packages:http://mono.ximian.com/daily/]])を取得しておく。
#code(sh){{
make get-monolite-latest
}}
準備が整ったら、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
-コンパイルに関するドキュメント
--[[Compiling Mono From Tarball - Mono:http://www.mono-project.com/Compiling_Mono_From_Tarball]]
**動作確認
***新しくMonoをインストールした場合
mono -Vでmonoが動作することを確認する。
#prompt{{
$ mono -V
Mono JIT compiler version 2.6
Copyright 2002-2008 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm
SIGSEGV: altstack
Notifications: epoll
Architecture: x86
Disabled: none
}}
***既に別のバージョンのMonoが存在する環境にインストールした場合
新しく/opt/monoにインストールしたMonoを参照できるように、環境変数を設定するスクリプトを用意しておく。 参考: [[Parallel Mono Environments - Mono:http://www.mono-project.com/Parallel_Mono_Environments]]
#code(sh,mono-2.6-env){{
#!/bin/bash
MONO_PREFIX=/opt/mono
export DYLD_LIBRARY_PATH=$MONO_PREFIX/lib:$DYLD_LIBRARY_PATH
export LD_LIBRARY_PATH=$MONO_PREFIX/lib:$LD_LIBRARY_PATH
export C_INCLUDE_PATH=$MONO_PREFIX/include
export ACLOCAL_PATH=$MONO_PREFIX/share/aclocal
export PKG_CONFIG_PATH=$MONO_PREFIX/lib/pkgconfig
PATH=$MONO_PREFIX/bin:$PATH
}}
まずmono -Vで先にインストールされていたmonoが動作することを確認する。
#prompt(Ubuntuでの実行例){{
$ which mono
/usr/bin/mono
$ mono -V
Mono JIT compiler version 2.4.2.3
Copyright 2002-2008 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm
SIGSEGV: altstack
Notifications: epoll
Architecture: x86
Disabled: none
}}
#prompt(Fedoraでの実行例){{
$ which mono
/usr/bin/mono
$ mono -V
Mono JIT compiler version 2.4.2.3
Copyright 2002-2008 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm
SIGSEGV: altstack
Notifications: epoll
Architecture: x86
Disabled: none
}}
続いて、先ほど用意したスクリプトを読み込んだあとでmono -Vを実行し、新しくインストールしたmonoが動作することを確認する。
#prompt{{
$ source mono-2.6-env
$ which mono
/opt/mono/bin/mono
$ mono -V
Mono JIT compiler version 2.6
Copyright 2002-2008 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm
SIGSEGV: altstack
Notifications: epoll
Architecture: x86
Disabled: none
}}
***GAC
gacutil -lでアセンブリがGACに登録されていることを確認する。 GACのパスを明示的に指定する場合は-rootオプションで指定する(例えばgacutil -l -root /opt/mono/lib/など)。
#prompt{{
$ gacutil -l
The following assemblies are installed into the GAC:
:
System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.ComponentModel.DataAnnotations, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.ComponentModel.DataAnnotations, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Core, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Core, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
:
}}
***gmcs
gmcs --aboutでgmcsのバージョンを確認する。
#prompt{{
$ gmcs --about
The Mono C# compiler is Copyright 2001-2008, Novell, Inc.
The compiler source code is released under the terms of the
MIT X11 or GNU GPL licenses
For more information on Mono, visit the project Web site
http://www.mono-project.com
The compiler was written by Miguel de Icaza, Ravi Pratap, Martin Baulig, Marek Safar, Raja R Harinath, Atushi Enomoto
}}
***dmcs
C# 4.0よりサポートされる機能を含むコードがコンパイル出来るかどうか試す。
#code(cs,test.cs){{
using System;
class Test {
static void Print(int x = 1, int y = 2, int z = 3)
{
Console.WriteLine("x: {0}", x);
Console.WriteLine("y: {0}", y);
Console.WriteLine("z: {0}", z);
Console.WriteLine();
}
public static void Main()
{
Print(x: 17, z: 23);
Print();
}
}
}}
#prompt(実行結果){{
$ dmcs test.cs && mono test.exe
x: 17
y: 2
z: 23
x: 1
y: 2
z: 3
}}
***csharp(C#シェル)
csharpシェルが動作するか確認する。
#prompt{{
$ csharp
Mono C# Shell, type "help;" for help
Enter statements below.
csharp> Console.WriteLine(Environment.Version);
2.0.50727.1433
csharp> Console.WriteLine(Environment.OSVersion);
Unix 2.6.31.6
csharp> quit;
null
}}
*その他のアセンブリ・ライブラリ
**gluezilla
依存するパッケージのインストール。
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libgtk2.0-dev libnss3-dev libnspr4-dev libxul-dev
# libxul-devはxulrunner-devでも可
}}
#code(sh,Fedoraの場合){{
yum install \
gtk2-devel nss-devel nspr-devel xulrunner-devel-unstable
}}
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/gluezilla/gluezilla-2.6.tar.bz2
tar -xvf gluezilla-2.6.tar.bz2
cd gluezilla-2.6/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
checking Gtk+ 2.0... found
checking Mono... found
checking Mozilla NSPR... nspr
checking Mozilla NSS... nss
checking Mozilla XPCOM > 1.8... libxul-embedding-unstable
:
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
***gluezillaの動作テスト
gluezillaが動作するかテストしたい場合は、tests/browser/にあるテスト用のアプリケーションをビルド・起動して動作を確認できる。
まず、ldconfigでライブラリのリンク・キャッシュを再構成する。
#code(sh){{
sudo ldconfig
}}
次に、テスト用のMakefileで指定されているアセンブリ参照の誤りを修正する。
#prompt{{
$ cd tests/browser/
$ cp Makefile Makefile.org
$ sed 's/Mono.Mozilla.dll/Mono.WebBrowser.dll/g' Makefile.org > Makefile
$ diff Makefile.org Makefile
348c348
< gmcs -debug -pkg:dotnet -r:Mono.Mozilla.dll -target:exe -out:$@ $(test_build_sources)
---
> gmcs -debug -pkg:dotnet -r:Mono.WebBrowser.dll -target:exe -out:$@ $(test_build_sources)
}}
修正後、make testでテスト用のアプリケーションが起動する。 起動するとウィンドウが開くので、アドレスバーに適当なURLを入れてページが表示されるか確認する。
**gtk-sharp-2.0
依存するパッケージのインストール。
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libglade2-dev libgtk2.0-dev libpango1.0-dev
}}
#code(sh,Fedoraの場合){{
yum install \
libglade2-devel gtk2-devel pango-devel
}}
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/gtk-sharp212/gtk-sharp-2.12.9.tar.bz2
tar -xvf gtk-sharp-2.12.9.tar.bz2
cd gtk-sharp-2.12.9/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix = /opt/mono
* C# compiler: /opt/mono/bin/mcs -define:GTK_SHARP_2_6 -define:GTK_SHARP_2_8 -define:GTK_SHARP_2_10 -define:GTK_SHARP_2_12
Optional assemblies included in the build:
* glade-sharp.dll: yes
* gtk-dotnet.dll: yes
* Mono.Cairo.dll: using system assembly
NOTE: if any of the above say 'no' you may install the
corresponding development packages for them, rerun
autogen.sh to include them in the build.
* Documentation build enabled: yes
---
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**Mono.Addins
-依存するアセンブリ
--gtk-sharp-2.0
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/mono-addins/mono-addins-0.4.zip
unzip mono-addins-0.4.zip
cd mono-addins-0.4/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
Configuration summary
* Installation prefix = /opt/mono
* gui support: yes
* unit tests: no
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**gnome-sharp-2.0
-依存するアセンブリ
--gtk-sharp-2.0
依存するパッケージのインストール。
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libgnome2-dev libgnomecanvas2-dev libgnomeui-dev
}}
#code(sh,Fedoraの場合){{
yum install \
libgnome-devel libgnomecanvas-devel libgnomeui-devel
}}
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/gnome-sharp2/gnome-sharp-2.24.1.tar.bz2
tar -xvf gnome-sharp-2.24.1.tar.bz2
cd gnome-sharp-2.24.1/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix = /opt/mono
* C# compiler: /opt/mono/bin/mcs -define:GTK_SHARP_2_6 -define:GTK_SHARP_2_8 -define:GNOME_SHARP_2_16 -define:GNOME_SHARP_2_20 -define:GNOME_SHARP_2_24
Optional assemblies included in the build:
* art-sharp.dll: yes
* gnomevfs-sharp.dll: yes
* gnome-sharp.dll: yes
NOTE: if any of the above say 'no' you may install the
corresponding development packages for them, rerun
autogen.sh to include them in the build.
gnome-sharp.dll requires libgnomecanvas, libgnome,
and libgnomeui.
---
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**gecko-sharp
-依存するアセンブリ
--gtk-sharp-2.0
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/gecko-sharp2/gecko-sharp-2.0-0.13.tar.bz2
tar -xvf gecko-sharp-2.0-0.13.tar.bz2
cd gecko-sharp-2.0-0.13/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix: /opt/mono
* compiler: /opt/mono/bin/mcs
* Documentation: yes
---
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**gnome-desktop-sharp
-依存するアセンブリ
--gtk-sharp-2.0
--gnome-sharp-2.0
依存するパッケージのインストール。
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libgtksourceview2.0-dev libgnomeprint2.2-dev libgnomeprintui2.2-dev libgtkhtml3.14-dev libnautilus-burn-dev \
libpanel-applet2-dev librsvg2-dev libvte-dev libwnck-dev
}}
#code(sh,Fedoraの場合){{
yum install \
gtksourceview2-devel libgnomeprint22-devel libgnomeprintui22-devel gnome-panel-devel gtkhtml3-devel \
librsvg2-devel vte-devel libwnck-devel
}}
Fedora 12ではnautilus-cd-burnerが見つからなかったのでnautilusburn-sharp.dllはインストールせずに進める。
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/gnome-desktop-sharp2/gnome-desktop-sharp-2.24.0.tar.bz2
tar -xvf gnome-desktop-sharp-2.24.0.tar.bz2
cd gnome-desktop-sharp-2.24.0/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix = /opt/mono
* C# compiler: /opt/mono/bin/mcs
Optional assemblies included in the build:
* gnome-panel-sharp.dll: yes
* gnome-print-sharp.dll: yes
* gtkhtml-sharp.dll: yes
* gtksourceview2-sharp.dll: yes
* nautilusburn-sharp.dll: no
* rsvg-sharp.dll: yes
* vte-sharp.dll: yes
* wnck-sharp.dll: yes
NOTE: if any of the above say 'no' you may install the
corresponding development packages for them, rerun
autogen.sh to include them in the build.
---
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**mono-tools
-依存するアセンブリ
--gtk-sharp-2.0
--gnome-sharp-2.0
-オプションで参照されるアセンブリ
--gecko-sharp
--gtkhtml-sharp
--webkit-sharp
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/mono-tools/mono-tools-2.6.tar.bz2
tar -xvf mono-tools-2.6.tar.bz2
cd mono-tools-2.6/
./configure --prefix=/opt/mono
}}
configureの結果例。
#prompt{{
---
Configuration summary
* Installation prefix = /opt/mono
* Using Gecko = yes
* Using GtkHtml = yes
* Using Mono.WebBrowser = yes
* Using WebKit = no
NOTE: if any of the above say 'no' you may install the
corresponding development packages for them, rerun
autogen.sh to include them in the build.
}}
問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**mono-debugger
依存するパッケージのインストール。
#code(sh,Ubuntuの場合){{
sudo apt-get install \
libncurses5-dev
}}
#code(sh,Fedoraの場合){{
yum install \
ncurses-devel
}}
ソースのダウンロードとconfigure。
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/mono-debugger/mono-debugger-2.6.tar.bz2
tar -xvf mono-debugger-2.6.tar.bz2
cd mono-debugger-2.6/
./configure --prefix=/opt/mono
}}
configureの結果に問題が無ければ、make、make installする。
#code(sh){{
make
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
*インストールされるアセンブリ
ここまでの手順でインストールされるアセンブリの一覧は以下の通り。
#prompt{{
$ gacutil -l -root /opt/mono/lib/
The following assemblies are installed into the GAC:
Accessibility, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Accessibility, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Accessibility, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
ByteFX.Data, Version=0.7.6.1, Culture=neutral, PublicKeyToken=0738eb9f132ed756
ByteFX.Data, Version=0.7.6.2, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Commons.Xml.Relaxng, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Commons.Xml.Relaxng, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Commons.Xml.Relaxng, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
CustomMarshalers, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
CustomMarshalers, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
CustomMarshalers, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
FirebirdSql.Data.Firebird, Version=1.7.1.0, Culture=neutral, PublicKeyToken=0706f5520aae4ff4
I18N, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.CJK, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.CJK, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.CJK, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.MidEast, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.MidEast, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.MidEast, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Other, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Other, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Other, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Rare, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Rare, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.Rare, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.West, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.West, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
I18N.West, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
IBM.Data.DB2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=7c307b91aa13d208
ICSharpCode.SharpZipLib, Version=0.6.0.0, Culture=neutral, PublicKeyToken=1b03e6acf1164f73
ICSharpCode.SharpZipLib, Version=0.84.0.0, Culture=neutral, PublicKeyToken=1b03e6acf1164f73
ICSharpCode.SharpZipLib, Version=2.6.0.0, Culture=neutral, PublicKeyToken=1b03e6acf1164f73
ICSharpCode.SharpZipLib, Version=2.84.0.0, Culture=neutral, PublicKeyToken=1b03e6acf1164f73
Microsoft.Build.Engine, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Engine, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Engine, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Framework, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Framework, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Tasks, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Tasks, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Tasks.v3.5, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Utilities, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Utilities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Build.Utilities.v3.5, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.CSharp, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.JScript, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.JScript, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.JScript, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.VisualC, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.VisualC, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.VisualC, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Vsa, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Vsa, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Microsoft.Vsa, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
Mono.Addins, Version=0.4.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Addins.CecilReflector, Version=0.4.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Addins.Gui, Version=0.4.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Addins.Setup, Version=0.4.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.C5, Version=1.1.0.0, Culture=neutral, PublicKeyToken=ba07f434b1c35cbd
Mono.CSharp, Version=2.1.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Cairo, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Cairo, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Cairo, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Cecil, Version=0.6.9.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Cecil.Mdb, Version=0.2.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.CompilerServices.SymbolWriter, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.CompilerServices.SymbolWriter, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.CompilerServices.SymbolWriter, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.Sqlite, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.Sqlite, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SqliteClient, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SqliteClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SqliteClient, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SybaseClient, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SybaseClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.SybaseClient, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.Tds, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.Tds, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.Tds, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.TdsClient, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.TdsClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Data.TdsClient, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Debugger, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Debugger.Frontend, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Debugger.Soft, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Debugger.SymbolWriter, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.GetOptions, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.GetOptions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.GetOptions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Http, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Http, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Http, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Management, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Management, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging.RabbitMQ, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging.RabbitMQ, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Messaging.RabbitMQ, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Posix, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Posix, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Posix, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security.Win32, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security.Win32, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Security.Win32, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Simd, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Simd, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Tasklets, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Tasklets, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Mono.WebBrowser, Version=0.5.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Novell.Directory.Ldap, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Novell.Directory.Ldap, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Novell.Directory.Ldap, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
Npgsql, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7
Npgsql, Version=2.0.0.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7
Npgsql, Version=4.0.0.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7
OpenSystem.C, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
OpenSystem.C, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
OpenSystem.C, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
PEAPI, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
PEAPI, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
PEAPI, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
RabbitMQ.Client, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
RabbitMQ.Client, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
RabbitMQ.Client, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.ComponentModel.DataAnnotations, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.ComponentModel.DataAnnotations, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Configuration.Install, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Core, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Core, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.DataSetExtensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.DataSetExtensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.Linq, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.Linq, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.OracleClient, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.OracleClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.OracleClient, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Data.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
System.Data.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.DirectoryServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.DirectoryServices, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.DirectoryServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Drawing.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Dynamic, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.EnterpriseServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.EnterpriseServices, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.IdentityModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.IdentityModel.Selectors, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.IdentityModel.Selectors, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Management, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Management, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Management, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Messaging, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Messaging, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Messaging, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Runtime.Remoting, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Runtime.Remoting, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Runtime.Serialization, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Runtime.Serialization, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Runtime.Serialization.Formatters.Soap, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Runtime.Serialization.Formatters.Soap, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Runtime.Serialization.Formatters.Soap, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Security, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Security, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Security, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.ServiceModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.ServiceModel.Web, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.ServiceModel.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.ServiceProcess, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.ServiceProcess, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.ServiceProcess, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Transactions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Web, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Web.Abstractions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Abstractions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.DynamicData, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.DynamicData, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions.Design, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions.Design, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Extensions.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Mvc, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Routing, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Routing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
System.Web.Services, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Web.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
System.Windows.Forms, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Xml, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Xml.Linq, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
System.Xml.Linq, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
WindowsBase, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
WindowsBase, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
art-sharp, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
atk-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
cscompmgd, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
cscompmgd, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
cscompmgd, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
gconf-sharp, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gconf-sharp-peditors, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gdk-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gecko-sharp, Version=2.0.0.0, Culture=neutral, PublicKeyToken=ccf7d78a55e9f021
glade-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
glib-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gnome-panel-sharp, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gnome-print-sharp, Version=2.18.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gnome-sharp, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gnome-vfs-sharp, Version=2.24.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gnomedesktop-sharp, Version=2.20.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gtk-dotnet, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gtk-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gtkhtml-sharp, Version=3.16.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
gtksourceview2-sharp, Version=2.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
monodoc, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
nautilusburn-sharp, Version=2.20.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
nunit-console-runner, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.core, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.core.extensions, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.core.interfaces, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.framework, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.framework.extensions, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.mocks, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
nunit.util, Version=2.4.8.0, Culture=neutral, PublicKeyToken=96d09a1eb7f44a77
pango-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.0.2.Mono.Addins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.2.Mono.Addins.CecilReflector, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.2.Mono.Addins.Gui, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.2.Mono.Addins.Setup, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.3.Mono.Addins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.3.Mono.Addins.CecilReflector, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.3.Mono.Addins.Gui, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.0.3.Mono.Addins.Setup, Version=0.0.0.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756
policy.2.10.atk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.gdk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.glade-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.glib-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.gtk-dotnet, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.gtk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.10.pango-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.16.art-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.16.gconf-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.16.gconf-sharp-peditors, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.16.gnome-vfs-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.20.art-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.20.gconf-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.20.gconf-sharp-peditors, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.20.gnome-vfs-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.art-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.atk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gconf-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gconf-sharp-peditors, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gdk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.glade-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.glib-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gnome-vfs-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gtk-dotnet, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.gtk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.4.pango-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.art-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.atk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gconf-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gconf-sharp-peditors, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gdk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.glade-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.glib-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gnome-vfs-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gtk-dotnet, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.gtk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.6.pango-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.art-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.atk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gconf-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gconf-sharp-peditors, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gdk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.glade-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.glib-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gnome-vfs-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gtk-dotnet, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.gtk-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
policy.2.8.pango-sharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
rsvg2-sharp, Version=2.18.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
vte-sharp, Version=0.16.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
wnck-sharp, Version=2.20.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f
Number of items = 326
}}
${smdncms:title,MonoDevelop 2.2のインストール}
${smdncms:keywords,MonoDevelop,2.2,ビルド,インストール}
Ubuntu 9.10に[[MonoDevelop 2.2:http://monodevelop.com/]]をソースからビルドしてインストールする手順。
${smdncms:keywords,MonoDevelop,2.2,ビルド,インストール,Ubuntu 9.10,Fedora 12}
[[MonoDevelop 2.2:http://monodevelop.com/]]をソースからビルドしてインストールする手順。 検証に使った環境はUbuntu 9.10 DesktopおよびFedora 12 Desktop。
-リンク
--[[MonoDevelop 2.2 Released - MonoDevelop:http://monodevelop.com/Download/MonoDevelop_2.2_Released]]
*MonoDevelop本体
**MonoDevelopが必要とするアセンブリのインストール
MonoDevelopが必要とするアセンブリをあらかじめインストールしておく。 必要になるものは以下のアセンブリ。
-MonoDevelopが必要とするアセンブリ
MonoDevelopが必要とするアセンブリをあらかじめインストールしておく。 必要になるものは以下のアセンブリ。 各アセンブリのインストール方法については[[programming/mono/install_2.6]]を参照のこと。
-MonoDevelopが必要とするアセンブリ・パッケージ
--Mono Addins
--gtk-sharp
--monodoc
--gecko-sharp
--gtksourceview-sharp
--mono-debugger
**ソースのダウンロードとconfigure
#code(sh){{
インストールするには、make installする。
#code(sh){{
sudo make install
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
インストールが完了したら、monodevelop -Vでmonodevelopの出力を確認する。
*デバッガ
**Mono Debugger support
-依存するパッケージ類
--mono-debugger
sudo make install
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**GDB Debugger support
インストールするには、make installする。
#code(sh){{
sudo make install
sudo make install # Ubuntuの場合
su -c 'make install' # Fedoraの場合
}}
**デバッガの動作確認
${smdncms:title,MonoDevelop 2.2のインストール}
${smdncms:keywords,MonoDevelop,2.2,ビルド,インストール}
Ubuntu 9.10に[[MonoDevelop 2.2:http://monodevelop.com/]]をソースからビルドしてインストールする手順。
-リンク
--[[MonoDevelop 2.2 Released - MonoDevelop:http://monodevelop.com/Download/MonoDevelop_2.2_Released]]
--[[Download - MonoDevelop:http://monodevelop.com/Download]]
--[[What's new in MonoDevelop 2.2 - MonoDevelop:http://monodevelop.com/index.php?title=Download/What%27s_new_in_MonoDevelop_2.2]]
-関連するページ
--[[programming/mono/install_monodevelop_trunk]]
--[[programming/mono]]
*MonoDevelop本体
**MonoDevelopが必要とするアセンブリのインストール
MonoDevelopが必要とするアセンブリをあらかじめインストールしておく。 必要になるものは以下のアセンブリ。
-MonoDevelopが必要とするアセンブリ
--Mono Addins
--gtk-sharp
--monodoc
--gecko-sharp
--gtksourceview-sharp
**ソースのダウンロードとconfigure
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/monodevelop/monodevelop-2.2.tar.bz2
tar -xvf monodevelop-2.2.tar.bz2
cd monodevelop-2.2/
./configure
}}
configureの結果を確認する。
#prompt{{
Configuration summary
* Installation prefix = /usr/local
* C# compiler = /usr/local/bin/gmcs
* Mono class library development extensions: yes
* Version control support: yes
* Providers:
* Subversion: yes
* C/C++ project support: yes
* Platform bindings: GNOME
* Unit tests: no
* Mozilla location:
}}
**ビルド、インストール
問題が無ければ、makeする。
#code(sh){{
make
}}
ビルドしたものをインストールせずすぐに実行したければmake runする。
#code(sh){{
make run
}}
インストールするには、make installする。
#code(sh){{
sudo make install
}}
インストールが完了したら、monodevelop -Vでmonodevelopの出力を確認する。
#prompt{{
MonoDevelop Ide 2.2.0.0 - LGPL
The MonoDevelop IDE application.
http://monodevelop.com
Authors: MonoDevelop Team
}}
*デバッガ
**Mono Debugger support
-依存するパッケージ類
--mono-debugger
***ソースのダウンロードとconfigure
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/monodevelop-debugger-mdb/monodevelop-debugger-mdb-2.2.tar.bz2
tar -xvf monodevelop-debugger-mdb-2.2.tar.bz2
cd monodevelop-debugger-mdb-2.2/
./configure
}}
configureの結果を確認する。
#prompt{{
monodevelop-debugger-mdb has been configured with
prefix = /usr/local
config = DEBUG
}}
***ビルド、インストール
問題が無ければ、makeする。
#code(sh){{
make
}}
インストールするには、make installする。
#code(sh){{
sudo make install
}}
**GDB Debugger support
***ソースのダウンロードとconfigure
#code(sh){{
wget http://ftp.novell.com/pub/mono/sources/monodevelop-debugger-gdb/monodevelop-debugger-gdb-2.2.tar.bz2
tar -xvf monodevelop-debugger-gdb-2.2.tar.bz2
cd monodevelop-debugger-mdb-2.2/
./configure
}}
configureの結果を確認する。
#prompt{{
monodevelop-debugger-gdb has been configured with
prefix = /usr/local
config = DEBUG
}}
***ビルド、インストール
問題が無ければ、makeする。
#code(sh){{
make
}}
インストールするには、make installする。
#code(sh){{
sudo make install
}}
**デバッガの動作確認
[ツール]メニューの[アドインマネージャ]を開き、Debuggingの下に「MDB support for Mono.Debugging」がリストされていることを確認する。
#ref(addin-manager.png,アドインマネージャ)
次に、プロジェクトを開き適当な場所にブレークポイントを設定したあと、[実行]メニューの[デバッグ]を使って実行する。 正しく動作すれば、このようにブレークポイントで停止し、カーソルをポイントすれば変数の内容が表示される。
#ref(debugger.png,変数の内容を表示しているところ)
*ダウンロード
#googleadunit
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,TundereBird-0.21.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.21
---[[works/libs/Smdn.Formats.Mime]] 0.15
---[[works/libs/Smdn.Formats.Ini]] 0.15
--${smdncms:distfilelink,TundereBird-0.20.tar.bz2}
---下記ライブラリのソースを同梱しています
---[[Smdn.Protocols.Imap4>works/libs/Smdn.Net.Imap4]] 0.20
---[[works/libs/Smdn.Formats.Ini]] 0.10
*使い方
tunderebird.iniを開いてアカウント情報を記入してから起動してください。
+tunderebird.iniを開いてアカウント情報を記入してから起動してください。
+Visual Studioではログ出力により動作が遅くなる場合があります。 遅くなる場合は、tunderebird.exe.configを編集してログを出力しないようにしてください。
*不具合・要望・質問等
ライブラリに関する不具合・要望・質問は[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.2x
:0.20|POP3のサポートを削除
メッセージのアップロード・ダウンロード機能を追加
IMAPサーバの情報を表示するタブを追加
**0.1x
:0.13|ライブラリのバージョンアップに伴うリリース
:0.12|ライブラリのバージョンアップに伴うリリース
:0.11|POP3に対応
:0.10|初版
**0.21
-機能追加
--設定ファイルにメールボックスの選択時にSELECTとEXAMINEのどちらを使用するか指定するReadOnlyキーを追加
--メールボックス・メッセージに対する各種操作(作成・削除・フラグの設定など)を行えるようにした
-修正・改善
--メールボックス一覧取得時などのUI周りの動作を改善
**0.20
-POP3のサポートを削除
-メッセージのアップロード・ダウンロード機能を追加
-IMAPサーバの情報を表示するタブを追加
**0.13
-ライブラリのバージョンアップに伴うリリース
**0.12
-ライブラリのバージョンアップに伴うリリース
**0.11
-POP3に対応
**0.10
-初版
${smdncms:title,ドキュメント・サンプル}
${smdncms:keywords,}
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。
[[works/libs/Smdn.Net.Imap4]]のドキュメントとサンプルです。 ご質問などありましたら[[掲示板>misc/forum/libs]]へどうぞ。
*ライブラリの設計と実装の概要
**クライアント
クライアントの実装は2種類あります。 一つはSmdn.Protocols.Imap4.Client.Session名前空間のImapSessionクラス、もう一つはSmdn.Protocols.Imap4.WebClient名前空間のImapWebRequest/ImapWebResponseクラスです。 Smdn.Protocols.Imap4.WebClient名前空間のクライアントは、System.Net.WebRequest/System.Net.WebResponseを継承したもので、内部でImapSessionクラスを使用しています。
二つのクライアントのモデルと概要は次の通りです。
:ImapSessionクラス|IMAPのコマンドとほぼ1対1で対応するメソッドを持つクラスです。 IMAPの操作は抽象化していません。 仕様と1対1で対応するような実装にしてあります。
切断する/されるまで選択済みメールボックス・メールボックス毎のフラグ・サーバの能力・名前空間等のセッションの状態を保持します。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、読み込みのみの操作に関しては送信されるIMAPコマンドを意識せずに扱えます。
ImapWebRequest.KeepAliveプロパティでリクエスト毎にセッションを切断するか、ログイン状態を維持するかどうか設定できます。 また、送信するコマンドはImapWebRequest.Methodプロパティで変更できます。
**認証
認証時に必要なユーザ名・パスワードはSystem.Net.ICredentialsByHostインターフェイスを通して取得します。 ICredentialsインターフェイスではなく、ICredentialsByHostインターフェイスを実装していて、GetCredentialメソッドが適切なSystem.Net.NetworkCredentialを返すクラスなら何でも設定できます。
ImapWebRequest.Credentialsプロパティは、WebRequestから継承しているためICredentialsインターフェイスを実装していることを要求しますが、同時にICredentialsByHostを実装していない場合は例外をスローします。
**証明書の選択と検証
認証時に使用する証明書はX509Certificate2Collectionで設定できます。 また、証明書の選択と検証にはRemoteCertificateValidationCallbackデリゲートとLocalCertificateSelectionCallbackデリゲートを使用できます。
|*証明書に関する型と該当するメンバ(いずれもクラス・プロパティ)
|~証明書に関する型|>|~該当するメンバ|
|~|~Smdn.Protocols.Imap4.Client.Connection名前空間|~Smdn.Protocols.Imap4.WebClient名前空間|
|X509Certificate2Collection|ImapConnection.CertCollection|ImapSessionManager.CertCollection|
|RemoteCertificateValidationCallback|ImapConnection.CertificateValidationCallback|ImapSessionManager.CertificateValidationCallback|
|LocalCertificateSelectionCallback|ImapConnection.CertificateSelectionCallback|ImapSessionManager.CertificateSelectionCallback|
**操作とデータ構造
ImapSessionクラスには、IMAPコマンドと1対1に対応するメソッドが用意されています。 また、すべてのコマンドの引数とレスポンスのデータ構造は、それに対応する型が定義されています。 これらの型は出来る限り仕様と1対1で対応するように実装してあり、IMAPの詳細が分からなくても使えることを目的とするような抽象化はしていません。
*使用例
個々のサンプルの詳細については、後述するSmdn.Net.Imap4.WebClient名前空間の説明を参照してください。
**メールボックスのインスタンス
メールボックスの情報はImapMailboxクラスに保持されます。 このクラスのインスタンスは、LISTコマンド等により作成された後は、ログアウトするまでライブラリ側で管理されます。 同じメールボックスに対してSELECTしたりRENAMEした場合はインスタンスの値のみが更新され、常に同じインスタンスが返されます。
**ログ
シンボルTRACEを有効にしてビルドした場合、トレースにログを出力します。 ログにはパスワードを含む送受信内容を解読可能な状態で出力します。 ログの出力が不要な場合はTrace.csを削除するか、TRACEを無効にしてリビルドしてください。
|*ログ出力に使用するTraceSourceの名前と出力内容
|TraceSource|出力内容|h
|Smdn.Protocols.Imap4|サーバとの送受信内容とセッション毎の動作ログを出力します。|
|Smdn.Protocols.Imap4#Connection|サーバとの送受信内容のみを出力します。|
*Smdn.Protocols.Imap4.WebClient名前空間
Smdn.Protocols.Imap4.WebClient名前空間のクラスの使い方。
**簡単なサンプル
WebClientクラスを使って、localhostのINBOXメールボックスからUIDが1のメールをダウンロードし、sample.emlとして保存するサンプル。
**メッセージのダウンロード
WebClientクラスを使って、localhostのINBOXメールボックスからUIDが1のメールをダウンロードし、sample.emlとして保存するサンプル。 ログインユーザ名にuser、パスワードにpassを使用し、認証方式にDIGEST-MD5を使用。
#code(cs){{
using System;
using System.Net;
using Smdn.Protocols.Imap4.WebClient;
using Smdn.Net.Imap4.WebClient;
class Sample {
public static void Main(string[] args)
}
}}
**メッセージのアップロード
WebClientクラスを使って、localhostのINBOXメールボックスにsample.emlをアップロードするサンプル。
#code(cs){{
using System;
using System.IO;
using System.Net;
using Smdn.Protocols.Imap4.WebClient;
using Smdn.Net.Imap4.WebClient;
class Sample {
public static void Main(string[] args)
}
}}
**メッセージの検索
WebRequestクラスを使って、Gmailアカウントのメールボックスからタイトルに[Mono-dev]を含むメールの一覧を取得する例。
#code(cs){{
using System;
using System.Net;
using Smdn.Protocols.Imap4.WebClient;
using Smdn.Net.Imap4.WebClient;
class Sample {
public static void Main(string[] args)
}
}}
*ライブラリの設計と実装の概要
**クライアント
クライアントの実装は2種類あります。 一つはSmdn.Net.Imap4.Client.Session名前空間のImapSessionクラス、もう一つはSmdn.Net.Imap4.WebClient名前空間のImapWebRequest/ImapWebResponseクラスです。 Smdn.Net.Imap4.WebClient名前空間のクライアントは、System.Net.WebRequest/System.Net.WebResponseを継承したもので、内部でImapSessionクラスを使用しています。
二つのクライアントのモデルと概要は次の通りです。
:ImapSessionクラス|IMAPのコマンドとほぼ1対1で対応するメソッドを持つクラスです。 IMAPの操作は抽象化していません。 仕様と1対1で対応するような実装にしてあります。
切断する/されるまで選択済みメールボックス・メールボックス毎のフラグ・サーバの能力・名前空間等のセッションの状態を保持します。
:ImapWebRequest/ImapWebResponseクラス|IMAP URL(&urn2url(urn:ietf:rfc:5092,short);)を用いたクライアントの実装です。 IMAP URLの形式でIMAPの操作を行うので、読み込みのみの操作に関しては送信されるIMAPコマンドを意識せずに扱えます。
ImapWebRequest.KeepAliveプロパティでリクエスト毎にセッションを切断するか、ログイン状態を維持するかどうか設定できます。 また、送信するコマンドはImapWebRequest.Methodプロパティで変更できます。
**認証
認証時に必要なユーザ名・パスワードはSystem.Net.ICredentialsByHostインターフェイスを通して取得します。 ICredentialsインターフェイスではなく、ICredentialsByHostインターフェイスを実装していて、GetCredentialメソッドが適切なSystem.Net.NetworkCredentialを返すクラスなら何でも設定できます。
ImapWebRequest.Credentialsプロパティは、WebRequestから継承しているためICredentialsインターフェイスを実装していることを要求しますが、同時にICredentialsByHostを実装していない場合は例外をスローします。
**証明書の選択と検証
認証時に使用する証明書はX509Certificate2Collectionで設定できます。 また、証明書の選択と検証にはRemoteCertificateValidationCallbackデリゲートとLocalCertificateSelectionCallbackデリゲートを使用できます。
|*証明書に関する型と該当するメンバ(いずれもクラス・プロパティ)
|~証明書に関する型|>|~該当するメンバ|
|~|~Smdn.Net.Imap4.Protocol.Client名前空間|~Smdn.Net.Imap4.WebClient名前空間|
|X509Certificate2Collection|ImapConnection.CertCollection|ImapSessionManager.CertCollection|
|RemoteCertificateValidationCallback|ImapConnection.CertificateValidationCallback|ImapSessionManager.CertificateValidationCallback|
|LocalCertificateSelectionCallback|ImapConnection.CertificateSelectionCallback|ImapSessionManager.CertificateSelectionCallback|
**操作とデータ構造
ImapSessionクラスには、IMAPコマンドと1対1に対応するメソッドが用意されています。 また、すべてのコマンドの引数とレスポンスのデータ構造は、それに対応する型が定義されています。 これらの型は出来る限り仕様と1対1で対応するように実装してあり、IMAPの詳細が分からなくても使えることを目的とするような抽象化はしていません。
**メールボックスのインスタンス
メールボックスの情報はImapMailboxクラスに保持されます。 このクラスのインスタンスは、LISTコマンド等により作成された後は、ログアウトするまでライブラリ側で管理されます。 同じメールボックスに対してSELECTしたりRENAMEした場合はインスタンスの値のみが更新され、常に同じインスタンスが返されます。
**ログ
シンボルTRACEを有効にしてビルドした場合、トレースにログを出力します。 ログにはパスワードを含む送受信内容を解読可能な状態で出力します。 ログの出力が不要な場合はTrace.csを削除するか、TRACEを無効にしてリビルドしてください。
|*ログ出力に使用するTraceSourceの名前と出力内容
|TraceSource|出力内容|h
|Smdn.Net.Imap4.Client|サーバとの送受信内容とセッション毎の動作ログを出力します。|
|Smdn.Net.Imap4.Client#Connection|サーバとの送受信内容のみを出力します。|
*Smdn.Net.Imap4.WebClient名前空間
Smdn.Net.Imap4.WebClient名前空間のクラスの使い方。
**imap, imapsスキームの登録
Smdn.Protocols.Imap4.WebClient名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
Smdn.Net.Imap4.WebClient名前空間のクラスを使う場合には、WebRequestクラスがimapスキームおよびimapsスキームのURLを処理できるようにImapSessionManager.RegisterWebRequestPrefixメソッドを呼び出しておく必要があります。
このメソッドはWebRequest.RegisterPrefixメソッドを呼び出し、imapスキームおよびimapsスキームに対してImapSessionManagerを関連付けます。
|ImapWebRequestMethods.Thread|THREADコマンドを送信して検索クエリに該当するメッセージの一覧をスレッド形式で取得します。|スレッド形式のアルゴリズムはImapWebRequest.ThreadingAlgorithmプロパティで指定します。 また、取得したスレッド形式の一覧は、ImapWebResponse.ThreadTreeプロパティに設定されます。&br;''サーバがTHREAD=* extensionをサポートしない場合、WebExceptionをスローします。''|
|ImapWebRequestMethods.Sort|SORTコマンドを送信して検索クエリに該当するメッセージの一覧をソート済みの形式で取得します。|ソート方法はImapWebRequest.SortCriteriaプロパティで指定します。 また、取得したメッセージの一覧は、ImapWebResponse.Messagesプロパティに設定されます。&br;''サーバがSORT=* extensionをサポートしない場合、WebExceptionをスローします。''|
IMAP URLに関するその他の事柄。
-HTTPなどのURLと同様にUriクラスを用いることができますが、ライブラリにはIMAP URLに対応したImapUriクラスを用意してあります。
***IMAP URLに関する注意事項など
-現時点では検索クエリに日本語等非ASCII文字を含めることはできません。 URLエンコードした文字列を検索クエリに含めた場合でも、エンコードした結果に非ASCII文字が含まれるような場合はリクエスト時にWebExceptionをスローします。
-UIDVALIDITYを含むIMAP URLも扱えますが、無視します。 現時点ではUIDVALIDITYが指定されていない場合と同様に扱います。
*Smdn.Protocols.Imap4.Client.Session名前空間
Smdn.Protocols.Imap4.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Protocols.Imap4.WebClientの各クラスの実装を参照してください。
**ImapWebRequestクラスのプロパティ
ImapWebRequestクラスにはコマンド送信時の動作を制御するためのプロパティを用意してあります。 プロパティの値によってリクエスト内容と動作が変わります。
|*ImapWebRequestクラスのプロパティ
|プロパティ|デフォルト|対象となるコマンド|リクエスト内容と動作|h
|KeepAlive|true|全て|リクエストが終了した後もログイン状態を維持するかどうかを指定します。|
|AllowLoginRedirect|true|全て(認証時)|認証時にサーバがレスポンスコードREFERRALを返した場合、レスポンスコードで指定されたURLで再度ログインを試みるかどうかを指定します。(この機能は未テストです。 期待する動作となるかどうかは分かりません)
|UseTlsIfAvailable|true|全て(認証時)|サーバがサポートしている場合、TLSを使用した接続に変更します。|
|UseDeflateIfAvailable|false|全て|サーバがサポートしている場合、DEFLATE圧縮アルゴリズムを使用した接続に変更します。 (この機能は現在動作しません。 trueにした場合、NotImplementedExceptionがスローされます)|
|ExpectedErrorResponseCodes|null|全て|サーバから返されることが予期されるエラーレスポンスコードの配列を指定します。 サーバからこれらのレスポンスコードが返された場合は、WebExceptionがスローされません。|
|ReadOnly|false|FETCH, SEARCH等|メールボックスを選択する際に、SELECTコマンドの代わりにEXAMINEコマンドを送信するかどうかを指定します。 メッセージに対する操作を行うコマンドを送信する場合に有効になります。 EXAMINEコマンドで選択したメールボックスのメッセージに対する操作の結果はサーバの実装によります。 ReadOnlyがtrueでもDELETEなどのコマンドには影響しません。|
|SearchCriteriaEncoding|Encoding.UTF8|SEARCH等|検索クエリのエンコードに使用する文字コードを指定します。 サーバがサポートしていない文字コードを指定した場合はエラーとなります。 (この機能は現在動作しません。 将来のバージョンで検索クエリにASCII文字以外も含められるようにした時点で機能します。)|
|AllowCreateMailbox|true|COPY|COPYコマンドを送信した際にサーバがレスポンスコードTRYCREATEを返した場合、自動的にメールボックスを作成するかどうかを指定します。|
|DestinationUri|null|COPY, RENAME|COPYの場合はメッセージのコピー先、RENAMEの場合は変更後のメールボックス名を含むURLを指定します。 URLはコピー元・変更前と同一サーバ、同一ユーザである必要があります。 それ以外の場合、InvalidOperationExceptionをスローします。|
|StoreDataItem|null|STORE|STOREコマンドでメッセージに追加・削除・設定するフラグを指定します。|
|SortCriteria|null|SORT|SORTコマンドで使用するソート方法を指定します。|
|ThreadingAlgorithm|null|THREAD|THREADコマンドで使用するスレッド形式のアルゴリズムを指定します。|
**サンプル
***メッセージのコピー
INBOXにあるメッセージすべてをINBOX.backupにコピーする例。 AllowCreateMailboxプロパティをtrueにしておくことで、サーバがレスポンスコードTRYCREATEを返した場合は自動的にメールボックスを作成します。
#code(cs){{
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.WebClient;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?ALL") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Copy;
request.AllowCreateMailbox = true;
request.DestinationUri = new Uri("imap://user@localhost/INBOX.backup/");
using {
:
:
}
}}
***メールボックスの削除
メールボックスINBOX.oldを削除する例。 ExpectedErrorResponseCodesプロパティにImapResponseCode.NonExistentを指定しておくことで、メールボックスが存在しない場合(サーバがレスポンスコードNONEXISTENTを返した場合)でもWebExceptionをスローしないようにします。
#code(cs){{
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.old/") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Delete;
request.ExpectedErrorResponseCodes = new[] {ImapResponseCode.NonExistent};
using {
:
:
}
}}
***メールボックスの作成
メールボックスINBOX.newを作成する例。 先の例と同様に、メールボックスがすでに存在する場合(サーバがレスポンスコードALREADYEXISTSを返した場合)でもWebExceptionをスローしないようにします。
#code(cs){{
using System;
using System.Net;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
:
var request = WebRequest.Create("imap://user@localhost/INBOX.new/") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Create;
request.ExpectedErrorResponseCodes = new[] {ImapResponseCode.AlreadyExists};
using {
:
:
}
}}
***メッセージへのフラグの設定
fromにspammer.example.comを含むメッセージをすべて既読にし、Thunderbirdの迷惑メールのマーク(Junk)を設定する例。 ImapStoreDataItem.ReplaceFlagsメソッドを使って新しく置き換える(設定する)フラグを作成し、StoreDataItemプロパティにしています。
#code(cs){{
using System;
using System.Net;
using System.Text;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Protocol.Client;
using Smdn.Net.Imap4.WebClient;
:
var request = WebRequest.Create("imap://user@localhost/INBOX/?from spammer.example.com") as ImapWebRequest;
request.Credentials = new NetworkCredential("user", "pass");
request.Method = ImapWebRequestMethods.Store;
request.StoreDataItem = ImapStoreDataItem.ReplaceFlags(new[] {"Junk"}, ImapMessageFlag.Seen);
using {
:
:
}
}}
*Smdn.Net.Imap4.Client.Session名前空間
Smdn.Net.Imap4.Client.Session名前空間のクラスの使い方。 このドキュメントは作成中です。 [[works/tools/junk/TundereBird]]およびSmdn.Net.Imap4.WebClientの各クラスの実装を参照してください。
**簡単なサンプル
**サンプル
***ログインと各種コマンド送信の例
IDLEでメールボックス(INBOX)を監視し、新着メッセージが着たらサブジェクトを表示するサンプル。
#code(cs){{
using System;
using System.Net;
using Smdn.Protocols.Imap4;
using Smdn.Protocols.Imap4.Client;
using Smdn.Protocols.Imap4.Client.Protocol;
using Smdn.Protocols.Imap4.Client.Session;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Client;
using Smdn.Net.Imap4.Client.Session;
class Sample {
public static void Main()
ImapMessage[] messages;
session.UidFetch(matched, ImapFetchDataItem.All, out messages);
session.Fetch(matched, ImapFetchDataItem.All, out messages);
foreach {
Console.WriteLine(message.Envelope.Subject);
}
}}
***Gmail
Gmailに接続し、スター付きのメールにThunderbirdのTo Doタグを付けるサンプル。
#code(cs){{
using System;
using System.Net;
using Smdn.Protocols.Imap4;
using Smdn.Protocols.Imap4.Client;
using Smdn.Protocols.Imap4.Client.Protocol;
using Smdn.Protocols.Imap4.Client.Session;
using Smdn.Net.Imap4;
using Smdn.Net.Imap4.Client;
using Smdn.Net.Imap4.Client.Session;
using Smdn.Net.Imap4.Protocol.Client;
class Sample {
public static void Main()
C#で書いた.NET Framework/Mono用IMAP4rev1クライアントライブラリです。 IMAPサーバからのメールボックスの管理(作成・削除・ステータスの取得など)、メッセージの検索・取得・アップロードなどが出来ます。
*機能概要
-使用可能なコマンド
--認証系コマンド
---AUTHENTICATE(DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS), LOGIN, LOGOUT, STARTTLS
--メールボックス操作系コマンド
---標準コマンド: CREATE, RENAME, DELETE, CLOSE, SELECT, EXAMINE, LIST, LSUB, STATUS, SUBSCRIBE, UNSUBSCRIBE
---拡張コマンド: RLIST, RLSUB, UNSELECT, NAMESPACE
--メッセージ操作系コマンド
---標準コマンド: APPEND,SEARCH, EXPUNGE
---拡張コマンド:, UID EXPUNGE
--その他のコマンド
---標準コマンド: NOOP, CHECK, CAPABILITY
---拡張コマンド: ENABLE, COMPRESS, IDLE, ID
-クライアント機能
--IMAPコマンドと1対1に対応するメソッドを持つクライアント
--WebRequest/WebResponseクラスから派生しIMAP URLでの操作に対応したクライアント
使用可能なコマンド
:認証系コマンド|LOGIN, AUTHENTICATE, LOGOUT, STARTTLS
::認証方式|DIGEST-MD5, CRAM-MD5, NTLM, PLAIN, LOGIN, ANONYMOUS
:メールボックス操作系コマンド|
::標準コマンド|CREATE, RENAME, DELETE, CLOSE, SELECT, EXAMINE, LIST, LSUB, STATUS, SUBSCRIBE, UNSUBSCRIBE
::拡張コマンド|RLIST, RLSUB, UNSELECT, NAMESPACE
:メッセージ操作系コマンド|
::標準コマンド|APPEND,SEARCH, EXPUNGE
::拡張コマンド|(UID)SORT,, UID EXPUNGE
:その他のコマンド|
::標準コマンド|NOOP, CHECK, CAPABILITY
::拡張コマンド|ENABLE, COMPRESS, IDLE, ID
実装しているクライアントは次の二種類です。
:ImapSessionクラス|IMAPコマンドと1対1に対応するメソッドを持つクライアント
:ImapWebRequest/ImapWebResponseクラス|WebRequest/WebResponseクラスから派生し、IMAP URLでの操作に対応したクライアント
機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]、使い方・サンプルコードは[[works/libs/Smdn.Net.Imap4/doc]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
使い方・サンプルコードは[[works/libs/Smdn.Net.Imap4/doc]]、機能の詳細は[[works/libs/Smdn.Net.Imap4/feature]]をご覧ください。 またデモ用アプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*ダウンロード
#googleadunit
0.20以降はMIT X11ライセンスでのリリースとなります。 0.20より前のバージョンについては特に使用条件を定めていません。
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.2x
--${smdncms:distfilelink,Smdn.Net.Imap4.Client-0.21.tar.bz2}
--${smdncms:distfilelink,Smdn.Protocols.Imap4-0.20.tar.bz2}
-0.1x
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
*変更履歴
**0.2x
:0.20|ライセンスをMIT X11に変更
コマンド・リクエストの処理をセッションに共通スレッドからセッション毎のスレッドプールを使用するように変更
リクエストの処理速度を改善
&urn2url(urn:ietf:rfc:4315){UIDPLUS};、&urn2url(urn:ietf:rfc:4731){ESEARCH};、&urn2url(urn:ietf:rfc:5182){SEARCHRES};などの拡張に対応
DIGEST-MD5およびNTLM認証に対応
**0.1x
:0.13|STARTTLSコマンドによるTLSへのアップグレードに対応
不正な形式のModified UTF-7文字列のデコードで例外となる場合の対処を追加
PREAUTH応答のグリーティングメッセージからのcapability dataの取得に失敗する不具合を修正
FETCHリクエストを10240オクテット毎にpartial fetchするように改善
未知の種類のBODYSTRUCTUREの場合でも解析を継続するように改善
:0.12|Modified UTF-7(日本語等非ASCII文字を含むメールボックス名)に対応
レスポンス解析処理のバグを修正
IDLE後のレスポンス処理が即座に行われない不具合を修正
HMACMD5アルゴリズムの実装を独自の実装からライブラリ標準のクラスを用いたものに変更
:0.11|グリーティングメッセージからのcapability dataの取得に失敗する不具合を修正
セッションのステートチェック処理の誤りを修正
AUTHENTICATEで使用できる認証方法がない場合の動作を変更
:0.10|初版
**0.21
-機能追加
--WebClient名前空間
---ImapWebRequest.ReadOnlyプロパティを追加
---ImapWebRequest.AllowCreateMailboxプロパティを追加
---ImapWebRequest.ExpectedErrorResponseCodesプロパティを追加
-修正・改善
--DIGEST-MD5認証時にOverflowExceptionとなる不具合を修正(Windowsのみ)
--&urn2url(urn:ietf:rfc:4978){COMPRESS=DEFLATE};の実装を無効化
--ImapUriクラスを廃止、IMAP URL関連の実装を修正
--WebClient名前空間
---検索条件にマッチするメッセージが無い場合に例外エラーとなる不具合を修正
---CREATE/RENAME後にLSUBでメールボックスの属性を更新するように改善
-その他
--アセンブリ名・名前空間をSmdn.Protocols.Imap4からSmdn.Net.Imap4に改名
--アセンブリ構成を変更
**0.20
-機能追加
--DIGEST-MD5およびNTLM認証に対応
--&urn2url(urn:ietf:rfc:4315){UIDPLUS};、&urn2url(urn:ietf:rfc:4731){ESEARCH};、&urn2url(urn:ietf:rfc:5182){SEARCHRES};などの拡張に対応
-修正・改善
--コマンド・リクエストの処理をセッションに共通スレッドからセッション毎のスレッドプールを使用するように変更
--リクエストの処理速度を改善
-その他
--ライセンスをMIT X11に変更
**0.13
-STARTTLSコマンドによるTLSへのアップグレードに対応
-不正な形式のModified UTF-7文字列のデコードで例外となる場合の対処を追加
-PREAUTH応答のグリーティングメッセージからのcapability dataの取得に失敗する不具合を修正
-FETCHリクエストを10240オクテット毎にpartial fetchするように改善
-未知の種類のBODYSTRUCTUREの場合でも解析を継続するように改善
**0.12
-Modified UTF-7(日本語等非ASCII文字を含むメールボックス名)に対応
-レスポンス解析処理のバグを修正
-IDLE後のレスポンス処理が即座に行われない不具合を修正
-HMACMD5アルゴリズムの実装を独自の実装からライブラリ標準のクラスを用いたものに変更
**0.11
-グリーティングメッセージからのcapability dataの取得に失敗する不具合を修正
-セッションのステートチェック処理の誤りを修正
-AUTHENTICATEで使用できる認証方法がない場合の動作を変更
**0.10
-初版
*動作状況
以下のIMAPサーバに対して概ね問題なく動作することを確認済みです。
-GMail
-Dovecot
-Dovecot
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.4
-Mono 2.7
*制限事項
-MIMEメッセージのデコード機能は含んでいません。 デコード機能が必要な場合は他のライブラリか、[[works/libs/Smdn.Formats.Mime]]を使ってください。
|&urn2url(urn:ietf:rfc:4551,anchor-text);|CONDSTORE|&color(orange){partially implemented};||
|&urn2url(urn:ietf:rfc:4731,anchor-text);|ESEARCH|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:4959,anchor-text);|SASL-IR|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:4978,anchor-text);|COMPRESS=DEFLATE|&color(red){not tested};||
|&urn2url(urn:ietf:rfc:4978,anchor-text);|COMPRESS=DEFLATE|&color(gray){not implemented};||
|&urn2url(urn:ietf:rfc:5032,anchor-text);|WITHIN|&color(green){implemented};||
|&urn2url(urn:ietf:rfc:5092,anchor-text);|-|&color(orange){partially implemented};|URLAUTHは未実装です。 URLにUIDVALIDITYが指定されていてもUIDの検証は行いません。 [独自拡張]URLのスキームがimapsの場合、デフォルトポートとして993を使用し、SSLによる接続を試みます。|
|&urn2url(urn:ietf:rfc:5161,anchor-text);|ENABLE|&color(green){implemented};||
|EXAMINE with CONDSTORE parameter|&urn2url(urn:ietf:rfc:4551,#3.7,short);|&color(green){implemented};||
|SEARCH with RETURN result specifier|&urn2url(urn:ietf:rfc:4731,#3.1,short); &urn2url(urn:ietf:rfc:5182,#2.1,short); &urn2url(urn:ietf:id:ietf-morg-inthread-00,#3.5,short);|&color(green){implemented};||
|SORT with RETURN result specifier|&urn2url(urn:ietf:rfc:4731,#3.1,short); &urn2url(urn:ietf:rfc:5182,#2.1,short); &urn2url(urn:ietf:id:ietf-morg-inthread-00,#3.5,short);|&color(green){implemented};||
|COMPRESS|&urn2url(urn:ietf:rfc:4978,#3,short);|&color(red){not tested};||
|COMPRESS|&urn2url(urn:ietf:rfc:4978,#3,short);|&color(gray){not implemented};||
|ENABLE|&urn2url(urn:ietf:rfc:5161,#3.1,short);|&color(green){implemented};||
|LANGUAGE|&urn2url(urn:ietf:rfc:5255,#3.2,short);|&color(gray){not implemented};||
|COMPARATOR|&urn2url(urn:ietf:rfc:5255,#4.7,short);|&color(gray){not implemented};||
#googleadunit
0.14以降はMIT X11ライセンスでのリリースとなります。 0.14より前のバージョンについては特に使用条件を定めていません。
-${smdncms:distfilelink,Smdn.Formats.Mime-0.14.tar.bz2}
-以前のバージョン
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.1x
--${smdncms:distfilelink,Smdn.Formats.Mime-0.15.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Mime-0.14.tar.bz2}
--上記以前のバージョン
---[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
*サンプル
emlファイルを読み込んでヘッダの一覧とボディの内容を表示する例。
#code(cs){{
using System;
using System.IO;
using Smdn.Formats.Mime;
public class ReadMail {
public static void Main(string[] args) {
using {
var message = MimeMessage.Create(reader);
Dump(message);
}
var message = MimeMessage.Load("/home/smdn/Desktop/sample.eml");
Dump(message, 0);
}
private static void Dump(MimeMessage message)
private static void Dump(MimeMessage message, int nest)
{
DumpHeaders(message);
var indent = new string(' ', nest * 4);
DumpHeaders(message, indent);
Console.Write(indent);
Console.WriteLine(message.Body);
if
Console.WriteLine(message.ReadContentAsText());
else
Console.WriteLine(message.MimeType);
foreach {
Dump(part);
Console.WriteLine();
Dump(part, nest + 1);
}
}
private static void DumpHeaders(MimeMessage message)
private static void DumpHeaders(MimeMessage message, string indent)
{
foreach {
Console.Write("{0}: ", header.Key);
foreach {
Console.WriteLine(val);
}
Console.WriteLine("{0}{1}: {2}", indent, header.Name, header.Value);
}
}
}
}}
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もご覧ください。
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
*変更履歴
**0.1x
:0.14|ライセンスをMIT X11に変更
拡張子およびファイル内容からのMIMEタイプの判定処理を追加
Content-Transfer-Encodingヘッダの値が;で終端する場合にデコードできない不具合を修正
:0.13|コメントを含む場合等にMIME-Versionヘッダの値を正しく認識できない不具合を修正
改行・空白を含まずに連続するencoded-wordsを正しくデコードできない不具合を修正
ヘッダを含まないmultipartメッセージ等で解析に失敗する不具合を修正
:0.12|元のメッセージの改行文字を保持するように修正
Q-Encodeされた文字列を正しくデコードしない不具合を修正
Q-EncodeおよびB-Encodeされた文字列を正しく認識できない場合がある不具合を修正
メッセージの解析時に入力ストリームの8ビット目が損失する不具合を修正
Quoted-Printableのデコード処理の不具合を修正
:0.11|stringからインスタンスをコンストラクトできるようにした
:0.10|初版
**0.15
-機能追加
--添付ファイル・代替メッセージの作成機能、メッセージのエンコード・フォーマット機能を追加(ただしインターフェイスは未確定)
-修正・改善
--エンコーディングにutf8, shift-jisなど正式な名称とは異なる値が指定されている場合に解析に失敗する不具合を修正
--インターフェイスを修正
-その他
--アセンブリ構成を変更
**0.14
-ライセンスをMIT X11に変更
-拡張子およびファイル内容からのMIMEタイプの判定処理を追加
-Content-Transfer-Encodingヘッダの値が;で終端する場合にデコードできない不具合を修正
**0.13
-コメントを含む場合等にMIME-Versionヘッダの値を正しく認識できない不具合を修正
-改行・空白を含まずに連続するencoded-wordsを正しくデコードできない不具合を修正
-ヘッダを含まないmultipartメッセージ等で解析に失敗する不具合を修正
**0.12
-元のメッセージの改行文字を保持するように修正
-Q-Encodeされた文字列を正しくデコードしない不具合を修正
-Q-EncodeおよびB-Encodeされた文字列を正しく認識できない場合がある不具合を修正
-メッセージの解析時に入力ストリームの8ビット目が損失する不具合を修正
-Quoted-Printableのデコード処理の不具合を修正
**0.11
-stringからインスタンスをコンストラクトできるようにした
**0.10
-初版
*動作状況
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.4
-Mono 2.7
version 0.13の時点では、手元にある計9,189通のメール(スパム、メーリングリスト・メールマガジンから、携帯から、添付ファイル付きなどを含む)を解析した結果、ほぼ正常に解析できています。 ただし解析した結果が「読める」かどうかまでは検証していません。 またMono 1.9ではJISからのデコードが出来ない場合があるようです。
*機能
現在対応している機能の一覧です。 部分的に対応しているものも含みます。
-セクションが指定されていないキー=値のペアの読み込み
-;および#で記述されるコメント行
-;および#で記述されるコメント行の読み込み
-セクション名・キー名の前後に空白が含まれている形式の読み込み
-セクション名・キー名の比較に任意のIEqualityComparer<string>を指定可能
-任意のConverter<string, TOutput>を指定することで任意の型に変換した上でキーの値を取得可能
-非Windows環境でも使用可(GetPrivateProfile*系のWin32 APIは使用していません)
*ダウンロード
#googleadunit
0.14以降はMIT X11ライセンスでのリリースとなります。 0.14より前のバージョンについては特に使用条件を定めていません。
-${smdncms:distfilelink,Smdn.Formats.Ini-0.14.tar.bz2}
-以前のバージョン
--[[works/tools/junk/TundereBird]]に含まれているものを使ってください
-開発版
--[[anonsvn]]よりチェックアウトできます
-0.1x
--${smdncms:distfilelink,Smdn.Formats.Ini-0.15.tar.bz2}
--${smdncms:distfilelink,Smdn.Formats.Ini-0.14.tar.bz2}
--上記以前のバージョン
---[[works/tools/junk/TundereBird]]に含まれているものを使ってください
*不具合・要望・質問等
不具合・要望・使い方の質問は[[掲示板>misc/forum/libs]]へどうぞ。
*サンプル
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]をご覧ください。
本ライブラリを使用したサンプルアプリケーション[[works/tools/junk/TundereBird]]もあわせてご覧ください。
**読み込み
Sambaの設定ファイルと同様の形式のテキストを読み込み、値を表示する例。
#code(cs){{
using System;
using System.IO;
using Smdn.Formats.Ini;
class IniSample {
public static void Main(string[] args)
{
var ini = @"
[global]
# Change this to the workgroup/NT-domain name your Samba server will part of
workgroup = WORKGROUP
# This will prevent nmbd to search for NetBIOS names through DNS.
dns proxy = no
# The specific set of interfaces / networks to bind to
# This can be either the interface name or an IP address/netmask;
# interface names are normally preferred
; interfaces = 127.0.0.0/8 eth0
[printers]
comment = All Printers
browseable = no
path = /var/spool/samba
printable = yes
guest ok = no
read only = yes
create mask = 0700
";
var config = IniDocument.Load(new StringReader(ini));
Console.WriteLine("[global]");
// キーの値をstringで取得
Console.WriteLine("workgroup: {0}", config["global"]["workgroup"]);
// yesならtrue、それ以外はfalseとして値を取得
Console.WriteLine("dns proxy: {0}", config["global"].Get("dns proxy",;
// キーが存在しない場合のデフォルトを指定して取得
Console.WriteLine("interfaces: {0}", config["global"].Get("interfaces", "(default interface)"));
// 同じくデフォルトを指定してbool型の値として取得
Console.WriteLine("wins support: {0}", config["global"].Get("wins support", false,;
// 条件にマッチするセクションを取得(config["printers"]と同じ)
var printers = config.Find((section) => section.Name == "printers");
Console.WriteLine("[printers]");
// デフォルトでは大文字小文字を無視してキー名を比較する
//
Console.WriteLine("read only: {0}", printers.Get("READ Only",;
Console.WriteLine("guest ok: {0}", printers.Get("guest ok",;
Console.WriteLine("path: {0}", printers.Get("path",;
Console.WriteLine("create mask: 0b{0}", Convert.ToString(printers.Get("create mask",;
}
}
}}
#prompt(実行結果){{
[global]
workgroup: WORKGROUP
dns proxy: False
interfaces:
wins support: False
[printers]
read only: True
guest ok: False
path: /var/spool/samba
create mask: 0b111000000
}}
**書き込み
desktop.iniを作成、ファイルとコンソールに出力する例。
#code(cs){{
using System;
using Smdn.Formats.Ini;
class IniSample {
public static void Main(string[] args)
{
var desktopIni = new IniDocument();
// .ShellClassInfoセクションを作成・取得
var shellClassInfo = desktopIni[".ShellClassInfo"];
// それぞれのキーと値を設定
shellClassInfo["InfoTip"] = "hoge";
shellClassInfo["IconFile"] = @"%SystemRoot%\system32\mydocs.dll";
shellClassInfo["IconIndex"] = "-101";
desktopIni.Save(@"D:\test\desktop.ini");
desktopIni.Save(Console.Out);
}
}
}}
#prompt(コンソールおよびD:\test\desktop.iniの出力結果){{
[.ShellClassInfo]
InfoTip=hoge
IconFile=%SystemRoot%\system32\mydocs.dll
IconIndex=-101
}}
*変更履歴
**0.1x
:0.14|ライセンスをMIT X11に変更
:0.13|[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
:0.12|[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
:0.11|行頭に空白およびタブを含むセクション・エントリを読み込めるようにした
:0.10|初版
**0.15
-機能追加
--任意の型変換用デリゲート(Converter<string, TOutput>)を指定して値を取得できるようにした
--セクション名・キー名の比較に任意のIEqualityComparer<string>を指定できるようにした
--セクションを削除できるようにした
-修正・改善
--ファイルの上書き時に以前の内容が残る場合がある不具合を修正
--個々のセクションの間に改行を入れて保存するように修正
--クラス名を変更
**0.14
-ライセンスをMIT X11に変更
**0.13
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
**0.12
-[[works/tools/junk/TundereBird]]バージョンアップに伴うリリース
**0.11
-行頭に空白およびタブを含むセクション・エントリを読み込めるようにした
**0.10
-初版
*動作状況
以下の環境で動作することを確認済みです。
-.NET Framework 3.5
-Mono 2.4
-Mono 2.7
*対応予定
今後対応する予定の機能です。
-元のフォーマット・コメントを維持した保存機能
-大文字小文字を無視した読み込み機能
-インデント・改行などのフォーマットを指定した保存機能
${smdncms:title,System.Net.Mail.SmtpClient}
${smdncms:keywords,System.Net.Mail,SmtpClient,MailMessage}
System.Net.Mail.SmtpClientの使い方、メールの送信方法など。
#googleadunit
*SmtpClientとMailMessageの使い方
**基本・メールを送信する
本文・ヘッダともにiso-2022-jpを使用してメールを送信する例。 コメントにあるように、ヘッダのエンコーディングにiso-2022-jpなどを指定しても正しいQエンコーディング文字列にはならないので、代わりに自前でBエンコードするようにする。
#code(cs){{
private static string GetBEncoded(string str, Encoding encoding)
{
return string.Format("=?{0}?B?{1}?=", encoding.HeaderName, Convert.ToBase64String(encoding.GetBytes(str)));
}
public static void Main()
{
var message = new MailMessage("from@mail.example.com", "to@mail.example.net");
message.Body = "本文";
message.BodyEncoding = Encoding.GetEncoding("iso-2022-jp");
/*
* http://support.microsoft.com/kb/933866/ja
* NET Framework 2.0 ベースのアプリケーションで MailMessage を使ってメッセージを送信すると送受信者名、件名が文字化けする
*/
message.Subject = GetBEncoded("件名", Encoding.GetEncoding("iso-2022-jp"));
var client = new SmtpClient("localhost", 25);
client.Send(message);
}}
**ヘッダの長さと折り返し
SubjectプロパティやHeadersプロパティでヘッダの内容を指定する場合、長さなどは制限されない上、折り返しもされない模様。
#code(cs){{
var message = new MailMessage(...);
// 送信されるメッセージのSubjectヘッダには360文字のxが折り返されずに指定される
message.Subject = new string('x', 360);
}}
また、改行やタブなどを含む文字列を指定することもできないので、無理矢理折り返させることも出来ない。
#code(cs){{
message.Subject = "line1\r\n\tline2\r\n\tline3"; // ArgumentException
message.Subject = "line1\r\n line2\r\n line3"; // ArgumentException
message.Subject = "line1\n line2\n line3"; // ArgumentException
message.Headers["Subject"] = "line1\r\n\tline2\r\n\tline3"; // FormatException
message.Headers["Subject"] = "line1\r\n line2\r\n line3"; // FormatException
message.Headers["Subject"] = "line1\n line2\n line3"; // FormatException
}}
*SmtpClientインスタンスの作成
**SMTPサーバとしてGMailを使用する
GMail SMTPサーバでは認証とSSLでの接続が必要になるため、CredentialsとEnableSsl設定する必要がある。
#code(cs){{
/*
* 前略
*/
var client = new SmtpClient("smtp.gmail.com", 587);
client.DeliveryMethod = SmtpDeliveryMethod.Network;
client.Credentials = new NetworkCredential("user", "pass");
client.EnableSsl = true;
client.Send(message);
}}
**SMTPサーバの設定にアプリケーション構成ファイルを使用する
SmtpClientのHost, Port, Credentailsなどのプロパティは、コンストラクタ等で明示的に指定しない場合、アプリケーション構成ファイルから設定が読み込まれる。 SMTPサーバが不変の場合などは、アプリケーション構成ファイルを使うことができる。
前項のGMailを使用する場合の例をアプリケーション構成ファイルを使って記述すると次のようになる。
#code(xml,test.exe.config){{
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.net>
<mailSettings>
<smtp deliveryMethod="network">
<network
host = "smtp.gmail.com"
port = "587"
userName = "user"
password = "pass"
/>
</smtp>
</mailSettings>
</system.net>
</configuration>
}}
ただし、EnableSslプロパティはアプリケーション構成ファイルでは指定できないので、コード中で指定するほかない。
#code(cs){{
/*
* 前略
*/
var client = new SmtpClient();
client.EnableSsl = true;
client.Send(message);
}}
.NET Framework 4からはアプリケーション構成ファイルで指定できる項目が増え、EnableSslプロパティに相当する属性も指定出来るようになる模様。