[转]为ReportViewer导出的PDF文档加上水印

接到一個頗富挑戰性的需求，Reporting Service或RDLC報表可匯出成Excel、PDF等檔案格式，對一般麻瓜型使用者而言，PDF唯讀，Excel則可修改，業務單位希望在拿到報表紙本時加以區分；換句話說，如果能讓PDF與Excel檔的列印結果有別，即可做為報表結果是否唯讀，有無被修改可能的依據。(姑且排除使用者設法修改PDF檔或將Excel仿製成PDF樣式的情境)

我想到一個做法是為匯出的PDF檔加上浮水印。同一張報表匯出的Word、Excel、PDF檔內容理應一致，當PDF檔被加註浮水印，便足以形成區隔。在PDF檔加上浮水印非難事，用iTextSharp應可搞定，但匯出PDF檔的過程本屬ReportViewer內部運作，不容外人插手，要在匯出PDF檔時動手腳需要點Hacking，好一個讓程式魔人熱血沸騰的挑戰!

分析問題的第一步，先剖析ReportViwer匯出PDF檔的原理:

當執行PDF匯出動作時，實際上是呼叫ReportViewer加掛的HttpHandler，web.config可以看到相關設定:

<add path="Reserved.ReportViewerWebControl.axd" verb="*" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=11.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" validate="false" />

在網頁按匯出鈕時，瀏覽器被導向特定URL，傳入OpMode=Export、Format=PDF參數，由HttpHandler傳回當下檢視報表的PDF檔。如要在此過程動手腳，有個不錯的切入點是透過Global.asax或HttpModule攔截BeginRequest事件，遇到呼叫Reserved.ReportViewerWebControl.axd匯檔案時加入自訂邏輯，修改要傳回的檔案內容。但ReportViewer的HttpHandler在PDF檔產生後便立刻寫入HttpRepsonse傳回客戶端，輪不到我們插手，因此下一個挑戰是如何攔截並修改其內容。

此時，ASP.NET的另一個好用機制派上用場: Response.Filter，它允許我們在HttpResponse將結果byte[]寫入輸出Stream之前，先交由我們自訂的Stream物件處理，可以實現修改後再傳至客戶端的目的。

排版顯示純文字

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Web;

public class ExpFileFilterStream : MemoryStream
{
    private Stream output = null;
    Func<byte[], byte[]> modifier = null;
    private HttpResponse response = null;
    private bool firstFlush = false;
    public ExpFileFilterStream(HttpResponse resp, Func<byte[], byte[]> modifier)
    {
        response = resp;
        output = resp.Filter;
        this.modifier = modifier;
    }
    public override void Write(byte[] buffer, int offset, int count)
    {
        //由於ReportViewer會關閉BufferOutput，並分成多段Flush傳回前端，
        //在此重新啟用Buffer功能(因必須得到檔案完整內容再處理)，
        //但會漏掉第一次的Flush()，藉以以下邏輯避免第一次部分Flush()
        //註: ReportViewer在分段Flush的大小為81920，當少於此值表示不需略過Flush
        if (!response.BufferOutput && count == 81920)
        {
            response.BufferOutput = true;
            firstFlush = true;
        }
        base.Write(buffer, offset, count);
    }
    public override void Flush()
    {
        if (firstFlush)
        {
            firstFlush = false;
            return;
        }
        //Flush時，將要傳回內容byte[]交由外部邏輯處理後再取回
        byte[] buff = base.ToArray();
        if (modifier != null)
            buff = modifier(buff);
        output.Write(buff, 0, buff.Length);
    }
}

我寫了一個簡單的Filter Stream物件，原理是在Write()時先蒐集ReportViewer HttpHandler要傳回的檔案內容，當Flush()要傳回結果時，將先前接收到的PDF檔案內容(byte[])交由外部邏輯，Func<byte[], byte[]>，進行加蓋浮水印處理，再傳回修改版檔案到真正的OutputStream。

其中有小技巧: ReportViewer HttpHandler為了減少記憶體耗用及提高回應效率，會將Response.BufferOutput設為false，讓匯出檔案內容分成多段Flush()傳回(每段不超過81920 bytes)。由於我們需要接收完整檔案才能進行修改並一次回傳，故不容先傳回部分未修改內容的情形發生。在Write()將Response.BufferOutput改回true即可偷偷取消分段傳回，唯此時第一個分段的Flush()已箭在弦上，故要用一個firstFlush旗標避開第一次Flush()。之後因Response.BufferOutput已被設為true，會等到全部的PDF檔都透過Write()寫入才呼叫Flush()，此時MemoryStream所保存的便是完整PDF檔內容。

在BeginRequest事件加掛Response.Filter的工作，則寫成一個HttpModule。程式很單純，較花工夫的是透過iTextSharp在PDF左上角印上PDF yyyy/MM/dd HH:mm:ss樣式的半透明浮水印，iText歷史悠久、功能強大，網路上不難找到現成範例，很順利就完成了。

排版顯示純文字

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Web;
using iTextSharp.text.pdf;
using iText = iTextSharp.text;
using iTextSharp.text;
using System.IO;

namespace ReportViewerHacking
{
    public class WaterMarkModule : IHttpModule
    {
        #region IHttpModule Members

        public void Dispose()
        {
        }

        public void Init(HttpApplication context)
        {
            context.BeginRequest += context_BeginRequest;
        }

        void context_BeginRequest(object sender, EventArgs e)
        {
            HttpApplication app = sender as HttpApplication;
            string url = app.Context.Request.RawUrl;
            var context = app.Context;
            if (url.Contains("Reserved.ReportViewerWebControl.axd"))
            {
                var req = context.Request;
                var resp = context.Response;
                string opType = req["OpType"];
                string name = req["Name"];
                string format = req["Format"];
                if (opType == "Export" && format == "PDF")
                {
                    resp.BufferOutput = true;
                    resp.Filter = new ExpFileFilterStream(resp, (buff) =>
                    {
                        //輸入PDF內容，加上浮水印
                        PdfReader pr = new PdfReader(buff);
                        iText.Rectangle dimension = pr.GetPageSize(1);
                        MemoryStream ms = new MemoryStream();
                        PdfStamper stmp = new PdfStamper(pr, ms);
                        //REF: http://bit.ly/10qirzK
                        BaseFont bf =
                            BaseFont.CreateFont(BaseFont.TIMES_ROMAN, BaseFont.CP1252, false);
                        iText.Font fnt = new iText.Font(bf, 6, iText.Font.NORMAL, BaseColor.BLACK);
                        PdfContentByte cb = stmp.GetOverContent(1);
                        //設定半透明文字
                        PdfGState gstate = new PdfGState();
                        gstate.FillOpacity = 0.2f;
                        gstate.StrokeOpacity = 0.2f;
                        cb.SetGState(gstate);
                        cb.BeginText();
                        cb.SetFontAndSize(bf, 6);
                        cb.SetColorFill(BaseColor.BLACK);
                        cb.ShowTextAligned(PdfContentByte.ALIGN_LEFT,
                            string.Format("PDF {0:yyyy-MM-dd HH:mm:ss}", DateTime.Now),
                            dimension.GetLeft(1), dimension.GetTop(5), 0);
                        cb.EndText();

                        stmp.Close();
                        pr.Close();
                        return ms.ToArray();
                    });
                }
            }
        }
        #endregion
    }
}

將HttpModule掛進ASP.NET網站，之後只要ReportViewer匯出PDF檔，就一律會被偷偷加上浮水印，讓我過了小小當駭客的癮，哈!!