XPath(XML Path Language)是一套在 XML 文件裡定位節點的表達式語言;XSLT(Extensible Stylesheet Language Transformations)則架在它之上,用 XPath 描述節點的選取與處理規則,把來源 XML 轉換成 HTML、純文字或任何自訂格式。兩者搭配,正好適合處理「郵件合併」這類把結構化資料套進固定信件的任務。
以下示範由三個部分組成:Letter.xml 存放信件資料,Letter.xsl 定義信件版式,最後由 MSXML 4.0 套用樣式表,輸出一份合併完成的純文字信件。這個例子同時示範了 concat、starts-with 兩個字串函數,以及如何在輸出中插入換行、定義並使用變數。
<?xml version="1.0" encoding="UTF-8"?>
<Letter>
<Date>July 17, 2002</Date>
<To>
<FirstName>Vicky</FirstName>
<LastName>P</LastName>
<Sex>Male</Sex>
</To>
<Address>
<Line1>900 National Pkwy</Line1>
<Line2>Suite 105</Line2>
<City>Bellevue</City>
<State>WA</State>
<Zip>98007</Zip>
<Country>USA</Country>
</Address>
<Subject>ESTATE OF JOHN DOE / FILE NO. 12345.6789</Subject>
<Text>Please pay the property taxes as soon as possible.</Text>
<Sender>
<FirstName>John</FirstName>
<LastName>M</LastName>
<Title>Sr. Tax Consultant</Title>
</Sender>
</Letter>
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform">
<xsl:output method="text" indent="yes"/>
<xsl:variable name="NL" select="'
'" />
<xsl:variable name="Para" select="concat($NL, $NL)" />
<xsl:template match="/">
<xsl:value-of select="//Date" />
<xsl:value-of select="$Para" />
To,
<xsl:value-of select="concat(//To/FirstName, ' ', //To/LastName)" />
<xsl:value-of select="$NL" />
<xsl:value-of select="//Address/Line1" />
<xsl:value-of select="$NL" />
<xsl:value-of select="//Address/Line2" />
<xsl:value-of select="$NL" />
<xsl:value-of select="concat(//Address/City, ' ', //Address/State, ' ', //Address/Zip)" />
<xsl:value-of select="$NL" />
<xsl:value-of select="//Address/Country" />
<xsl:value-of select="$Para" />
Regarding: <xsl:value-of select="//Subject" />
<xsl:value-of select="$NL" />
Dear <xsl:if test="starts-with(//Sex, 'M')">Mr. </xsl:if><xsl:if test="starts-with(//Sex, 'F')">Miss </xsl:if>
<xsl:value-of select="concat(//To/FirstName, ' ', //To/LastName)" />,
<xsl:value-of select="$Para" />
<xsl:value-of select="//Text" />
<xsl:value-of select="$Para" />
Sincerely,
<xsl:value-of select="$Para" />
<xsl:value-of select="concat(//Sender/FirstName, ' ', //Sender/LastName)" />
<xsl:value-of select="$NL" />
<xsl:value-of select="//Sender/Title" />
</xsl:template>
</xsl:stylesheet>
幾個值得注意的細節:先用變數 $NL 存好換行字元實體,再用 concat 組出空行變數 $Para,後續就能重複引用;稱謂部分則用 starts-with 判斷性別欄位的第一個字元,決定輸出 Mr. 還是 Miss。
建立一個 Win32 主控台專案,在 stdafx.h 中引入 MSXML 4.0 的型別庫與標頭檔,並定義一個簡化 HRESULT 檢查的輔助函式:
#include <TCHAR.H>
#include <stdio.h>
#include <time.h>
#import "msxml4.dll"
#include <msxml2.h>
using namespace MSXML2;
inline void EVAL_HR(HRESULT _hr) { if FAILED(_hr) throw(_hr); }
#define TEMP_SIZE _MAX_PATH // 短緩衝區大小
static _TCHAR szTemp[TEMP_SIZE]; // 堆疊上的通用緩衝區
static DWORD dwLen;
若 #import 或 #include 失敗,代表尚未安裝 MSXML 4.0 SP1 的執行庫與 SDK,安裝後還要把 include 與 lib 的搜尋路徑加進 Visual C++ 的目錄清單。
int main(int argc, char* argv[])
{
try
{
EVAL_HR(CoInitialize(NULL));
if (!isMSXMLInstalled()) // 確認 MSXML 4.0 已安裝
return -1;
if (argc < 3) // 需傳入 XML 與 XSL 兩個檔名
return -1;
IXMLDOMDocument2Ptr pXMLDoc = NULL;
IXMLDOMDocument2Ptr pXSLDoc = NULL;
if (loadDocument(pXMLDoc, argv[1], true))
{
if (loadDocument(pXSLDoc, argv[2], false))
{
_FTPrintf(stdout, pXMLDoc->transformNode(pXSLDoc));
}
else
{
printMSXMLError(pXSLDoc);
}
}
else
{
printMSXMLError(pXMLDoc);
}
}
catch(...) { /* 例外處理 */ }
_FTPrintf(stdout, "\n\nPress Enter to continue...");
getchar();
CoUninitialize();
return 0;
}
執行時把 XML 檔與 XSLT 樣式表檔名當成命令列參數傳入。程式先以 isMSXMLInstalled() 驗證環境,接著兩次呼叫 loadDocument 分別載入資料與樣式表,最後由 transformNode 完成轉換並印到標準輸出。
原始範例與程式碼下載:https://www.perfectxml.com/CPPMSXML/downloads/20020716MailMerge.zip(譯自 PerfectXML)