ずん日記

去年は凶だったが今年は 大吉 だった。
弟が1番で大吉。僕が2番で大吉だった。
今年は本厄だが今年も良い年でありますように（−人−）

何故か僕が一番濡れていた。
毛皮のコートとかは水はじくみたいで良いなぁと思った。

こだまで帰った。
帰省時と同じく終電のこだまはやっぱり空いていた。
少し眠った。

豚肉のなんとか風 *1 とミネストローネをご馳走になった。 美味しかった。

重要。

５時半に終わったよー♪
久しぶりの早い帰宅。

何故かみんなとはぐれたので数人で適当な飯屋に入ってしまった。
ランチタイム真っ只中というのに自分たち以外誰も居ない店内…。 味はまずまずだけど量が少なかった。
戻って他の人達に聞いたところみんなで美味いカレー屋に言ったとのこと。 美味いカレー食べたかったな。

XML コメントはソースファイルからドキュメント作成用に記述するものなので コンパイルされたアセンブリには XML コメントは含まれていません。 その証拠に XML コメントをいくら記述してもアセンブリのファイルサイズは変わりません。
VS.NET でプロジェクトを参照設定すると XML コメントが表示されるのは ソースコードがそこにあるから単に VS.NET が気を利かせてくれてるだけだと思ってます。

実際に DLL で参照設定をしたときに XML コメントを Visual Studio 等のツールで 有効にする為にはどうしたらよいかというと、やりかたは以下の通り。
ソースファイルから生成された XML ドキュメントを『アセンブリ名.xml』 としてアセンブリと同じディレクトリに置いておくことで IntelliSense がそれを読み込んでコメントを表示してくれるようになります。
XML ドキュメントの生成方法はこんな感じ↓。

• コマンドラインの場合は csc.exe の引数に /doc:○○.xml を追加すると生成されます。
• Visual Studio .NET で開発している場合はプロジェクトのプロパティを開いて、 「構成プロパティ」の「ビルド」の「XML ドキュメントファイル」に『アセンブリ名.xml』 と入力しておくとビルド時に XML ドキュメントの生成も行ってくれます。

同じようなモノで、プロパティエディタの下部に表示されるコメントに関しては、 アセンブリの属性（DescriptionAttribute）を利用して実現されています。
具体的にはプロパティ名、イベント名、etc... の宣言の前に [Description("コメント")] と書いてあげます。
こちらはコンパイル時に DLL に含まれるので DLL の参照だけで利用することが出来ます。

写真をぱっと見て美味そうだったので 『かぼちゃのクリームスープ』と『ナスのトマトソーススパ』をさくっと頼んだのさ。
定員のお姉さんが何故か怪訝そうな顔で

どちらを先にお持ちしますか？

とか聞いてくるので不思議に思いつつ「どっちでもいいよ、一緒に持ってきて。」と答えた。
まず最初に来たのは…『かぼちゃのクリームスープ スパ 』!! …あれはそういう意味だったのか。
スープかと思ってたらスパを見落としてたのね。
食い始めるとすぐにもう一皿ナススパがドーンと。 目の前にはスパ２人前、 あぁ、食ったさそりゃー美味かったさ。
美味かったからまた今度行ってやるよチクショー。
美味かったけどとても負けた気分だった。

Response.Cache.SetCacheability(HttpCacheability.NoCache);

Response.ContentType = "application/pdf";
Response.AddHeader("Content-Disposition", "atachment; filename=hoge.pdf");

hoge.pdf の部分は拡張子が pdf な任意のファイル名を指定する。

GZIP圧縮する為のフィルタクラスを作り、 Response.Filter にセットすることで実現できます。
具体的には Page の Init イベントや Load イベントに以下の２行 *1 を追加してやります。

Response.AddHeader("Content-Encoding", "gzip");
Response.Filter = new Jp.Kawaz.Web.Util.GZipFilter(Response.Filter);

ここで使っている GZipFilter クラスのソースは以下の通りです。
.NET フレームワークには圧縮アルゴリズムが無いので SharpZipLib *2 というライブラリを使用しています。 ここからダウンロードした DLL を bin フォルダに置いておいて下さい。

using System;
using System.IO;
using ICSharpCode.SharpZipLib.GZip;

namespace Jp.Kawaz.Web.Util
{
    /// <summary>
    /// 出力ストリームを圧縮する為のフィルタです。
    /// <example>
    /// <remarks>
    /// 内容が html なら10分の1程度までトラフィックが軽減されると思います。
    /// </remarks>
    /// <example>
    /// Page の Load イベントや Init イベント等に以下の２行を追加することで
    /// クライアントへの送信が gzip 圧縮されます。
    /// <code>
    /// Response.AddHeader("Content-Encoding", "gzip");
    /// Response.Filter = new Jp.Kawaz.Web.Util.GZipFilter(Response.Filter);
    /// </code>
    /// ※注意※<br>
    /// Content.Server.Transfer を使う場合、ヘッダはクリアされるが Filter は
    /// GZipFilter のままなので Transfer される側のページでは
    /// Response.AddHeader("Content-Encoding", "gzip");
    /// のみを行うこと。
    /// </example>
    /// </summary>
    public class GZipFilter : MemoryStream
    {
        private Stream sink;

        public GZipFilter(Stream sink) : base()
        {
            this.sink = sink;
        }

        public override void Close() 
        {
            GZipOutputStream gzip = new GZipOutputStream(sink);
            WriteTo(gzip);
            gzip.Close();
            base.Close();
        }
    }
}

ほんとは Response.Filter = new ICSharpCode.SharpZipLib.GZip.GZipOutputStream(Response.Filter); の様に使おうとしたんだがコレだとエラーになったので 上記の様なクラスを作った。

このままだと全てのクライアントに対して gzip 圧縮したコンテンツを返してしまうので gzip を理解できないクライアントではそのページを見ることが出来なくなってしまう。
なので Filter を設定する部分は本来以下のようにするべきである。

foreach(string enc in Request.ServerVariables["HTTP_ACCEPT_ENCODING"].Trim().ToLower().Split(',')) 
{
    if(enc.Equals("gzip") || enc.Equals("x-gzip"))
    {
        Response.AddHeader("Content-Encoding", "gzip");
        Response.Filter = new Jp.Kawaz.Web.Util.GZipFilter(Response.Filter);
        break;
    }
}

GZipFilter のみを実装して利用する場合は上で説明したように、 各 aspx ページに GZipFilter を使う為の記述が必要だったが各ページでこれを行うのは とても面倒いし、間違えて２重に Filter を設定してしまったり、また Response.Server.Transfer を行う場合に不具合が発生しやすいなどの理由で あまり良いやり方ではないと思っていた。
そこで IHttpModule を継承して HTTP モジュールとして GZipModule を作り Web.config でそれを使うよう記述するだけで全てのコンテンツで gzip 圧縮を 有効にしようと頑張ってみた。

それで出来たのが以下に示す GZipModule です。

using System;
using System.Web;

namespace Jp.Kawaz.Web.Util
{
    /// <summary>
    /// レスポンスを圧縮する為の HTTP モジュールです。
    /// </summary>
    /// <remarks>
    /// ブラウザが gzip を解釈できる場合は HTTP のレスポンスを gzip 圧縮します。
    /// これにより text/html なコンテンツなら10分の1程までトラフィックを軽減することが出来ます。
    /// </remarks>
    /// <example>
    /// 使い方は Web.config に GZipModule を使うように以下の記述を追加するだけです。
    /// <code>
    /// &lt;configuration&gt;
    ///   &lt;system.web&gt;
    ///     &lt;httpModules&gt;
    ///       &lt;add name="GzipModule"
    ///         type="Jp.Kawaz.Web.Util.GzipModule, Jp.Kawaz.Web.Util" /&gt;
    ///     &lt;/httpModules&gt;
    ///   &lt;system.web&gt;
    /// &lt;/configuration&gt;
    /// </code>
    /// </example>
    public class GZipModule : IHttpModule
    {
        void IHttpModule.Dispose()
        {
        }

        void IHttpModule.Init(HttpApplication context) 
        {
            context.BeginRequest += new EventHandler(OnBeginRequest);
        }

        private void OnBeginRequest(object sender, EventArgs e) 
        {
            HttpApplication context = (HttpApplication)sender;
            foreach(string enc in
                context.Request.ServerVariables["HTTP_ACCEPT_ENCODING"].Trim().ToLower().Split(',')) 
            {
                if(enc.Equals("gzip"))
                {
                    context.Response.AddHeader("Content-Encoding", "gzip");
                    context.Response.Filter = new AESC.Web.Lib.GZipFilter(context.Response.Filter);
                    break;
                }
                else if(enc.Equals("x-gzip"))
                {
                    context.Response.AddHeader("Content-Encoding", "x-gzip");
                    context.Response.Filter = new AESC.Web.Lib.GZipFilter(context.Response.Filter);
                    break;
                }
            }
        }    
    }
}

このモジュールを利用するように Web.config に以下のように httpModules に add する。

<configuration>
  <system.web>
    <httpModules>
      <!-- ブラウザが gzip を解釈できる場合はレスポンスを gzip 圧縮します。-->
      <add name="GZipModule" type="Jp.Kawaz.Web.Util.GZipModule, Jp.Kawaz.Web.Util"/>
    </httpModules>
  </system.web>
</configuration>

ここで、<add> の type の記述方法だが、詳しくは MSDN を見て欲しいが、 簡単に説明すると一つ目が IHttpModule を継承するクラスのフルネームで 次の Jp.Kawaz.Web.Util はこのモジュールが含まれるアセンブリ名です。
例えばこの例では Jp.Kawaz.Web.Util.dll にこのモジュールが含まれていることを 表しています。
当然 WEB フォルダの bin ディレクトリにはこの dll を置いておく必要があります。

GZipModule を適用すると asmx ページ、つまり Web サービスが動かなくなる不具合が 発覚しました。
場当たり的な対策 を書いたので参照すること。

しかし当然実際に使ってみようと思えば何も考えずに書いたコードならば９割方は SecurityException で動かないだろう。
ここを乗り越えるのがマジ大変。
そしてこの件に関する情報がホントに無いのが困りモノなのである。

Visual C#.NETによるWebプログラミング入門―XML WebサービスとWebアプリケーション構築のノウハウ
これはスマートクライアントと .NET のコードアクセスセキュリティについての 書籍としては是非読んでおきたい。
っていうかこの本でも充分には解説されているわけではないが、 今のところこの本以外でスマートクライアントの実行について詳しく書いている 書籍やサイトは見たことが無い。
ホントにドキュメントが少ないのだ…。
この本を他のサイトで照会してるのを発見して即 amazon でゲット。
表紙の雰囲気等からパッと見内容が薄そうなんだが、 ところどころ詳しい解説があってなかなか侮れない。 特に60ページにわたるスマートクライアントの解説は必見だと思った。

上記リンクから購入してくれると僕に amazon から紹介料が入るらしい。 初めて設置してみたのでどうなるのか誰か試してもらいたい（笑
っていうか自分で買うときもここ経由で買うと紹介料入るらしいので 実質的に割引で本が買えるということか（ぉ
今後本を買うときはこのてを使ってみようと思う。

これについて調べてみたがどこかのフラグで 8.3 形式ファイル名を 無効に出来るようなことは出てこない。
つまり拡張子が txt なファイルの一覧が欲しければ以下のようにするしかないっぽい。

foreach(string fname in Directory.GetFiles(dirName)
{
    if(fname.EndWith(".txt"))
    {
        （何かの処理）
    }
}

うーむ、かなり怒る…。

private void OnBeginRequest(object sender, EventArgs e) 
{
    HttpApplication context = (HttpApplication)sender;
    //WEBサービスだったら何もしない
    if(context.Request.FilePath.EndsWith(".asmx")) 
    {
        return;
    }
    //ACCEPT_ENCODING を見て GZipFilter をセットする
    （…以下略…）
}

結論は wsdl.exe で wsdl から生成したプロキシクラスは Accept-Encoding を送ってない 為、gzip 圧縮がされません。
しかし普通なら圧縮されないだけですが実は GZipModule に不具合があり Accept-ncoding が送られてこない場合に例外が発生してエラーになってしまっていました。
ですのでそこを修正します。
修正個所は GZipModule の OnBeginRequest メソッドです。 以下が修正部分です。

private void OnBeginRequest(object sender, EventArgs e) 
{
	HttpApplication context = (HttpApplication)sender;
	//ACCEPT_ENCODING が送られていない場合は何もしない
	string strAcceptEncoding = context.Request.ServerVariables["HTTP_ACCEPT_ENCODING"];
	if(strAcceptEncoding == null) 
	{
		return;
	}
	//ACCEPT_ENCODING を見て GZipFilter をセットする
	foreach(string enc in strAcceptEncoding.Trim().ToLower().Split(',')) 
	{
		if(enc.Equals("gzip"))
		{
			context.Response.AddHeader("Content-Encoding", "gzip");
			context.Response.Filter = new AESC.Web.Lib.GZipFilter(context.Response.Filter);
			break;
		}
		else if(enc.Equals("x-gzip"))
		{
			context.Response.AddHeader("Content-Encoding", "x-gzip");
			context.Response.Filter = new AESC.Web.Lib.GZipFilter(context.Response.Filter);
			break;
		}
	}
}