Saturday, 15 March 2014

Eclipse - WAR file creation

Enjoying this guide? Join our developer community!

Step-by-Step Guide: How to Export a WAR File in Eclipse IDE

Exporting your dynamic web application into a WAR (Web Application Archive) file is essential when preparing to deploy on standalone servers like Apache Tomcat. Eclipse IDE provides an intuitive export wizard that packages your servlets, JSPs, libraries, and configurations into a single distribution archive with just a few clicks.

Step 1: Open Your Dynamic Web Project

Launch Eclipse IDE and ensure your web project is error-free in the Project Explorer:

Select and right-click on your Dynamic Web Project root folder.
Navigate to the context menu and hover over Export, then click on WAR file.
Alternative: Click File > Export > Web > WAR file and click Next.

Step 2: Configure Export Settings and Destination

In the WAR Export wizard dialog, specify the following details:

Web Project: Verify that the correct project is selected from the dropdown list.
Destination: Click Browse... and choose the target location on your computer (e.g., Desktop or build directory) where you want the .war file saved.
Target Runtime (Optional): Select your configured application server runtime (such as Apache Tomcat) if you want optimized library packaging.

Step 3: Review Export Options and Finish

Before completing the export, review the checkable options:

Optimize for a specific server runtime: Ensures runtime-provided classes are not unnecessarily bundled.
Overwrite existing file: Check this if you are updating an existing build file.

Click Finish. Eclipse will immediately package your compiled classes, assets, and descriptor files into the destination WAR file.

Why Do You Need a WAR File?

Deploying raw code or separate source folders to remote test or production servers is prone to error. A WAR file encapsulates your complete web application—including servlets, HTML, CSS, JavaScript, and third-party JARs—ensuring standard portability and effortless deployment into any servlet container.