1. Servlet的基础结构
下面我们来谈谈处理用户GET请求的最简单的servlet框架。GET请求就是用户在浏览器的地址栏里输入一个地址、在网页上点击连接或产生一个没有定义方法的Html表单后产生的请求。Servlets还能轻松处理表单的提交(POST),关于处理表单提交我们将在后面几部分谈到。
import Java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class SomeServlet extends HttpServlet {
public void doGet(
HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
// 用 "request" 读取http信息头(如cookie)
// 和HTML表单数据 (如用户输入和提交的数据)
// 用"response"指定http响应 和http信息头
// (如指明信息的类型、设定cookie).
PrintWriter out = response.getWriter();
// 用 "out"输出内容到浏览器
} }
不管是用doGet还是doPost方法,servlet都要用到HttpServlet扩展类。这些方法可分为两类:HttpServletRequest和HttpServletResponse。HttpServletRequest含有获得表单数据、HTTP信息头等信息的方法。 HttpServletResponse则包含指明HTTP响应 (200, 404,等。)、信息头(Content-Type, Set-Cookie, 等。)的方法,更重要的是你能使用PrintWriter方法向客户端输出信息。注重doGet和doPost方法会抛出两个异常,所以必须在定义里包含他们。要用到PrintWriter、HttpServlet和HttpServletRequest, HttpServletResponse方法还必须分别引入java.io、javax.servlet和javax.servlet.http。 一般来说,doGet和doPost是被service方法调用的,但有时候你可能想越过service方法而直接使用自己定义的service方法,比如定义一个既能处理GET也能处理POST请求的servlet。
2. 一个简单的Servlet--产生存文本
下面是一个产生存文本的简单servlet的实例。
2.1 HelloWorld.java
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class HelloWorld extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
PrintWriter out = response.getWriter();
out.println("Hello World");
}
}
2.2 编译和安装Servlet
注重,安装servlet的方法会因web服务器不同而不同。具体请参考您使用的web服务器所带的安装文档。Java Web 服务器即Java Web Server(JWS)2.0上带有联机实例。在JWS里,servlet程序必须JWS放在安装目录的servlets目录下才能运行。假如web服务器由多人使用并且没有好的虚拟服务器的下层结构来自动避免冲突,你也可以像我一样在servlets目录下创建一个独立包(我取名叫hall)即在servlets目录下创建一个hall子目录,并把你写的servlet放在该目录下。这里我把HelloWorld.java放在hall目录下。其他大多数服务器的安装都大同小异,本教程的servlet和jsp例子都在BEA Weblogic和IBM的WebSphere 3.0测试通过。其中WebSphere对于虚拟服务器有一套优秀的机制,所以没有必要为了名字的冲突而单独使用包。
假如你以前从未用过包,那么有两种在包内编译类文件的方法可以使用。
一种方法就是在CLASSPATH里设置好指向包含有你的servlet文件的目录,这样就可以在该目录下正常编译。举个例子,假如你在Windows下的servlet的目录是C:JavaWebServerservlets,包名(即子目录)是hall, 那么在dos窗口设置如下:
DOS> set CLASSPATH=C:JavaWebServerservlets;%CLASSPATH%
DOS> cd C:JavaWebServerservletshall
DOS> javac YourServlet.java
第一步、设置路径。最好一步到位,免得以后每次都要重新打开一个dos窗口。Windows 95/98系统下在autoexec.bat文件里加入"set CLASSPATH=..."表达式,将CLASSPATH指向servlet.jar和jsp.jar。在NT下,开始菜单-设置-控制面板,选择“系统”,选择“环境”,然后输入变量名和变量值。注重假如你的包名是 name1.name2.name3的格式,还应该设置CLASSPATH指向包的顶层(即name1)。
第二种方法是转到包的上层目录,然后执行"javac DirectoryYourServlet.java" (注重Windows下是反斜杆)或者unix下"javac directory/YourServlet.java" (注重Unix下是正斜杆)。再举个例子,比如你在windows下的servlet目录是C:JavaWebServerservlets,包名也就是子目录名是hall,那么执行下列操作:
DOS> cd C:JavaWebServerservlets
DOS> javac hallYourServlet.java
注重Windows下,大部分JDK 1.1版本的javac都要求反斜杆,后来在JDK 1.2里得到了修正,但是由于很多web服务器是根据JDK1.1来配的,所以为了方便起见许多servlet作者还是坚持反斜杆。
javac的-d选项可以用来指定将.class文件和源码文件放在不同的地方。
2.3 运行Servlet servlet
一般是放在JWS安装目录下的servlets目录下,并通过 http://host/servlet/ServletName调用。注重这里的servlets目录中的servlets带有"s",而URL地址栏里的则没有。上面的例子放在hall包里,所以这样调用:http://host/servlet/hall.HelloWorld。其他服务器在servlet放置目录和调用上可能会稍有不同。大部分服务器都答应你定义servlet目录的映射,因此一个servlet也可以通过http://host/any-path/any-file.html调用。具体得看不同服务器,具体可以查看服务器自带的文档。
译自http://www.apl.jhu.edu/~hall/java/Servlet-Tutorial/