HttpHandlerの登録
12146 ワード
カスタムHttpHandlerを作成した後、ASPを構成する必要があります.NETは、入力された特定のURLに対するHTTP要求をハンドラにマッピングする.次の手順では、必要な手順を説明します.
HttpHandlerの登録アプリケーションの仮想ルートディレクトリの下の/binディレクトリでHttpHandlerをコンパイルして配置する.NETクラス. アプリケーションのWeb.configプロファイルに同期または非同期のHttpHandlerを登録します.次の例では、すべてのHTTP要求をコンフィギュレーション・セクションのアイテムには、次の表に示す3つのプロパティがあります.
ツールバーの
説明
パス
パス属性には、単一のURLパスまたは単純なワイルドカード文字列(*.aspxなど)を含めることができます.
を選択します.
カンマで区切られたクラス/プログラムセットの組合せを指定します.ASP.NETは、まずアプリケーションの専用/binディレクトリでプログラムセットDLLを検索し、次にシステムプログラムセットキャッシュでプログラムセットDLLを検索する.
述語
述語リストは、カンマで区切られたHTTPメソッドリスト(例えば、「GET,PUT,POST」)であってもよいし、スクリプトマッピングの開始(例えば、ワイルドカード*[アスタリスク])であってもよい.
HttpHandlerファイル拡張子がインターネット情報サービス(IIS)に登録されていることを確認します.
この項では、次のコードの例を示します.同期HttpHandler 非同期HttpHandler HttpHandler工場
以下のコードはASP.NETアプリケーションで特定のMyAppを処理する.MyHello URLのリクエスト.次に、HttpHandlerの登録に必要なプロファイルの変更が表示されます.
WebでconfigでカスタムHttpHandlerを登録するアイテムを作成します.以下に示します.
以下のコードはASP.NETアプリケーションにおける特定の*への登録と処理MyAsynch URLのリクエスト.この場合、プロセッサは、プロセスを示すためにいくつかの時点でユーザに応答を送信する時間のかかるプロセスを開始する.次に、HttpHandlerの登録に必要なプロファイルの変更が表示されます.
Webでconfigでは、次のようにカスタム非同期HttpHandlerを登録するアイテムを作成します.
HttpHandlerの登録
Myhandler.dll
ファイルのMyHandler
プログラムセットのMyHandler.New
クラスおよびMyHandler.Fin
クラスにマッピングする.<configuration>
<system.web>
<httpHandlers>
<add verb="*" path="MyHandler.New"
type="MyHandler.New, MyHandlerAssembly" />
<add verb="*" path="*.myNewFileNameExtension"
type="MyHandler.Fin, MyHandlerAssembly" />
</httpHandlers>
<system.web>
</configuration>
ツールバーの
説明
パス
パス属性には、単一のURLパスまたは単純なワイルドカード文字列(*.aspxなど)を含めることができます.
を選択します.
カンマで区切られたクラス/プログラムセットの組合せを指定します.ASP.NETは、まずアプリケーションの専用/binディレクトリでプログラムセットDLLを検索し、次にシステムプログラムセットキャッシュでプログラムセットDLLを検索する.
述語
述語リストは、カンマで区切られたHTTPメソッドリスト(例えば、「GET,PUT,POST」)であってもよいし、スクリプトマッピングの開始(例えば、ワイルドカード*[アスタリスク])であってもよい.
HttpHandlerの例
この項では、次のコードの例を示します.
同期HttpHandler
以下のコードはASP.NETアプリケーションで特定のMyAppを処理する.MyHello URLのリクエスト.次に、HttpHandlerの登録に必要なプロファイルの変更が表示されます.
[C#]
using System.Web;
public class HelloWorldHandler : IHttpHandler {
public void ProcessRequest(HttpContext context) {
HttpRequest Request = context.Request;
HttpResponse Response = context.Response;
// A file ending in .MyHello need not exist. This handler executes
// whenever a file ending in .MyHello is requested.
Response.Write("<html>");
Response.Write("<body>");
Response.Write("<h1> Hello from Synchronous custom handler. </h1>");
Response.Write("</body>");
Response.Write("</html>");
}
public bool IsReusable {
// To enable pooling, return true here.
// This keeps the handler in memory.
get { return false; }
}
}
[Visual Basic]
Imports System.Web
Public Class HelloWorldHandler
Implements IHttpHandler
Public Sub ProcessRequest(ByVal context As System.Web.HttpContext) Implements System.Web.IHttpHandler.ProcessRequest
Dim request As HttpRequest = context.Request
Dim response As HttpResponse = context.Response
' A file named ending in .MyHello need not exist. This handler
' executes whenever a file ending in .MyHello is requested.
response.Write("<html>")
response.Write("<body>")
response.Write("<h1> Hello from Synchronous custom handler. </h1>")
response.Write("</body>")
response.Write("</html>")
End Sub
Public ReadOnly Property IsReusable() As Boolean Implements System.Web.IHttpHandler.IsReusable
Get
Return False
End Get
End Property
End Class
WebでconfigでカスタムHttpHandlerを登録するアイテムを作成します.以下に示します.
<configuration>
<system.web>
<httpHandlers>
<add verb="*" path="*.MyHello"
type="HelloWorldHandler,httpruntime" />
</httpHandlers>
</system.web>
</configuration>
非同期HttpHandler
以下のコードはASP.NETアプリケーションにおける特定の*への登録と処理MyAsynch URLのリクエスト.この場合、プロセッサは、プロセスを示すためにいくつかの時点でユーザに応答を送信する時間のかかるプロセスを開始する.次に、HttpHandlerの登録に必要なプロファイルの変更が表示されます.
[C#]
using System;
using System.Web;
using System.Threading;
namespace Handlers
{
class AsynchHandler : IHttpAsyncHandler
{
private HttpContext _context;
public bool IsReusable
{
get
{
// To enable pooling, return true here.
// This keeps the handler in memory.
return false;
}
}
public IAsyncResult BeginProcessRequest(HttpContext context, AsyncCallback cb, Object extraData)
{
// Now do something that might take a while.
MyAsynchOperation asynch = new MyAsynchOperation(cb, context);
asynch.KickOffThread();
context.Response.Write("BeginProcessRequest. Just kicked off a Thread.<br>");
context.Response.Flush();
// Signal the application that asynchronous
// processing is being performed.
SomeResult asynchForBegin = new SomeResult();
// Processing is not synchronous.
asynchForBegin.SetSynch(false);
// Processing is not complete.
asynchForBegin.SetCompleted(false);
_context = context;
return new SomeResult();
}
public void EndProcessRequest(IAsyncResult result)
{
_context.Response.Write("EndProcessRequest called.<br>");
}
// This method is required but is not called.
public void ProcessRequest(HttpContext context)
{
}
}//end class
public class SomeResult : IAsyncResult
{
/*
An instance of this class is returned to the application.
This class lets the application know how the BeginEventHandler method
has been handled. The application checks the CompletedSynchronously
method.
*/
private bool _blnIsCompleted = false;
private Mutex myMutex = null;
private Object myAsynchStateObject = null;
private bool _blnCompletedSynchronously = false;
public void SetCompleted(bool blnTrueOrFalse)
{
_blnIsCompleted = blnTrueOrFalse;
}
public void SetSynch(bool blnTrueOrFalse)
{
_blnCompletedSynchronously = blnTrueOrFalse;
}
public bool IsCompleted
{
// This is not called by the application.
// However, set it to true.
get { return _blnIsCompleted; }
}
public WaitHandle AsyncWaitHandle
{
// The application does not call this method.
get { return myMutex; }
}
public Object AsyncState
{
// The application does not call this method because
// null is passed in as the last parameter to
// BeginEventHandler.
get { return myAsynchStateObject; }
}
public bool CompletedSynchronously
{
// The application wants to know if this is synchronous.
// Return true if the Begin method was called synchronously.
get { return _blnCompletedSynchronously; }
}
}
}
[Visual Basic]
Imports System
Imports System.Web
Imports System.Threading
Namespace handler
Public Class AsynchHandler
Implements IHttpAsyncHandler
Private _context As HttpContext
Public ReadOnly Property IsReusable() As Boolean Implements System.Web.IHttpAsyncHandler.IsReusable
Get
Return False
End Get
End Property
Public Function BeginProcessRequest(ByVal context As System.Web.HttpContext, ByVal cb As System.AsyncCallback, ByVal extraData As Object) As System.IAsyncResult Implements System.Web.IHttpAsyncHandler.BeginProcessRequest
Dim asynch As New MyAsynchOperation(cb, context)
asynch.KickOffThread()
context.Response.Write("BeginProcessRequest. Just kicked off a Thread.<br>")
context.Response.Flush()
' Signal the application that asynchronous
' processing is being performed.
Dim asynchForBegin As New SomeResult()
' Processing is not synchronous.
asynchForBegin.SetSynch(False)
' Processing is not complete.
asynchForBegin.SetCompleted(False)
_context = context
Return New SomeResult()
End Function
Public Sub EndProcessRequest(ByVal result As System.IAsyncResult) Implements System.Web.IHttpAsyncHandler.EndProcessRequest
_context.Response.Write("EndProcessRequest called.<br>")
End Sub
Public Sub ProcessRequest(ByVal context As System.Web.HttpContext) Implements System.Web.IHttpAsyncHandler.ProcessRequest
' Ths is required but is not called.
End Sub
End Class
Class SomeResult
Implements IAsyncResult
Private _blnIsCompleted As Boolean = False
Private myMutex As Mutex = Nothing
Private myAsynchStateObject As Object = Nothing
Private _blnCompletedSynchronously As Boolean = False
Public Sub SetCompleted(ByVal blnTrueOrFalse As Boolean)
_blnIsCompleted = blnTrueOrFalse
End Sub
Public Sub SetSynch(ByVal blnTrueOrFalse As Boolean)
_blnCompletedSynchronously = blnTrueOrFalse
End Sub
Public ReadOnly Property AsyncState() As Object Implements System.IAsyncResult.AsyncState
Get
Return myAsynchStateObject
End Get
End Property
Public ReadOnly Property AsyncWaitHandle() As System.Threading.WaitHandle Implements System.IAsyncResult.AsyncWaitHandle
Get
Return myMutex
End Get
End Property
Public ReadOnly Property CompletedSynchronously() As Boolean Implements System.IAsyncResult.CompletedSynchronously
Get
Return _blnCompletedSynchronously
End Get
End Property
Public ReadOnly Property IsCompleted() As Boolean Implements System.IAsyncResult.IsCompleted
Get
Return _blnIsCompleted
End Get
End Property
End Class
End Namespace
Webでconfigでは、次のようにカスタム非同期HttpHandlerを登録するアイテムを作成します.
<configuration>
<system.web>
<httpHandlers>
<add verb="GET,POST" path="*.MyAsynch"
type="Handlers.AsynchHandler, Handlers" />
</httpHandlers>
</system.web>
</configuration>