IDEA中创建一个Servlet项目的详细步骤
IDEA中创建一个Servlet项目的详细步骤
本文将详细介绍如何在IntelliJ IDEA中创建一个简单的Java Servlet项目,并通过HTTP在浏览器中访问。从创建项目到最终部署和验证,每个步骤都配有详细的说明和截图,适合初学者学习。
1. 创建项目
打开IntelliJ IDEA,点击"NEW"创建一个新项目。生成如下的目录结构:
设置Maven的路径,选择"File" -> "settings" -> 输入"mvn"。
2. 引入依赖
我们所使用的Servlet是Tomcat的api,不是JDK,也就是说Servlet的使用需要引入第三方库。我们可以直接手动下载,但是在maven中不需要,我们只需将对应的地址写入到maven的配置项之中即可,maven会自动帮助我们下载。
首先先去maven的中央仓库获取到Servlet的地址:https://mvnrepository.com/
进入界面之后,在上方的搜索框中输入servlet,然后点击search按钮,点击第一条结果。下翻,找到与你的tomcat版本相匹配的servlet版本(如果tomcat是8,直接点击下载3.1.0;如果tomcat是9,直接点击下载4.0.1)。点击对应的版本,下拉,找到Maven下面的代码复制。
在maven的配置项文件pom.xml中,粘贴刚才的内容(需要先创建一个标签):
<dependencies>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
注意:第一次引入依赖的时候可能需要等待一些时间(maven需要进行下载)。
3. 创建目录
maven项目是普适的,不仅仅局限于Tomcat,但是如果想在Maven中使用Tomcat,就需要遵守Tomcat的一些规范,这些规范就是一个固定的目录结构。
在main文件夹上右键“New” -> “Directory” -> 输入“webapp”。
然后在webapp文件夹上右键“New” -> “Directory” -> 输入“WEB-INF”。
最后在WEB-INF文件夹上右键“New” -> “File” -> 输入“web.xml”。
与此同时,在我们创建好的web.xml文件中也需要添加一些内容,才符合完整的tomcat的文件格式要求。粘贴如下内容:
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
</web-app>
4. 编写代码
在src/main/java/文件夹中,编写自己的代码。
- 创建一个类,并继承于HttpServlet,同时添加注解,进行路由匹配
- 重写doGet方法
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/hello") // 这个注解的作用是进行路由匹配
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("hello world"); // 这是在tomcat的控制台中打印
resp.getWriter().write("hello world"); // 在对应的服务器上进行打印
}
}
5. 打包程序
- 首先配置属性——点击pom.xml——配置
<packaging>war</packaging>
<build>
<finalName>apitest</finalName>
</build>
说明:apitest就是最终生成的war文件名称。
- 开始进行打包——点击右侧的M按键,双击package。
当控制台中出现"BUILD SUCCESS"时表示创建成功,同时,在左侧也会创建出一个target目录。最后一个.war文件就是我们最终打的包。
6. 部署程序
打开tomcat所在目录,将刚才创建好的war包复制到tomcat的webapps目录下,这样就完成了部署程序。
7. 验证程序
进入tomcat的bin目录下,双击startup.bat打开程序,会启动cmd窗口,不要关闭。
在浏览器中访问部署好的程序,在地址栏输入:127.0.0.1:8080/apitest/hello。
说明:apitest是war包的名称,hello是注解@WebServlet("/hello") 中的内容。
最终结果:
- 首先在打开的界面上出现hello world
- 在打开的tomcat程序中也有hello world