八、设置HTTP应答头
程序员文章站
2024-02-26 20:02:46
8.1 http应答头概述 web服务器的http应答一般由以下几项构成：一个状态行，一个或多个应答头，一个空行，内容文档。设置http应答头往往和设置状态行中的状态...
8.1 http应答头概述
web服务器的http应答一般由以下几项构成：一个状态行，一个或多个应答头，一个空行，内容文档。设置http应答头往往和设置状态行中的状态代码结合起来。例如，有好几个表示“文档位置已经改变”的状态代码都伴随着一个location头，而401（unauthorized）状态代码则必须伴随一个www-authenticate头。
然而，即使在没有设置特殊含义的状态代码时，指定应答头也是很有用的。应答头可以用来完成：设置cookie，指定修改日期，指示浏览器按照指定的间隔刷新页面，声明文档的长度以便利用持久http连接，……等等许多其他任务。
设置应答头最常用的方法是httpservletresponse的setheader，该方法有两个参数，分别表示应答头的名字和值。和设置状态代码相似，设置应答头应该在发送任何文档内容之前进行。
setdateheader方法和setintheadr方法专门用来设置包含日期和整数值的应答头，前者避免了把java时间转换为gmt时间字符串的麻烦，后者则避免了把整数转换为字符串的麻烦。
httpservletresponse还提供了许多设置常见应答头的简便方法，如下所示：
setcontenttype：设置content-type头。大多数servlet都要用到这个方法。
setcontentlength：设置content-length头。对于支持持久http连接的浏览器来说，这个函数是很有用的。
addcookie：设置一个cookie（servlet api中没有setcookie方法，因为应答往往包含多个set-cookie头）。
另外，如上节介绍，sendredirect方法设置状态代码302时也会设置location头。
8.2 常见应答头及其含义
有关http头详细和完整的说明，请参见http://www.w3.org/protocols/规范。
应答头 说明
allow 服务器支持哪些请求方法（如get、post等）。
content-encoding 文档的编码（encode）方法。只有在解码之后才可以得到content-type头指定的内容类型。利用gzip压缩文档能够显著地减少html文档的下载时间。java的gzipoutputstream可以很方便地进行gzip压缩，但只有unix上的netscape和windows上的ie 4、ie 5才支持它。因此，servlet应该通过查看accept-encoding头（即request.getheader("accept-encoding")）检查浏览器是否支持gzip，为支持gzip的浏览器返回经gzip压缩的html页面，为其他浏览器返回普通页面。
content-length 表示内容长度。只有当浏览器使用持久http连接时才需要这个数据。如果你想要利用持久连接的优势，可以把输出文档写入bytearrayoutputstram，完成后查看其大小，然后把该值放入content-length头，最后通过bytearraystream.writeto(response.getoutputstream()发送内容。
content-type 表示后面的文档属于什么mime类型。servlet默认为text/plain，但通常需要显式地指定为text/html。由于经常要设置content-type，因此httpservletresponse提供了一个专用的方法setcontenttyep。
date 当前的gmt时间。你可以用setdateheader来设置这个头以避免转换时间格式的麻烦。
expires 应该在什么时候认为文档已经过期，从而不再缓存它？
last-modified 文档的最后改动时间。客户可以通过if-modified-since请求头提供一个日期，该请求将被视为一个条件get，只有改动时间迟于指定时间的文档才会返回，否则返回一个304（not modified）状态。last-modified也可用setdateheader方法来设置。
location 表示客户应当到哪里去提取文档。location通常不是直接设置的，而是通过httpservletresponse的sendredirect方法，该方法同时设置状态代码为302。
refresh 表示浏览器应该在多少时间之后刷新文档，以秒计。除了刷新当前文档之外，你还可以通过setheader("refresh", "5; url=http://host/path")让浏览器读取指定的页面。
注意这种功能通常是通过设置html页面head区的＜meta http-equiv="refresh" content="5;url=http://host/path"＞实现，这是因为，自动刷新或重定向对于那些不能使用cgi或servlet的html编写者十分重要。但是，对于servlet来说，直接设置refresh头更加方便。
注意refresh的意义是“n秒之后刷新本页面或访问指定页面”，而不是“每隔n秒刷新本页面或访问指定页面”。因此，连续刷新要求每次都发送一个refresh头，而发送204状态代码则可以阻止浏览器继续刷新，不管是使用refresh头还是＜meta http-equiv="refresh" ...＞。
注意refresh头不属于http 1.1正式规范的一部分，而是一个扩展，但netscape和ie都支持它。
server 服务器名字。servlet一般不设置这个值，而是由web服务器自己设置。
set-cookie 设置和页面关联的cookie。servlet不应使用response.setheader("set-cookie", ...)，而是应使用httpservletresponse提供的专用方法addcookie。参见下文有关cookie设置的讨论。
www-authenticate 客户应该在authorization头中提供什么类型的授权信息？在包含401（unauthorized）状态行的应答中这个头是必需的。例如，response.setheader("www-authenticate", "basic realm=＼"executives＼"")。
注意servlet一般不进行这方面的处理，而是让web服务器的专门机制来控制受密码保护页面的访问（例如.htaccess）。
8.3 实例：内容改变时自动刷新页面
下面这个servlet用来计算大素数。因为计算非常大的数字（例如500位）可能要花不少时间，所以servlet将立即返回已经找到的结果，同时在后台继续计算。后台计算使用一个优先级较低的线程以避免过多地影响web服务器的性能。如果计算还没有完成，servlet通过发送refresh头指示浏览器在几秒之后继续请求新的内容。
注意，本例除了说明http应答头的用处之外，还显示了servlet的另外两个很有价值的功能。首先，它表明servlet能够处理多个并发的连接，每个都有自己的线程。servlet维护了一份已有素数计算请求的vector表，通过查找素数个数（素数列表的长度）和数字个数（每个素数的长度）将当前请求和已有请求相匹配，把所有这些请求同步到这个列表上。第二，本例证明，在servlet中维持请求之间的状态信息是非常容易的。维持状态信息在传统的cgi编程中是一件很麻烦的事情。由于维持了状态信息，浏览器能够在刷新页面时访问到正在进行的计算过程，同时也使得servlet能够保存一个有关最近请求结果的列表，当一个新的请求指定了和最近请求相同的参数时可以立即返回结果。
primenumbers.java
注意，该servlet要用到前面给出的servletutilities.java。另外还要用到：primelist.java，用于在后台线程中创建一个素数的vector；primes.java，用于随机生成biginteger类型的大数字，检查它们是否是素数。（此处略去primelist.java和primes.java的代码。）
package hall;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
public class primenumbers extends httpservlet {
private static vector primelistvector = new vector();
private static int maxprimelists = 30;
public void doget(httpservletrequest request,
httpservletresponse response)
throws servletexception, ioexception {
int numprimes = servletutilities.getintparameter(request, "numprimes", 50);
int numdigits = servletutilities.getintparameter(request, "numdigits", 120);
primelist primelist = findprimelist(primelistvector, numprimes, numdigits);
if (primelist == null) {
primelist = new primelist(numprimes, numdigits, true);
synchronized(primelistvector) {
if (primelistvector.size() ＞= maxprimelists)
primelistvector.removeelementat(0);
primelistvector.addelement(primelist);
}
}
vector currentprimes = primelist.getprimes();
int numcurrentprimes = currentprimes.size();
int numprimesremaining = (numprimes - numcurrentprimes);
boolean islastresult = (numprimesremaining == 0);
if (!islastresult) {
response.setheader("refresh", "5");
}
response.setcontenttype("text/html");
printwriter out = response.getwriter();
string title = "some " + numdigits + "-digit prime numbers";
out.println(servletutilities.headwithtitle(title) +
"＜body bgcolor=＼"#fdf5e6＼"＞＼n" +
"＜h2 align=center＞" + title + "＜/h2＞＼n" +
"＜h3＞primes found with " + numdigits +
" or more digits: " + numcurrentprimes + ".＜/h3＞");
if (islastresult)
out.println("＜b＞done searching.＜/b＞");
else
out.println("＜b＞still looking for " + numprimesremaining +
" more＜blink＞...＜/blink＞＜/b＞");
out.println("＜ol＞");
for(int i=0; i＜numcurrentprimes; i++) {
out.println(" ＜li＞" + currentprimes.elementat(i));
}
out.println("＜/ol＞");
out.println("＜/body＞＜/html＞");
}
public void dopost(httpservletrequest request,
httpservletresponse response)
throws servletexception, ioexception {
doget(request, response);
}
// 检查是否存在同类型请求（已经完成，或者正在计算）。
// 如存在，则返回现有结果而不是启动新的后台线程。
private primelist findprimelist(vector primelistvector,
int numprimes,
int numdigits) {
synchronized(primelistvector) {
for(int i=0; i＜primelistvector.size(); i++) {
primelist primes = (primelist)primelistvector.elementat(i);
if ((numprimes == primes.numprimes()) &&
(numdigits == primes.numdigits()))
return(primes);
}
return(null);
}
}
}
primenumbers.html
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞大素数计算＜/title＞
＜/head＞
＜center＞
＜body bgcolor="#fdf5e6"＞
＜form action="/servlet/hall.primenumbers"＞
＜b＞要计算几个素数:＜/b＞
＜input type="text" name="numprimes" value=25 size=4＞＜br＞
＜b＞每个素数的位数:＜/b＞
＜input type="text" name="numdigits" value=150 size=3＞＜br＞
＜input type="submit" value="开始计算"＞
＜/form＞
＜/center＞
＜/body＞
＜/html＞
web服务器的http应答一般由以下几项构成：一个状态行，一个或多个应答头，一个空行，内容文档。设置http应答头往往和设置状态行中的状态代码结合起来。例如，有好几个表示“文档位置已经改变”的状态代码都伴随着一个location头，而401（unauthorized）状态代码则必须伴随一个www-authenticate头。
然而，即使在没有设置特殊含义的状态代码时，指定应答头也是很有用的。应答头可以用来完成：设置cookie，指定修改日期，指示浏览器按照指定的间隔刷新页面，声明文档的长度以便利用持久http连接，……等等许多其他任务。
设置应答头最常用的方法是httpservletresponse的setheader，该方法有两个参数，分别表示应答头的名字和值。和设置状态代码相似，设置应答头应该在发送任何文档内容之前进行。
setdateheader方法和setintheadr方法专门用来设置包含日期和整数值的应答头，前者避免了把java时间转换为gmt时间字符串的麻烦，后者则避免了把整数转换为字符串的麻烦。
httpservletresponse还提供了许多设置常见应答头的简便方法，如下所示：
setcontenttype：设置content-type头。大多数servlet都要用到这个方法。
setcontentlength：设置content-length头。对于支持持久http连接的浏览器来说，这个函数是很有用的。
addcookie：设置一个cookie（servlet api中没有setcookie方法，因为应答往往包含多个set-cookie头）。
另外，如上节介绍，sendredirect方法设置状态代码302时也会设置location头。
8.2 常见应答头及其含义
有关http头详细和完整的说明，请参见http://www.w3.org/protocols/规范。
应答头 说明
allow 服务器支持哪些请求方法（如get、post等）。
content-encoding 文档的编码（encode）方法。只有在解码之后才可以得到content-type头指定的内容类型。利用gzip压缩文档能够显著地减少html文档的下载时间。java的gzipoutputstream可以很方便地进行gzip压缩，但只有unix上的netscape和windows上的ie 4、ie 5才支持它。因此，servlet应该通过查看accept-encoding头（即request.getheader("accept-encoding")）检查浏览器是否支持gzip，为支持gzip的浏览器返回经gzip压缩的html页面，为其他浏览器返回普通页面。
content-length 表示内容长度。只有当浏览器使用持久http连接时才需要这个数据。如果你想要利用持久连接的优势，可以把输出文档写入bytearrayoutputstram，完成后查看其大小，然后把该值放入content-length头，最后通过bytearraystream.writeto(response.getoutputstream()发送内容。
content-type 表示后面的文档属于什么mime类型。servlet默认为text/plain，但通常需要显式地指定为text/html。由于经常要设置content-type，因此httpservletresponse提供了一个专用的方法setcontenttyep。
date 当前的gmt时间。你可以用setdateheader来设置这个头以避免转换时间格式的麻烦。
expires 应该在什么时候认为文档已经过期，从而不再缓存它？
last-modified 文档的最后改动时间。客户可以通过if-modified-since请求头提供一个日期，该请求将被视为一个条件get，只有改动时间迟于指定时间的文档才会返回，否则返回一个304（not modified）状态。last-modified也可用setdateheader方法来设置。
location 表示客户应当到哪里去提取文档。location通常不是直接设置的，而是通过httpservletresponse的sendredirect方法，该方法同时设置状态代码为302。
refresh 表示浏览器应该在多少时间之后刷新文档，以秒计。除了刷新当前文档之外，你还可以通过setheader("refresh", "5; url=http://host/path")让浏览器读取指定的页面。
注意这种功能通常是通过设置html页面head区的＜meta http-equiv="refresh" content="5;url=http://host/path"＞实现，这是因为，自动刷新或重定向对于那些不能使用cgi或servlet的html编写者十分重要。但是，对于servlet来说，直接设置refresh头更加方便。
注意refresh的意义是“n秒之后刷新本页面或访问指定页面”，而不是“每隔n秒刷新本页面或访问指定页面”。因此，连续刷新要求每次都发送一个refresh头，而发送204状态代码则可以阻止浏览器继续刷新，不管是使用refresh头还是＜meta http-equiv="refresh" ...＞。
注意refresh头不属于http 1.1正式规范的一部分，而是一个扩展，但netscape和ie都支持它。
server 服务器名字。servlet一般不设置这个值，而是由web服务器自己设置。
set-cookie 设置和页面关联的cookie。servlet不应使用response.setheader("set-cookie", ...)，而是应使用httpservletresponse提供的专用方法addcookie。参见下文有关cookie设置的讨论。
www-authenticate 客户应该在authorization头中提供什么类型的授权信息？在包含401（unauthorized）状态行的应答中这个头是必需的。例如，response.setheader("www-authenticate", "basic realm=＼"executives＼"")。
注意servlet一般不进行这方面的处理，而是让web服务器的专门机制来控制受密码保护页面的访问（例如.htaccess）。
8.3 实例：内容改变时自动刷新页面
下面这个servlet用来计算大素数。因为计算非常大的数字（例如500位）可能要花不少时间，所以servlet将立即返回已经找到的结果，同时在后台继续计算。后台计算使用一个优先级较低的线程以避免过多地影响web服务器的性能。如果计算还没有完成，servlet通过发送refresh头指示浏览器在几秒之后继续请求新的内容。
注意，本例除了说明http应答头的用处之外，还显示了servlet的另外两个很有价值的功能。首先，它表明servlet能够处理多个并发的连接，每个都有自己的线程。servlet维护了一份已有素数计算请求的vector表，通过查找素数个数（素数列表的长度）和数字个数（每个素数的长度）将当前请求和已有请求相匹配，把所有这些请求同步到这个列表上。第二，本例证明，在servlet中维持请求之间的状态信息是非常容易的。维持状态信息在传统的cgi编程中是一件很麻烦的事情。由于维持了状态信息，浏览器能够在刷新页面时访问到正在进行的计算过程，同时也使得servlet能够保存一个有关最近请求结果的列表，当一个新的请求指定了和最近请求相同的参数时可以立即返回结果。
primenumbers.java
注意，该servlet要用到前面给出的servletutilities.java。另外还要用到：primelist.java，用于在后台线程中创建一个素数的vector；primes.java，用于随机生成biginteger类型的大数字，检查它们是否是素数。（此处略去primelist.java和primes.java的代码。）
package hall;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
public class primenumbers extends httpservlet {
private static vector primelistvector = new vector();
private static int maxprimelists = 30;
public void doget(httpservletrequest request,
httpservletresponse response)
throws servletexception, ioexception {
int numprimes = servletutilities.getintparameter(request, "numprimes", 50);
int numdigits = servletutilities.getintparameter(request, "numdigits", 120);
primelist primelist = findprimelist(primelistvector, numprimes, numdigits);
if (primelist == null) {
primelist = new primelist(numprimes, numdigits, true);
synchronized(primelistvector) {
if (primelistvector.size() ＞= maxprimelists)
primelistvector.removeelementat(0);
primelistvector.addelement(primelist);
}
}
vector currentprimes = primelist.getprimes();
int numcurrentprimes = currentprimes.size();
int numprimesremaining = (numprimes - numcurrentprimes);
boolean islastresult = (numprimesremaining == 0);
if (!islastresult) {
response.setheader("refresh", "5");
}
response.setcontenttype("text/html");
printwriter out = response.getwriter();
string title = "some " + numdigits + "-digit prime numbers";
out.println(servletutilities.headwithtitle(title) +
"＜body bgcolor=＼"#fdf5e6＼"＞＼n" +
"＜h2 align=center＞" + title + "＜/h2＞＼n" +
"＜h3＞primes found with " + numdigits +
" or more digits: " + numcurrentprimes + ".＜/h3＞");
if (islastresult)
out.println("＜b＞done searching.＜/b＞");
else
out.println("＜b＞still looking for " + numprimesremaining +
" more＜blink＞...＜/blink＞＜/b＞");
out.println("＜ol＞");
for(int i=0; i＜numcurrentprimes; i++) {
out.println(" ＜li＞" + currentprimes.elementat(i));
}
out.println("＜/ol＞");
out.println("＜/body＞＜/html＞");
}
public void dopost(httpservletrequest request,
httpservletresponse response)
throws servletexception, ioexception {
doget(request, response);
}
// 检查是否存在同类型请求（已经完成，或者正在计算）。
// 如存在，则返回现有结果而不是启动新的后台线程。
private primelist findprimelist(vector primelistvector,
int numprimes,
int numdigits) {
synchronized(primelistvector) {
for(int i=0; i＜primelistvector.size(); i++) {
primelist primes = (primelist)primelistvector.elementat(i);
if ((numprimes == primes.numprimes()) &&
(numdigits == primes.numdigits()))
return(primes);
}
return(null);
}
}
}
primenumbers.html
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞大素数计算＜/title＞
＜/head＞
＜center＞
＜body bgcolor="#fdf5e6"＞
＜form action="/servlet/hall.primenumbers"＞
＜b＞要计算几个素数:＜/b＞
＜input type="text" name="numprimes" value=25 size=4＞＜br＞
＜b＞每个素数的位数:＜/b＞
＜input type="text" name="numdigits" value=150 size=3＞＜br＞
＜input type="submit" value="开始计算"＞
＜/form＞
＜/center＞
＜/body＞
＜/html＞