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.tutoraspire.

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.

Spring Boot Project Deployment Using Tomcat

Step 8: Create a Controller class in the package com.tutoraspire. 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.tutoraspire;  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.

Spring Boot Project Deployment Using Tomcat

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.tutoraspire;  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 <finalName> 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.tutoraspire</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

Spring Boot Project Deployment Using Tomcat

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.

Spring Boot Project Deployment Using Tomcat

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.

Spring Boot Project Deployment Using Tomcat

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:UsersAnubhavDocumentsworkspace-sts-3.9.9.RELEASEspring-boot-war-deployment-exampletarget  

Spring Boot Project Deployment Using Tomcat

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:

Spring Boot Project Deployment Using Tomcat

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

  C:Cd Program FilesApache Software FoundationTomcat  8.5bin  C:Cd Program FilesApache Software FoundationTomcat  8.5bin>startup  

Spring Boot Project Deployment Using Tomcat

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

Spring Boot Project Deployment Using Tomcat

The following image shows that WAR is deployed successfully.

Spring Boot Project Deployment Using Tomcat

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

Spring Boot Project Deployment Using Tomcat

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

Social Media Marketing Tutorial

Download and Install SPSS

You may also like