3/11/2010 3:00:58 AM

[Tips] 用 “磁碟鏡像" 更換硬碟 #2, Windows 2003 的跨距磁區

繼上一篇，介紹了如何用windows server内建的磁碟鏡像 (Mirror) 更換硬碟後，這次剛好有windows 2003，就拿來試了一下...

廢話就不多說了，先來看一下 2003 的步驟，再來看看跟 2008 / 2008R2 差在那裡:

原本的樣子，磁碟1 (8.00GB) 是舊的硬碟，磁碟2 (16.00GB) 是要換上來的新硬碟:
磁碟1 + 磁碟2 做成鏡像 (MIRROR):

等待重新同步化 (Resync) 完成:
Resync 完成後，移除鏡像:

移除鏡像完成後的狀態:
用 2003 的延伸磁區，把磁碟2後面沒用到的空間也併進 D: 來

合併之後的狀態:

整個步驟跟前一篇都差不多，主要都是靠鏡像(MIRROR)搬完資料後，再把新硬碟多的可用空間併進來。唯一的差別就在這裡: 2003 的 "延伸磁區" (英文: extend volume) 是可以把兩個硬碟，或是兩個分割區併在一起使用。在磁碟管理員還是看的到這些分割區的存在。這就有點像 JBOD (Just a Bunch Of Disks) 的模式。

不過在 2008 之後 (其實 vista 也是)，這個功能就改了。原本的名字 extend volumn 現在改成直接擴大原分割區，把原分割區後面可用的空間都納進來，就像你砍掉再重建一個大的分割區一樣，只是資料會留著不會掉。當然有 extend 也有相對的 shrink volume, 這功能會把分割區縮小，騰出空間來讓你多切一個分割區...。而原本 JBOD 模式的功能，則改為 span disk, 用起來效果就如上圖一樣，當然你願意的話，也可以把多顆硬碟 (可以不同容量) 通通併成一個來使用，最多可以併到 32 顆硬碟...。

沒經過這次更換硬碟，還真沒發現 2008 / vista 總算內建這組 extend / shrink volume 的功能進來。雖然很陽春，不過已經很實用了，在過去這種動作是得搬出像 partition magic 這類軟體才能做的到，而這種東西每次用起來心裡都會毛毛的，深怕一不小心就把資料都給毀了...。

這篇小品文章就記到這裡，希望有幫到需要的人 :D

3/6/2010 2:54:22 AM

[Tips] 用 “磁碟鏡像" 無痛更換硬碟

543 | TROUBLE SHOOTING | 小技巧 | 技術隨筆 | 敗家 Facebook Share

老是寫一堆像外星文，沒人看的懂的 multi-threading 文章，偶爾也來換換口味吧。前陣子把 SERVER 的兩顆 750GB HDD (RAID1) 升級了一下，升級成兩顆 1.5TB HDD (RAID1)。更換硬碟是小事，不過這個硬碟上有些服務，如網站，資料庫，還有一些重要資料，跟分享資料夾，想一想要更換也是挺囉唆的...。

想了幾個辦法，不過都不符合我既懶又挑毛病的個性... 原本考慮的更換方式有:

硬上... 新硬碟裝上去，檔案COPY過去，能停的服務就停掉，花一堆時間搬資料，然後再恢復原服務 (如 SQL、IIS等等)。至於比較麻煩的，像是目錄分享的，只好移掉再重建。中斷服務的時間就是從關機裝硬碟，一直到全部完成為止。
用 disk clone 的工具，如 true image / ghost 之類的軟體。不過這樣通常得停機做 clone, 750GB 也是要執行好一段時間，加上我這次買的是 Advanced Format 的硬碟，用這類工具會有效能的問題，事後還得校正回來… ouch, 算了...

想來想去，我用的是 windows server, 有內建的 Mirror set, 就拿來用一用好了。我真正作的是把 mirror set 的兩顆都升級，不過為了簡化說明，我底下的例子就只以替換一般的硬碟就好，反正道理是一樣的。

說穿了不值錢，就是用 mirror 的磁碟複製特性，加上 extend volume 的功能，我除了需要關機裝上新硬碟之外，其它包含資料複製的所有時間，原服務都不用中斷 (當然速度會慢一點)，所有服務的設定也都不用修改，算是既無腦又防呆的完美方案... 只要簡單的按幾下滑鼠就可以達成我的目標。

直接來看看怎麼作的吧! 很簡單，先利用 mirror 把資料轉移到新硬碟... 然後中斷 mirror, 再用 extend volume 把磁區大小調大就可以收工了。來看分解步驟:

我原本的磁碟組態是長這個樣子 (圖我是事後用 VM 模擬的)，其中 Disk 1 (8.00GB) 就是我要換掉的...
關機裝上一顆新的硬碟 Disk 2 之後，變成這樣 (Disk 2 (16.00GB) 是新的硬碟):
把 disk1 / disk2 做成磁碟鏡像之後，就變成這樣:
鏡像做好，Resync 完成後，就可以中斷鏡像了。中斷之後變成這個樣子:
目前為止，看來磁碟轉移已經完成了，剩下就是想辦法把後面的空間吃進來。接下來的就用 Extend Volume 括大 D: 的大小:

之後就大功告成了。這方法不但簡單，而且整個過程中，全程 D:\ 都可以正常的使用。除了 (1) --> (2) 需要關機裝硬碟之外， (2) ~ (5) 全程，放在 D:\ 的 SQL DB，IIS 網站，還有 pagefile 通通都正常運作中。有了 windows server 的磁碟陣列還真是好用啊 :D

不過，事情也是有黑暗面的... 這個方法是有幾個小缺點啦...

被迫使用 "動態磁碟" :
dynamic disk 其實不是什麼缺點啦，不過你要是會用到其它 OS，像 linux 之類的，或是用其它的磁碟管理軟體，可能就不認得了。這是缺點之一..
只有 windows server 可以使用:
desktop os (windows 2000 pro, xp, vista, win7) 都只支援部份的磁碟管理功能，這作法關鍵的 mirror 是不支援的... 只能乾瞪眼 @@
Extend Volume 只適用 windows 2008 以上的版本:
記得 windows 2003 只支援到 span volume, 在 disk manager 裡還是會顯示兩個 partition, 只不過只會有一個磁碟機代號，容量會是兩個加起來的而已。一樣啦，是不會有什麼大問題，看起來不大爽而已 XD

偶爾換個口味，貼些小品文章，這邊我也不是很專業，有啥更好的作法也歡迎留 comment 啊 :D

12/10/2008 11:30:18 PM

XmlWellFormedWriter.WriteRaw( ) 的 Bug 後續發展

Microsoft.NET | 543 | C# | MSDN | TROUBLE SHOOTING | XML | 技術隨筆 Facebook Share

一時順手，就按下 Visual Studio 2008 上面的 [Report Bug] 回報上一篇發現的 Bug, 沒想到 M$ 真的有回應耶... :D

反正 M$ 在 connect 裡的回應本來就公開的，我就順手貼一下:

https://connect.microsoft.com/VisualStudio/feedback/ViewFeedback.aspx?FeedbackID=386899&wa=wsignin1.0

Hello,
Originally the WriteRaw method was designed for XmlWriters that are formatting text XML into a file. In those cases the WriteRaw method can be used to write out an XML fragment that is already formatted and checked for well-formedness. It can also be used for writing text nodes with special character that have been already escaped and no further processing of the text is needed.
However, when we introduced the XmlWriter over XmlDocument/XDocument (accessed via XPathNavigator editing methods), the use of the WriteRaw method on top of XmlDocument became controversial. We had two options:
1. Threat it as a text
2. Parse it into nodes

The second option is very difficult (if not possible) to do. The XML fragment can we written out in multiple WriteRaw calls, so we could not assume that a single WriteRaw will contain a fully enclosed fragment. It can also be interleaved with other XmlWriter calls and nested many times – overall a very hard thing to implement properly. So that is why we have decided to treat the WriteRaw content as text, which is what you are seeing.
If you have an XML fragment in a string and you want to append it to XmlDocument, you can do it like this:

                XmlDocument doc = new XmlDocument();
                XmlElement rootElement = doc.CreateElement("root");
                rootElement.InnerXml = "<a/><a/><a/><a/><a/>";
                doc.AppendChild(rootElement);

Or if you really want to use the XmlWriter from XPathNavigator.AppendChild(), you can create an XmlReader over your fragment and use the WriteNode method on the XmlWriter:

                XmlDocument doc = new XmlDocument();
                XmlWriter writer = doc.CreateNavigator().AppendChild();
                writer.WriteStartElement("root");
                using (XmlReader r = XmlReader.Create(new StringReader("<a/><a/><a/><a/><a/>"), new XmlReaderSettings { ConformanceLevel = ConformanceLevel.Fragment } ) ) {
                    writer.WriteNode(r, false);
                }
                writer.WriteEndElement();
                writer.Close();
                doc.Save(Console.Out);

I hope this helps.
Thank you,
-Helena Kotas, System.Xml Developer

看來 M$ 認為這是權宜之計，不算 BUG，要 USER 就直接避掉了，只是他建議的解法剛好就是我上一篇用的，用 XmlReader, 搭上 ConformanceLevel.Fragment 的設定解決掉...

只不過，這種情況，不是應該丟出 NotSupportException 比較好嘛? 幹嘛拿個不適當的實作填進來?

提外話，現在 WEB 2.0 的時代，M$ 工程師除了寫 CODE 之外，也要負責回客戶的問題了? 真辛苦...

12/7/2008 4:35:27 PM

原來 System.Xml.XmlWellFormedWriter 有 Bug ..

Microsoft.NET | 543 | C# | MSDN | TROUBLE SHOOTING | XML | 小技巧 Facebook Share

果然沒啥人知道的 code, bug 也會比較慢被抓出來 ... 兩個小時前我才貼了找到 XmlNodeWriter 的替代品，用了一下就被我挖到一個 BUG ... @_@

先來看看我的 Sample Code:

XmlTextWriter v.s. XmlWellFormedWriter[copy code]

            // test xml text writer, correct result
            // output: <?xml version="1.0" encoding="big5"?><root><a/><a/><a/><a/><a/></root>
            {
                Console.WriteLine("Using XmlTextWriter:");

                XmlWriter writer = XmlWriter.Create(Console.Out);
                writer.WriteStartElement("root");
                writer.WriteRaw("<a/><a/><a/><a/><a/>");
                writer.WriteEndElement();
                writer.Flush();

                Console.WriteLine();
                Console.WriteLine();
            }


            // test xml node writer, wrong result
            // output: <?xml version="1.0" encoding="big5"?><root>&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;</root>
            {
                Console.WriteLine("Using XmlWellFormedWriter:");

                XmlDocument xmldoc = new XmlDocument();
                XmlWriter writer = xmldoc.CreateNavigator().AppendChild();
                writer.WriteStartElement("root");
                writer.WriteRaw("<a/><a/><a/><a/><a/>");
                writer.WriteEndElement();
                writer.Close();

                xmldoc.Save(Console.Out);
                Console.WriteLine();
                Console.WriteLine();
            }

   1:  // test xml text writer, correct result

   2:  // output: <?xml version="1.0" encoding="big5"?><root><a/><a/><a/><a/><a/></root>

   3:  {

   4:      Console.WriteLine("Using XmlTextWriter:");

   5:      XmlWriter writer = XmlWriter.Create(Console.Out);

   6:      writer.WriteStartElement("root");

   7:      writer.WriteRaw("<a/><a/><a/><a/><a/>");

   8:      writer.WriteEndElement();

   9:      writer.Flush();

  10:      Console.WriteLine();

  11:      Console.WriteLine();

  12:  }

  13:  // test xml node writer, wrong result

  14:  // output: <?xml version="1.0" encoding="big5"?><root>&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;&lt;a/&gt;</root>

  15:  {

  16:      Console.WriteLine("Using XmlWellFormedWriter:");

  17:      XmlDocument xmldoc = new XmlDocument();

  18:      XmlWriter writer = xmldoc.CreateNavigator().AppendChild();

  19:      writer.WriteStartElement("root");

  20:      writer.WriteRaw("<a/><a/><a/><a/><a/>");

  21:      writer.WriteEndElement();

  22:      writer.Close();

  23:      xmldoc.Save(Console.Out);

  24:      Console.WriteLine();

  25:      Console.WriteLine();

  26:  }

而這是程式的輸出畫面:

兩段 code 除了拿到的 XmlWriter 來源不同之外，用它寫 XML DATA 的方式是一致的，不過寫出來的 XML 則完全不同。看來兩種 XmlWriter 對於 WriteRaw(...) 的實作不大相同。而照 MSDN 上的說明來說，XmlTextWriter的行為是對的，XmlWellFormedWriter 則太雞婆了，沒事多作一次編碼...

該說運氣好嘛? 哈哈... 繼上次撈到一個 SmtpMail 的 Bug 之後，這次又撈到一個... 要用的人注意一下，不過即使有這個 Bug, 也不會影響它的地位啦，這 Writer 解決了我很大的困擾，動搖國本也要用下去... (咳... 不過是避開一個 API ...)

最後我改了用法，一方面 API 有 BUG 是一回事，另一方面直接用這 API 也很危險，因為 MSDN 說它不會去做內容的驗證，也就是說透過 WriteRaw( ) 寫進不合法的資料，會讓你整份輸出都毀了... 第二個原因比較重要，因此我換了一個替代作法, 類似 Pipe 一樣，把 XmlReader 讀到的東西都寫到 XmlWriter:

XmlCopyPipe 實作[copy code]

       /// <summary>
        /// 從 XmlReader 複製到 XmlWriter
        /// </summary>
        /// <param name="reader"></param>
        /// <param name="writer"></param>
        private static void XmlCopyPipe(XmlReader reader, XmlWriter writer)
        {

            if (reader == null)
            {

                throw new ArgumentNullException("reader");

            }

            if (writer == null)
            {

                throw new ArgumentNullException("writer");

            }


            while (reader.Read() == true)
            {
                switch (reader.NodeType)
                {

                    case XmlNodeType.Element:

                        writer.WriteStartElement(reader.Prefix, reader.LocalName, reader.NamespaceURI);

                        writer.WriteAttributes(reader, true);

                        if (reader.IsEmptyElement)
                        {

                            writer.WriteEndElement();

                        }

                        break;

                    case XmlNodeType.Text:

                        writer.WriteString(reader.Value);

                        break;

                    case XmlNodeType.Whitespace:

                    case XmlNodeType.SignificantWhitespace:

                        writer.WriteWhitespace(reader.Value);

                        break;

                    case XmlNodeType.CDATA:

                        writer.WriteCData(reader.Value);

                        break;

                    case XmlNodeType.EntityReference:

                        writer.WriteEntityRef(reader.Name);

                        break;

                    case XmlNodeType.XmlDeclaration:

                    case XmlNodeType.ProcessingInstruction:

                        writer.WriteProcessingInstruction(reader.Name, reader.Value);

                        break;

                    case XmlNodeType.DocumentType:

                        writer.WriteDocType(reader.Name, reader.GetAttribute("PUBLIC"), reader.GetAttribute("SYSTEM"), reader.Value);

                        break;

                    case XmlNodeType.Comment:

                        writer.WriteComment(reader.Value);

                        break;

                    case XmlNodeType.EndElement:

                        writer.WriteFullEndElement();

                        break;

                }
            }
        }

   1:  /// <summary>

   2:   /// 從 XmlReader 複製到 XmlWriter

   3:   /// </summary>

   4:   /// <param name="reader"></param>

   5:   /// <param name="writer"></param>

   6:   private static void XmlCopyPipe(XmlReader reader, XmlWriter writer)

   7:   {

   8:       if (reader == null)

   9:       {

  10:           throw new ArgumentNullException("reader");

  11:       }

  12:       if (writer == null)

  13:       {

  14:           throw new ArgumentNullException("writer");

  15:       }

  16:       while (reader.Read() == true)

  17:       {

  18:           switch (reader.NodeType)

  19:           {

  20:               case XmlNodeType.Element:

  21:                   writer.WriteStartElement(reader.Prefix, reader.LocalName, reader.NamespaceURI);

  22:                   writer.WriteAttributes(reader, true);

  23:                   if (reader.IsEmptyElement)

  24:                   {

  25:                       writer.WriteEndElement();

  26:                   }

  27:                   break;

  28:               case XmlNodeType.Text:

  29:                   writer.WriteString(reader.Value);

  30:                   break;

  31:               case XmlNodeType.Whitespace:

  32:               case XmlNodeType.SignificantWhitespace:

  33:                   writer.WriteWhitespace(reader.Value);

  34:                   break;

  35:               case XmlNodeType.CDATA:

  36:                   writer.WriteCData(reader.Value);

  37:                   break;

  38:               case XmlNodeType.EntityReference:

  39:                   writer.WriteEntityRef(reader.Name);

  40:                   break;

  41:               case XmlNodeType.XmlDeclaration:

  42:               case XmlNodeType.ProcessingInstruction:

  43:                   writer.WriteProcessingInstruction(reader.Name, reader.Value);

  44:                   break;

  45:               case XmlNodeType.DocumentType:

  46:                   writer.WriteDocType(reader.Name, reader.GetAttribute("PUBLIC"), reader.GetAttribute("SYSTEM"), reader.Value);

  47:                   break;

  48:               case XmlNodeType.Comment:

  49:                   writer.WriteComment(reader.Value);

  50:                   break;

  51:               case XmlNodeType.EndElement:

  52:                   writer.WriteFullEndElement();

  53:                   break;

  54:           }

  55:       }

  56:   }

很好用的作法，就像過去需要 COPY XML 資料，最常見的就是把來源跟目的都用 XmlDocument 載入，直接用 ImportNode( ) 把 XML 片段資料搬到另一個 XmlDocument 再儲存。跟上一篇的原因一樣，看起來很蠢... 就想到這個作法，透過 XmlReader, 拿到的是已經 parsing 過的資料，直接寫到 XmlWriter。而我用的 Writer 正好又可避開重複作 parsing 動作的優點，正好這樣效能跟可用性都兼顧了... 經過 parsing, 至少寫出來的東西會安心一點...

把最後我的程式搭配這個 XmlPipeCopy 改一改:

用 XmlCopyPipe 取代 WriteRaw( )[copy code]

                XmlDocument xmldoc = new XmlDocument();
                XmlWriter writer = xmldoc.CreateNavigator().AppendChild();
                writer.WriteStartElement("root");


                XmlReaderSettings settings = new XmlReaderSettings();
                settings.ConformanceLevel = ConformanceLevel.Fragment;
                XmlReader reader = XmlReader.Create(
                    new StringReader("<a/><a/><a/><a/><a/>"),
                    settings);
                XmlCopyPipe(reader, writer);


                writer.WriteEndElement();
                writer.Close();

                xmldoc.Save(Console.Out);

   1:  XmlDocument xmldoc = new XmlDocument();

   2:  XmlWriter writer = xmldoc.CreateNavigator().AppendChild();

   3:  writer.WriteStartElement("root");

   4:  XmlReaderSettings settings = new XmlReaderSettings();

   5:  settings.ConformanceLevel = ConformanceLevel.Fragment;

   6:  XmlReader reader = XmlReader.Create(

   7:      new StringReader("<a/><a/><a/><a/><a/>"),

   8:      settings);

   9:  XmlCopyPipe(reader, writer);

  10:  writer.WriteEndElement();

  11:  writer.Close();

  12:  xmldoc.Save(Console.Out);

試了一下，果然如預期的執行了 :D，結果也沒錯，還好 XmlWellFormedWriter 的 Bug 只存在於 WriteRaw... 閃開就沒事了:

其中有個陷阱，就是如何用 XmlReader 讀取 XmlFragment (可以有多個 ROOT 的 XML DATA)。其實這個解法跟程式碼，大部份都是這篇看來的，只不過在裡面加了個 LOOP 跟改了名字，各位覺的好用的話記得去謝原作者 Mark Fussell, 別謝錯人了 :D

10/31/2008 2:20:00 AM

關不掉的 Vista UAC !?

TROUBLE SHOOTING | 小技巧 Facebook Share

不知道是更新了啥 PATCH，還是那次沒正常關機，我公司 VISTA 的 UAC 突然莫名奇妙的被打開了。怪的是控制台裡看到的還是關掉的，不管怎麼改狀態也不會改變 (一直都是關的) ...。

直覺告訴我一定是控制台的 AP 那邊出問題，設定值寫不進去造成的...，於是我就開使找其它可以修改 UAC 設定的方法...，最後找到這個，還真的成功了 :D，看來沒機會動用 ProcessMonitor 追追看問題了..

找到的方法是: msconfig.exe

在開始 --> 執行裡輸入 msconfig.exe 後，可以看到這一項:

看來是直接修改 registry, 果然有效，直接執行後 REBOOT 就一切正常了 -_-, 如果有人也碰過一樣的問題可以試看看!

10/20/2008 1:53:00 AM

該如何學好 "寫程式" #4. 你的程式夠 "可靠" 嗎?

撐了很久，續篇來了。這次要進階一點，直接從 software engineer (軟體工程師) 的階段開始。

所謂的軟體工程師，我對它的定義是在這個領域已經算是資深人員了。programmer 該作的是把程式寫好，要挑正確的方式及技術寫好你的程式 (如之前幾篇介紹的演算法及資料結構等等)。而軟體工程師呢? 之前介紹的那些已經不夠了，你該好好的安排你的 code 及工具，要能把你的 solution (如會用到的演算法及資料結構)，跟你手上能運用的資源 (如程式語言、開發工具及函式庫) 作最佳化的搭配及整合。因此我認為在這階段的重點有幾個:

先成為一個好的 programmer (廢話)
程式要有足夠的可靠性 (穩定、沒有BUG、易讀、對於未知問題的防禦能力)
要有足夠的系統知識 (比如作業系統/API/系統服務/記憶體管理等等 OS 提供的環境及功能)
程式要有好的結構 (正確/優秀的類別設計、好維護、有足夠的擴充及應變能力)
要有解決未知問題或是未知 BUG 的能力，有自行學習新知的能力。

這些能力，跟 programmer 需要俱備的剛好是另一個角度的要求。某種程度上是各自發展的，不會互相衝突。有心的 programmer 應該要及早作好準備。如果 programmer 是要把程式寫對，那 software engineer 就是要把程式寫好，用專業的方式來寫，而不是用業餘的方式。

什麼叫作 "專業" 的程式? 我舉幾個例子，你的程式防呆嗎? 你的程式面對未知的問題或狀況的免疫力夠不夠強? 面對問題時你的程式有沒有比其它人的程式還容易抓出 BUG ? 你有能力有系統的找出未知的問題嗎? 還是只能看著程式碼發呆? 面對上面的問題有沒有有效的預防措施? 設計階段可以怎樣預防? ... etc

實在太多了。不過這些看起來又是教條，實際上這幾點會影響的到底是什麼? 後面幾篇就一項一項來看吧!

[程式要有足夠的可靠性]

老實說，我很怕光是這一段，就會拖到好幾篇了 ... @_@，我會盡量挑出重點來寫。開始之前先問一下，不知道有多少人看過馬奎爾 (Steve Maguire) 寫的這本書? 有的話記得留個回應 :D

"完美程式設計指南" (Writing Solid Code)

這本書真是經典。不過它真的也很 "經典"，是 1993 年就出版的書。以講程式設計來說，這個年代的書真的可以扔了，裡面的範例現在沒幾個人用的到了。不過它提到的作法真的是很實際，只是書上的範例大半都過時了，下面碰到的例子我都會用 C# 重新表達一次作者的理念。在這個主題我就舉幾個例子，各位讀者可以自己回顧一下你的程式碼，到底藏了多少地雷在裡面?

[要讓問題浮現出來: 善用 DEBUG / RELEASE 模式]

專不專業就看這裡了。如果你想當個稱職的軟體工程師，除了讓程式跑的快之外，第一點就是要降低 BUG 數。如果你面對 BUG 的態度是 "找到再改就好"，或是 BUG 一堆你也沒方法去預防，也沒辦法降低 BUG 出現的頻率，那麼你跟半路出家的人差別在那?

大家都知道 Visual Studio 正上方就有個切換 Release / Debug 模式的選單吧? 你確切瞭解它是幹嘛的嗎? 先從一個簡單的範例開始吧! 我工作上常碰到線上測驗之類的應用軟體開發，因此線上考試算分是個很常用的功能。因此我把這個重責大任交給工程師來處理。先來看看我要求工程師寫什麼 CODE ? 我用 XML 定義了一份考卷 (QUIZ.xml，含正確答案)，也定義了答案卷的格式 (PAPER-XXXX.xml)，程式很簡單，就是拿到題目跟答案卷後，要算出正確的總分。

不難吧? 先看看 XML 檔長啥樣子:

試卷 (QUIZ.xml)[copy code]

<?xml version="1.0" encoding="utf-8" ?><quiz>	<question score="20">		<body>那一隻熊最勵害?</body>		<item correct="false">白熊</item>		<item correct="false">黑熊</item>		<item correct="false">棕熊</item>		<item correct="true">灰熊</item>	</question>	<question score="40">		<body>誰發現萬有引力?</body>		<item correct="false">鼠頓</item>		<item correct="true">牛頓</item>		<item correct="false">虎頓</item>		<item correct="false">兔頓</item>	</question>	<question score="40">		<body>下列那些東西是可以吃的?</body>		<item correct="false">東瓜</item>		<item correct="true">西瓜</item>		<item correct="true">南瓜</item>		<item correct="false">北瓜</item>	</question></quiz>

   1:  <?xml version="1.0" encoding="utf-8" ?>

   2:  <quiz>

   3:    <question score="20">

   4:      <body>那一隻熊最勵害?</body>

   5:      <item correct="false">白熊</item>

   6:      <item correct="false">黑熊</item>

   7:      <item correct="false">棕熊</item>

   8:      <item correct="true">灰熊</item>

   9:    </question>

10:

  11:    <question score="40">

  12:      <body>誰發現萬有引力?</body>

  13:      <item correct="false">鼠頓</item>

  14:      <item correct="true">牛頓</item>

  15:      <item correct="false">虎頓</item>

  16:      <item correct="false">兔頓</item>

  17:    </question>

18:

  19:    <question score="40">

  20:      <body>下列那些東西是可以吃的?</body>

  21:      <item correct="false">東瓜</item>

  22:      <item correct="true">西瓜</item>

  23:      <item correct="true">南瓜</item>

  24:      <item correct="false">北瓜</item>

  25:    </question>

  26:  </quiz>

再來代表答案卷的檔案 (PAPER-PERFECT.xml)，這份看來是天才寫的，每一題都答對了... @_@

答案卷 (都是正確答案，PAPER-PERFECT.xml)[copy code]

<?xml version="1.0" encoding="utf-8" ?><quiz>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="true" />	</question>	<question>		<item checked="false" />		<item checked="true" />		<item checked="false" />		<item checked="false" />	</question>	<question>		<item checked="false" />		<item checked="true" />		<item checked="true" />		<item checked="false" />	</question></quiz>

   1:  <?xml version="1.0" encoding="utf-8" ?>

   2:  <quiz>

   3:    <question>

   4:      <item checked="false" />

   5:      <item checked="false" />

   6:      <item checked="false" />

   7:      <item checked="true" />

   8:    </question>

   9:    <question>

  10:      <item checked="false" />

  11:      <item checked="true" />

  12:      <item checked="false" />

  13:      <item checked="false" />

  14:    </question>

  15:    <question>

  16:      <item checked="false" />

  17:      <item checked="true" />

  18:      <item checked="true" />

  19:      <item checked="false" />

  20:    </question>

  21:  </quiz>

而我交待的算分規則也很簡單，就一般考試的計算方式: 每題有自己的配分，以複選題來算，答對幾個選項就照比例給分，答錯會倒扣。新人工程師果然好用耐操，不一會就交給我這份 Library 的程式碼:

第一版計分程式[copy code]

        public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)        {            int questionCount = quizDoc.SelectNodes("/quiz/question").Count;            int totalScore = 0;            for (int questionPos = 0; questionPos < questionCount; questionPos++)            {                XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                totalScore += ComputeQuestionScore(quiz_question, paper_question);            }            return totalScore;        }        public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)        {            int totalScore = 0;            int itemCount = quiz_question.SelectNodes("item").Count;            //            //  題目的配分            //            int quiz_score = int.Parse(quiz_question.GetAttribute("score"));            //            //  答對一個選項的分數            //            int item_score = quiz_score / itemCount;            for (int itemPos = 0; itemPos < itemCount; itemPos++)            {                XmlElement quiz_item = quiz_question.SelectNodes("item")[itemPos] as XmlElement;                XmlElement paper_item = paper_question.SelectNodes("item")[itemPos] as XmlElement;                //                //  算成積                //                if (quiz_item.GetAttribute("correct") == paper_item.GetAttribute("checked"))                {                    totalScore += item_score;                }                else                {                    totalScore -= item_score;                }            }                        return totalScore;        }

   1:  public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)

   2:  {

   3:      int questionCount = quizDoc.SelectNodes("/quiz/question").Count;

   4:      int totalScore = 0;

   5:      for (int questionPos = 0; questionPos < questionCount; questionPos++)

   6:      {

   7:          XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

   8:          XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

   9:          totalScore += ComputeQuestionScore(quiz_question, paper_question);

  10:      }

  11:      return totalScore;

  12:  }

  13:  public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)

  14:  {

  15:      int totalScore = 0;

  16:      int itemCount = quiz_question.SelectNodes("item").Count;

  17:      //

  18:      //  題目的配分

  19:      //

  20:      int quiz_score = int.Parse(quiz_question.GetAttribute("score"));

  21:      //

  22:      //  答對一個選項的分數

  23:      //

  24:      int item_score = quiz_score / itemCount;

  25:      for (int itemPos = 0; itemPos < itemCount; itemPos++)

  26:      {

  27:          XmlElement quiz_item = quiz_question.SelectNodes("item")[itemPos] as XmlElement;

  28:          XmlElement paper_item = paper_question.SelectNodes("item")[itemPos] as XmlElement;

  29:          //

  30:          //  算成積

  31:          //

  32:          if (quiz_item.GetAttribute("correct") == paper_item.GetAttribute("checked"))

  33:          {

  34:              totalScore += item_score;

  35:          }

  36:          else

  37:          {

  38:              totalScore -= item_score;

  39:          }

  40:      }

  41:      return totalScore;

  42:  }

很中規中舉的程式，把天才寫的答案卷 (paper-perfect.xml) 套進去算，也真的拿到滿分，於是工程師就很高興的把程式 shelve 給我...

各位回頭想想上面的問題。這段程式以作業的標準來說勉強及格了。但是以實際系統運作的角度來說有那些缺陷?

原則上程式只要是人寫的都會有 BUG，不過我也是人，沒辦法一眼看穿所有程式的問題... 只能事事抱著懷疑的態度，試一試再說。我不是天才，所以寫不出滿分的答案，我另外準備了一份答案卷 (PAPER-NORMAL1.xml):

只答對第一題的答案卷 (PAPER-NORMAL1.xml)[copy code]

<?xml version="1.0" encoding="utf-8" ?><quiz>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="true" />	</question>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="false" />	</question>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="false" />	</question></quiz>

   1:  <?xml version="1.0" encoding="utf-8" ?>

   2:  <quiz>

   3:    <question>

   4:      <item checked="false" />

   5:      <item checked="false" />

   6:      <item checked="false" />

   7:      <item checked="true" />

   8:    </question>

   9:    <question>

  10:      <item checked="false" />

  11:      <item checked="false" />

  12:      <item checked="false" />

  13:      <item checked="false" />

  14:    </question>

  15:    <question>

  16:      <item checked="false" />

  17:      <item checked="false" />

  18:      <item checked="false" />

  19:      <item checked="false" />

  20:    </question>

  21:  </quiz>

見鬼了，算出來是 40 分... 蠢才也是有尊嚴的，不用平白無故送我 20 分吧... @_@，我把 BUG 丟回去給工程師，最後他抓出 BUG 在那裡了，第二題第三題我完全沒作答，應該視為放棄才對，結果程式也照規則給我算分... 運氣好多賺了 20 分.. 工程師又改了一版給我，這次加上了放棄此題的判斷 (第八行):

修正後的程式 #2: 放棄的話不算分[copy code]

        public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)        {            int totalScore = 0;            int itemCount = quiz_question.SelectNodes("item").Count;            //            //  如果都沒作答, 此題放棄            //            if (paper_question.SelectNodes("item[@checked='true']").Count == 0) return 0;            //            //  題目的配分            //            int quiz_score = int.Parse(quiz_question.GetAttribute("score"));

   1:  public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)

   2:  {

   3:      int totalScore = 0;

   4:      int itemCount = quiz_question.SelectNodes("item").Count;

   5:      //

   6:      //  如果都沒作答, 此題放棄

   7:      //

   8:      if (paper_question.SelectNodes("item[@checked='true']").Count == 0) return 0;

   9:      //

  10:      //  題目的配分

  11:      //

  12:      int quiz_score = int.Parse(quiz_question.GetAttribute("score"));

有了上一次經驗，直覺告訴我我還得再測一測，搞不好還有其它 BUG ... 這次找了丁丁來考試，丁丁果真是個人才，交了一份全都錯的答案卷給我，前兩題放棄，第三題全選錯 (PAPER-NATIVE.xml):

丁丁的答案卷: 倒扣 (PAPER-NATIVE.xml)[copy code]

<?xml version="1.0" encoding="utf-8" ?><quiz>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="false" />	</question>	<question>		<item checked="false" />		<item checked="false" />		<item checked="false" />		<item checked="false" />	</question>	<question>		<item checked="true" />		<item checked="false" />		<item checked="false" />		<item checked="true" />	</question></quiz>

   1:  <?xml version="1.0" encoding="utf-8" ?>

   2:  <quiz>

   3:    <question>

   4:      <item checked="false" />

   5:      <item checked="false" />

   6:      <item checked="false" />

   7:      <item checked="false" />

   8:    </question>

   9:    <question>

  10:      <item checked="false" />

  11:      <item checked="false" />

  12:      <item checked="false" />

  13:      <item checked="false" />

  14:    </question>

  15:    <question>

  16:      <item checked="true" />

  17:      <item checked="false" />

  18:      <item checked="false" />

  19:      <item checked="true" />

  20:    </question>

  21:  </quiz>

果然有柯南的地方就有密室殺人事件... @_@，又被我抓到一個問題。這次得到的總分是 -40，那有人扣到負的? 工程師又被我叫來唸了一頓，這次改了這版程式給我 (第十一行，最低是0分):

修正後的程式 #3: 倒扣到0分為止[copy code]

        public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)        {            int questionCount = quizDoc.SelectNodes("/quiz/question").Count;            int totalScore = 0;            for (int questionPos = 0; questionPos < questionCount; questionPos++)            {                XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                totalScore += ComputeQuestionScore(quiz_question, paper_question);            }            return Math.Max(0, totalScore);        }

   1:  public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)

   2:  {

   3:      int questionCount = quizDoc.SelectNodes("/quiz/question").Count;

   4:      int totalScore = 0;

   5:      for (int questionPos = 0; questionPos < questionCount; questionPos++)

   6:      {

   7:          XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

   8:          XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

   9:          totalScore += ComputeQuestionScore(quiz_question, paper_question);

  10:      }

  11:      return Math.Max(0, totalScore);

  12:  }

金融業最重視的就是錢了，銀行的程式連一毛錢都不能算錯，而在線上考試的系統也一樣，連一分都不能算錯。只是當你的老闆這樣要求你的時後，你是謹記在心，還是照一般方式寫程式嗎? 還是你有什麼有效的措施可以預防這些問題? 這時才是顯示你專業的地方啊... 套句鄉民的慣用語:

"閃開! 讓專業的來..."

哈哈，來看看鄉民... 不，專家該怎麼解決這種問題。怕程式錯就加上一堆檢查就好了。上面舉的例子真的只是 BUG 而以，其它還有更多不可預測的問題，像是題目跟答案卷跟本搭不起來，或是沒有答案卷等等鳥問題都有可能發生。那怎辦? 可憐的工程師被我訓了一頓，只好摸摸鼻子加了一堆令人哭笑不得的 check code, 像這樣:

多了一堆 CHECK 及印出 DEBUG MESSAGE 的程式碼[copy code]

        public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)        {            int totalScore = 0;            int itemCount = quiz_question.SelectNodes("item").Count;            if (quiz_question == null)            {                throw new Exception("沒有題目卷");            }            if (paper_question == null)            {                throw new Exception("沒有答案卷");            }            //            //  如果都沒作答, 此題放棄            //            if (paper_question.SelectNodes("item[@checked='true']").Count == 0)            {                Console.WriteLine("偵測到沒作答的答案，此題放棄");                return 0;            }            //            //  確認題目跟答案的選項數目一致            //            if (paper_question.SelectNodes("item").Count != quiz_question.SelectNodes("item").Count)            {                throw new Exception("此題的選項跟題目定義不符合");            }

   1:  public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)

   2:  {

   3:      int totalScore = 0;

   4:      int itemCount = quiz_question.SelectNodes("item").Count;

   5:      if (quiz_question == null)

   6:      {

   7:          throw new Exception("沒有題目卷");

   8:      }

   9:      if (paper_question == null)

  10:      {

  11:          throw new Exception("沒有答案卷");

  12:      }

  13:      //

  14:      //  如果都沒作答, 此題放棄

  15:      //

  16:      if (paper_question.SelectNodes("item[@checked='true']").Count == 0)

  17:      {

  18:          Console.WriteLine("偵測到沒作答的答案，此題放棄");

  19:          return 0;

  20:      }

  21:      //

  22:      //  確認題目跟答案的選項數目一致

  23:      //

  24:      if (paper_question.SelectNodes("item").Count != quiz_question.SelectNodes("item").Count)

  25:      {

  26:          throw new Exception("此題的選項跟題目定義不符合");

  27:      }

老實說這範例我也寫不下去了，加這麼多 check 是好事，不過事情都有黑暗面，我覺的不妥的地方有幾個:

可讀性變差
太多的 check / debug code, 完全把正常流程的 code 淹沒了，一眼看去看不出什麼邏輯...
效能變差
對我來說，有些問題是輸入造成的 (如沒有給答案卷)，有些是鳥程式自己沒寫好 (如前面的例子)。並不是所有的 check 都需要寫在程式裡。
花在寫 check 程式的時間太多
沒錯，寫個程式五分鐘就搞定，寫 check 要多花廿分鐘...

即使這樣，我還是贊成要這樣做。只是要做的聰明一點，要消掉上面的疑慮，還要達成一樣的效果。不需要什麼新技術，十幾年前馬奎爾這本 "Write Solid Code" 就講的很清楚了，要同時維護 RELEASE / DEBUG 兩種版本的程式!

在 C 的年代，只靠兩個巨集就解決了，分別是 TRACE 跟 ASSERT。一個就相當於 printf，可以印出 MESSAGE，另一個 ASSERT 則什麼都不做，只要你傳給它當參數是 TRUE 的話。否則就會印出錯誤訊息同時中止程式。而這兩個巨集都有個特點，就是只在 DEBUG MODE 發生作用，如果是在 RELEASE MODE，則一點用都沒有，就像你沒寫這段 CODE 一樣。

細節我就不多說了，這本書講的很清楚，我直接來用。老實說這種應用太經典了，經典到每種程式語言跟開發工具都有支援，連 Microsoft 在 JavaScript 都有實作，甚至跟 debugger 也有整合，不過不曉得有多少人知道? 在 .NET 當然也有 (System.Diagnoistics)。來看看我改版過的 code:

套用 TRACE / ASSERT 的程式碼[copy code]

        public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)        {            Trace.Assert(quizDoc != null);            Trace.Assert(paperDoc != null);            Trace.Assert(quizDoc.SelectNodes("/quiz/question").Count == paperDoc.SelectNodes("/quiz/question").Count);            int questionCount = quizDoc.SelectNodes("/quiz/question").Count;            int totalScore = 0;            for (int questionPos = 0; questionPos < questionCount; questionPos++)            {                XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;                totalScore += ComputeQuestionScore(quiz_question, paper_question);            }            totalScore = Math.Max(0, totalScore);            Trace.Assert(totalScore >= 0);            return totalScore;        }        public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)        {            int totalScore = 0;            int itemCount = quiz_question.SelectNodes("item").Count;            //if (quiz_question == null)            //{            //    throw new Exception("沒有題目卷");            //}            //if (paper_question == null)            //{            //    throw new Exception("沒有答案卷");            //}            ////            ////  確認題目跟答案的選項數目一致            ////            //if (paper_question.SelectNodes("item").Count != quiz_question.SelectNodes("item").Count)            //{            //    throw new Exception("此題的選項跟題目定義不符合");            //}            Trace.Assert(quiz_question != null);            Trace.Assert(paper_question != null);            Trace.Assert(paper_question.SelectNodes("item").Count == quiz_question.SelectNodes("item").Count);            //            //  如果都沒作答, 此題放棄            //            if (paper_question.SelectNodes("item[@checked='true']").Count == 0)            {                //Console.WriteLine("偵測到沒作答的答案，此題放棄");                Trace.WriteLine("偵測到沒作答的答案，此題放棄");                return 0;            }            //            //  題目的配分            //            int quiz_score = int.Parse(quiz_question.GetAttribute("score"));            //            //  答對一個選項的分數            //            int item_score = quiz_score / itemCount;            for (int itemPos = 0; itemPos < itemCount; itemPos++)            {                XmlElement quiz_item = quiz_question.SelectNodes("item")[itemPos] as XmlElement;                XmlElement paper_item = paper_question.SelectNodes("item")[itemPos] as XmlElement;                //                //  算成積                //                if (quiz_item.GetAttribute("correct") == paper_item.GetAttribute("checked"))                {                    totalScore += item_score;                }                else                {                    totalScore -= item_score;                }            }            Trace.Assert(totalScore >= (0 - quiz_score));            Trace.Assert(totalScore <= quiz_score);                        return totalScore;        }

   1:  public static int ComputeQuizScore(XmlDocument quizDoc, XmlDocument paperDoc)

   2:  {

   3:      Trace.Assert(quizDoc != null);

   4:      Trace.Assert(paperDoc != null);

   5:      Trace.Assert(quizDoc.SelectNodes("/quiz/question").Count == paperDoc.SelectNodes("/quiz/question").Count);

   6:      int questionCount = quizDoc.SelectNodes("/quiz/question").Count;

   7:      int totalScore = 0;

   8:      for (int questionPos = 0; questionPos < questionCount; questionPos++)

   9:      {

  10:          XmlElement quiz_question = quizDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

  11:          XmlElement paper_question = paperDoc.SelectNodes("/quiz/question")[questionPos] as XmlElement;

  12:          totalScore += ComputeQuestionScore(quiz_question, paper_question);

  13:      }

  14:      totalScore = Math.Max(0, totalScore);

  15:      Trace.Assert(totalScore >= 0);

  16:      return totalScore;

  17:  }

  18:  public static int ComputeQuestionScore(XmlElement quiz_question, XmlElement paper_question)

  19:  {

  20:      int totalScore = 0;

  21:      int itemCount = quiz_question.SelectNodes("item").Count;

  22:      //if (quiz_question == null)

  23:      //{

  24:      //    throw new Exception("沒有題目卷");

  25:      //}

  26:      //if (paper_question == null)

  27:      //{

  28:      //    throw new Exception("沒有答案卷");

  29:      //}

  30:      ////

  31:      ////  確認題目跟答案的選項數目一致

  32:      ////

  33:      //if (paper_question.SelectNodes("item").Count != quiz_question.SelectNodes("item").Count)

  34:      //{

  35:      //    throw new Exception("此題的選項跟題目定義不符合");

  36:      //}

  37:      Trace.Assert(quiz_question != null);

  38:      Trace.Assert(paper_question != null);

  39:      Trace.Assert(paper_question.SelectNodes("item").Count == quiz_question.SelectNodes("item").Count);

  40:      //

  41:      //  如果都沒作答, 此題放棄

  42:      //

  43:      if (paper_question.SelectNodes("item[@checked='true']").Count == 0)

  44:      {

  45:          //Console.WriteLine("偵測到沒作答的答案，此題放棄");

  46:          Trace.WriteLine("偵測到沒作答的答案，此題放棄");

  47:          return 0;

  48:      }

  49:      //

  50:      //  題目的配分

  51:      //

  52:      int quiz_score = int.Parse(quiz_question.GetAttribute("score"));

  53:      //

  54:      //  答對一個選項的分數

  55:      //

  56:      int item_score = quiz_score / itemCount;

  57:      for (int itemPos = 0; itemPos < itemCount; itemPos++)

  58:      {

  59:          XmlElement quiz_item = quiz_question.SelectNodes("item")[itemPos] as XmlElement;

  60:          XmlElement paper_item = paper_question.SelectNodes("item")[itemPos] as XmlElement;

  61:          //

  62:          //  算成積

  63:          //

  64:          if (quiz_item.GetAttribute("correct") == paper_item.GetAttribute("checked"))

  65:          {

  66:              totalScore += item_score;

  67:          }

  68:          else

  69:          {

  70:              totalScore -= item_score;

  71:          }

  72:      }

  73:      Trace.Assert(totalScore >= (0 - quiz_score));

  74:      Trace.Assert(totalScore <= quiz_score);

  75:      return totalScore;

  76:  }

我特地把之前加的亂七八糟的 check code 用註解留下來，各位可以看看用 TRACE / ASSERT 前後的差別有多少。ASSERT是其中的精華。你可以到處都加上 ASSERT ，來說明你對於程式執行到某個地方的 "假設"。舉例來說，你 "假設" 呼叫你 FUNC 的人一定會傳 quizDoc 跟 paperDoc 給你，你又不想為了它寫一堆 IF ....，你就可以簡單的加上這一行 ASSERT( quizDoc != null), 代表只有 quizDoc 不是 NULL 時才是 "正常" 的。

那真的不正常的話會怎樣? 我特地拿掉倒扣扣到 0 分為止的 check, 用新版的 code 執行看看。

在 .NET 裡 ASSERT 觸動後就是這個樣子。那 TRACE 呢? 我們進 DEBUG MODE 來看看:

TRACE Message 直接被收到 Visual Studio 的 Output 視窗內。不過在 .NET 環境下，這兩者的行為已經跟書上講的廿年前作法有很多不同了。這些機制仍然可以開關，不過已經不是靠 DEBUG / RELEASE MODE 來切換，而是在 .NET configuration 裡用設定檔的方式來切換。

------------------------------------

果然寫到一半寫不完 @_@，先做個小結。這些技巧都是一般人寫程式不會注意的，然而這些才是你寫的程式品質有沒有比別人好的關鍵，要讓你的程式可靠，做好預防措施是很重要的。你沒有辦法在所有地方都派警衛防守，但是你至少可以張貼警告標示，ASSERT 就是這樣的東西。下一篇會更進一步的以這例子為延申，ASSERT 還有更強大的應用。也許有人看到這裡會想說:

"怎麼跟單元測試有點像? 我們直接用 UnitTest 就好了啊"

沒錯，單元測試其實就是從最基本的 Trace / Assert 衍生出來的，一直到這幾年才成為顯學。後續幾篇也會再對這些議題做討論，敬請期待 :D

9/27/2008 2:04:00 AM

令人火大的 SQL 字元編碼...

SQL | TROUBLE SHOOTING | 不爽 Facebook Share

今天同事有個問題搞不定，就找我去處理，越弄越火... 嘖嘖，這裡就來還原一下現場，記錄一下這個鳥問題...。

最討厭處理這種問題了。現在客戶 IT 都委外，結果就變成 IT 本身不大管事，什麼事就交給外包商就好... 而這種 A 包商跟 B 包商之間的問題，往往就變成踢皮球... 除非有明確證據指出人就是他殺的，不然? 出問題的一方自己摸摸鼻子吧。幾年來吃了不少這種虧，這就是小廠的悲哀啊。

這次碰到的例子是客戶 A 系統建的資料，需要整理後匯到我們負責維護的 B 系統。而中間資料需要作些修正，所以建了一個中繼資料庫，透過 LINKED SERVER，從 A 系統的 DB 把整個 TABLE SELECT 一份到中繼資料庫，然後再進行一連串的修正...

一開始問題很單純，就兩邊碰到中文字編碼不同，直接 SELECT 就碰到這樣的亂碼..

看起來是個小問題，請對方 IT 確認了編碼的問題後，我在中繼資料庫作了點調整，convert 成 ntext 就搞定了。已經可以跑出正確的中文資料了。

正想把程式弄一弄就收工，然後很得意的回報問題搞定時，發現不大對勁，怎麼整個 BATCH 跑下來結果還是錯的? 還錯的不一樣? 真是奇了... 原本轉 UNICODE 問題，再怎麼樣也應該只是變亂碼，或是變 ? 而以，結果這次看到的是資料錯亂，跑出其它的字出來...

這張圖是我把問題簡化後抓到的，原本是有上百行的 SQL SCRIPT ... @_@ 被我抽絲撥繭剩這段。第 33 筆資料是有問題的，不過出現的資料不是原本 "馥瑈" 啊，原本是第二個字變成 ? 而以... 現在竟然變成上一筆資料 (第32筆) 的內容，而第三個字 '榮' 則是由前面好幾筆的 "XX榮" 留下來，第四個字 "子" 就真的不曉得從那裡來了...

好怪的問題，如果是程式碰到這種 BUG，一看就像某個 BUFFER 沒清掉就一直重複被使用，後面的值直接蓋掉前面的值，字串長一點沒被蓋掉，就這樣留下來了。而到了第 33 這筆不知為什麼原因，整個 BUFFER 的內容就跑出來... 這段 SQL SCRIPT 跟本沒作什麼事，不過是前面的 SELECT 指令，改 SELECT INTO 到 TEMP TABLE，然後再撈出來而以。直接 SELECT 沒問題，沒道理 SELECT INTO 就掛掉啊! 不過還真的被我碰到了，see the ghost ..

我沒有直接拼下去 GOOGLE 或是試各種解法，而是想了一下問題是怎麼回事? SQL / DB 的東西我只算外行人，沒本事跟他硬碰硬，我也不知道有啥工具可以看 SQL NATIVE CLIENT 的 TRACE INFO 之類的，只能靠想像，猜一下問題會在那。一開始我就否定掉是不是什麼編碼或是定序的問題，因為我可以正確的 SELECT 出來啊，而且如果 SELECT INTO 是變成 ?? 的話我也許還會頭痛一點，不過竟然是上一筆的資料跑過來了? 這個問題很明顯的，跟本就是 overflow (緩衝區溢位) 之類的 BUG。八成是什麼地方應該填個 0x00 作字串結尾的 CODE 錯掉，結果 SQL 就抓過頭，抓到不該抓的舊資料才會這樣。

拿我寫了十幾年程式的經驗，跟它賭下去了!! 於是我就沒再去跟一堆編碼定序之類的設定搏鬥了，因為我認定這是 SQL SERVER 或是 SQL NATIVE CLIENT 的 BUG。我採的方案是找可以繞過去的方式，於是我把我想的到的 COPY TABLE 都用上了，最後試出來的是笨方法...

用... 用... 用 CURSOR 一筆一筆的跑... @_@

哈哈，各位看倌請笑小聲一點，我這貴州的驢子就只會這種把戲而以.... 果然這樣就正確了。CURSOR 的 FETCH 指令，把欄位的值抓到 nvarchar 的變數，就一切 OK，然後再把這變數的值 update 回我的暫存 TABLE，就什麼問題都沒了 -_-

真是它ㄨㄨㄨㄨ的，最後的 SOLUTION 細節我就不一一的貼出來了，反正只是換個方式 COPY TABLE 而以。既然我賭是 M$ 的問題，而換條路的方式 (完全沒改任何定序 OR 編碼) 也成功了，我就不跟它奮鬥下去了，客戶的 IT 既然懶的上 UPDATE / SERVICE PACK，我也只好避掉問題了事... 咳咳。特地貼出來記念一下，如果你們也碰到一樣的問題，切記切記，別跟它硬碰硬啊... :D

4/6/2007 3:01:00 PM

原來 System.Net.Mail 也會有 Bug ...

Microsoft.NET | TROUBLE SHOOTING | 小技巧 | 技術隨筆 Facebook Share

果然老外寫的程式, 就是容易忽略掉亞洲語系的需求... 為了這個 Bug, 足足浪費我兩天的時間 [:@], 既然糾出來了, 當然要講一下... 先來看這段 sample code:

   1:  MailMessage mail = new MailMessage();

   2:  Encoding chtEnc = Encoding.GetEncoding(950);

   3:  mail.From = new MailAddress("peter@chicken-house.net", "吳小皮", chtEnc);

   4:  mail.To.Add(new MailAddress("annie@chicken-house.net", "吳小妹", chtEnc));

   5:  mail.Subject = "今天天氣很好";

   6:  mail.SubjectEncoding = chtEnc;

   7:  mail.Body = "blah blah blah...";

   8:  (new SmtpClient()).Send(mail);

嗯, 執行的很好, 收的到 MAIL, 編碼也沒問題. 不過沒有回應的 code 總是不大 friendly, 加印一行 message 看看...

   1:  MailMessage mail = new MailMessage();

   2:  Encoding chtEnc = Encoding.GetEncoding(950);

   3:  mail.From = new MailAddress("peter@chicken-house.net", "吳小皮", chtEnc);

   4:  mail.To.Add(new MailAddress("annie@chicken-house.net", "吳小妹", chtEnc));

   5:  mail.Subject = "今天天氣很好";

   6:  mail.SubjectEncoding = chtEnc;

   7:  mail.Body = "blah blah blah...";

   8:  Console.WriteLine("準備寄信 (From: {0})", mail.From);

   9:  (new SmtpClient()).Send(mail);

My God !!! 啥米, 這樣就錯? 而且錯的地方讓我丈二金剛摸不著頭腦... 執行的環境試過 XP, 2003, Vista, 中英文版, 都有 windows update 更新所有的 patch, 除了訊息有中英文版不同之外, 錯誤通通一樣, Exception Dump 如下:

			準備寄信 (From: "吳小皮" )未處理的例外狀況: System.Net.Mail.SmtpException: 傳送郵件失敗。	---> System.FormatException: 標頭值中找到無效的字元。	於 System.Net.Mime.HeaderCollection.Set(String name, String value)   於 System.Net.Mail.Message.PrepareHeaders(Boolean sendEnvelope)   於 System.Net.Mail.Message.Send(BaseWriter writer, Boolean sendEnvelope)   於 System.Net.Mail.SmtpClient.Send(MailMessage message)   --- 內部例外狀況堆疊追蹤的結尾 ---   於 System.Net.Mail.SmtpClient.Send(MailMessage message)   於 Program.Main()

真是它ㄨㄨㄨ的, 怎麼會這樣? 我實際的情況比較慘, 是加了一堆 Console.WriteLine( ) 後才突然發現有問題, 跟本搞不清楚怎麼回事... 試到最後, 確定加了 Console.WriteLine( ) 會有問題, 問題是, 這行到底有什麼了不起的? 不過就是 mail.Form.ToString() ... [:|]

決定繼續挖下去, 先從 Exception 開始查. 前面有一大堆不好追的就跳過去了, 從 dump 的 call stack, 再用 Refactor 去反組譯 .net 的 assembly, 最後這裡看起來最像是 Exception 的源頭:

class: System.Net.Mime.HeaderCollection
method: public override void Set(string name, string value)

截錄片段 source code:

   1:  if (!MimeBasePart.IsAnsi(value, false))

   2:  {

   3:      throw new FormatException(SR.GetString("InvalidHeaderValue"));

   4:  }

怎麼看都沒問題, 追過 IsAnsi( ), 裡面沒啥特別的 code, 就 char 的值小於 0xff 就判定 pass. 所以問題應該出在 value 的值送進來判定時就已經有問題了... 再往上追, value 的源頭是 MailAddress 物件的 .ToEncodedString( ) 來的:

class: System.Net.Mail.MailAddress

   1:  internal string ToEncodedString()

   2:  {

   3:      if (this.fullAddress == null)

   4:      {

   5:          if ((this.encodedDisplayName != null) && (this.encodedDisplayName != string.Empty))

   6:          {

   7:              StringBuilder builder = new StringBuilder();

   8:              MailBnfHelper.GetDotAtomOrQuotedString(this.encodedDisplayName, builder);

   9:              builder.Append(" <");

  10:              builder.Append(this.Address);

  11:              builder.Append('>');

  12:              this.fullAddress = builder.ToString();

  13:          }

  14:          else

  15:          {

  16:              this.fullAddress = this.Address;

  17:          }

  18:      }

  19:      return this.fullAddress;

  20:  }

然後跟加了就會出問題的 ToString( ) 比對著看:

   1:  public override string ToString()

   2:  {

   3:      if (this.fullAddress == null)

   4:      {

   5:          if ((this.encodedDisplayName != null) && (this.encodedDisplayName != string.Empty))

   6:          {

   7:              StringBuilder builder = new StringBuilder();

   8:              builder.Append('"');

   9:              builder.Append(this.DisplayName);

  10:              builder.Append("\" <");

  11:              builder.Append(this.Address);

  12:              builder.Append('>');

  13:              this.fullAddress = builder.ToString();

  14:          }

  15:          else

  16:          {

  17:              this.fullAddress = this.Address;

  18:          }

  19:      }

  20:      return this.fullAddress;

  21:  }

Ouch, 真是想罵人, 問題就在這裡... 看起來是 M$ 工程師為了避開重複作編碼的動作, 每次呼叫 ToEncodedString( ) 及 ToString( ) 時都會去看看 fullAddress 這個 private field 是否有值? 有的話代表之前已經作過編碼了, 就直接撿現成. 問題出在第一次呼叫時, 編碼的動作在 ToString( ) 及 ToEncodedString( ) 各寫了一次 (果然沒有做好 refactoring ... 哈哈), 結果 ToString( ) 的這份 code implementation 是錯的, 跟本沒編碼 [:@] ... 我沒事雞婆在寄信前呼叫 ToString( ) 印 Messabe 算我運氣背, 就碰到這個 Bug.. [:@]

花了近兩天, 不過最後有找到 Bug, 而且還是 M$ 的 Bug, 哈哈, 總算證明人不是我殺的 [:D], submit M$ 的 Bug 有獎金嘛? 不只 Bug, 連問題都找到了... 有的話通知一下 [:D]

[Tips] 用 “磁碟鏡像" 更換硬碟 #2, Windows 2003 的跨距磁區

[Tips] 用 “磁碟鏡像" 無痛更換硬碟

XmlWellFormedWriter.WriteRaw( ) 的 Bug 後續發展

原來 System.Xml.XmlWellFormedWriter 有 Bug ..

關不掉的 Vista UAC !?

該如何學好 "寫程式" #4. 你的程式夠 "可靠" 嗎?

令人火大的 SQL 字元編碼...

原來 System.Net.Mail 也會有 Bug ...

本週最熱門文章

精選文章

安德魯是誰?

Month List

Recent comments

本週最熱門文章

精選文章

安德魯是誰?

Month List

文章分類

Recent comments