這一篇彙整了四個與日常開發密切相關的話題:如何把 XML 註解自動生出來、如何替自家的小工具接上線上金流、如何用增益元件強化 Visual Studio 的編碼體驗,以及一本資料庫開發經典的最新版消息。
.NET Framework 把「寫文件」的成本壓得很低。所謂 XML 註解,其實是嵌在原始碼裡的特殊 XML 標記,用來描述類別、方法、屬性與事件等中繼資料;編譯時 Visual Studio 會把這些標記抽成一份獨立的 XML 檔,再透過 Sandcastle 這類工具轉換成說明文件。
諷刺的是,真正耗人的從來不是設定流程,而是那一句一句親手敲出來的說明文字。GhostDoc 1.9.5 想解決的正是這一段。
GhostDoc 會自動產生 XML 註解(點擊圖片可檢視較大視圖)
這套由 Roland Weigelt 開發的免費增益元件,安裝之後只要在方法上按一下右鍵、選「Document This」,它就會依方法的型別、參數、命名與上下文資訊,替你寫出第一版註解。若你文件化的是 .NET 內建型別,它會直接沿用 Microsoft 既有的說明文字;若你的命名採用 Pascal 或 Camel 大小寫慣例,它會先把名稱拆成單字,逐字推敲後再組裝成通順的句子。所有判斷邏輯都走 GhostDoc 的規則引擎——內建規則可以改,也能新增自己的規則,甚至匯出規則檔,帶到另一台機器繼續用。
但要老實說:除了最單純的成員,GhostDoc 產生的內容只能當草稿。它省下的是打字時間,不是審閱責任;語意是否精準,仍得由開發者自己過目。
價格:免費。
網址:www.roland-weigelt.de/Ghostdoc
做為開發者,大概都有過這種念頭:把自己寫的元件或應用程式包裝成產品賣給同行。技術從來不是難點,卡住的多半是「錢怎麼收」。
今天幾乎所有線上交易都以信用卡或金融卡完成。要收這類款項,你需要兩樣東西:商戶帳戶與付款關閘。前者由金融機構提供(可能是住家附近的銀行,也可能是 PayPal 這類線上服務),讓你能接收來自其他帳戶或信用卡的款項;後者則是實際處理電子付款交換的系統。
提供付款關閘服務的公司不少,作者認為其中最容易上手的是 Authorize.Net。開好帳戶之後,你可以選擇兩種收款路徑:
不論走哪一條路,Authorize.Net 都會把款項從顧客的卡片帳戶轉進你的商戶帳戶,整個流程通常只要幾秒。它同時提供位址驗證與卡號驗證以降低詐騙風險,也能設定為處理定期定額扣款。
別忘了,Authorize.Net 只是關閘。你仍需另外申請商戶帳戶,而那意味著一組自己的費用:多數社區型金融機構的設定費約 100 美元、月費約 30 美元,每筆交易再抽 2.0–3.0% 加上 0.05–0.50 美元。
價格:設定費 149.00 美元、月費 20.00 美元、每筆交易 0.10 美元。
網址:www.authorize.Net
Visual Studio 每個新版本都會補進更多向導與工具,但真正把生產力拉開差距的,往往是市場上這些第三方增益元件——它們針對「寫程式、重構、測試」這三件事做了更深的著墨。
JetBrains 的 ReSharper 2.5 就是代表。它提供智慧型錯誤提示與一鍵快速修復、更完整的重構支援、可自訂的程式碼格式化、單元測試整合、NAnt 與 MSBuild 腳本編輯,還有一整套用來在大型專案的型別與檔案之間搜尋、跳轉的工具。
ReSharper 以燈泡圖示提示可套用快速修復(點擊圖片可檢視較大視圖)
最實用的是快速修復:偵測到警告或錯誤的那一行旁會亮起燈泡圖示。舉例來說,你忘了做型別轉換,ReSharper 會透過燈泡提醒你,並直接幫你把轉換補上。
導航與搜尋在大型專案裡更是效果顯著。「Navigate from Here」能一鍵跳到變數或型別的宣告處、跳到基底類別,同時列出所有衍生型別與該變數在專案中被使用的每一個位置;「Find Results」視窗簡化了特定型別的搜尋;「File Structure」視窗則列出目前檔案的型別與成員,你可以直接在該視窗重新排序,或快速跳到某個成員。
版本差異要注意:ReSharper for Visual Studio .NET 2003 只支援 C#;Visual Studio 2005 版則有部分 Visual Basic 功能缺席,而 C# 開發者也未必能用上全部特性。此外它還包含部分 ASP.NET 網頁編輯功能。
價格:單人授權 249 美元。
網址:www.jetbrains.com/resharper
1990 年代末,作者剛開始寫資料驅動的 Visual Basic 應用程式時,一位同事推薦了 William R. Vaughn 的《Visual Basic 和 SQL Server 簡要指南》。那是一本厚到被取了「門掣」外號的書,整個 90 年代一共出了六版。九年之後,Vaughn 與 Peter Blackburn 合寫的第七版問世,書名也改為《Visual Studio 和 SQL Server 簡要指南》(Addison-Wesley,2007)。
第七版依循前幾版的骨架,把重要主題講得深入而透徹:從 SQL Server 2005 的安裝、安全性與管理疑難,到 T-SQL 基礎(SELECT、INSERT、UPDATE、DELETE)、檢視、使用者自訂函數、觸發器、預存程序,一路談到資料庫設計、正規化與資料/關聯性完整性。
全書分成篇幅相當的兩半。前半是 SQL Server 專屬話題,包含應用程式架構、各種資料存取手法的取捨,以及 SQL Server 2005 各版本的差異比較;後半則是「用 Visual Studio 處理資料」,涵蓋透過 IDE 存取資料庫、以 ADO.NET 透過程式操作資料、建立具型別的資料集,以及在應用程式架構中把資料庫實體建模成物件。
Vaughn 經驗老到,文筆流暢,讓這本書成為 .NET 資料驅動開發者的必備工具。範例程式碼同樣以 Visual Basic 寫成,但 C# 開發者不必因此卻步——這本書真正的價值在於觀念與架構上的建議,而不是可以直接複製貼上的片段。
網址:www.aw-bc.com
本文作者 Scott Mitchell 著作等身,創辦了 4GuysFromRolla.com,自 1998 年起使用 Microsoft Web 技術並獲選 MVP,現為獨立顧問、講師與作家。來信請寄 toolsmm@microsoft.com,或透過他的部落格 www.ScottOnWriting.Net 聯絡。