在前面一节中已经讲过Servlet通过下面的方法来提供服务:
对于HTTP Servlets,正确提供响应的过程是首先填写响应(response)的头信息,然后从响应(response)中得到输出流,最后向输出流中写入内容信息。响应(response)头信息必须最先设置。下面将描述如何从请求(request)中获得信息和产生HTTP响应(response)。
- 实现service方法。
- 实现HttpServlet的doMethod方法(doGet、doDelete、doOptions、 doPost、doPut、doTrace)。
对于HTTP Servlets,正确提供响应的过程是首先填写响应(response)的头信息,然后从响应(response)中得到输出流,最后向输出流中写入内容信息。响应(response)头信息必须最先设置。下面将描述如何从请求(request)中获得信息和产生HTTP响应(response)。
- 取得客户端请求
一个HttpServletRequest对象提供到达HTTP 头部数据,也允许你获取客户端的数据。怎样获取这些数据取决于HTTP端请求方法。不管用任何HTTP方式,你都可以用 getParameterValues方法返回特定名称的参数值。对于用 HTTP GET 请求的方式,这个getQueryString方法将会返回一个可以用来分析的值。
客户端请求(request)包含了从客户端传递到Servlet的数据。所有的请求(request)都实现了ServletRequest接口。这个接口定义了一些方法访问下面的信息,如表14-1所示。
表14-1 ServletRequest接口方法 类 型 描 述 对 应 方 法 参数,用来在客户端和Servlet之间传送信息 getAttribute(String name) getAttributeNames() getInputStream() getParameter(String name) getParameterMap() getParameterNames() getParameterValues(String name) 对象值属性,用来在Servlet容器和Servlet 之间,或者协作的Servlet之间传递信息 removeAttribute(String name) setAttribute(String name, Object o) 有关请求使用的协议信息, 客户端和服务器在请求中的调用 getContentLength() getContentType() getProtocol() getReader() getRealPath(String path) getRemoteAddr() getRemoteHost() getRequestDispatcher(String path) 有关请求使用的协议信息, 客户端和服务器在请求中的调用 getScheme() getServerName() getServerPort() isSecure() 有关localization的信息 getCharacterEncoding() getLocale() getLocales() setCharacterEncoding(String env)
下面的代码段示范了如何使用request中的方法获得客户端信息。
Enumeration params = request.getParameterNames(); String paramName = null; String[] paramValues = null; while (params.hasMoreElements()) { paramName = (String) params.nextElement(); paramValues = request.getParameterValues(paramName); System.out.println("/nParameter name is " + paramName); for (int i = 0; i < paramValues.length; i++) { System.out.println(", value " + i + " is " + paramValues[i].toString()); } }
HTTP Servlets使用HTTP request对象(HttpServletRequest),它包含了request URL、HTTP头信息、查询字符串,等等。HTTP request URL 包括几个部分:
http:// : ?
一般情况下:
requestURI = contextPath + servletPath + pathInfo Context path:通过getContextPath方法获得。 Servlet Path:通过getServletPath方法获得。 PathInfo:通过getPathInfo方法获得。
如表14-2所示。
表14-2 路径的对应 Request Path Path Elements /catalog/help/feedback.jsp ContextPath: /catalog ServletPath: /help/feedback.jsp PathInfo: null
- 提供HTTP响应
响应(response)包含了在服务器和客户端之间传递的数据。所有的响应(response)都实现了ServletResponse接口。这个接口定义了一些方法提供给开发人员使用,如表14-3所示。
表14-3 ServletResponse接口方法 类 型 描 述 对 应 方 法 获得向客户端发送数据的输出流 发送字符流:getWriter() 发送字节流:getOutputStream() 指示响应返回的内容类型(例如:text/html) 已经注册的内容类型名称保存在IANA (Internet Assigned Numbers Authority) setContentType(java.lang.String type) 指出是否是缓冲输出。默认情况下写入输出的 内容被立即发送到客户端。使用缓冲后写入输出的内容先 不发送到客户端,这样Servlet有更多的时间设置相应的 状态码和头信息,或者转移到其他的Web资源 flushBuffer() getBufferSize() isCommitted() reset() resetBuffer() setBufferSize(int size) setContentLength(int len) 设置localization信息 getCharacterEncoding() getLocale() setLocale(java.util.Locale loc)
HTTP response类(HttpServletResponse)有一些代表HTTP头信息的域:
- 状态码用来指出响应(response)失败的原因。
- Cookies在客户端存储应用相关的信息,有时cookies用来维护和标识用户的session。
Servlet首先设置响应(response)头信息,包括响应(response)的内容类别和缓冲区大小,然后在 doGet方法中从响应(response)获得PrintWriter ,最后向输出中写入HTML代码,调用close()方法提交这次对客户端的响应(response)。示范代码如下:
public void doGet (HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 设置头信息 response.setContentType("text/html"); response.setBufferSize(8192); PrintWriter out = response.getWriter(); // 向response中输出 out.println("<html>" + "<head><title>+ messages.getString("TitleBookDescription") +</title></head>"); ... out.println("</body></html>"); // 关闭输出流 out.close(); }
下面介绍一个HTTP Servlet处理POST方式的例子(T111)
本文选自飞思图书《精通Java核心技术》