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端口

步骤 2 : 模仿和排错

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

推荐使用diffmerge软件，进行文件夹比较。把你自己做的项目文件夹，和我的可运行项目文件夹进行比较。 
这个软件很牛逼的，可以知道文件夹里哪两个文件不对，并且很明显地标记出来 
这里提供了绿色安装和使用教程：diffmerge 下载和使用教程

步骤 3 : 创建一个java项目j2ee

File->New->Other->Java->Java Project
输入名称j2ee
这样就创建一个单纯的基于java的项目
注意： 必须 放在 e:projectj2ee目录下，后续配置是基于这个目录进行
注意：不要使用如下方式
File->New->Other-Web->Dynamic Web Project
这是eclipse ee创建项目的方式，它会把各种tomcat,相关配置文件的生成都自动做掉了。 而这些细节，恰恰就是你需要学习和掌握的。 所以对于初学者不建议使用这种方式。

步骤 4 : 导入必须的servlet-api.jar包

因为是开发Servlet所以需要用到 servlet-api.jar 这个包里的相关类。

servlet-api.jar 包位于 D: omcatlibservlet-api.jar

或者从本网页的右侧下载 

导入办法:

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

步骤 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 和 当前时间的字符串

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 block

            e.printStackTrace();

        }

    }

     

}

步骤 6 : 配置web.xml

首先在j2ee下创建目录web
接着再创建目录web/WEB-INF
然后在WEB-INF目录中创建 web.xml

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

<servlet> 标签下的 <servlet-name>
与 <servlet-mapping> 标签下的 <servlet-name> 必须一样

<servlet-name>与<servlet-class>可以不一样，但是为了便于理解与维护，一般都会写的一样。 一目了然

<?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兼容了。

步骤 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

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

步骤 9 : 删除tomcat webapps下的ROOT目录

在上一步部署web的时候server.xml中的path 配置为 "/" 与 webapps下的ROOT目录冲突了

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

步骤 10 : 重启tomcat，访问http://127.0.0.1/hello

关闭tomcat后，重新启动startup.bat 访问下面地址就可以看到servlet的输出

http://127.0.0.1/hello

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

步骤 11 : 完整项目

最后，在右侧提供本项目的完整压缩包。

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

更多内容，点击了解： https://how2j.cn/k/servlet/servlet-eclipse/558.html