上一节我们介绍了 javax.servlet.Servlet接口和继承javax.servlet.GenericServlet抽象类生成Servlet的方法。 而实际上,直接继承GenericServlet并不方便也不实用, 更多的情况下是继承javax.servlet.http.HttpServlet来生成Servlet。

HttpServlet

先来复习一下上一节提到的类结构图:

servlet-basic-07.png

可以看到,HttpServlet继承了GenericServlet,不过它也是一个抽象类, 不能直接使用,只能继承它。

HttpServlet中常用的方法有两个:

doGet
void doGet(HttpServletRequest req, HttpServletResponse res) throws ServletException, IOException
当浏览器用GET方式访问时,该方法被调用。

doPost
void doPost(HttpServletRequest req, HttpServletResponse res) throws ServletException, IOException
当浏览器用POST方式访问时,该方法被调用。

这两个函数内部的处理方法基本上与上一节介绍的GenericServlet.service()函数相同。

另外其他的HTTP请求也都有相应的方法:

HTTP请求类别HttpServlet的方法
GET doGet()
POST doPost()
HEAD doHead()
PUT doPut()
DELETE doDelete()

HttpServletRequest

doGet()doPost()函数的两个参数为 HttpServletRequestHttpServletResponse对象。

HttpServletRequest接口表示浏览器请求,你可以通过这个类获取浏览器发送到服务器的任何信息。 对于PHP程序员来说,这个类有点类似于 $_GET$_POST$_SERVER 等几个变量的内容。 它的常用方法如下:

getParameter
String getParameter(String name)
获取指定变量名name所对应的参数值。该方法实际上为父接口 javax.servlet.ServletRequest的方法。如果是GET请求则获取查询字符串后的参数,POST请求则获取<form>表单中的参数。类似于PHP的$_GET$_POST数组。

getParameterValues
String[] getParameterValues(String name)
这个方法与getParameter()类似。当你要获取<input type=”check”>这类会返回多个值的表单属性时,就应当用这个方法。

getMethod
String getMethod()
返回字符串"GET""POST"

getRequestURI
String getRequestURI()
获取请求的URI(不包括查询字符串)。相当于PHP的$_SERVER['REQUEST_URI']

getServletPath
String getServletPath()
获取Servlet的路径。相当于PHP的$_SERVER['PHP_SELF']

getPathInfo
String getPathInfo()
获取PathInfo。相当于PHP的$_SERVER['PATH_INFO']

setCharacterEncoding
void setCharacterEncoding(String new)
设置请求的编码。需要处理汉字时务必要通过该方法设置正确的字符编码,否则将无法正确读取浏览器发过来的文字。

还有好多有用的方法大家可以自己去参考接口文档。

HttpServletResponse

HttpServletResponse接口则用于控制服务器发送给客户端的内容,相当于PHP的echoheader等函数。

setContentType
void setContentType(String type)
设置返回值的类型。通常的HTML内容可设置为"text/html; charset=UTF-8"等,而动态生成的图片则可以设置为"image/gif"等。输出汉字之前,务必要通过该方法指定输出的字符编码。相当于在PHP中写 header("Content-Type: image/gif")

ServletOutputStream
ServletOutputStream getOutputStream() throws IOException
向客户端发送二进制数据时,需要通过此方法获取输出流。

getWriter
PrintWriter getWriter() throws IOException
向客户端发送文本数据时,需要通过此方法获取输出流。

示例程序

上一节建立Servlet时,我们先生成了Java代码,再将其添加到web.xml的Servlet节中。 实际上可以直接在web.xml的Servlet节中建立Servlet,Lomboz会自动帮我们生成Java代码。

我们这次将建立一个表单提交程序,通过一个HTML表单提交数据,然后在Servlet中读出数据并显示出来。

首先右键单击WebContent目录,选择New->HTML,新建一个HTML文档,命名为 htmlpost.html。 下一步是选择HTML模板,直接用默认值即可。

然后编辑 htmlpost.html,可参考本节的源代码。源代码下载:

httppost.zip

右键单击Deployment Descriptor中的Servlets,选择New->Servlet

httpservlet-01.png

按照下图的样子,在Java package处输入包名 com.idv2.learnjsp,在 Class name处输入类名 HttpPost,单击Next。

httpservlet-02.png

出现Servlet映射的配置界面,输入适当的Description。注意下方的 URL Mappings,这个就是从浏览器访问该Servlet时使用的URL。

httpservlet-03.png

下一步选择新建的类的属性,通常选择默认即可。 不过我们的Servlet只需要处理POST方法,所以下方的重载列表中只需选择doPost即可。

httpservlet-04.png

最后单击Finish,即可完成Servlet的建立,并且Lomboz会自动在Java代码的src目录中生成HttpPost.java文件的框架。

编辑java代码,可以参考下面的源代码下载。

httppost.zip

其实这段代码的主要内容就是通过 getParameter 或者 getParameterValues 方法来获取客户端提交的数据。其代码片段如下;

// 字符集
request.setCharacterEncoding("UTF-8");

// 从表单中获得数据
out.println("  <li>用户名: " + request.getParameter("username"));
out.println("  <li>密码: " + request.getParameter("password"));
out.println("  <li>确认密码: " + request.getParameter("confpass"));

// 获取复选框的表单选项
String interests[] = request.getParameterValues("interests");
out.println("  <li>兴趣爱好: <br/>");
if (interests != null) {
  for (int i = 0; i < interests.length; i++) {
    out.println(interests[i] + "<br/>");
  }
}

编辑好代码之后,在Server视图中启动Tomcat,打开浏览器,输入 http://localhost:8080/LearnJSP/httppost.html, 输入信息之后单击“注册”,即可看到输入的注册信息。