Spring Boot Tutorial
Creating Project
Project Components
Tool Suite
- hello-world-example
- project-deployment-using-tomcat
Spring Boot AOP
Spring Boot Database
Spring Boot View
- sb-thymeleaf-view
SB Caching
Spring Boot Misc
Spring Boot - RESTful
Spring Tutorial
- spring-tutorial
Spring Cloud
- spring-cloud-tutorial
Spring Microservices
- spring-microservices-tutorial
Interview Questions
- spring-interview

next → ← prev

Project Deployment Using Tomcat

In this section, we will learn how to deploy the Spring Boot application on Tomcat Server.

It includes three steps:

Setting up a Spring Boot Application
Create a Spring Boot WAR
Deploy the WAR to Tomcat

Example

Let's create a Maven example to be deployed on Tomcat

Setting up a Spring Boot Application

Step 1: Open Spring Initializr http://start.spring.io.

Step 2: Provide the Group name. We have provided the com.w3cschoool.

Step 3: Provide the Artifact Id. We have provided the spring-boot-war-deployment-example.

Step 4: Add the Spring Web dependency.

     <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>

    

Step 5: Click on the Generate button. It wraps all the specification related to the project and download the jar file in our local system.

Spring Boot Project Deployment Using Tomcat

Step 6: Extract the jar file.

Step 7: Import the project folder by using the following steps:

File -> Import -> Existing Maven Project -> Next -> Browse -> Select the Project Folder -> Finish

After importing the project, we can see the following directory structure in the Package Explorer section of the IDE.

Step 8: Create a Controller class in the package com.w3cschoool. We have created a class with the name DemoRestController.

Inside the controller class, we have defined a method hello() that returns a String.

DemoRestController.java

     package com.w3cschoool;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class DemoRestController 
{
@GetMapping("/hello")
public String hello() 
{
return "Hello User, have a nice day.";
}
}

    

Step 9: Run the SpringBootWarDeploymentExampleApplication.java file as Java Application.

Step 10: Open the browser and invoke the URL http://localhost:8080/hello.

Note: Before moving to the next step, ensure that the application is running correctly.

Create a Spring Boot WAR

It makes use of Spring Framework's Servlet 3.0 support and allows us to configure application when the servlet container launches it. There are three steps to create a WAR for deployment:

Extends the SpringBootServletInitializer class in the main class.
Marked the embedded servlet container as provided.
Update packaging JAR to

Let's implement the above three steps in an application.

Step 11: Open the SpringBootWarDeploymentExampleApplication.java file and initialize the Servlet Context required by the Tomcat. To achieve the same extends the SpringBootServletInitializer interface.

     public class SpringBootWarDeploymentExampleApplication extends SpringBootServletInitializer
{
}

    

Step 12: Override the Configure method.

     @Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) 
{
return application.sources(SpringBootWarDeploymentExampleApplication.class);
} 

    

SpringBootWarDeploymentExampleApplication.java

     package com.w3cschoool;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
@SpringBootApplication
public class SpringBootWarDeploymentExampleApplication extends SpringBootServletInitializer
{
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) 
{
return application.sources(SpringBootWarDeploymentExampleApplication.class);
}
public static void main(String[] args) 
{
SpringApplication.run(SpringBootWarDeploymentExampleApplication.class, args);
}
}

    

Step 13: Open the pom.xml file and marked the servlet container (Tomcat) as provided.

     <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>  

    

Step 14: We need to deploy WAR file so change the package type to WAR in pom.xml file.

Step 15: Modify the final WAR file name by using the tag to avoid including the version numbers. We have created a WAR file with the name web-services.

pom.xml

     <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.w3cschoool</groupId>
<artifactId>spring-boot-war-deployment-example</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>spring-boot-war-deployment-example</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.2.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>  
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>web-services</finalName>
 <plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>	 
</build>
</project>

    

To build our Tomcat-deployable WAR application, we execute the maven clean package. After that our WAR file is generated at /target/abc.war (where abc is assumed Artifact Id). We should consider that this new setup makes our Spring Boot Application a non-standalone application.

Step 16: Create a WAR file by using the following steps:

Right-click on the project -> Run As -> 5 Maven Build

An Edit Configuration dialog box appears on the screen.

Step 17: Write clean install in the Goals label and check the Skip Tests. Click on the Apply and Run button, respectively.

When the WAR file successfully created, it shows the WAR file path and a message BUILD SUCCESS in the console, as shown in the following figure.

Step 18: Copy the path and access the target folder of the application. We found the WAR file inside the target folder with the same name as we have specified in the pom.xml file. In our case, path is:

     C:\Users\Anubhav\Documents\workspace-sts-3.9.9.RELEASE\spring-boot-war-deployment-example\target

    

Deploy the WAR file to Tomcat

To deploy the WAR file, follow the steps below:

Step 19: Download and install the Apache Tomcat Server, if not installed.

Step 20: Copy the WAR file (web-services.war) and paste it inside the webapps folder of the Tomcat. In our case, the location of the webapps folder is:

Step 21: Now open the Command Prompt and type the following commands:

     C:\Cd Program Files\Apache Software Foundation\Tomcat  8.5\bin
C:\Cd Program Files\Apache Software Foundation\Tomcat  8.5\bin>startup

The startup command starts the Tomcat server and deploys the WAR file, as shown below.

The following image shows that WAR is deployed successfully.

Step 23: Open the browser and invoke the URL http://localhost:8080/web-services/hello. It returns the message Hello User, have a nice day.

Download WAR Deployment Example Project

Next TopicSpring Boot AOP

← prev next →

Hot Tutorials

HTML/CSS

JavaScript

Backend language

Development Framework

Database

Mobile development

Development tools

Big Data

XML Tutorial

Contact US

Email:jjw.quan@gmail.com

Spring Boot Tutorial

Creating Project

Project Components

Tool Suite

Spring Boot AOP

Spring Boot Database

Spring Boot View

SB Caching

Spring Boot Misc

Spring Boot - RESTful

Spring Tutorial

Spring Cloud

Spring Microservices

Interview Questions

Project Deployment Using Tomcat

Example

Note: Before moving to the next step, ensure that the application is running correctly.

Create a Spring Boot WAR

Deploy the WAR file to Tomcat

Hot Tutorials

Python tutorial

Vue.js Tutorial

HTML Tutorial

Java Tutorial

PHP Tutorial

Spring Tutorial

JavaScript Tutorial

CSS Tutorial

jQuery Tutorial

SQL Tutorial

C Tutorial

HTML/CSS

HTML Tutorial

HTML5 Tutorial

CSS Tutorial

Bootstrap Tutorial

JavaScript

JavaScript Tutorial

Vue.js Tutorial

ReactJS Tutorial

jQuery Tutorial

Node.js Tutorial

TypeScript Tutorial

AngularJS Tutorial

JSON Tutorial

Ajax Tutorial

ES6 Tutorial

Angular 7 Tutorial

jQuery UI Tutorial

Backend language

Python tutorial

Java Tutorial

Node.js Tutorial

PHP Tutorial

Go Tutorial

C Tutorial

C++ Tutorial

C# Tutorial

Ruby Tutorial

JSP Tutorial

JSTL Tutorial

ASP.NET Tutorial

Perl Tutorial

Scala Tutorial

VBA Tutorial

Development Framework

Spring Tutorial

Spring Boot Tutorial

Django Tutorial

Servlet Tutorial

Struts 2 Tutorial

Hibernate Tutorial

Solr Tutorial

Database

SQL Tutorial

MySQL Tutorial

Oracle Tutorial

SQL Server Tutorial

PostgreSQL Tutorial

DB2 Tutorial