Java Servlet API中文说明文档(五)

　　public void setContentType(String type);

　　这个方法用来设定响应的content类型。这个类型以后可能会在另外的一些情况下被隐式地修改，这里所说的另外的情况可能当服务器发现有必要的情况下对MIME的字符设置。

　　为了保证成功地设定响应头的content类型，在响应被提交到输出流之前必须调用这个方法。

　　七、SingleThreadModel接口

　　定义

　　public interface SingleThreadModel;

　　这是一个空接口，它指定了系统如何处理对同一个Servlet的调用。如果一个Servlet被这个接口指定，那么在这个Servlet中的service方法中将不会有两个线程被同时执行。

　　Servlet可以通过维持一个各自独立的Servlet实例池，或者通过只让Servlet的service中只有一个线程的方法来实现这个保证。

　　八、GenericServlet类

　　public abstract class GenericServlet implements Servlet,

　　ServletConfig, Serializable;

　　这个类的存在使得编写Servlet更加方便。它提供了一个简单的方案，这个方案用来执行有关Servlet生命周期的方法以及在初始化时对ServletConfig对象和ServletContext对象进行说明。

　　方法

　　1、destroy

　　public void destroy();

　　在这里destroy方法不做任何其他的工作。

　　2、getInitParameter

　　public String getInitParameter(String name);

　　这是一个简便的途径，它将会调用ServletConfig对象的同名的方法。

　　3、getInitParameterNames

　　public Enumeration getInitParameterNames();

　　这是一个简便的途径，它将会调用ServletConfig对象的同名的方法。

　　4、getServletConfig

　　public ServletConfig getServletConfig();

　　返回一个通过这个类的init方法产生的ServletConfig对象的说明。

　　5、getServletContext

　　public ServletContext getServletContext();

　　这是一个简便的途径，它将会调用ServletConfig对象的同名的方法。

　　6、getServletInfo

　　public String getServletInfo();

　　返回一个反映Servlet版本的String。

　　7、init

　　public void init() throws ServletException;

　　public void init(ServletConfig config) throws ServletException;

　　init(ServletConfig config)方法是一个对这个Servlet的生命周期进行初始化的简便的途径。

　　init()方法是用来让你对GenericServlet类进行扩充的，使用这个方法时，你不需要存储config对象，也不需要调用super.init(config)。

　　init(ServletConfig config)方法会存储config对象然后调用init()。如果你重载了这个方法，你必须调用super.init(config)，这样GenericServlet类的其他方法才能正常工作。

　　8、log

　　public void log(String msg);

　　public void log(String msg, Throwable cause);

　　通过Servlet content对象将Servlet的类名和给定的信息写入log文件中。

　　9、service

　　public abstract void service(ServletRequest request, ServletResponse

　　response) throws ServletException, IOException;

　　这是一个抽象的方法，当你扩展这个类时，为了执行网络请求，你必须执行它。

　　九、ServletInputStream类

　　定义

　　public abstract class ServletInputStream extends InputStream

　　这个类定义了一个用来读取客户端的请求信息的输入流。这是一个Servlet引擎提供的抽象类。一个Servlet通过使用ServletRequest接口获得了对一个ServletInputStream对象的说明。

　　这个类的子类必须提供一个从InputStream接口读取有关信息的方法。

　　方法

　　1、readLine

　　public int readLine(byte[] b, int off, int len) throws IOException;

　　从输入流的指定的偏移量开始将指定长度的字节读入到指定的数组中。如果该行所有请求的内容都已被读取，这个读取的过程将结束。如果是遇到了新的一行，新的一行的首个字符也将被读入到数组中。

十、ServletOutputStream类

　　定义

　　public abstract class ServletOutputStream extends OutputStream

　　这是一个由Servlet引擎使用的抽象类。Servlet通过使用ServletResponse接口的使用获得了对一个这种类型的对象的说明。利用这个输出流可以将数据返回到客户端。

　　这个类的子类必须提供一个向OutputStream接口写入有关信息的方法。

　　在这个接口中，当一个刷新或关闭的方法被调用时。所有数据缓冲区的信息将会被发送到客户端，也就是说响应被提交了。请注意，关闭这种类型的对象时不一定要关闭隐含的socket流。

　　方法

　　1、print

　　public void print(String s) throws IOException;

　　public void print(boolean b) throws IOException;

　　public void print(char c) throws IOException;

　　public void print(int i) throws IOException;

　　public void print(long l) throws IOException;

　　public void print(float f) throws IOException;

　　public void print(double d) throws IOException;

　　输出变量到输出流中

　　2、println

　　public void println() throws IOException;

　　public void println(String s) throws IOException;

　　public void println(boolean b) throws IOException;

　　public void println(char c) throws IOException;

　　public void println(int i) throws IOException;

　　public void println(long l) throws IOException;

　　public void println(float f) throws IOException;

　　public void println(double d) throws IOException;

　　输出变量到输出流中，并增加一个回车换行符

　　十一、ServletException类

　　定义

　　public class ServletException extends Exception

　　当Servlet遇到问题时抛出的一个异常。

　　构造函数

　　public ServletException();

　　public ServletException(String message);

　　public ServletException(String message, Throwable cause);

　　public ServletException(Throwable cause);

　　构造一个新的ServletException，如果这个构造函数包括一个Throwable参数，这个Throwable对象将被作为可能抛出这个异常的原因。

　　方法

　　1、getRootCause

　　public Throwable getRootCause();

　　如果配置了抛出这个异常的原因，这个方法将返回这个原因，否则返回一个空值。

　　十二、UnavailableException类

　　定义

　　public class UnavailableException extends ServletException

　　不论一个Servlet是永久地还是临时地无效，都会抛出这个异常。Servlet会记录这个异常以及Servlet引擎所要采取的相应措施。

　　临时的无效是指Servlet在某一时间由于一个临时的问题而不能处理请求。例如，在另一个不同的应用层的服务（可能是数据库）无法使用。这个问题可能会自行纠正或者需要采取其他的纠正措施。

　　永久的无效是指除非管理员采取措施，这个Servlet将不能处理客户端的请求。例如，这个Servlet配置信息丢失或Servlet的状态被破坏。

　　Servlet 引擎可以安全地处理包括永久无效在内的这两种异常，但是对临时无效的正常处理可以使得Servlet引擎更健壮。特别的，这时对Servlet的请求只是被阻止（或者是被延期）一段时间，这显然要比在service自己重新启动前完全拒绝请求更为科学。

　　构造函数

　　public UnavailableException(Servlet servlet, String message);

　　public UnavailableException(int seconds, Servlet servlet,

　　String message);

　　构造一个包含指定的描述信息的新的异常。如果这个构造函数有一个关于秒数的参数，这将给出Servlet发生临时无效后，能够重新处理请求的估计时间。如果不包含这个参数，这意味着这个Servlet永久无效。

　　方法

　　1、getServlet

　　public Servlet getServlet();

　　返回报告无效的Servlet。这被Servlet引擎用来识别受到影响的Servlet。

　　2、getUnavailableSeconds

　　public int getUnavailableSeconds();

　　返回Servlet预期的无效时间，如果这个Servlet是永久无效，返回-1。

　　3、isPermanent

　　public boolean isPermanent();

　　如果这个Servlet永久无效，返回布尔值true，指示必须采取一些管理行动以使得这个Servlet可用。

　　软件包：javax.servlet.http

　　所包含的接口：HttpServletRequest；HttpServletResponse；HttpSession；HttpSessionBindingListener；HttpSessionContext。

　　所包含的类：Cookie；HttpServlet；HttpSessionBindingEvent；HttpUtils。