Java Servlet API文档有用阐明（servlet-api.jar的作用）-编程开发-知优网

Java Servlet API文档是很庞大的一个知识库，本文是一份关于2.1版Java Servlet API的说明文档，希望对你有帮助。

Java Servlet API文档在实践开发中十分重要，这份Java Servlet API文档1998年的11月份就已定稿，其间一些与技能关系不大的部分已被省略，有爱好的读者能够从http://java.sun.com/products/Servlet/2.1/servletspec-2.1.zip下载原文阅览。

这是一份关于2.1版Java Servlet API的阐明文档，作为对这本文档的弥补，你能够到http://java.sun.com/products/servlet/index.html下面下载Javadoc格局的文档。

Java Servlet API文档谁需求

这份文档描绘了Java Servlet API的最新版别2.1版。所以，这本书关于Servlet的开发者及servlet引擎的开发者相同适用。

Java Servlet API文档的组成

Java Servlet API由两个软件包组成：一个是对应HTTP的软件包，另一个是不对应HTTP的通用的软件包。这两个软件包的一起存在使得Java Servlet API能够习惯将来的其他恳求-呼应的协议。

这份文档以及方才提及的Javadoc格局的文档都描绘了这两个软件包，Javadoc格局的文档还描绘了你应该怎么运用这两个软件包中的一切办法。

Java Servlet API文档有关标准

你或许对下面的这些Internet标准感爱好，这些标准将直接影响到Servlet API的开展和履行。你能够从http://info.internet.isi.edu/7c/in-notes/rfc/.cache 找到下面说到的一切这些RFC标准。

RFC 1738 一致资源定位器(URL)

RFC 1808 相关一致资源定位器

RFC 1945 超文本传输协议--HTTP/1.0

RFC 2045 多用途Internet邮件扩展(多用途网际邮件扩大协议(MIME))榜首部分:Internet信息体格局

RFC 2046 多用途Internet邮件扩展(多用途网际邮件扩大协议(MIME))第二部分:媒体类型

RFC 2047 多用途网际邮件扩大协议(MIME)(多用途Internet邮件扩展)第三部分:信息标题扩展用于非ASCII文本

RFC 2048 多用途Internet邮件扩展(多用途网际邮件扩大协议(MIME))第四部分: 注册进程

RFC 2049 多用途Internet邮件扩展(多用途网际邮件扩大协议(MIME))第五部分:一致性标准和比如

RFC 2068 超文本传输协议 -- HTTP/1.1

RFC 2069 一个扩展HTTP:摘要拜访判定

RFC 2109 HTTP状况办理机制

RFC 2145 HTTP 版别号的运用和解说

RFC 2324 超文本Coffee Pot操控协议 (HTCPCP/1.0)

万维网协会（http://www.w3.org）办理着这些协议的标准和履行。

Java Servlet API文档之Servlet的解析和载入

Servlet引擎解析并载入一个Servlet，这个进程能够产生在引擎启动时，需求一个Servlet去呼应恳求时，以及在此之间的任何时候。

Servlet引擎运用Java类载入东西载入一个Servlet，Servlet引擎能够从一个本地的文件体系、一个长途的文件体系以及网络载入Servlet。

Java Servlet API文档之Servlet的初始化

Servlet引擎载入Servlet后，Servlet引擎有必要对Servlet进行初始化，在这一进程中，你能够读取一些固定存储的数据、初始化JDBC的衔接以及树立与其他资源的衔接。

在初始化进程中，javax.servlet.Servlet接口的init()办法供给了Servlet的初始化信息。这样，Servlet能够对自己进行装备。

init()办法取得了一个Servlet装备目标（ServletConfig）。这个目标在Servlet引擎中履行，并答应Servlet经过它获处相关参数。这个目标使得Servlet能够拜访ServletContext目标。

Java Servlet API文档之Servlet处理恳求

Servlet被初始化之后，它现已能够处理来自客户端的恳求，每一个来自客户端的恳求都被描绘成一个ServletRequest目标，Servlet的呼应被描绘成一个ServletResponse目标。

当客户端宣布恳求时，Servlet引擎传递给Servlet一个ServletRequest目标和一个ServletResponse目标，这两个目标作为参数传递到service()办法中。

Servlet也能够履行ServletRequest接口和ServletResponse接口。ServletRequest接口使得Servlet有权运用客户端宣布的恳求。Servlet能够经过ServletInputStream目标读取恳求信息。

ServletResponse接口答应Servlet树立呼应头和状况代码。经过履行这个接口，Servlet有权运用ServletOutputStream类来向客户端回来数据。

Java Servlet API文档之完结多线程和映射

在多线程的环境下，Servlet有必要能处理许多一起产生的恳求。破例的状况是这个Servlet履行了SingleThreadModel接口，假如是那样的话，Servlet只能一起处理一个恳求。

Servlet按照Servlet引擎的映射来呼应客户端的恳求。一个映射对包含一个Servlet实例以及一个Servlet回来数据的URL，例如：HelloServlet with /hello/index.html。

可是，一个映射或许是由一个URL和许多Servlet实例组成，例如：一个分布式的Servlet引擎或许运转在不止一个的服务器中，这样的话，每一个服务器中都或许有一个Servlet实例，以平衡进程的载入。作为一个Servlet的开发者，你不能假定一个Servlet只要一个实例。

Java Servlet API文档之Servlet的卸载

Servlet引擎并不必需确保一个Servlet在任何时候或在服务敞开的任何时候都被载入。Servlet引擎能够自在的在任何时候运用或铲除一个Servlet。因而，咱们不能依靠一个类或实例来存储重要的信息。

当Servlet引擎决议卸载一个Servlet时（例如，假如这个引擎被封闭或许需求让资源），这个引擎有必要答应Servlet开释正在运用的资源并存储有关材料。为了完结以上作业，引擎会调用Servlet的destroy()办法。

在卸载一个Servlet之前，Servlet引擎有必要等候一切的service()办法完结或超时完毕（Servlet引擎会对超时作出界说）。当一个Servlet被卸载时，引擎将不能给Servlet发送任何恳求。引擎有必要开释Servlet并完结无用存储单元的搜集

Java Servlet API文档之Servlet映射技能

作为一个Servlet引擎的开发者，你有必要关于怎么映射客户端的恳求到Servlet有很多的习惯性。这份阐明文档不规则映射怎么产生。可是，你有必要能够自在地运用下面的一切技能：

映射一个Servlet到一个URL

例如，你能够指定一个特别的Servlet它仅被来自/feedback/index.html的恳求调用。

映射一个Servlet到以一个指定的目录名开端的一切URL

例如，你能够映射一个Servlet到/catalog，这样来自/catalog/、 /catalog/garden和/catalog/housewares/index.html的恳求都会被映射到这个Servlet。可是来自 /catalogtwo 或/catalog.html的恳求没被映射。

映射一个Servlet到一切以一个特定的字段结束的一切URL

例如，你能够映射一个来自于一切以in.thtml结束的恳求到一个特定的Servlet。

映射一个Servlet到一个特别的URL /servlet/servlet_name。

例如，假如你树立了一个名叫listattributes的Servlet，你能够经过运用/servlet/listattributes来拜访这个Servlet。

经过类名调用Servlet

例如，假如Servlet引擎接纳了来自/servlet/com.foo.servlet.MailServlet的恳求，Servlet引擎会载入这个com.foo.servlet.MailServlet类，树立实例，并经过这个Servlet来处理恳求。

Java Servlet API文档之Servlet环境

ServletContext接口界说了一个Servlet环境目标，这个目标界说了一个在Servlet引擎上的Servlet的视图。经过运用这个目标，Servlet能够记载事情、得到资源并得到来自Servlet引擎的类（例如RequestDispatcher目标）。一个 Servlet只能运转在一个Servlet环境中，可是不同的Servlet能够在Servlet引擎上有不同的视图。

假如Servlet引擎支撑虚拟主机，每个虚拟主机有一个Servlet环境。一个Servlet环境不能在虚拟主机之间同享。

Servlet引擎能够答应一个Servlet环境有它自己的活动范围。

例如，一个Servlet环境是归于bank运用的，它将被映射到/bank目录下。在这种状况下，一个对getContext办法的调用会回来/bank的Servlet环境。

HTTP会话

HTTP是一个没有状况的协议。要树立一个有用的Web服务运用，你有必要能够辨认一个接连的来自远端的客户机的仅有的恳求。跟着时刻的曩昔，开展了许多会话盯梢的技能，可是运用起来都比较费事。

Java Servlet API供给了一个简略的接口，经过这个接口，Servlet引擎能够有用地盯梢用户的会话。

Java Servlet API文档之树立Session

由于HTTP是一个恳求-呼应协议，一个会话在客户机参加之前会被认为是一个新的会话。参加的意思是回来会话盯梢信息到服务器中，指出会话已被树立。在客户端参加之前，咱们不能判别下一个客户端恳求是现在会话的一部分。

鄙人面的状况下，Session会被认为是新的Session。

客户端的Session在此之前还不知道

客户端挑选不参加Session，例如，假如客户端回绝接纳来自服务器的cookie

作为一个Servlet的开发者，你有必要决议你的Web运用是否处理客户机不参加或不能参加Session。服务器会在Web服务器或 Servlet规则的时刻内保持一个Session目标。当Session停止时，服务器会开释Session目标以及一切绑定在Session上的目标。

Java Servlet API文档之绑定目标到Session中

假如有助于你处理运用的数据需求，你或许需求绑定目标到Session中，你能够经过一个仅有的姓名绑定任何的目标到Session中，这时，你需求运用HttpSession目标。任何绑定到Session上的目标都能够被处理同一会话的Servlet调用。

有些目标或许需求你知道什么时候会被放置到Session中或从Session中移开。你能够经过运用 HttpSessionBindingListener接口取得这些信息。当你的运用存储数据到Session中，或从Session中铲除数据，Servlet都会经过HttpSessionBindingListener检杳什么类被绑定或被撤销绑定。这个接口的办法会通报被绑定或被撤销绑定的目标。

Java Servlet API文档是很巨大的一个知识库，那么其实常用的一些文档内容咱们要在平常活跃总结。

【修改引荐】