三、第一个Servlet

3.1 servlet基本结构

　　 下面的代码显示了一个简单servlet的基本结构。该servlet处理的是get请求，所谓的get请求，如果你不熟悉http，可以把它看成是当用户在浏览器地址栏输入url、点击web页面中的链接、提交没有指定method的表单时浏览器所发出的请求。servlet也可以很方便地处理post请求。post请求是提交那些指定了method=“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”读取和请求有关的信息（比如cookies）
  // 和表单数据

    // 使用“response”指定http应答状态代码和应答头
    // （比如指定内容类型，设置cookie）

    printwriter out = response.getwriter();
    // 使用 "out"把应答内容发送到浏览器
  }
}




　　 如果某个类要成为servlet，则它应该从httpservlet 继承，根据数据是通过get还是post发送，覆盖doget、dopost方法之一或全部。doget和dopost方法都有两个参数，分别为httpservletrequest 类型和httpservletresponse 类型。httpservletrequest提供访问有关请求的信息的方法，例如表单数据、http请求头等等。httpservletresponse除了提供用于指定http应答状态（200，404等）、应答头（content-type，set-cookie等）的方法之外，最重要的是它提供了一个用于向客户端发送数据的printwriter 。对于简单的servlet来说，它的大部分工作是通过println语句生成向客户端发送的页面。

　　 注意doget和dopost抛出两个异常，因此你必须在声明中包含它们。另外，你还必须导入java.io包（要用到printwriter等类）、javax.servlet包（要用到httpservlet等类）以及javax.servlet.http包（要用到httpservletrequest类和httpservletresponse类）。

　　 最后，doget和dopost这两个方法是由service方法调用的，有时你可能需要直接覆盖service方法，比如servlet要处理get和post两种请求时。

　　 3.2 输出纯文本的简单servlet

　　 下面是一个输出纯文本的简单servlet。

　　 3.2.1 helloworld.java
package hall;

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");
  }
}




　　 3.2.2 servlet的编译和安装

　　 不同的web服务器上安装servlet的具体细节可能不同，请参考web服务器文档了解更权威的说明。假定使用java web server（jws）2.0，则servlet应该安装到jws安装目录的servlets子目录下。在本文中，为了避免同一服务器上不同用户的servlet命名冲突，我们把所有servlet都放入一个独立的包hall中；如果你和其他人共用一个服务器，而且该服务器没有“虚拟服务器”机制来避免这种命名冲突，那么最好也使用包。把servlet放入了包hall之后，helloworld.java实际上是放在servlets目录的hall子目录下。

　　 大多数其他服务器的配置方法也相似，除了jws之外，本文的servlet和jsp示例已经在bea weblogic和ibm websphere 3.0下经过测试。websphere具有优秀的虚拟服务器机制，因此，如果只是为了避免命名冲突的话并非一定要用包。

　　 对于没有使用过包的初学者，下面我们介绍编译包里面的类的两种方法。

　　 一种方法是设置classpath，使其指向实际存放servlet的目录的上一级目录（servlet主目录），然后在该目录中按正常的方式编译。例如，如果servlet的主目录是c:＼javawebserver＼servlets，包的名字（即主目录下的子目录名字）是hall，在windows下，编译过程如下：
  dos＞ set classpath=c:＼javawebserver＼servlets;%classpath%
  dos＞ cd c:＼javawebserver＼servlets＼hall
  dos＞ javac yourservlet.java



　　 第二种编译包里面的servlet的方法是进入servlet主目录，执行“javac directory＼yourservlet.java”（windows）或者“javac directory/yourservlet.java”（unix）。例如，再次假定servlet主目录是c:＼javawebserver＼servlets，包的名字是hall，在windows中编译过程如下：
  dos＞ cd c:＼javawebserver＼servlets
  dos＞ javac hall＼yourservlet.java



　　 注意在windows下，大多数jdk 1.1版本的javac要求目录名字后面加反斜杠(＼)。jdk1.2已经改正这个问题，然而由于许多web服务器仍旧使用jdk 1.1，因此大量的servlet开发者仍旧在使用jdk 1.1。

　　 最后，javac还有一个高级选项用于支持源代码和.class文件的分开放置，即你可以用javac的“-d”选项把.class文件安装到web服务器所要求的目录。

　　 3.2.3 运行servlet

　　 在java web server下，servlet应该放到jws安装目录的servlets子目录下，而调用servlet的url是http://host/servlet/servletname。注意子目录的名字是servlets（带“s”），而url使用的是“servlet”。由于helloworld servlet放入包hall，因此调用它的url应该是http://host/servlet/hall.helloworld。在其他的服务器上，安装和调用servlet的方法可能略有不同。

　　 大多数web服务器还允许定义servlet的别名，因此servlet也可能用http://host/any-path/any-file.html形式的url调用。具体如何进行配置完全依赖于服务器类型，请参考服务器文档了解细节。

　　 3.3 输出html的servlet

　　 大多数servlet都输出html，而不象上例一样输出纯文本。要输出html还有两个额外的步骤要做：告诉浏览器接下来发送的是html；修改println语句构造出合法的html页面。

　　 第一步通过设置content-type（内容类型）应答头完成。一般地，应答头可以通过httpservletresponse的setheader方法设置，但由于设置内容类型是一个很频繁的操作，因此servlet api提供了一个专用的方法setcontenttype。注意设置应答头应该在通过printwriter发送内容之前进行。下面是一个实例：

　　 hellowww.java
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class hellowww extends httpservlet {
  public void doget(httpservletrequest request,
                    httpservletresponse response)
      throws servletexception, ioexception {
    response.setcontenttype("text/html");
    printwriter out = response.getwriter();
    out.println("＜!doctype html public ＼"-//w3c//dtd html 4.0 " +
      "transitional//en＼"＞＼n" +
                "＜html＞＼n" +
                "＜head＞＜title＞hello www＜/title＞＜/head＞＼n" +
                "＜body＞＼n" +
                "＜h1＞hello www＜/h1＞＼n" +
                "＜/body＞＜/html＞");
  }
}




　　 3.4 几个html工具函数

　　 通过println语句输出html并不方便，根本的解决方法是使用javaserver pages（jsp）。然而，对于标准的servlet来说，由于web页面中有两个部分（doctype和head）一般不会改变，因此可以用工具函数来封装生成这些内容的代码。

　　 虽然大多数主流浏览器都会忽略doctype行，但严格地说html规范是要求有doctype行的，它有助于html语法检查器根据所声明的html版本检查html文档合法性。在许多web页面中，head部分只包含＜title＞。虽然许多有经验的编写者都会在head中包含许多meta标记和样式声明，但这里只考虑最简单的情况。

　　 下面的java方法只接受页面标题为参数，然后输出页面的doctype、head、title部分。清单如下：

　　 servletutilities.java
package hall;

public class servletutilities {
  public static final string doctype =
    "＜!doctype html public ＼"-//w3c//dtd html 4.0 transitional//en＼"＞";

  public static string headwithtitle(string title) {
    return(doctype + "＼n" +
           "＜html＞＼n" +
           "＜head＞＜title＞" + title + "＜/title＞＜/head＞＼n");
  }

  // 其他工具函数的代码在本文后面介绍
}




　　 hellowww2.java

　　 下面是应用了servletutilities之后重写hellowww类得到的hellowww2：
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class hellowww2 extends httpservlet {
  public void doget(httpservletrequest request,
                    httpservletresponse response)
      throws servletexception, ioexception {
    response.setcontenttype("text/html");
    printwriter out = response.getwriter();
    out.println(servletutilities.headwithtitle("hello www") +
                "＜body＞＼n" +
                "＜h1＞hello www＜/h1＞＼n" +
                "＜/body＞＜/html＞");
  }
}