首先我们得下载安装Tomcat,推荐看Tomcat(HTTP服务器)下载以及认识,
我们将通过打印一个hello word的方式来熟悉servlet开发,通过Tomcat部署一个webapp的流程
servlet的含义
Tomcat提供了一系列的api接口,这些api背后已经把一些基础工作都做好了(比如像处理HTTP协议这样的重复性工作)
Java程序员,只需要调用已经提供好的api,通过少量的代码,就可以完成基本http服务器的核心功能,Tomcat给这组 api 起了个名字,就是 servlet
一.创建项目
1.我们要在idea中创建一个JAVA项目
要注意Build system要选择Maven
Maven
Maven是Java中一个常用的构建工具,一个程序在运行的过程中,往往需要涉及到一些第三方库的依赖,另外还需要针对这个写好的程序进行打包部署
Maven存在的意义,就是为了更好的进行依赖管理和打包
2.创建好项目以后我们将看到项目的目录位置
main目录下要写的就是业务代码,resources文件夹放置的是一些依赖资源,test目录下放的是测试代码,pom.xml 这个文件是maven项目最主要的配置文件(maven主要用来管理依赖和打包)
此时我们看到main目录下的java目录中,编译器以及给我们写好了一些代码,我们是不需要的,直接将 org.example 这个文件删除掉,删除以后就是这样
3.删除好以后,我们在java目录下创建一个HelloWord类
二.引入依赖
当前的代码要使用 servlet 开发,而 servlet 并不是Java标准库自带的,就需要让 maven 把servlet 的依赖给获取到
要使用 servlet 中的 api 就需要引入依赖,我们要到中心仓库https://mvnrepository.com/中找到 servlet 的依赖
进入中心仓库后,搜索 servlet 找到 java servlet api
选择3.1.0版本,servlet 的版本和 tomcat 的版本是有对应关系的,tomcat 的版本使用8,servlet 就是3.1,如果不匹配就可能会出现问题
复制Maven处的代码
此时就需要引入依赖
在pom.xml 文件(maven中最主要的配置文件)中创建一个dependencies标签(注意dependencies标签要创建在project标签内部),将复制的代码粘贴到标签中
三.创建目录
创建目录的操作是固定的,不能有区别的,我们要按照 servlet 项目的要求,创建出一些特定的目录和文件
要在main目录下创建一个webapp包,在其内部创建一个WEB-INF包,在其内部创建一个web.xml文件。
web.xml 就是告诉 tomcat,我现在这个目录里的东西就是一个 webapp,就需要 tomcat 加载
web.xml 里还需要填写一些内容,不能是空着的,这些内容是固定的内容,只需要粘贴即可
<!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>
将上述的代码粘贴到 web.xml 中,不要修改任何格式哦,要不然就会出现问题
四.编写代码
此时我们终于可以编写代码了,要想打印一个 hello word 实际上要编写的代码没有多少,但有很多细节,当前提供纯代码以及带注释的代码
纯代码
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {System.out.println("hello word");resp.getWriter().write("hello word");}
}
带注释的代码
//要在Servlet类上加这个注解
//这个注解,就把当前这个Servlet类,和一个请求的路径关联起来了(配置路由)
//Tomcat会在合适的时机,自动调用doGet
//合适的时机:
//1.HTTP请求的方法,是否是GET
//2.请求的路径(url后面带有层次结构的路径)是否符合参数的要求
//一个Servlet程序里,可能有多个Servlet类,这些Servlet类就需要在不同的情况下被执行到
//我们所加注解中的参数是"/hello",表示当前请求的路径中带有“hello”的时候,我们这个HelloServlet类的代码才会被执行
@WebServlet("/hello")
//在利用Servlet开发时通常都需要继承HttpServlet
//HttpServlet来源于导入到pom.xml中Servlet的依赖,依赖导入成功就能成功继承HttpServlet
//继承HttpServlet不是目的,目的是为了重写这个父类中的方法
public class HelloServlet extends HttpServlet {/*** HttpServletRequest类型的req代表这次请求的HTTP内容* HttpServletResponse类型的resp代表这次请求要返回的HTTP响应* *///doGet方法本质上是一个回调函数,不需要我们手动调用//我们将这个方法定义好以后,就会交给Tomcat//Tomcat在收到一个合适的Get请求以后就会自动调用doGet//调用doGet时,Tomcat就会自动解析这次的HTTP请求,生成一个空的HttpServletResponse对象resp(这个对象的属性都是和HTTP协议格式匹配的)//把空的对象(没有初始化)resp传给doGet//doGet要做的事情,就是根据传入的HTTP请求,计算出响应//doGet里的代码,就是根据req里不同参数的细节,生成一个具体的resp对象(往空对象中设置属性)//Tomcat就会根据resp响应对象,转换成符合HTTP协议的响应报文@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//这段代码是编译器自动添加的,一定要删除掉,要不然会出现问题//super.doGet(req, resp);//此时打印的 hello word 是打印到服务器日志中的System.out.println("hello word");//要想把 hello word 返回给客户端,还需要进一步使用下列代码//resp是未初始化过的空的响应对象,doGet的目的就是为了把这个对象给设置好//通过getWriter可以获得resp内置的输出流对象//使用write方法,就可以把一个字符串写到resp对象中(把数据写入到了HTTP响应的body中)//浏览器拿到HTTP响应后body的内容就可以显示到页面上了resp.getWriter().write("hello word");}
}
//此时代码就写完了,或许会有人疑惑,难道不需要有一个main方法吗?没有main方法程序怎么运行呢?
//Servlet程序是不需要main方法的,因为我们写的代码并不是独立的程序,而是放到Tomcat上执行的
//main方法其实是在tomcat里的,我们写的doGet等方法就是给tomcat调用的
五.对程序进行打包
在maven中,默认打包生成的是 .jar 包(常用的 Java 打包方式,jar里面就是一些 .class文件)但是 tomcat 需要的并不是 jar 包而是 war 包(本质上和 jar 包差不多,这里会包含一些前端代码,以及一些tomcat的配置)
我们就需要在 maven 主要的配置文件 pom.xml 中添加一些标签,要添加的标签如下:
<packaging>war</packaging><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-war-plugin</artifactId><version>3.2.0</version><!--要在下面添加以下配置--><configuration><failOnMissingWebXml>false</failOnMissingWebXml></configuration></plugin></plugins><finalName>hello_servlet</finalName></build>
packaging 标签代表要打包的类型,是 war 包
在build标签中的finalName标签代表打包好以后的 war 包的名称
加好代码以后我们就找到 idea 右边的 maven 中的 package 选项,双击即可打包
打包好以后,我们能看到目录中多出来了几个文件
六.部署,把打好的war包放到tomcat的webapps目录中
对目录中打包好的 war 包,我们右键 选择Open in ,点击Explorer,找到 war 包所在的文件夹
将 war 包复制到 tomcat 的webapps 目录下,然后运行 tomcat
此时我们就在 tomcat 上部署好了一个 webapp
七.验证
通过浏览器去发送一个 http 请求给我们在 tomcat 上部署好了的 webapp,我们访问的 url 是127.0.0.1:8080/hello_servlet/hello url 的结构和我们编写代码时的命名是对应的
127.0.0.1是回显IP,代表我们本机的IP地址
8080是 tomcat 默认的端口号
hello_servlet 是我们部署的 webapp 的名称,tomcat 上可能会部署多个 webapp 通过hello_servlet 这个路径可以准确找到我们要访问的 webapp
/hello 和我们在代码中写的注解的参数相对应,因为一个 webapp 中可能会有多个 servlet 的类,通过注解中的参数,我们可以准确的找到我们要访问的 servlet 的类
我们重写的是doGet 方法,这样要是HTTP请求是 Get 类型,就会调用 doGet 方法来处理HTTP请求
输入 api 访问,我们就能得到如下的页面
这就大功告成了!