Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet

Servlet 本身不能独立运行,需要在一个web应用中运行的
而一个web应用是部署在tomcat中的

所以开发一个servlet需要如下几个步骤
创建web应用项目
编写servlet代码
部署到tomcat中

开发的IDE也有各种选择,有的使用MyEclipse,有的使用eclipse 的EE版本,有的使用IDEA开发。

本例使用Eclipse EE版 结合独立的 tomcat进行一次java普通项目的创建。

这样做的好处是,通过最原始的方式创建一个web应用,可以掌握最基本的知识。

以后再碰到相关问题出错的时候,更加利于解决。

注: 动态WEB项目的风格在如何在Eclipse中创建动态Web项目中也有讲解

必读: 基于Tomcat的程序要成功运行,对于配置文件的正确性有着苛刻的要求,任何一个地方出错了,都会导致运行失败。 如果你是第一次学习本教程,务必严格按照教程的指导,完全模仿操作,直到成功看到运行效果。 第一次成功之后,信心,思路都会有较好的铺垫,然后再根据自己的疑惑,在“成功”的代码上做原本想做的改动和调整,这样可以大大节约学习的时间,提高效率,切勿一来就擅自改动,给自己的学习制造障碍

步骤1:先运行,看到效果,再学习
步骤2:模仿和排错
步骤3:创建一个java项目j2ee
步骤4:导入必须的servlet-api.jar包
步骤5:编写HelloServlet
步骤6:配置web.xml
步骤7:指定项目输出到classes目录
步骤8:配置tomcat的server.xml 中的<context
步骤9:删除tomcat webapps下的ROOT目录
步骤10:重启tomcat,访问http://127.0.0.1/hello
步骤11:完整项目
步骤 1 : 先运行,看到效果,再学习
先运行,再学习

本知识点是一个JAVA WEB项目,需要做不少步骤,任何一步部做漏了,做错了,都有可能失败,这样会影响学习的信心,并且误以为本教程是走不通的。

所以先下载下载区(点击进入)的可运行项目:j2ee.rar,解压后部署在tomcat中,观察是否正常运行。确定可以运行,确定教程是可以跑得起来的,再学习下面的内容。

部署tomcat的办法请参考:在tomcat中部署JAVA WEB应用

部署成功之后,测试地址

http://127.0.0.1/hello

注: 本教程用的是80端口

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 2 : 模仿和排错
在确保可运行项目能够正确无误地运行之后,再严格照着教程的步骤,对代码模仿一遍。
模仿过程难免代码有出入,导致无法得到期望的运行结果,此时此刻通过比较正确答案 ( 可运行项目 ) 和自己的代码,来定位问题所在。
采用这种方式,学习有效果,排错有效率,可以较为明显地提升学习速度,跨过学习路上的各个槛。

推荐使用diffmerge软件,进行文件夹比较。把你自己做的项目文件夹,和我的可运行项目文件夹进行比较。
这个软件很牛逼的,可以知道文件夹里哪两个文件不对,并且很明显地标记出来
这里提供了绿色安装和使用教程:diffmerge 下载和使用教程
步骤 3 : 创建一个java项目j2ee
File->New->Other->Java->Java Project
输入名称j2ee
这样就创建一个单纯的基于java的项目
注意: 必须 放在 e:\project\j2ee目录下,后续配置是基于这个目录进行
注意:不要使用如下方式
File->New->Other-Web->Dynamic Web Project
这是eclipse ee创建项目的方式,它会把各种tomcat,相关配置文件的生成都自动做掉了。 而这些细节,恰恰就是你需要学习和掌握的。 所以对于初学者不建议使用这种方式。

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 4 : 导入必须的servlet-api.jar包
因为是开发Servlet所以需要用到 servlet-api.jar 这个包里的相关类。

servlet-api.jar 包位于 D:\tomcat\lib\servlet-api.jar

或者从本网页的右侧下载

导入办法:

右键点击项目 -> properties -> Java Build Path ->Libraries -> Add External JARs

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 5 : 编写HelloServlet
创建 HelloServlet(在Eclipse中创建一个普通类的方式:菜单->File->New->Class)
注意:eclipse创建的时候会自带一个包名j2ee,不要使用这个包名,让包名置空

HelloServlet继承了 HttpServlet
并且提供了一个doGet方法

后续测试该类的时候,会直接在浏览器输入地址

http://127.0.01/hello

在浏览器中输入地址提交数据的方式是GET (参考GET和POST的区别)
所以该Servlet需要提供一个对应的doGet方法

在doGet中,输出html
分别是 标题元素h1 和 当前时间的字符串

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet

import java.io.IOException;import java.util.Date;
 import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;
 public class HelloServlet extends HttpServlet{
 public void doGet(HttpServletRequest request, HttpServletResponse response){ try {response.getWriter().println("<h1>Hello Servlet!</h1>");response.getWriter().println(new Date().toLocaleString());} catch (IOException e) {// TODO Auto-generated catch blocke.printStackTrace();}} }

步骤 6 : 配置web.xml
首先在j2ee下创建目录web
接着再创建目录web/WEB-INF
然后在WEB-INF目录中创建 web.xml

web.xml提供路径与servlet的映射关系
把/hello这个路径,映射到 HelloServlet这个类上

标签下的
与 标签下的 必须一样

与可以不一样,但是为了便于理解与维护,一般都会写的一样。 一目了然

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet

<?xml version="1.0" encoding="UTF-8"?><web-app>
 <servlet><servlet-name>HelloServlet</servlet-name><servlet-class>HelloServlet</servlet-class></servlet>
 <servlet-mapping><servlet-name>HelloServlet</servlet-name><url-pattern>/hello</url-pattern></servlet-mapping>
 </web-app>

步骤 7 : 指定项目输出到classes目录
首先在WEB-INF下创建classes目录

把项目的class文件输出由原来的 j2ee/bin 设置到 j2ee/web/WEB-INF/classes下

步骤:
项目右键->properties->Java Build Path->Source->右下角的 Brower-> 指定位置是 j2ee/web/WEB-INF/classes。

为什么要有这一步? 在ecilpse中默认输出的class是在bin目录下,但是tomcat启动之后,在默认情况下,不会去bin目录找这些class文件,而是到WEB-INF/classes这个目录下去寻找。 所以通过这一步的配置,使得eclipse的class文件输出到WEB-INF/classes目录下,那么这样就和tomcat兼容了。

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 8 : 配置tomcat的server.xml 中的<context
Tomcat 请使用 80端口的,纯净版tomcat

为了把 j2ee/web 这个目录部署到tomcat中,进行如下操作:

打开tomcat/conf/sever.xml

在 <Host name=“localhost” 。。。 下面加一句

<Context path="/" docBase="e:\\project\\j2ee\\web" debug="0" reloadable="false" />

path="/" 就表示直接通过 http://127.0.0.1/hello 就可以访问网页了。

如果设置为

<Context path="/j2ee" docBase="e:\\project\\j2ee\\web" debug="0" reloadable="false" />

那么表示需要通过 http://127.0.0.1/j2ee/hello才能访问呢

如果这一步老是失败,请直接在右侧下载修改好的server.xml

步骤 9 : 删除tomcat webapps下的ROOT目录
在上一步部署web的时候server.xml中的path 配置为 “/” 与 webapps下的ROOT目录冲突了

所以要删除ROOT目录,如果没有就不用删除了

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 10 : 重启tomcat,访问http://127.0.0.1/hello
关闭tomcat后,重新启动startup.bat 访问下面地址就可以看到servlet的输出

http://127.0.0.1/hello

并且每一次刷新,都能看到输出新的时间

Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet
步骤 11 : 完整项目
最后,在右侧提供本项目的完整压缩包。

实在搞不出来,可以先解压出来,完全照着里面的复制一遍,总归能搞得出来的


上一篇:Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet


下一篇:Servlet系列教材 (一)- 基础 - 教程:开发第一个Servlet