理解WAR文件结构
war（web application archive）文件是java web应用程序的部署标准格式，本质上是一个遵循特定目录结构的zip或jar文件。当部署到servlet容器（如tomcat）时，容器会解析这个结构来运行应用程序。一个典型的war文件结构如下：
your-webapp.war ├── index.jsp (或其他静态资源如HTML, CSS, JS) ├── WEB-INF/ │ ├── web.xml (部署描述符) │ ├── classes/ (编译后的Java类文件，即.class文件) │ │ └── com/yourcompany/yourwebapp/YourServlet.class │ └── lib/ (应用程序所需的JAR库文件) │ └── some-library.jar └── META-INF/ (可选，包含JAR/WAR清单文件等元数据)
要手动创建WAR文件，核心任务就是将项目源文件组织成上述结构，然后将其打包成一个.war后缀的压缩文件。
使用Apache Ant构建WAR文件
虽然可以完全手动通过命令行进行文件复制和打包，但使用构建工具（如Apache Ant）可以更高效、可重复地完成这些步骤。Ant是一个基于XML的构建工具，非常适合执行这种结构化的任务。
1. 安装Apache Ant
如果您的系统尚未安装Ant，请首先下载并安装它。访问Apache Ant官方网站获取最新版本，并按照其指南配置环境变量。
2. 准备Ant构建脚本
在项目根目录下创建一个名为build.xml的文件，并添加以下内容。这个脚本定义了两个主要任务：compile（编译Java源文件并准备WAR内容）和war（生成WAR文件）。
立即学习“Java免费学习笔记（深入）”；
脚本说明：
- property标签：定义了项目中的各种路径变量，方便管理和修改。请确保servlet.api.jar的路径指向您项目中实际使用的Servlet API JAR文件。
- clean目标：用于清除之前构建生成的文件和目录，确保每次构建都是干净的。
-
compile目标：
- 首先创建build/WEB-INF/classes目录，用于存放编译后的Java类。
- 将WebContent目录下的index.jsp（或其他静态资源）复制到build目录的根部。
- 将WebContent/WEB-INF/目录下的内容（如web.xml）复制到build/WEB-INF/。注意这里排除了classes和lib子目录，因为它们会通过其他方式处理。
- 使用javac任务编译src目录下的所有Java源文件，并将编译后的.class文件输出到build/WEB-INF/classes。classpath属性非常重要，它需要包含Servlet API JAR文件，以便编译器能找到Servlet相关的类。includeantruntime="false"避免Ant自身的JAR被包含到classpath中。
-
war目标：
- 创建dist目录，用于存放最终生成的WAR文件。
- 使用war任务来创建WAR文件。
- destfile：指定生成的WAR文件的路径和名称。
- basedir：指定WAR文件的内容来源目录，即build目录。
- webxml：指定部署描述符web.xml的路径。
-
：这个嵌套标签非常关键，它指示Ant将WebContent/WEB-INF/lib目录下的所有JAR文件复制到WAR文件的WEB-INF/lib目录中。
3. 执行Ant构建
在命令行中，切换到包含build.xml文件的项目根目录，然后运行以下命令：
ant clean war
- ant clean：会执行clean目标，清理旧的构建产物。
- ant war：会执行war目标。由于war目标依赖于compile目标，Ant会自动先执行compile目标。
执行成功后，您将在dist目录下找到生成的mywebapp.war文件。这个WAR文件可以直接部署到任何兼容的Servlet容器（如Tomcat）中。
注意事项与建议
- Servlet API版本：确保build.xml中servlet.api.jar的路径和版本与您项目实际使用的Servlet API版本一致，并且该JAR文件确实存在于指定路径。
-
项目结构：本教程假定您的项目结构类似于：
MyWebApp/ ├── src/ (Java源文件) │ └── com/yourcompany/yourwebapp/YourServlet.java ├── WebContent/ (Web内容，如JSP, HTML, CSS, JS, WEB-INF) │ ├── index.jsp │ └── WEB-INF/ │ ├── web.xml │ └── lib/ (项目依赖的JAR包) │ └── javax.servlet-api-4.0.1.jar ├── build.xml (Ant构建脚本)
如果您的项目结构不同，需要相应调整build.xml中的路径。
- 其他资源：如果您的项目包含图片、CSS、JavaScript等其他静态资源，且它们位于WebContent目录下，copydir任务通常会处理它们，或者您需要添加额外的copy任务来确保它们被包含到WAR包的正确位置。
- 日志与错误：在执行Ant时，注意命令行输出的日志信息。如果出现错误，仔细阅读错误消息以定位问题。
- 现代构建工具的推荐：尽管Ant能够完成WAR包的构建，但对于更复杂的项目，特别是那些有大量第三方依赖管理需求的项目，强烈建议使用Maven或Gradle。这些工具提供了更强大的依赖管理、生命周期管理和插件生态系统，能够大大简化项目构建和维护的复杂性。本教程旨在帮助理解WAR包的底层构建原理，但在实际开发中，应优先考虑使用更现代的构建工具。
