我習慣將控制元件行為的最後一個參數,設為文件(呈現內容)的"格式",如使用者想要 XML 格式的回傳內容,則傳入 'xml'。例如:
程式定義:
class Controller {
function method( docType ) {
// return result as a XML document.
}
}
var controller = new Controller;
調用控制項時的 URI:
controller/method/xml
# invoke controller->method('xml');
不過,我更喜歡將"文件格式"這個參數放在 URI 的副檔名部份。這部份我放在文章後段。
再看一個更具體的例子。控制元件 Human 有一個行為 query 可以查詢某人的資料,第一個參數是人名,最後一個參數是查詢結果的資料格式。
調用控制元件時的 URI:
不過,我更喜歡將"文件格式"這個參數放在 URI 的副檔名部份,讓使用者認為他是直接取得"一份那種格式的文件"。亦即使用者認為他是在觀看一份靜態的文件。再舉前例說明如下: