常見(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ǔ)言版本了。下文的范例展示的全都是消息的英文版本。