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