QuickWAP V1.0 精簡版是一款基於 WAP 1.2 協議、以 VB6 開發的伺服器組件,用途是輔助以 ASP+WML 撰寫 WAP 網頁。因為它是原生 Windows 元件,由系統直接呼叫,處理 WML 的速度比 IIS 自行解析 ASP+WML 快上數倍,同時也省下了不少中文編碼的困擾。
1. 將 QuickWAP.dll 複製到系統的 system32 目錄:Windows 2000 系列放 系統盤:/WINNT/system32/,Windows XP/2003 放 系統盤:/Windows/system32/。
2. 註冊元件:開「開始」選單 →「執行」,輸入 Regsvr32 QuickWap.dll。成功後會跳出提示對話框。


3. 驗證安裝:新建一個 ASP 檔,寫入建立物件並呼叫 TestQuickWap 的幾行程式碼,透過 IIS 執行後若正常輸出,就代表組件已可使用。
特別注意:使用前必須先在伺服器設定好 WAP 相關的 MIME 類型,否則瀏覽器與網關都無法正確辨識檔案。對照表如下:
設定路徑:開「開始」→ 設定 → 控制台 → 管理工具 → Internet 資訊服務(IIS)管理器,右鍵點「本機電腦」選內容,開啟 MIME 類型後逐項把上表加進去。


這兩個函式負責頁首與頁尾。PageHeader 用來輸出 WAP 檔頭並產生卡片,語法為 Wap.PageHeader("CacheControl", "forua", "OtherAtt")。其中 CacheControl 的 max-age 指定卡片在快取中的存活秒數,設為 0 則每次都必須連回伺服器重新取件;forua 為可選屬性,決定 meta 標籤是否在傳輸前被中間代理刪除,預設 false;OtherAtt 用於附加其他屬性,值可用單引號或雙引號包起。PageFooter 沒有參數,直接輸出檔尾即可。

兩者都會把要輸出的文字做 UTF-8 轉碼後送出。差別只有一點:WriteRow 等於 WriteOut 加上一個換行標籤,所以用它輸出時可以省掉手動補的換行。寫 WML 時,這個小差異能省下大量標籤。

Wap.WriteRow Wap.A("Title", "Url", "DisplayText")。Title 是顯示在手機螢幕角落的提示文字,Url 可用相對或絕對路徑,DisplayText 是畫面上的連結文字。參數之間必須以逗號分隔。

語法為 Wap.WriteOut Wap.EasyMorePage("ToShowContent", TextLong),前者是要分頁的長字串,後者是每頁顯示的字元數。手機螢幕小,長文分頁幾乎是必要功能,這個函式把它簡化成一行。

Wap.WriteOut Wap.Img("Url", "Tip", OtherAtt)。Tip 是圖片無法載入時顯示的替代文字,OtherAtt 可附加 align 等屬性。

Wap.WriteRow Wap.ImgA("ImgPath", "Url", "DisplayText"),把圖片與連結合成一個元素,是手機介面上最實用的組合。

Wap.WriteOut Wap.P("AlignMent", "WrapMode")。對齊方式有 left、center、right 三種;換行模式有 wrap 與 nowrap 兩種。兩兩搭配可做出六種段落樣式。

Wap.WriteRow Wap.Utf8_Gb2312("SearchString"),把被轉成 UTF-8 編碼的字串還原為中文,處理表單回傳或外部資料寫入時經常會用到。

問:用不習慣,可以卸載嗎?
可以。執行 Regsvr32 /u QuickWap.dll 即可移除。
問:為什麼一開始覺得不順手?
任何新的開發模式都需要一段適應期。把八個函式用過幾輪之後,多半會發現它比手寫 WML 標籤快得多,也就慢慢習慣了。
