常見(jiàn)參數(shù)
多數(shù) Manager 命令都能夠接受一個(gè)或多個(gè)查詢參數(shù),這些查詢參數(shù)如下所示:
- path 要處理的 Web 應(yīng)用的上下文路徑(包含前面的斜杠)。要想選擇 ROOT Web 應(yīng)用,指定 / 即可。注意:無(wú)法對(duì) Manager 應(yīng)用自身執(zhí)行管理命令。
- version 并行部署 所用的 Web 應(yīng)用版本號(hào)。
- war Web 應(yīng)用歸檔(WAR)文件的 URL,或者含有 Web 應(yīng)用的目錄路徑名,或者是上下文配置 .xml 文件。你可以按照以下任一格式使用 URL:
- file:/absolute/path/to/a/directory 解壓縮后的 Web 應(yīng)用所在的目錄的絕對(duì)路徑。它將不做任何改動(dòng),直接附加到你所指定的上下文路徑上。
- file:/absolute/path/to/a/webapp.war Web 應(yīng)用歸檔(WAR)文件的絕對(duì)路徑。只對(duì) /deploy 命令有效,也是該命令所唯一能接受的格式。
- jar:file:/absolute/path/to/a/warfile.war!/ 本地 WAR 文件的 URL。另外,為了能夠完整引用一個(gè)JAR 文件,你可以采用 JarURLConnection 類的任何有效語(yǔ)法。
- file:/absolute/path/to/a/context.xml Web 應(yīng)用上下文配置 .xml 文件的絕對(duì)路徑,上下文配置文件包含著上下文配置元素。
- directory 主機(jī)應(yīng)用的基本目錄中的 Web 應(yīng)用的目錄名稱。
- webapp.war 主機(jī)應(yīng)用的基本目錄中的 WAR 文件的名稱。
每個(gè)命令都會(huì)以 text/plain 的形式(比如,沒(méi)有 HTML 標(biāo)記的純 ASCII 碼文本 )返回響應(yīng),從而便于開(kāi)發(fā)者與程序閱讀。
響應(yīng)的第一行以 OK 或 FAIL 開(kāi)頭,表明請(qǐng)求的命令是否成功。如果失敗,響應(yīng)第一行隨后部分就會(huì)帶有遇到問(wèn)題的描述。一些包含其他信息行的命令會(huì)在下文予以介紹。
國(guó)際化說(shuō)明 Manager 應(yīng)用會(huì)在資源包中查找消息字符串,所以這些字符串可能已經(jīng)轉(zhuǎn)化為你所用平臺(tái)的語(yǔ)言版本了。下文的范例展示的全都是消息的英文版本。