萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 一般處理程式 完整解析:原理、優勢與三大經典應用場景

什麼是一般處理程式?

一般處理程式 是相對於 `.aspx` 網頁表單的一種輕量級 HTTP 請求處理機制。它實作 IHttpHandler 介面,直接處理請求與回應,不經過完整的頁面生命週期 (無 Init、Load、Render 等事件),因此效能極高。

Visual Studio 建立 `.ashx` 時會產生兩個檔案:

  • Handler.ashx:標記檔,指定 `CodeBehind` 與 `Class`
  • Handler.ashx.cs:實作邏輯的 C# 類別

標準實作範本

<%@ WebHandler Language="C#" Class="web.Handler" %>

// Handler.ashx.cs
using System.Web;

namespace web
{
    public class Handler : IHttpHandler
    {
        public void ProcessRequest(HttpContext context)
        {
            context.Response.ContentType = "text/plain";
            context.Response.Write("Hello World");
        }

        public bool IsReusable => false; // 是否可跨請求重用,通常為 false
    }
}

核心優勢比較

特性.aspx 網頁表單.ashx 一般處理程式
基底類別Page無 (實作 IHttpHandler)
生命週期完整 (Init, Load, PreRender, Render...)單一 ProcessRequest 方法
ViewState支援不支援
控制項樹完整控制項模型無
資源消耗較高極低
適用場景完整 HTML 頁面API、檔案下載、圖片處理、AJAX 端點

三大經典應用場景完整實作

場景一:圖片防盜鏈 / 動態圖片輸出

public class ImageHandler : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        string referer = context.Request.UrlReferrer?.Host ?? "";
        string allowedDomain = "mysite.com";
        
        // 防盜鏈檢查
        if (!referer.EndsWith(allowedDomain))
        {
            context.Response.StatusCode = 403;
            context.Response.ContentType = "image/png";
            // 輸出預設「防盜鏈」圖片
            context.Response.WriteFile("~/Images/hotlink-denied.png");
            return;
        }

        string imagePath = context.Server.MapPath("~/Images/photo.jpg");
        context.Response.ContentType = "image/jpeg";
        context.Response.WriteFile(imagePath);
    }
    public bool IsReusable => true; // 靜態圖片可重用
}

場景二:驗證碼圖片產生 (無 Session 依賴)

public class CaptchaHandler : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        string code = GenerateCode(4);
        context.Session["CaptchaCode"] = code; // 或用分散式快取
        
        using (var bitmap = new Bitmap(100, 36))
        using (var g = Graphics.FromImage(bitmap))
        using (var ms = new MemoryStream())
        {
            // 繪製干擾線、文字... (參考前文驗證碼範例)
            g.Clear(Color.White);
            // ... 繪製邏輯 ...
            
            bitmap.Save(ms, ImageFormat.Gif);
            context.Response.ClearContent();
            context.Response.ContentType = "image/gif";
            context.Response.BinaryWrite(ms.ToArray());
        }
    }
    public bool IsReusable => false;
}

場景三:自訂副檔名映射 / RESTful API 端點

需在 `web.config` 註冊副檔名對應:

<system.webServer>
    <handlers>
        <add name="ApiHandler" verb="*" path="*.api" 
             type="MyProject.ApiHandler, MyProject" />
    </handlers>
</system.webServer>
public class ApiHandler : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        string action = context.Request.PathInfo.TrimStart('/'); // /user/get → user/get
        context.Response.ContentType = "application/json";
        
        switch (action.ToLower())
        {
            case "user/get":
                context.Response.Write("{\"id\":1,\"name\":\"張三\"}");
                break;
            case "user/list":
                context.Response.Write("[{\"id\":1},{\"id\":2}]");
                break;
            default:
                context.Response.StatusCode = 404;
                context.Response.Write("{\"error\":\"Not Found\"}");
                break;
        }
    }
    public bool IsReusable => true;
}

進階主題:IHttpAsyncHandler 非同步處理

長時間運作的處理程式 (如大檔案轉換、外部 API 呼叫) 應實作非同步介面避免阻塞執行緒池:

public class AsyncHandler : IHttpAsyncHandler
{
    public IAsyncResult BeginProcessRequest(HttpContext context, AsyncCallback cb, object extraData)
    {
        var task = Task.Run(() => DoWork(context));
        return task.ContinueWith(t => cb(t));
    }

    public void EndProcessRequest(IAsyncResult result) { }

    public void ProcessRequest(HttpContext context) 
    { 
        throw new NotSupportedException("請使用非同步版本"); 
    }

    public bool IsReusable => false;

    private void DoWork(HttpContext context)
    {
        // 耗時操作...
        context.Response.Write("完成");
    }
}

常見坑點與最佳實踐

  1. ContentType 必須正確設定:`application/json`、`image/png`、`text/xml` 等,否則前端解析失敗
  2. 避免使用 Session:預設 `IsReusable=false` 但若啟用 Session 會鎖定 Session,併發效能大幅下降。必要時實作 `IReadOnlySessionState` 或 `IRequiresSessionState`
  3. 大檔案輸出用 `TransmitFile`:`Response.TransmitFile(path)` 直接由 IIS 發送,不經 ASP.NET 記憶體
  4. 錯誤處理:包裝 try-catch,回傳標準 HTTP 狀態碼與 JSON 錯誤格式
  5. 路由衝突:ASP.NET MVC/WebAPI 路由優先級高於 `.ashx`,注意路徑設計

現代替代方案

  • ASP.NET Core:Middleware、Minimal API、Controller 取代 Handler
  • ASP.NET Web API:標準 REST API 框架
  • Azure Functions / AWS Lambda:Serverless 無伺服器架構

總結

一般處理程式 是 ASP.NET 傳統架構中處理非 HTML 輸出的最佳選擇:效能高、無 ViewState 負擔、部署簡單。掌握其原理與三大經典場景 (圖片處理、驗證碼、自訂 API),能在維護舊系統或特定輕量級需求時遊刃有餘。現代專案建議遷移至 ASP.NET Core Middleware 或 Minimal API 獲得更好的架構支援。

copyright © 萬盛學電腦網 all rights reserved