指令巨集 command-macros
指令巨集為指令集提供已命名的捷徑。 巨集是在個別的巨集定義檔案中定義,這些檔案可附加到影像目錄或預設目錄。
$ *
名稱*$
*
name*
不區分大小寫,而且可能包含ASCII字母、數字、'-'、'_'和'.'的任何組合 個字元。
巨集可在'?'之後的任何要求中叫用,也可在catalog::Modifier
或catalog::PostModifier
欄位中的任何地方叫用。 巨集只能代表一或多個、完整的「影像伺服」命令,而且必須以&
分隔符號與其他命令分開。
在剖析期間,巨集引動詞在早期會被替代字串取代。 巨集內的命令會覆寫請求中的相同命令(如果這些命令發生在請求中的巨集呼叫之前)。 此處理流程不同於catalog::Modifier
,其中要求字串中的命令一律會覆寫catalog::Modifier
字串中的命令,無論要求中的位置為何。
命令巨集不能有引數值,但自訂變數可用來將要求中的值傳遞至巨集。
巨集可能是巢狀的。 不過,只有在巨集定義剖析時已定義巨集時,才能叫用巨集。 此工作流程是透過先出現在相同巨集定義檔案中,或將此類內嵌巨集的定義置於預設巨集定義檔案中來完成。
範例 section-2f73d36ac8d64254a03bae5afeae2fb9
如果要將相同的屬性套用至不同的影像,巨集就相當有用。
http://server/cat/1345?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/1435?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/8243?wid=480&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1
您可以定義通用屬性的巨集:
view wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1
巨集的使用方式如下:
http://server/cat/1345?$view$ http://server/cat/1435?$view$ http://server/cat/8243?$view$&wid=480
因為wid=
與第三個要求不同,您只需覆寫 after 值,即可叫用巨集(指定wid=
before $view$
無效)。
另請參閱 section-8cdba0ed2480444ca61e719e54f8871c
目錄::MacroFile , 目錄::Modifier, 巨集定義參考